org.hypergraphdb.type
Class JavaBeanBinding

java.lang.Object
  extended by org.hypergraphdb.type.JavaAbstractBinding
      extended by org.hypergraphdb.type.JavaBeanBinding
All Implemented Interfaces:
HGGraphHolder, HGAtomType, HGCompositeType

public class JavaBeanBinding
extends JavaAbstractBinding

Acts as a HGAtomType for Java beans. Uses underlying RecordType instance to manage the layout in the store, but operates on actual bean instances instead of Records.

Author:
Borislav Iordanov

Constructor Summary
JavaBeanBinding(HGHandle typeHandle, RecordType hgType, java.lang.Class<?> clazz)
           
 
Method Summary
 java.lang.Object make(HGPersistentHandle handle, LazyRef<HGHandle[]> targetSet, IncidenceSetRef incidenceSet)
          Construct a new run-time instance of a hypergraph atom.
 void release(HGPersistentHandle handle)
          Release a hypergraph value instance from the persistent store.
 HGPersistentHandle store(java.lang.Object instance)
          Store a run-time instance of a hypergraph atom into the hypergraph HGStore as a new atom.
 
Methods inherited from class org.hypergraphdb.type.JavaAbstractBinding
equals, getDimensionNames, getHGType, getJavaClass, getProjection, getTypeHandle, setHyperGraph, subsumes, toString
 
Methods inherited from class java.lang.Object
getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

JavaBeanBinding

public JavaBeanBinding(HGHandle typeHandle,
                       RecordType hgType,
                       java.lang.Class<?> clazz)
Method Detail

make

public java.lang.Object make(HGPersistentHandle handle,
                             LazyRef<HGHandle[]> targetSet,
                             IncidenceSetRef incidenceSet)
Description copied from interface: HGAtomType

Construct a new run-time instance of a hypergraph atom. A plain node must be constructed whenever the targetSet parameter is null or of length 0. Otherwise, a HGLink instance must be constructed.

It is not required that all atom types be able to construct both plain (node) atoms and HGLinks. It is up to an HGAtomType implementation to support either or both. When a HGLink counterpart is not available for a particular run-time type, an implementation may choose to create an instance of the default link value holder implementation HGValuedLink, provided by HyperGraph.

Specified by:
make in interface HGAtomType
Overrides:
make in class JavaAbstractBinding
Parameters:
handle - The HGPersistentHandle of the atom value.
targetSet - When the atom is a link, this parameter holds the target set of the link. When the atom is a node, the parameter is an array of 0 length.
incidenceSet - TODO
Returns:
The run-time atom instance. The return value should never be null. In case the handle points to an invalid instance (inexisting or with a erronous layout), the method should throw a HGException.

store

public HGPersistentHandle store(java.lang.Object instance)
Description copied from interface: HGAtomType

Store a run-time instance of a hypergraph atom into the hypergraph HGStore as a new atom.

Specified by:
store in interface HGAtomType
Overrides:
store in class JavaAbstractBinding
Parameters:
instance - The atom instance.
Returns:
The persistent handle of the stored value.

release

public void release(HGPersistentHandle handle)
Description copied from interface: HGAtomType

Release a hypergraph value instance from the persistent store.

This method should be called when a HGPersistentHandle returned from the store is no longer in use.

Specified by:
release in interface HGAtomType
Overrides:
release in class JavaAbstractBinding
Parameters:
handle - The persistent handle of the value to release.