Author: clr Date: Mon Apr 18 12:28:19 2005 New Revision: 161789 URL: http://svn.apache.org/viewcvs?view=rev&rev=161789 Log: Added methods to return the sequence value as a long; fixed allocate to take an int parameter
Modified: incubator/jdo/trunk/api20/src/java/javax/jdo/datastore/Sequence.java Modified: incubator/jdo/trunk/api20/src/java/javax/jdo/datastore/Sequence.java URL: http://svn.apache.org/viewcvs/incubator/jdo/trunk/api20/src/java/javax/jdo/datastore/Sequence.java?view=diff&r1=161788&r2=161789 ============================================================================== --- incubator/jdo/trunk/api20/src/java/javax/jdo/datastore/Sequence.java (original) +++ incubator/jdo/trunk/api20/src/java/javax/jdo/datastore/Sequence.java Mon Apr 18 12:28:19 2005 @@ -34,11 +34,14 @@ /** * Returns the fully qualified name of the <code>Sequence</code>. + * @return the name of the sequence */ String getName (); /** - * Returns the next sequence value object. + * Returns the next sequence value as an Object. If the next + * sequence value is not available, throw JDODataStoreException. + * @return the next value */ Object next (); @@ -48,15 +51,32 @@ * short order. There is no externally visible behavior of this * method. It is used to potentially improve the efficiency of * the algorithm of obtaining additional sequence value objects. + * @param additional the number of additional values to allocate */ - void allocate (); + void allocate (int additional); /** * Returns the current sequence value object if it is * available. It is intended to return a sequence value object - * previously used. The implementation might choose to return - * <code>null</code> for all cases or for any cases where a - * sequence value object is not available. + * previously used. If the current sequence value is not available, + * throw JDODataStoreException. + * @return the current value */ Object current (); + + /** + * Returns the next sequence value as a long. If the next + * sequence value is not available or is not numeric, throw + * JDODataStoreException. + * @return the next value + */ + long nextValue(); + + /** + * Returns the current sequence value as a long. If the current + * sequence value is not available or is not numeric, throw + * JDODataStoreException. + * @return the current value + */ + long currentValue(); }