Package net.ontopia.persistence.proxy

Class SQLOneToManyReference

java.lang.Object

net.ontopia.persistence.proxy.SQLOneToManyReference

All Implemented Interfaces:

FieldAccessIF

Direct Known Subclasses:

SQLBatchOneToManyReference

public class SQLOneToManyReference
extends Object
implements FieldAccessIF

INTERNAL: Class that performs the task of accessing and manipulating 1:M reference fields in the database.

Field Summary

Fields

Modifier and Type	Field	Description
protected RDBMSAccess	access
protected int	batchSize
protected boolean	close_stm
protected boolean	debug
protected FieldInfoIF	field
protected FieldInfoIF	identity_field
protected FieldInfoIF[]	select_fields
protected String	sql_add
protected String	sql_clear
protected String	sql_load
protected String	sql_load_multiple
protected String	sql_remove
protected FieldInfoIF	value_field

Constructor Summary

Constructors

Constructor	Description
SQLOneToManyReference(RDBMSAccess access, FieldInfoIF field)

Method Summary

Modifier and Type	Method	Description
protected void	add(IdentityIF identity, Collection<?> values)
protected void	add_bindParameters(PreparedStatement stm, IdentityIF identity, Object value)
protected PreparedStatement	add_getStatement()
void	clear(IdentityIF identity)	INTERNAL: Clears the field value for the given object identity.
protected void	clear_bindParameters(PreparedStatement stm, IdentityIF identity)
protected PreparedStatement	clear_getStatement()
protected void	executeUpdate(PreparedStatement stm, String sql)
Object	load(AccessRegistrarIF registrar, IdentityIF identity)	INTERNAL: Loads the field value for the given object identity.
Object	loadMultiple(AccessRegistrarIF registrar, Collection<IdentityIF> identities, IdentityIF current)	INTERNAL: Loads the field value for all the given object identities.
protected void	remove(IdentityIF identity, Collection<?> values)
protected void	remove_bindParameters(PreparedStatement stm, IdentityIF identity, Object value)
protected PreparedStatement	remove_getStatement()
void	storeDirty(ObjectAccessIF oaccess, Object object)	INTERNAL: The object field is dirty and a call to this method should cause the field value to be updated.

Methods inherited from class java.lang.Object

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

Field Detail

debug

protected boolean debug

access

protected RDBMSAccess access

field

protected FieldInfoIF field

sql_load

protected String sql_load

sql_load_multiple

protected String sql_load_multiple

sql_add

protected String sql_add

sql_remove

protected String sql_remove

sql_clear

protected String sql_clear

select_fields

protected FieldInfoIF[] select_fields

identity_field

protected FieldInfoIF identity_field

value_field

protected FieldInfoIF value_field

close_stm

protected boolean close_stm

batchSize

protected int batchSize

Constructor Detail

SQLOneToManyReference

public SQLOneToManyReference(RDBMSAccess access,
                             FieldInfoIF field)

Method Detail

load

public Object load(AccessRegistrarIF registrar,
                   IdentityIF identity)
            throws Exception

Description copied from interface: FieldAccessIF

INTERNAL: Loads the field value for the given object identity. The specified access registrar will be notified about the value(s) read from the database.

Specified by:

load in interface FieldAccessIF

Returns:

The value loaded for the specific field. Note that if the field is a reference field the identity will be returned, not the actual object. This is because the storage system does not deal with persistent object instances directly.

Throws:

IdentityNotFoundException - if the identity was not found.

Exception

loadMultiple

public Object loadMultiple(AccessRegistrarIF registrar,
                           Collection<IdentityIF> identities,
                           IdentityIF current)
                    throws Exception

Description copied from interface: FieldAccessIF

INTERNAL: Loads the field value for all the given object identities. The specified access registrar will be notified about the value(s) read from the database.

Specified by:

loadMultiple in interface FieldAccessIF

Returns:

The value loaded for the specific field for the current identity. Note that if the field is a reference field the identity will be returned, not the actual object. This is because the storage system does not deal with persistent object instances directly.

Throws:

IdentityNotFoundException - if the identity was not found.

Exception

add

protected void add(IdentityIF identity,
                   Collection<?> values)
            throws Exception

Throws:

Exception

add_getStatement

protected PreparedStatement add_getStatement()
                                      throws SQLException

Throws:

SQLException

add_bindParameters

protected void add_bindParameters(PreparedStatement stm,
                                  IdentityIF identity,
                                  Object value)
                           throws Exception

Throws:

Exception

remove

protected void remove(IdentityIF identity,
                      Collection<?> values)
               throws Exception

Throws:

Exception

remove_getStatement

protected PreparedStatement remove_getStatement()
                                         throws SQLException

Throws:

SQLException

remove_bindParameters

protected void remove_bindParameters(PreparedStatement stm,
                                     IdentityIF identity,
                                     Object value)
                              throws Exception

Throws:

Exception

clear

public void clear(IdentityIF identity)
           throws Exception

Description copied from interface: FieldAccessIF

INTERNAL: Clears the field value for the given object identity. This method is only applicable for 1:M and M:M fields.

Specified by:

clear in interface FieldAccessIF

Throws:

Exception

clear_getStatement

protected PreparedStatement clear_getStatement()
                                        throws SQLException

Throws:

SQLException

clear_bindParameters

protected void clear_bindParameters(PreparedStatement stm,
                                    IdentityIF identity)
                             throws Exception

Throws:

Exception

storeDirty

public void storeDirty(ObjectAccessIF oaccess,
                       Object object)
                throws Exception

Description copied from interface: FieldAccessIF

INTERNAL: The object field is dirty and a call to this method should cause the field value to be updated. Note that the field access may also store other field values if it decides to do so. After the field value(s) has been updated the dirty flag(s) should be set to false.

Specified by:

storeDirty in interface FieldAccessIF

Throws:

Exception

executeUpdate

protected void executeUpdate(PreparedStatement stm,
                             String sql)
                      throws Exception

Throws:

Exception