Jifty::Plugin::ClassLoader(3)

NAME
Jifty::Plugin::ClassLoader - Automatically generates application classes

DESCRIPTION
"Jifty::Plugin::ClassLoader" loads additional model and action classes on behalf of the application out of the configured plugin classes. Unlike, "Jifty::ClassLoader", this class will only autogenerate classes if the plugin provides them. The plugin classes are checked before the base Jifty classes, so that a plugin can override the Jifty class, just as any existing application classes will be loaded first.

  new
Returns a new ClassLoader object. Doing this installs a hook into @INC that allows Jifty::Plugin::ClassLoader to dynamically create needed classes if they do not exist already. This works because if use/require encounters a blessed reference in @INC, it will invoke the INC method with the name of the module it is searching for on the reference.

Takes two mandatory arguments, "base", which should be the application's base path; and "plugin" which is the plugin classname.

  INC
The hook that is called when a module has been "require"'d that cannot be found on disk. The following stub classes are auto-generated:

Application
    An empty application base class is created that doesn't provide any methods or inherit from anything.

Application::Record
    An empty class that descends from Jifty::Record is created.

Application::Collection
    An empty class that descends from Jifty::Collection is created.

Application::Notification
    An empty class that descends from Jifty::Notification.

Application::Dispatcher
    An empty class that descends from Jifty::Dispatcher.

Application::Bootstrap
    An empty class that descends from Jifty::Bootstrap.

Application::Upgrade
    An empty class that descends from Jifty::Upgrade.

Application::CurrentUser
    An empty class that descends from Jifty::CurrentUser.

Application::Model::AnythingCollection
    If "Application::Model::Something" is a valid model class, then it creates a subclass of Jifty::Collection whose "record_class" is "Application::Model::Something".

Application::Action::(Create or Update or Delete)Anything
    If "Application::Model::Something" is a valid model class, then it creates a subclass of Jifty::Action::Record::Create, Jifty::Action::Record::Update, or Jifty::Action::Record::Delete whose record_class is "Application::Model::Something".

  require
Loads all of the application's Actions and Models. It additionally "require"'s all Collections and Create/Update actions for each Model base class -- which will auto-create them using the above code if they do not exist on disk.

  DESTROY
When the ClassLoader gets garbage-collected, its entry in @INC needs to be removed.