org.objectweb.medor.tuple.lib
Class EmptyTupleCollection

java.lang.Object
  |
  +--org.objectweb.medor.tuple.lib.EmptyTupleCollection
All Implemented Interfaces:
TupleCollection

public class EmptyTupleCollection
extends java.lang.Object
implements TupleCollection

This class represents an empty TupleCollection.

Author:
S.Chassande-Barrioz

Constructor Summary
EmptyTupleCollection(TupleStructure _ts)
           
 
Method Summary
 void first()
          Moves the cursor to the first Tuple, row number 1.
 TupleStructure getMetaData()
          Retrieves the number,types and stors properties of the data sources of this TupleCollection Object.
 java.lang.Object getObject(int column)
          Returns the value of the designated column in the current row of this TupleCollection object as an Object in the Java programming language.
 int getRow()
          Retrieves the current row Number.
 Tuple getTuple()
          Returns the Tuple value of the current row of this TupleCollection object.
 Tuple getTuple(int row)
          Returns the Tuple value of the designeted row of this TupleCollection object.
 boolean isEmpty()
          Tell whether the current TupleCollection Object is empty or no.
 boolean isLast()
          Indicates whether the cursor is on the last row of this TupleCollection object.
 boolean next()
          Moves the cursor down one row from its current position to the next tuple of this TupleCollection object.
 boolean row(int row)
          Moves the cursor to the given row number in this TupleCollection object.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

EmptyTupleCollection

public EmptyTupleCollection(TupleStructure _ts)
Method Detail

getMetaData

public TupleStructure getMetaData()
                           throws MedorException
Description copied from interface: TupleCollection
Retrieves the number,types and stors properties of the data sources of this TupleCollection Object.

Specified by:
getMetaData in interface TupleCollection
Returns:
a TupleCollectionMetaData Object defining teh TupleCollection.
Throws:
MedorException - if a data source access error occurs

isLast

public boolean isLast()
               throws MedorException
Description copied from interface: TupleCollection
Indicates whether the cursor is on the last row of this TupleCollection object.

Specified by:
isLast in interface TupleCollection
Returns:
true if the current Tuple is the last one or if the TupleCollection is Empty.
Throws:
MedorException - if data source access error

next

public boolean next()
             throws MedorException
Description copied from interface: TupleCollection
Moves the cursor down one row from its current position to the next tuple of this TupleCollection object.

Specified by:
next in interface TupleCollection
Returns:
true if move is impossible and false if move is not performed.
Throws:
MedorException - if data source access error

first

public void first()
           throws MedorException
Description copied from interface: TupleCollection
Moves the cursor to the first Tuple, row number 1.

Specified by:
first in interface TupleCollection
Throws:
MedorException - if data source access error

getRow

public int getRow()
           throws MedorException
Description copied from interface: TupleCollection
Retrieves the current row Number.

Specified by:
getRow in interface TupleCollection
Returns:
-1 if the iterator is out of bounds of the TupleCollection or if it is empty.
Throws:
MedorException - if data source access error.

getObject

public java.lang.Object getObject(int column)
                           throws MedorException
Description copied from interface: TupleCollection
Returns the value of the designated column in the current row of this TupleCollection object as an Object in the Java programming language.

Specified by:
getObject in interface TupleCollection
Returns:
the value of the designeted attribute like an Object.
Throws:
MedorException - if data source access error or invald attribute index.

getTuple

public Tuple getTuple()
               throws MedorException
Description copied from interface: TupleCollection
Returns the Tuple value of the current row of this TupleCollection object.

Specified by:
getTuple in interface TupleCollection
Returns:
the value of the current Tuple.
Throws:
MedorException - if data source access error.

getTuple

public Tuple getTuple(int row)
               throws MedorException
Description copied from interface: TupleCollection
Returns the Tuple value of the designeted row of this TupleCollection object.

Specified by:
getTuple in interface TupleCollection
Parameters:
row - :int
Returns:
the a Tuple Number row.
Throws:
MedorException - if data source access error.

row

public boolean row(int row)
            throws MedorException
Description copied from interface: TupleCollection
Moves the cursor to the given row number in this TupleCollection object. The first row is row 1, the second is row 2, and so on.

Specified by:
row in interface TupleCollection
Returns:
true if move is possible
Throws:
MedorException - if row number is invelid or data source access error

isEmpty

public boolean isEmpty()
                throws MedorException
Description copied from interface: TupleCollection
Tell whether the current TupleCollection Object is empty or no.

Specified by:
isEmpty in interface TupleCollection
Returns:
true if the TupleCollection is empty.
Throws:
MedorException - if data source access error.