t.w.w.m.Model : class documentation

Invalidate the cache for this object, so the next time getData is called, it's getter method is called again.

Hook for subclasses to initialize themselves without having to mess with the __init__ chain.

Add a view for the model to keep track of.

Remove a view that the model no longer should keep track of.

Notify all views that something was changed on me. Passing a dictionary of {'attribute': 'new value'} in changed will pass this dictionary to the view for increased performance. If you don't want to do this, don't, and just use the traditional MVC paradigm of querying the model for things you're interested in.

Look up a full submodel name. I will split on `/' and call getSubmodel on each element in the 'path'.

Override me if you don't want 'traversing'-style lookup, but would rather like to look up a model based on the entire model name specified.

If you override me to return Deferreds, make sure I look up values in a cache (created by setSubmodel) before doing a regular Deferred lookup.

XXX: Move bits of this docstring to interfaces.py

Check if a submodel name is allowed. Subclass me to implement a name security policy.

Get the submodel `name' of this model. If I ever return a Deferred, then I ought to check for cached values (created by setSubmodel) before doing a regular Deferred lookup.

Set a submodel on this model. If getSubmodel or lookupSubmodel ever return a Deferred, I ought to set this in a place that lookupSubmodel/getSubmodel know about, so they can use it as a cache.

Return the raw data contained by this Model object, if it is a wrapper. If not, return self.

Set the raw data referenced by this Model object, if it is a wrapper. This is done by telling our Parent model to setSubmodel the new data. If this object is not a wrapper, keep the data around and return it for subsequent getData calls.