NAME
Oak::Application - Class for creating applications in Oak
HIERARCHY
DESCRIPTION
This is the class that will be used to create real applications, the executable file will launch it.
When you create an application object, a reference is created as $::APPLICATION. If you want to undef the Oak::Application object by hand, you need to undef it also.
PROPERTIES
- topLevels
-
A hashref containing information about the toplevel objects: name => [class, xmlfile, persistent]
If the persistent param is defined, the object will not be deleted and recreated every itaration of the application. This is usefull for Oak::DataModule components.
- default
-
The default toplevel, the first toplevel to be shown on application startup
METHODS
- constructor
-
This method was overwrited to create all the objects passed to new. The objects it creates will be available in the namespace ::TL. ie: If one toplevel component have the name pagLogin, its object will be available as $::TL::pagLogin.
- initiateTopLevel(NAME)
-
Creates the Top-Level object NAME defined in the XMLFILE using CLASS.
The exceptions generated by Oak::Component wont be treated here, so, they will propagate to the first level.
Exceptions generated by Oak::Application Oak::Application::Error::DuplicatedTopLevel - toplevel components have the same name
Oak::Application::Error::ClassNotFound - toplevel class not found in lib
- freeAllTopLevel
-
Destroy all the top level components.
- run
-
Abstract in Oak::Application, each type of application will implement how they run.
EXCEPTIONS
The following exceptions are introduced by Oak::Application
- Oak::Application::Error::ClassNotFound
-
This error is throwed when the class passed as parameter to the new failed to be required.
- Oak::Application::Error::DuplicatedTopLevel
-
This error is throwed when two toplevel components have the same name
EXAMPLES
my $app = new Oak::Application
(
"formCreate" => ["MyApp::TopLevel1", "TopLevel1.xml"],
"formList" => ["MyApp::TopLevel2", "TopLevel2.xml"],
"formSearch" => ["MyApp::TopLevel3", "TopLevel3.xml"],
"default" => "formCreate"
);
$app->run; # abstract in Oak::ApplicationCOPYRIGHT
Copyright (c) 2001 Daniel Ruoso <daniel@ruoso.com> All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.