net.ontopia.persistence.proxy
Class SQLOneToOne

java.lang.Object
  net.ontopia.persistence.proxy.SQLOneToOne

All Implemented Interfaces:

FieldAccessIF

Direct Known Subclasses:

SQLBatchOneToOne

public class SQLOneToOne
extends java.lang.Object
implements FieldAccessIF

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

Field Summary

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 FieldInfoIF[]	select_fields_ref
protected int	select_value_index
protected java.lang.String	sql_load
protected java.lang.String	sql_load_multiple
protected java.lang.String	sql_set
protected FieldInfoIF	value_field

Constructor Summary

SQLOneToOne(RDBMSAccess access, FieldInfoIF field)

Method Summary

void	clear(IdentityIF identity) INTERNAL: Clears the field value for the given object identity.
protected void	executeUpdate(java.sql.PreparedStatement stm, java.lang.String sql)
java.lang.Object	load(AccessRegistrarIF registrar, IdentityIF identity) INTERNAL: Loads the field value for the given object identity.
java.lang.Object	loadMultiple(AccessRegistrarIF registrar, java.util.Collection identities, IdentityIF current) INTERNAL: Loads the field value for all the given object identities.
protected java.sql.PreparedStatement	set_getStatement()
void	storeDirty(ObjectAccessIF oaccess, java.lang.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

sql_load

protected java.lang.String sql_load

sql_load_multiple

protected java.lang.String sql_load_multiple

sql_set

protected java.lang.String sql_set

identity_field

protected FieldInfoIF identity_field

select_fields

protected FieldInfoIF[] select_fields

select_fields_ref

protected FieldInfoIF[] select_fields_ref

value_field

protected FieldInfoIF value_field

field

protected FieldInfoIF field

select_value_index

protected int select_value_index

close_stm

protected boolean close_stm

batchSize

protected int batchSize

Constructor Detail

SQLOneToOne

public SQLOneToOne(RDBMSAccess access,
                   FieldInfoIF field)

Method Detail

load

public java.lang.Object load(AccessRegistrarIF registrar,
                             IdentityIF identity)
                      throws java.lang.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.

java.lang.Exception

loadMultiple

public java.lang.Object loadMultiple(AccessRegistrarIF registrar,
                                     java.util.Collection identities,
                                     IdentityIF current)
                              throws java.lang.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.

java.lang.Exception

clear

public void clear(IdentityIF identity)
           throws java.lang.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:

java.lang.Exception

storeDirty

public void storeDirty(ObjectAccessIF oaccess,
                       java.lang.Object object)
                throws java.lang.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:

java.lang.Exception

set_getStatement

protected java.sql.PreparedStatement set_getStatement()
                                               throws java.sql.SQLException

Throws:

java.sql.SQLException

executeUpdate

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

Throws:

java.lang.Exception