t.w.w.c.Controller(resource.Resource) : class documentation

Initialize.

Import the given object or module into this Controllers's controller namespace stack. If the given object or module has a getSubcontroller function or method, it will be called when a node has a controller="foo" attribute. If no getSubcontroller method is defined, a default one will be provided which looks for the literal name in the namespace.

Look for a controller named "controllerName" to handle the node "node". When a node <div controller="foo" /> is present in the template, this method will be called with controllerName set to "foo".

Return None if this Controller doesn't want to provide a Subcontroller for the given name.

Set the callable "factory", which takes a model and should return an InputHandler, to be called by the default implementation of getSubview when the controllerName "name" is present in the template.

This would generally be used like this:

   view.setSubcontrollerFactory("foo", MyFancyInputHandlerClass)

This is equivalent to:

   def wcfactory_foo(self, request, node, m):
       return MyFancyInputHandlerClass(m)

Which will cause an instance of MyFancyInputHandlerClass to be instanciated when template node <div controller="foo" /> is encountered.

Set the view that this controller is related to.

Look for a factory method to create the object to handle the next segment of the URL. If a wchild_* method is found, it will be called to produce the Resource object to handle the next segment of the path. If a wchild_* method is not found, getDynamicChild will be called with the name and request.

Parameters	name	The name of the child being requested. (type: string )
	request	The HTTP request being handled. (type: twisted.web.server.Request )

This method is called when getChild cannot find a matching wchild_* method in the Controller. Override me if you wish to have dynamic handling of child pages. Should return a Resource if appropriate. Return None to indicate no resource found.

Parameters	name	The name of the child being requested. (type: string )
	request	The HTTP request being handled. (type: twisted.web.server.Request )

By default, we return ourself as the index. Override this to provide different behavior for a URL that ends in a slash.

Trigger any inputhandlers that were passed in to this Page, then delegate to the View for traversing the DOM. Finally, call gatheredControllers to deal with any InputHandlers that were constructed from any controller= tags in the DOM. gatheredControllers will render the page to the browser when it is done.

By default, we don't do anything

We are done handling the node to which this controller was attached.

Override this to recieve notification when the view rendering process is complete.