com.triactive.jdo.store.mapping
Class ComplexMapping

java.lang.Object
  com.triactive.jdo.store.mapping.Mapping
      com.triactive.jdo.store.mapping.ComplexMapping

Direct Known Subclasses:

MapMapping, SetMapping

public abstract class ComplexMapping

extends Mapping

A database mapping that incorporates custom logic for object storage and retrieval.

Author:

Mike Martin

Field Summary

Fields inherited from class com.triactive.jdo.store.mapping.Mapping

dba, fmd, type

Constructor Summary

protected	ComplexMapping(DatabaseAdapter dba, java.lang.Class type) Constructs a new complex mapping for a given Java type.
protected	ComplexMapping(DatabaseAdapter dba, FieldMetaData fmd) Constructs a new complex mapping for a given persistent field.

Method Summary

abstract void	deleteObject(StateManager sm) Deletes an object from the database.
abstract void	deleteObjects(java.util.Collection sms) Deletes a collection of objects from the database.
abstract java.lang.Object	fetchObject(StateManager sm) Fetchs an object from the database.
abstract void	insertObject(StateManager sm, java.lang.Object value) Inserts an object in the database.
abstract void	updateObject(StateManager sm, java.lang.Object value) Updates an object in the database.

Methods inherited from class com.triactive.jdo.store.mapping.Mapping

accessAsFieldIn, defineConstraints, defineStorage, equals, getDefaultMappingsByType, getFieldMetaData, getType, hashCode, newSqlLiteral

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ComplexMapping

protected ComplexMapping(DatabaseAdapter dba,
                         java.lang.Class type)

Constructs a new complex mapping for a given Java type.

Parameters:

dba - the database adapter

type - the Java class that this mapping maps to the database

ComplexMapping

protected ComplexMapping(DatabaseAdapter dba,
                         FieldMetaData fmd)

Constructs a new complex mapping for a given persistent field.

Parameters:

dba - the database adapter

fmd - the field metadata for the field that this mapping maps to the database

Method Detail

insertObject

public abstract void insertObject(StateManager sm,
                                  java.lang.Object value)

Inserts an object in the database.

Parameters:

sm - The state manager of the instance owning the Java object being inserted.

value - The object to insert.

fetchObject

public abstract java.lang.Object fetchObject(StateManager sm)

Fetchs an object from the database.

Parameters:

sm - The state manager of the instance owning the Java object being fetched.

updateObject

public abstract void updateObject(StateManager sm,
                                  java.lang.Object value)

Updates an object in the database.

Parameters:

sm - The state manager of the instance owning the Java object being updated.

value - The object to update.

deleteObject

public abstract void deleteObject(StateManager sm)

Deletes an object from the database.

Parameters:

sm - The state manager of the instance owning the Java object being deleted.

deleteObjects

public abstract void deleteObjects(java.util.Collection sms)

Deletes a collection of objects from the database. The specified collection cannot be empty.

Parameters:

sms - The state managers of the instances owning the Java objects being deleted. Must be non-empty.

Throws:

java.util.NoSuchElementException - if the specified collection is empty