|
Oracle ADF Business Components Domains API Reference 10.1.2 B14023-02 | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object
oracle.jbo.domain.DBSequence
A lightweight, tier-independent wrapper that allows working with attributes that should get their number values from database sequence on insert of a new row.
If you designated an Entity Object attribute to be of type DBSequence, the framework assumes that the attribute value will be refreshed when that Entity Object is posted to the database This implementation assumes that there is an insert-trigger on the table corresponding to the Entity Object, that populates the corresponding column value with a number when the Entity is inserted into the database.
At runtime when a new Entity instance is created, this domain automatically fills in a temporary negative value as a place-holder for the attribute that is marked to be of DBSequence type. When the new Entity is posted, this value is updated from the database.
oracle.jbo.server.EntityImpl
, Serialized FormField Summary | |
static java.lang.String |
AM_IMPL_CLIENT |
Constructor Summary | |
DBSequence() Internal: Applications should not use this constructor. |
|
DBSequence(java.math.BigDecimal num) Create an instance of DBSequence with the given number as it's value. |
|
DBSequence(java.math.BigInteger num) Create an instance of DBSequence with the given number as it's value. |
|
DBSequence(DBSequence seq) Internal: Applications should not invoke this method. |
|
DBSequence(java.lang.Integer num) Create an instance of DBSequence with the given number as it's value. |
|
DBSequence(java.lang.Long num) Create an instance of DBSequence with the given number as it's value. |
|
DBSequence(Number num) Create an instance of DBSequence with the given number as it's value. |
|
DBSequence(java.lang.String numberString) Internal: Applications should not invoke this method. |
|
DBSequence(java.lang.String seqName, ApplicationModule am) Uses the given sequence name to get a Sequence value that is stored for the value of this DBSequence instance |
Method Summary | |
static java.lang.Long |
createInstanceWithAM(ApplicationModule am) Deprecated. since 9.0.3. Use new instance of this class to get the next value. |
boolean |
equals(java.lang.Object other) Test if the specified value is equal to this Sequence object. |
byte[] |
getBytes() Internal: Applications should not invoke this method. Converts this domain value into a bytes, so that the oracle.jbo.Key object can render this domain into a short string form. |
static CustomDatumFactory |
getCustomDatumFactory() Internal: Applications should not invoke this method. |
java.lang.Object |
getData() Internal: Applications should not invoke this method. |
Number |
getSequenceNumber() Returns the value of this Sequence as an oracle.jbo.domain.Number |
long |
getValue() Return this domain's value as long. |
static XMLDomainFactory |
getXMLDomainFactory(java.lang.Class attrClass) Internal: Applications should not use this method. |
int |
hashCode() Computes a hash code for this Sequence object. |
void |
setBytes(byte[] bArr) Passes in the bytes that represent the value of this object. |
void |
setContext(DomainOwnerInterface owner, Transaction trans, java.lang.Object ctx) Internal: Applications should not use this method. |
Datum |
toDatum(oracle.jdbc.driver.OracleConnection conn) Internal: Applications should not invoke this method. |
java.lang.String |
toString() For testing purposes only: Returns a string representation of the generated sequence value. |
Methods inherited from class java.lang.Object |
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
Field Detail |
public static final java.lang.String AM_IMPL_CLIENT
Constructor Detail |
public DBSequence()
public DBSequence(java.math.BigInteger num)
public DBSequence(java.math.BigDecimal num)
public DBSequence(java.lang.Long num)
public DBSequence(java.lang.Integer num)
public DBSequence(Number num)
public DBSequence(DBSequence seq)
public DBSequence(java.lang.String numberString)
Called from AttributeDef for default values only.
public DBSequence(java.lang.String seqName, ApplicationModule am)
This method will increment the specified database sequence when it is invoked.
seqName
- The name of the database sequence that will be used to generate sequence values.am
- The application module instance that will provide the JDBC connection and the marshalling context for the sequence requests.Method Detail |
public static CustomDatumFactory getCustomDatumFactory()
Initializes the Number
Domain. This method is invoked when JBO is initialized.
CustomDatumFactory
for the Number
Domain.public long getValue()
public java.lang.Object getData()
public void setContext(DomainOwnerInterface owner, Transaction trans, java.lang.Object ctx)
public Number getSequenceNumber()
public java.lang.String toString()
public boolean equals(java.lang.Object other)
this
Sequence object.other
- The object to which the Sequence should be compared.this
Sequence.public int hashCode()
this
Sequence object.this
Sequence object.public static java.lang.Long createInstanceWithAM(ApplicationModule am)
am
- The application module instance that will provide the JDBC connection for the sequence requestpublic Datum toDatum(oracle.jdbc.driver.OracleConnection conn) throws java.sql.SQLException
Converts this Number
Domain object back into an SQL NUMBER
object.
Datum
containing NUMBER
object.SQLException
- Never.java.sql.SQLException
public byte[] getBytes()
public void setBytes(byte[] bArr)
public static XMLDomainFactory getXMLDomainFactory(java.lang.Class attrClass)
|
Oracle ADF Business Components Domains API Reference 10.1.2 B14023-02 | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Copyright © 1997, 2005, Oracle. All rights reserved.