Interface PropertyConduitSource

All Known Implementing Classes:

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


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).

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

Copyright © 2003-2012 The Apache Software Foundation.