net.esper.event.property
Class NestedPropertyGetter

java.lang.Object
  extended by net.esper.event.property.NestedPropertyGetter
All Implemented Interfaces:
EventPropertyGetter

public class NestedPropertyGetter
extends Object
implements EventPropertyGetter

Getter for one or more levels deep nested properties.


Constructor Summary
NestedPropertyGetter(List<EventPropertyGetter> getterChain, BeanEventTypeFactory beanEventTypeFactory)
          Ctor.
 
Method Summary
 Object get(EventBean eventBean)
          Return the value for the property in the event object specified when the instance was obtained.
 boolean isExistsProperty(EventBean eventBean)
          Returns true if the property exists, or false if the type does not have such a property.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

NestedPropertyGetter

public NestedPropertyGetter(List<EventPropertyGetter> getterChain,
                            BeanEventTypeFactory beanEventTypeFactory)
Ctor.

Parameters:
getterChain - is the chain of getters to retrieve each nested property
beanEventTypeFactory - is the chache and factory for event bean types and event wrappers
Method Detail

get

public Object get(EventBean eventBean)
           throws PropertyAccessException
Description copied from interface: EventPropertyGetter
Return the value for the property in the event object specified when the instance was obtained. Useful for fast access to event properties. Throws a PropertyAccessException if the getter instance doesn't match the EventType it was obtained from, and to indicate other property access problems.

Specified by:
get in interface EventPropertyGetter
Parameters:
eventBean - is the event to get the value of a property from
Returns:
value of property in event
Throws:
PropertyAccessException - to indicate that property access failed

isExistsProperty

public boolean isExistsProperty(EventBean eventBean)
Description copied from interface: EventPropertyGetter
Returns true if the property exists, or false if the type does not have such a property.

Useful for dynamic properties of the syntax "property?" and the dynamic nested/indexed/mapped versions. Dynamic nested properties follow the syntax "property?.nested" which is equivalent to "property?.nested?". If any of the properties in the path of a dynamic nested property return null, the dynamic nested property does not exists and the method returns false.

For non-dynamic properties, this method always returns true since a getter would not be available unless

Specified by:
isExistsProperty in interface EventPropertyGetter
Parameters:
eventBean - is the event to check if the dynamic property exists
Returns:
indictor whether the property exists, always true for non-dynamic (default) properties

© 2007 EsperTech Inc.
All rights reserved.
Visit us at espertech.com