org.apache.tapestry5.ioc.services
Interface PropertyAccess

All Known Implementing Classes:

PropertyAccessImpl

public interface PropertyAccess

A wrapper around the JavaBean Introspector that allows more manageable access to JavaBean properties of objects.

Only provides access to simple properties. Indexed properties are ignored.

Starting in Tapestry 5.2, public fields can now be accessed as if they were properly JavaBean properties. Where there is a name conflict, the true property will be favored over the field access.

Method Summary

void	clearCache() Discards all stored property access information, discarding all created class adapters.
Object	get(Object instance, String propertyName) Reads the value of a property.
ClassPropertyAdapter	getAdapter(Class forClass) Returns the adapter used to access properties within the indicated class.
ClassPropertyAdapter	getAdapter(Object instance) Returns the adapter for a particular object instance.
void	set(Object instance, String propertyName, Object value) Updates the value of a property.

Method Detail

get

Object get(Object instance,
           String propertyName)

Reads the value of a property.

Throws:

UnsupportedOperationException - if the property is write only

IllegalArgumentException - if property does not exist

set

void set(Object instance,
         String propertyName,
         Object value)

Updates the value of a property.

Throws:

UnsupportedOperationException - if the property is read only

IllegalArgumentException - if property does not exist

getAdapter

ClassPropertyAdapter getAdapter(Object instance)

Returns the adapter for a particular object instance. A convienience over invoking getAdapter(Class).

getAdapter

ClassPropertyAdapter getAdapter(Class forClass)

Returns the adapter used to access properties within the indicated class.

clearCache

void clearCache()

Discards all stored property access information, discarding all created class adapters.