org.apache.tapestry5.services
Interface PropertyConduitSource

All Known Implementing Classes:
PropertyConduitSourceImpl

public interface PropertyConduitSource

A source for PropertyConduits, which can be thought of as a compiled property path expression. PropertyConduits are the basis of the "prop:" binding factory, thus this service defines the expression format used by the PropBindingFactory.


Method Summary
 PropertyConduit create(Class rootType, String expression)
          Returns a property conduit instance for the given expression.
 

Method Detail

create

PropertyConduit create(Class rootType,
                       String expression)
Returns a property conduit instance for the given expression. PropertyConduitSource caches the conduits it returns, so despite the name, this method does not always create a new conduit. The cache is cleared if a change to component classes is observed.

Callers of this method should observe notifications from the InvalidationEventHub for ComponentClasses and discard any aquired conduits; failure to do so will create memory leaks whenever component classes change (the conduits will keep references to the old classes and classloaders).

Parameters:
rootType - the type of the root object to which the expression is applied
expression - expression to be evaluated on instances of the root class
Returns:
RuntimeException if the expression is invalid (poorly formed, references non-existent properties, etc.)


Copyright © 2003-2012 The Apache Software Foundation.