com.goldencode.p2j.persist

Class RecordIdentifier<T extends java.io.Serializable>

java.lang.Object

com.goldencode.p2j.persist.RecordIdentifier<T>

Type Parameters:

T - table reference type

All Implemented Interfaces:

java.io.Externalizable, java.io.Serializable

Direct Known Subclasses:

TableIdentifier

public class RecordIdentifier<T extends java.io.Serializable>
extends java.lang.Object
implements java.io.Externalizable

A combination of database table reference (either the table name, DMO interface, or DMO implementation class) and record ID (primary key), which uniquely identifies a database record.

Normally, if the initial import is done with FWD, and anyone creating new records always uses the p2j_id_generator_sequence for new keys, the Long recordID component will unique identify records by itself (FWD keys are guaranteed to be unique across all tables of a database). Adding the table component (although redundant in normal execution of FWD) will only make it safer (when records are created in a non-standard way), even if at a bit performance penalty.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
private int	hashCode Cached hash code
private java.lang.Long	recordID Primary key of a database record
private T	table Table identifier

Constructor Summary

Constructors

Constructor and Description
RecordIdentifier() Default constructor
RecordIdentifier(T table, java.lang.Long recordID) Constructor.

Method Summary

Modifier and Type	Method and Description
boolean	equals(java.lang.Object o) Overridden equivalence test which takes all data values of this object into account.
java.lang.Long	getRecordID() Get the record's primary key.
T	getTable() Get the database table name.
int	hashCode() Overridden implementation to maintain consistency with overridden equals(java.lang.Object) method.
void	readExternal(java.io.ObjectInput in) Replacement for the default object reading method.
java.lang.String	toString() Compose a string representation of this object for assistance in debugging and testing.
void	writeExternal(java.io.ObjectOutput out) Replacement for the default object writing method.

Methods inherited from class java.lang.Object

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

Field Detail

table

private T extends java.io.Serializable table

Table identifier

recordID

private java.lang.Long recordID

Primary key of a database record

hashCode

private int hashCode

Cached hash code

Constructor Detail

RecordIdentifier

public RecordIdentifier()

Default constructor

RecordIdentifier

public RecordIdentifier(T table,
                        java.lang.Long recordID)

Constructor.

Parameters:

table - Table identifier.

recordID - Primary key.

Throws:

ErrorConditionException - if any parameter is null.

Method Detail

getTable

public T getTable()

Get the database table name.

Returns:

Table name.

getRecordID

public java.lang.Long getRecordID()

Get the record's primary key.

Returns:

Primary key.

equals

public boolean equals(java.lang.Object o)

Overridden equivalence test which takes all data values of this object into account.

Overrides:

equals in class java.lang.Object

Parameters:

o - Another LockRecord instance to test for equivalence with this instance.

Returns:

true if both instances have the same values for table and record ID, else false.

hashCode

public int hashCode()

Overridden implementation to maintain consistency with overridden equals(java.lang.Object) method.

Overrides:

hashCode in class java.lang.Object

Returns:

Hash code for this instance.

toString

public java.lang.String toString()

Compose a string representation of this object for assistance in debugging and testing.

Overrides:

toString in class java.lang.Object

Returns:

String representation of this object's internal state.

writeExternal

public void writeExternal(java.io.ObjectOutput out)
                   throws java.io.IOException

Replacement for the default object writing method.

Specified by:

writeExternal in interface java.io.Externalizable

Parameters:

out - The output destination to which fields will be saved.

Throws:

java.io.IOException - In case of I/O errors.

readExternal

public void readExternal(java.io.ObjectInput in)
                  throws java.io.IOException,
                         java.lang.ClassNotFoundException

Replacement for the default object reading method.

Specified by:

readExternal in interface java.io.Externalizable

Parameters:

in - Input source from which fields will be restored.

Throws:

java.io.IOException - In case of I/O errors.

java.lang.ClassNotFoundException - If payload can't be instantiated.