NAME

Class::MVC - model-view-controller paradigma

SYNOPSIS

        use Class::Maker 'class';

        use Class::MVC;
        
        class 'Widget',
        {
                isa => [qw( Class::MVC )]
        };

        class 'Widget::ViewModel',
        {                       
                isa => [qw( Device::Output::Channel )],
                
                public =>
                {
                        string => [qw( info )],
                },
        };

        class 'Widget::Model',
        {
                isa => [qw( Class::MVC::Model Shell::Widget::ViewModel)],
        };

        class 'Widget::View',
        {
                isa => [qw( Class::MVC::CompositeView )],
                
                public =>
                {
                        ref => [qw( device )],
                },
        };

        class 'Widget::Controller',
        {
                isa => [qw( Class::MVC::Controller )],          
                
                public => 
                {
                        ref => [qw( sensor )],
                },
                
                default =>
                {
                        sensor => Device::Input->new(),
                },
        };      
  

DESCRIPTION

The Model-View-Controller (MVC) is a general paradigma mostly used for GUI-development. It is very well known and tons of publications are available through your favorite search engine (Or jump to "REFERENCES"). It is also an introductional example from the famous "Design Patterns" book.

                            +------------+
                            |   Model    |
                            +------------+
                           /\ .          /\
                           / .            \
                          / .              \
                         / .                \
                        / \/                 \
                  +------------+ <------ +------------+
 Graphical  <==== |    View    |         | Controller |  <==== User Input
  Output          +------------+ ......> +------------+

Class::MVC::Model

This class is derived from Class::Observable (Class::Observable). Class::MVC::View's observe it to make appropriate changes to the presentation (aka View) if an update of the "Class::MVC::Model" happens.

[Note] Some publications prefer to separate a Data Model and a View Model. My personal preference tend to have a simple ViewModel class and let a DataModel class derive from Class::MVC::Model and our ViewModel class.

Class::MVC::View

model

Reference to a Class::MVC::Model object.

controller

Reference to a Class::MVC::Controller object.

Class::MVC::Model-notify_observers( 'update' )> will call a _on_update method of the observing View's.

[Note] Class::MVC::View is derived from Class::Listener to dispatch the observer notify to the _on_update method.

Class::MVC::CompositeView

This is the base class for nested views. A CompsiteView is a derived View. Its update() method takes the job to inform the super_view of sub_view changes changes.

See "REFERENCES".

super_view

Points to the view that contains it and another subviews.

sub_views (unimplemented)

An array pointing to all subviews.

Class::MVC::Controller

model

Reference to a Class::MVC::Model.

view

Reference to a Class::MVC::View.

update_model()

Sends a Class::Listener update ( $this, @_ ) signal to the model.

change_view()

Sends a Class::Listener change ( $this, @_ ) signal to the view.

Calls Class::MVC::View methods to do controller specific view changes (for example beep() or flicker() when wrong input is done).

SIGNALS

Signals are transported via the Class::Listener::signal method ("SEE ALSO").

EXPORT

None by default.

AUTHOR

Murat Uenalan, <muenalan@cpan.org>

SEE ALSO

Class::Maker, Class::Listener and Class::Observable.

REFERENCES

[1]

http://ootips.org/mvc-pattern.html

[2]

http://www.enode.com/x/markup/tutorial/mvc.html

[3]

http://st-www.cs.uiuc.edu/users/smarch/st-docs/mvc.html

cpanm Class::MVC

perl -MCPAN -e shell
install Class::MVC