Package org.ofbiz.core.entity

Class EntityListIterator

java.lang.Object

org.ofbiz.core.entity.EntityListIterator

All Implemented Interfaces:

Iterator<GenericValue>, ListIterator<GenericValue>

public class EntityListIterator
extends Object
implements ListIterator<GenericValue>

Generic Entity Cursor List Iterator for Handling Cursored DB Results

Note that you should *not* rely on this for streaming large datasets, as the backing ResultSet will pull the entire dataset into memory anyway. For more information, see PSA: OfBizListIterator is not good enough Created July 12, 2002

Author:

David E. Jones

Field Summary

Fields

Modifier and Type	Field	Description
protected boolean	closed
protected GenericDelegator	delegator
protected boolean	haveMadeValue
protected ModelEntity	modelEntity
protected ModelFieldTypeReader	modelFieldTypeReader
protected ResultSet	resultSet
protected List<ModelField>	selectFields
protected SQLProcessor	sqlp

Constructor Summary

Constructors

Constructor	Description
EntityListIterator(SQLProcessor sqlp, ModelEntity modelEntity, List<ModelField> selectFields, ModelFieldTypeReader modelFieldTypeReader)

Method Summary

Modifier and Type	Method	Description
boolean	absolute(int rowNum)	performs the same function as the ResultSet.absolute method; if rowNum is positive, goes to that position relative to the beginning of the list; if rowNum is negative, goes to that position relative to the end of the list; a rowNum of 1 is the same as first(); a rowNum of -1 is the same as last()
void	add(GenericValue obj)
void	afterLast()	Sets the cursor position to just after the last result so that previous() will return the last result
void	beforeFirst()	Sets the cursor position to just before the first result so that next() will return the first result
void	close()
GenericValue	currentGenericValue()	NOTE: Calling this method does return the current value, but so does calling next() or previous(), so calling one of those AND this method will cause the value to be created twice
int	currentIndex()
boolean	first()	Sets the cursor position to last result; if result set is empty returns false
List<GenericValue>	getCompleteList()
List<GenericValue>	getPartialList(int start, int number)	Gets a partial list of results starting at start and containing at most number elements.
boolean	hasNext()	PLEASE NOTE: Because of the nature of the JDBC ResultSet interface this method can be very inefficient; it is much better to just use next() until it returns null
boolean	hasPrevious()	PLEASE NOTE: Because of the nature of the JDBC ResultSet interface this method can be very inefficient; it is much better to just use previous() until it returns null
boolean	isCaseSensitive(String entityFieldName)	Detect whether or not the column data is case sensitive.
boolean	last()	Sets the cursor position to last result; if result set is empty returns false
GenericValue	next()	Moves the cursor to the next position and returns the GenericValue object for that position; if there is no next, returns null
int	nextIndex()	Returns the index of the next result, but does not guarantee that there will be a next result
GenericValue	previous()	Moves the cursor to the previous position and returns the GenericValue object for that position; if there is no previous, returns null
int	previousIndex()	Returns the index of the previous result, but does not guarantee that there will be a previous result
void	remove()
void	set(GenericValue obj)
void	setDelegator(GenericDelegator delegator)
void	setFetchSize(int rows)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface java.util.Iterator

forEachRemaining

Field Details

sqlp

protected SQLProcessor sqlp

resultSet

protected ResultSet resultSet

modelEntity

protected ModelEntity modelEntity

selectFields

protected List<ModelField> selectFields

modelFieldTypeReader

protected ModelFieldTypeReader modelFieldTypeReader

closed

protected boolean closed

haveMadeValue

protected boolean haveMadeValue

delegator

protected GenericDelegator delegator

Constructor Details

EntityListIterator

public EntityListIterator(SQLProcessor sqlp,
 ModelEntity modelEntity,
 List<ModelField> selectFields,
 ModelFieldTypeReader modelFieldTypeReader)

Method Details

