Changes between Version 6 and Version 7 of CORE_MVC_BASE


Ignore:
Timestamp:
11/23/08 14:13:39 (16 years ago)
Author:
peko
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • CORE_MVC_BASE

    v6 v7  
    11= General Overview = 
    22These are the base classes that of which the MVC consists: [[BR]] 
    3 MVC is based upon the MVC pattern. 
     3MVC is based upon the MVC pattern.[[BR]] 
     4 '''Not that the tree kinds of Frames mentioned below ARE NOT the only frames Sophie2.0 will have. Though for the time being these are the Frames it has.''' 
    45== Model == 
    56Model represents this part of the application that is responsible for the persistence and the things that are later displayed by the View. 
    … …  
    1314  * [source:trunk/sophie2-platform/modules/org.sophie2.messy/src/main/java/org/sophie2/messy/model/frame/image/ImageFrame.java@112 ImageFrame]s 
    1415  * [source:/trunk/sophie2-platform/modules/org.sophie2.messy/src/main/java/org/sophie2/messy/model/frame/media/MediaFrame.java@112 MediaFrame]s 
    15  
     16  * Other types, not defined yet. 
    1617Diagram: [[BR]] [[Image(source:/trunk/sophie2-platform/doc/uml-design-diagrams/SimpleModelHierarchy.png)]] 
    1718 About the diagram: 
    … …  
    1920 * a Book contains Pages 
    2021 * a Page contains Frames 
    21  * Frames are divided into three types which extend the functionalities of a Frame. The tree types are: !TextFrame, !ImageFrame and !MediaFrame. 
     22 * Frames are divided into several types which extend the functionalities of a Frame. These include !TextFrame, !ImageFrame, !MediaFrame and other not defined yet. 
    2223 
    2324== View == 
    … …  
    2728 * The  [source:trunk/sophie2-platform/modules/org.sophie2.messy/src/main/java/org/sophie2/messy/view/app/AppView.java@203 AppView] has !BookViews 
    2829 * a [source:trunk/sophie2-platform/modules/org.sophie2.messy/src/main/java/org/sophie2/messy/view/book/BookView.java@148 BookView] contains !PageViews 
    29  * a [source:trunk/sophie2-platform/modules/org.sophie2.messy/src/main/java/org/sophie2/messy/view/page/PageView.java@112 PageView] has various [source:trunk/sophie2-platform/modules/org.sophie2.messy/src/main/java/org/sophie2/messy/view/frame/FrameView.java@112 FrameView]s corresponding to the Frames in the model: [source:trunk/sophie2-platform/modules/org.sophie2.messy/src/main/java/org/sophie2/messy/view/frame/TextFrameView.java@112 TextFrameView], [source:trunk/sophie2-platform/modules/org.sophie2.messy/src/main/java/org/sophie2/messy/view/frame/ImageFrameView.java@112 ImageFrameView], [source:trunk/sophie2-platform/modules/org.sophie2.messy/src/main/java/org/sophie2/messy/view/frame/MediaFrameView.java@112 MediaFrameView] 
     30 * a [source:trunk/sophie2-platform/modules/org.sophie2.messy/src/main/java/org/sophie2/messy/view/page/PageView.java@112 PageView] has various [source:trunk/sophie2-platform/modules/org.sophie2.messy/src/main/java/org/sophie2/messy/view/frame/FrameView.java@112 FrameView]s corresponding to the Frames in the model: [source:trunk/sophie2-platform/modules/org.sophie2.messy/src/main/java/org/sophie2/messy/view/frame/TextFrameView.java@112 TextFrameView], [source:trunk/sophie2-platform/modules/org.sophie2.messy/src/main/java/org/sophie2/messy/view/frame/ImageFrameView.java@112 ImageFrameView], [source:trunk/sophie2-platform/modules/org.sophie2.messy/src/main/java/org/sophie2/messy/view/frame/MediaFrameView.java@112 MediaFrameView] up to now. 
    3031Diagram of the View part of the MVC is not needed since every View is a corresponding part of the model. A diagram for the Views will be more or less like the diagram of the model. For example every !FrameView is a visual representation of a Frame. A Book has a corresponding !BookView etc. [[BR]] 
    3132 
    3233== Controller == 
    3334 
    34 The Controller part is represented by the Logics. We have !AppLogic, !BookLogic, !PageLogic and !FrameLogic. At this point we have only a !TextFrameLogic instead of three !FrameLogics(for Text, Image and Media) but three Logics will be provided later. While one can create instances of the model and view (Books, Pages, Frames, !AppViews, !BookViews, !PageViews etc.), the Logics are singletons which means that they have only one instance which is used to control the instances of the model. The only instance of a Logic is the one invoked by the View. This means that if we have multiple !BookViews, we use only one !BookLogic to apply changes to the Books. Logics are entirely and only used to control the model and change it. They '''do not have state'''. By convention, the names of the methods which control the Model should start with "user" and continue with an explanation of what the method changes or does. Example: (method which is part of the !PageLogic and serves to create a Frame on a certain point on the screen)[[BR]] 
     35The Controller part is represented by the Logics. We have !AppLogic, !BookLogic, !PageLogic and !FrameLogic. At this point we have only a !TextFrameLogic instead of several !FrameLogics(for Text, Image, Media and other) but Logics will be provided later. While one can create instances of the model and view (Books, Pages, Frames, !AppViews, !BookViews, !PageViews etc.), the Logics are singletons which means that they have only one instance which is used to control the instances of the model. The only instance of a Logic is the one invoked by the View. This means that if we have multiple !BookViews, we use only one !BookLogic to apply changes to the Books. Logics are entirely and only used to control the model and change it. They '''do not have state'''. By convention, the names of the methods which control the Model should start with "user" and continue with an explanation of what the method changes or does. Example: (method which is part of the !PageLogic and serves to create a Frame on a certain point on the screen)[[BR]] 
    3536{{{ 
    3637public void userDropFrame(PageView pageView, ImmPoint location, final FrameKind kind) { 
    … …  
    4647 
    4748== MVC == 
    48 The Model-Viewer-Controlled in Sophie2.0 can be noticed in four levels (or layers) and these are: App, Book, Page and Frame including the three types of frames. Here is a detailed diagram of the MVC. One can think of it as a grid containing layers of MVCs. [[BR]] 
     49The Model-Viewer-Controlled in Sophie2.0 can be noticed in four levels (or layers) up to now and these are: App, Book, Page and Frame including the several types of frames. Here is a detailed diagram of the MVC. One can think of it as a tree containing layers of MVCs. [[BR]] 
    4950 
    5051[[Image(source:/trunk/sophie2-platform/doc/uml-design-diagrams/MVC-diagram-detailed.png)]]. [[BR]]