com.solarmetric.rd.kodo.util
Interface ProxyManager

All Known Implementing Classes:

SimpleProxyManager

public interface ProxyManager

Manager for copying and proxying second class objects. JDO considers second class objects to be those that are often used as fields of persistent or transactional instances, and which can themselves be modified without resetting the owning class' field. Because these types can change without an explicit call to the owning PersistenceCapable instance, special care must be taken to ensure that their state is managed correctly. Specifically, they must be copied when saving state for rollback, and they must be proxied for any instance whose state is managed by a StateManager, where proxying involves creating a second class object that automaticlly notifies its owning instance whenever it is modified. Generally, this factory is only used by the JDO implementation; second class object handling is transparent to client code.

Method Summary

java.lang.Object	getArrayCopy(java.lang.Object orig, java.lang.Object owner, java.lang.String field) Return a new array of the same component type as the given array and containing the same elements.
java.util.Collection	getCollectionCopy(java.util.Collection orig, java.lang.Object owner, java.lang.String field) Return a new collection of the same type as the given one with a copy of all contained elements.
com.solarmetric.rd.kodo.util.ProxyCollection	getCollectionProxy(java.lang.Class type, java.lang.Class elementType, java.util.Collection contents, java.util.Comparator compare, java.lang.Object owner, java.lang.String field) Return a proxy for the given collection type.
java.util.Date	getDateCopy(java.util.Date orig, java.lang.Object owner, java.lang.String field) Return a copy of the given date with the same information.
com.solarmetric.rd.kodo.util.ProxyDate	getDateProxy(java.util.Date orig, java.lang.Object owner, java.lang.String field) Return a proxy for the given date instance.
java.util.Map	getMapCopy(java.util.Map orig, java.lang.Object owner, java.lang.String field) Return a new map of the same type as the given one with a copy of all contained key/value pairs.
com.solarmetric.rd.kodo.util.ProxyMap	getMapProxy(java.lang.Class type, java.lang.Class keyType, java.lang.Class valueType, java.util.Map contents, java.util.Comparator compare, java.lang.Object owner, java.lang.String field) Return a proxy for the given map type.

Method Detail

getDateCopy

public java.util.Date getDateCopy(java.util.Date orig,
                                  java.lang.Object owner,
                                  java.lang.String field)

Return a copy of the given date with the same information. If the given date is proxied, the returned instance will be the correct non-proxied type.

getCollectionCopy

public java.util.Collection getCollectionCopy(java.util.Collection orig,
                                              java.lang.Object owner,
                                              java.lang.String field)

Return a new collection of the same type as the given one with a copy of all contained elements. If the given type is a proxy type, the returned instance will be of the correct non-proxied type.

getMapCopy

public java.util.Map getMapCopy(java.util.Map orig,
                                java.lang.Object owner,
                                java.lang.String field)

Return a new map of the same type as the given one with a copy of all contained key/value pairs. If the given type is a proxy type, the returned instance will be of the correct non-proxied type.

getArrayCopy

public java.lang.Object getArrayCopy(java.lang.Object orig,
                                     java.lang.Object owner,
                                     java.lang.String field)

Return a new array of the same component type as the given array and containing the same elements. Works for both primitive and object array types.

getDateProxy

public com.solarmetric.rd.kodo.util.ProxyDate getDateProxy(java.util.Date orig,
                                                           java.lang.Object owner,
                                                           java.lang.String field)

Return a proxy for the given date instance. The owner of the proxy should be set to the given object and field.

getCollectionProxy

public com.solarmetric.rd.kodo.util.ProxyCollection getCollectionProxy(java.lang.Class type,
                                                                       java.lang.Class elementType,
                                                                       java.util.Collection contents,
                                                                       java.util.Comparator compare,
                                                                       java.lang.Object owner,
                                                                       java.lang.String field)

Return a proxy for the given collection type. The returned collection will allow only addition of elements assignable from the given element type, and can be configured to not allow the addition of null elements. The owner of the proxy should be set to the given object and field.

getMapProxy

public com.solarmetric.rd.kodo.util.ProxyMap getMapProxy(java.lang.Class type,
                                                         java.lang.Class keyType,
                                                         java.lang.Class valueType,
                                                         java.util.Map contents,
                                                         java.util.Comparator compare,
                                                         java.lang.Object owner,
                                                         java.lang.String field)

Return a proxy for the given map type. The returned map will allow only addition of keys/values assignable from the given keyType/valueType, and can be configured to not allow the addition of null keys/elements. The owner of the proxy should be set to the given object and field.