setDelegator

public void setDelegator(GenericDelegator delegator)

isCaseSensitive

public boolean isCaseSensitive(String entityFieldName)
                        throws GenericEntityException

Detect whether or not the column data is case sensitive.

Parameters:

entityFieldName - the field to check.

Returns:

true if the field is case sensitive or false otherwise.

Throws:

GenericEntityException - if the information could not be found.

afterLast

public void afterLast()
               throws GenericEntityException

Sets the cursor position to just after the last result so that previous() will return the last result

Throws:

GenericEntityException

beforeFirst

public void beforeFirst()
                 throws GenericEntityException

Sets the cursor position to just before the first result so that next() will return the first result

Throws:

GenericEntityException

last

public boolean last()
             throws GenericEntityException

Sets the cursor position to last result; if result set is empty returns false

Throws:

GenericEntityException

first

public boolean first()
              throws GenericEntityException

Sets the cursor position to last result; if result set is empty returns false

Throws:

GenericEntityException

close

public void close()
           throws GenericEntityException

Throws:

GenericEntityException

currentGenericValue

public GenericValue currentGenericValue()
                                 throws GenericEntityException

NOTE: Calling this method does return the current value, but so does calling next() or previous(), so calling one of those AND this method will cause the value to be created twice

Throws:

GenericEntityException

currentIndex

public int currentIndex()
                 throws GenericEntityException

Throws:

GenericEntityException

absolute

public boolean absolute(int rowNum)
                 throws GenericEntityException

performs the same function as the ResultSet.absolute method; if rowNum is positive, goes to that position relative to the beginning of the list; if rowNum is negative, goes to that position relative to the end of the list; a rowNum of 1 is the same as first(); a rowNum of -1 is the same as last()

Throws:

GenericEntityException

hasNext

public boolean hasNext()

PLEASE NOTE: Because of the nature of the JDBC ResultSet interface this method can be very inefficient; it is much better to just use next() until it returns null

Specified by:

hasNext in interface Iterator<GenericValue>

Specified by:

hasNext in interface ListIterator<GenericValue>

hasPrevious

public boolean hasPrevious()

PLEASE NOTE: Because of the nature of the JDBC ResultSet interface this method can be very inefficient; it is much better to just use previous() until it returns null

Specified by:

hasPrevious in interface ListIterator<GenericValue>

next

public GenericValue next()

Moves the cursor to the next position and returns the GenericValue object for that position; if there is no next, returns null

Specified by:

next in interface Iterator<GenericValue>

Specified by:

next in interface ListIterator<GenericValue>

nextIndex

public int nextIndex()

Returns the index of the next result, but does not guarantee that there will be a next result

Specified by:

nextIndex in interface ListIterator<GenericValue>

previous

public GenericValue previous()

Moves the cursor to the previous position and returns the GenericValue object for that position; if there is no previous, returns null

Specified by:

previous in interface ListIterator<GenericValue>

previousIndex

public int previousIndex()

Returns the index of the previous result, but does not guarantee that there will be a previous result

Specified by:

previousIndex in interface ListIterator<GenericValue>

setFetchSize

public void setFetchSize(int rows)
                  throws GenericEntityException

Throws:

GenericEntityException

getCompleteList

public List<GenericValue> getCompleteList()
                                   throws GenericEntityException

Throws:

GenericEntityException

getPartialList

public List<GenericValue> getPartialList(int start,
 int number)
                                  throws GenericEntityException

Gets a partial list of results starting at start and containing at most number elements. Start is a one based value, ie 1 is the first element.

Throws:

GenericEntityException

add

public void add(GenericValue obj)

Specified by:

add in interface ListIterator<GenericValue>

remove

public void remove()

Specified by:

remove in interface Iterator<GenericValue>

Specified by:

remove in interface ListIterator<GenericValue>

set

public void set(GenericValue obj)

Specified by:

set in interface ListIterator<GenericValue>