Egg - WEB Application Framework.
# The helper script is generated. perl -MEgg::Helper -e 'Egg::Helper->out' > egg_helper.pl # The project is generated. perl egg_helper.pl Project MyApp # Confirming the operation of project. ./MyApp/bin/tirigger.cgi # The project object is acquired. use lib './MyApp/lib'; require MyApp; my $e= MyApp->new;
Egg is WEB application framework.
The composition of the module operates at comparatively simply and high speed.
It is MVC framework of model and view and controller composition.
* It was a plug-in etc. and there were Catalyst and some interchangeability in the version before. Interchangeability was completely lost from the change of the method name in this version. However, there might not be transplant in the difficulty.
The setting of the configuration of Egg is a method of passing HASH to the method of 'egg_startup' directly and the definition. There is a method to read to a semiautomatic target by it and 'Egg::Plugin::ConfigLoader'.
Please refer to the document of Egg::Plugin::ConfigLoader for details.
Route PATH of project.
* It is not route PATH of the template. * There is no default. Please set it.
Title of project.
Default is a class name of the project.
Contents type used by default.
Default is 'text/html'.
Language used by default
There is no default.
Extension of template used by default.
* There is no '.' needing.
Default is 'tt'.
Template name used by default.
Default is 'index'.
Route URI for static contents.
* Please end by '/'.
Default is '/'.
Passing for template.
* The thing set by the ARRAY reference can be done. * There is no default. Please set it.
PATH setting of various folders.
lib
Local PATH where library of project is put.
Default is '< $e.root >/lib'.
static
Local PATH where static contents are put.
Default is '< $e.root >/htdocs'.
etc
For preservation of configuration file etc.
Default is '< $e.root >/etc'.
cache
For preservation of cash data.
Default is '< $e.root >/cache'.
template
The main template depository.
Default is '< $e.root >/root'.
comp
Template depository for include.
Default is '< $e.root >/comp'.
tmp
Temporary work directory PATH.
Default is '< $e.root >/tmp'.
lib_project
Project directory PATH in dir->{lib}.
Egg compulsorily sets it based on the value of dir->{lib}.
root
Copy of root.
The accessor to stash is generated with the set name.
It is a setting of MODEL. As for the content, the setting of each MODEL becomes ARRAY further by ARRAY, too. The setting of the first is treated as MODEL of default.
MODEL => [ [ DBI => { dsn => '.....', user => '...', ... } ], ],
It is a setting of VIEW. As for the content, the setting of each VIEW becomes ARRAY further by ARRAY, too. The setting of the first is treated as VIEW of default.
VIEW => [ [ Mason => { comp_root => [ ... ], data_dir => '...', } ], ],
Please refer to the module document of each object for other settings.
The project name under operation is returned.
Configuration is returned by the HASH reference.
The request object is returned.
Alias: req
The response object is returned.
Alias: res
The dispatch object is returned.
* It is necessary to load the plug-in with the dispatch method. Egg::Plugin::Dispatch::Standard and Egg::Plugin::Dispatch::Fast are prepared by the standard.
The log object is returned.
* When the plugin with the log method is not loaded, Egg::DummyLog is used. - new, notes, debug, error
Necessary for operating the project prior is prepared.
CONFIG_HASH is set to 'config' method. If Egg::Plugin::ConfigLoader is loaded, it is CONFIG_HASH omissible. However, it is a thing that the configuration file is arranged in an appropriate place in this case.
__PACKAGE__->egg_startup;
If specified MODEL is loaded, the package name is returned.
If specified VIEW is loaded, the package name is returned.
The loaded MODEL name list is returned by the ARRAY reference.
The loaded VIEW name list is returned by the ARRAY reference.
The loaded MODEL management data is returned by the HASH reference.
The loaded VIEW management data is returned by the HASH reference.
The use of specified MODEL is enabled.
* MODEL_NAME is not omissible.
* PACKAGE_NAME is an actual package name of object MODEL. Egg::Model::[MODEL_NAME] is used when omitting it.
* If INCLUDE_FLAG is true, require is done at the same time.
$e->regist_model('MyModel', 'MyApp::Model::MyModel', 1);
The use of specified VIEW is enabled.
* VIEW_NAME is not omissible.
* PACKAGE_NAME is an actual package name of object VIEW. Egg::View::[VIEW_NAME] is used when omitting it.
$e->regist_view('MyView', 'MyApp::View::MyView', 1);
The MODEL name of default is returned. * A high setting of the priority level defaults most and it is treated.
When MODEL_NAME is specified, default is temporarily replaced.
The VIEW name of default is returned. * A high setting of the priority level defaults most and it is treated.
When VIEW_NAME is specified, default is temporarily replaced.
The object of specified MODEL is returned.
When MODEL_NAME is omitted, the MODEL object of default is returned.
The object of specified VIEW is returned.
When VIEW_NAME is omitted, the VIEW object of default is returned.
The project is completely operated, and the result code is returned at the end.
* Do not call this method from the code inside of the project.
The value of the common data specified with KEY_NAME is returned.
When KEY_NAME is omitted, the common data is returned by the HASH reference.
The value of the flag specified with FLAG_NAME is returned.
The result of combining the value of $e->config->{dir} specified with CONF_KEY with PATH is returned.
$e->path('static', 'images/any.png'); => /path/to/myapp/htdocs/images/any.png
The URI object generated based on [URI] is returned.
The URI object of the query_form setting when ARGS_HASH is passed is returned.
The value set to $e->dispatch->page_title is returned. $e->config->{title} is returned if there is no setting.
The title can be set by passing TITLE_STRING.
$e->reqonse->status is set when RESPONSE_STATUS is passed and finished is made effective.
RESPONSE_STATUS is 500 or $e->log->error is done any more. At this time, if ERROR_MSG has been passed, it is included in the argument.
0 It is $e->reqonse->status(0) when is passed, and finished is invalidated.
$e->request->snip is returned.
$e->dispatch->action is returned.
The state of the debugging flag is returned.
$Egg::Request::MP_VERSION is returned.
If the debugging flag is effective, MESSAGE is output to STDERR.
Nothing is done usually.
When the project module is read, Egg generates the handler method. And, dynamic contents are output from the handler method via the following method calls and processing is completed.
If $e->debug is effective, it replaces with _ start_engine_debug. After the call of each method, '_start_engine_debug' measures the execution time. This measurement result is reported to STDERR at the end of processing.
_prepare_model
Prior because MODEL is operated is prepared.
_prepare_view
Prior because VIEW is operated is prepared.
_prepare
It is a prior hook for the plugin.
_dispatch_start
It is a prior hook for dispatch.
If it is effective, $e->finished has not already done anything.
_dispatch_action
It is a hook for correspondence action of dispatch.
If an appropriate template has been decided, and $e->response->body is undefined, $e->view->output is done.
_dispatch_finish
It is a hook after the fact for dispatch.
_finalize
It is a hook after the fact for the plugin.
_finalize_output
If it seems to complete the output of contents that are effective $e->finished and have defined $e->response->{header}, nothing is done.
Contents are output, and $e->finished is set.
When some errors occur by '_start_engine', it is called.
The plug-in for which the processing when the error occurs is necessary prepares this method.
This method finally writes the log, and outputs contents for debugging.
They are the last processing most.
$e->response->result is called and the Result code is returned.
Distribution site.
L<http://egg.bomcity.com/>.
sourcefoge project.
L<http://sourceforge.jp/projects/egg/>.
Egg::Base, Egg::Request, Egg::Response, Egg::Model, Egg::View, Egg::Release,
Masatoshi Mizuno <lushe@cpan.org>
Copyright (C) 2007 by Bee Flag, Corp. <http://egg.bomcity.com/>, All Rights Reserved.
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.6 or, at your option, any later version of Perl 5 you may have available.
To install Egg::Release, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Egg::Release
CPAN shell
perl -MCPAN -e shell install Egg::Release
For more information on module installation, please visit the detailed CPAN module installation guide.