Class AbstractPagingItemReader<T>
- java.lang.Object
- org.springframework.batch.item.ItemStreamSupport
- org.springframework.batch.item.support.AbstractItemStreamItemReader<T>
- org.springframework.batch.item.support.AbstractItemCountingItemStreamItemReader<T>
- org.springframework.batch.item.database.AbstractPagingItemReader<T>
- All Implemented Interfaces:
ItemReader<T>,ItemStream,ItemStreamReader<T>,org.springframework.beans.factory.InitializingBean
- Direct Known Subclasses:
HibernatePagingItemReader,JdbcPagingItemReader,JpaPagingItemReader
public abstract class AbstractPagingItemReader<T> extends AbstractItemCountingItemStreamItemReader<T> implements org.springframework.beans.factory.InitializingBean
AbstractItemStreamReaderfor to extend when reading database records in a paging fashion.Implementations should execute queries using paged requests of a size specified in
setPageSize(int). Additional pages are requested when needed asAbstractItemCountingItemStreamItemReader.read()method is called, returning an object corresponding to current position.- Since:
- 2.0
- Author:
- Thomas Risberg, Dave Syer
Constructor Summary
Constructors Constructor Description AbstractPagingItemReader()
Method Summary
All Methods Instance Methods Abstract Methods Concrete Methods Modifier and Type Method Description voidafterPropertiesSet()Check mandatory properties.protected voiddoClose()Close the resources opened inAbstractItemCountingItemStreamItemReader.doOpen().protected abstract voiddoJumpToPage(int itemIndex)protected voiddoOpen()Open resources necessary to start reading input.protected TdoRead()Read next item from input.protected abstract voiddoReadPage()intgetPage()The current page number.intgetPageSize()The page size configured for this reader.protected voidjumpToItem(int itemIndex)Move to the given item index.voidsetPageSize(int pageSize)The number of rows to retrieve at a time.Methods inherited from class org.springframework.batch.item.support.AbstractItemCountingItemStreamItemReader
close, getCurrentItemCount, isSaveState, open, read, setCurrentItemCount, setMaxItemCount, setSaveState, update
Methods inherited from class org.springframework.batch.item.ItemStreamSupport
getExecutionContextKey, setExecutionContextName, setName
Field Detail
logger
protected org.apache.commons.logging.Log logger
results
protected volatile java.util.List<T> results
Method Detail
getPage
public int getPage()
The current page number.- Returns:
- the current page
getPageSize
public int getPageSize()
The page size configured for this reader.- Returns:
- the page size
setPageSize
public void setPageSize(int pageSize)
The number of rows to retrieve at a time.- Parameters:
pageSize- the number of rows to fetch per page
afterPropertiesSet
public void afterPropertiesSet() throws java.lang.ExceptionCheck mandatory properties.- Specified by:
afterPropertiesSetin interfaceorg.springframework.beans.factory.InitializingBean- Throws:
java.lang.Exception- See Also:
InitializingBean.afterPropertiesSet()
doRead
protected T doRead() throws java.lang.Exception
Description copied from class:AbstractItemCountingItemStreamItemReaderRead next item from input.- Specified by:
doReadin classAbstractItemCountingItemStreamItemReader<T>- Returns:
- an item or
nullif the data source is exhausted - Throws:
java.lang.Exception- Allows subclasses to throw checked exceptions for interpretation by the framework
doReadPage
protected abstract void doReadPage()
doOpen
protected void doOpen() throws java.lang.ExceptionDescription copied from class:AbstractItemCountingItemStreamItemReaderOpen resources necessary to start reading input.- Specified by:
doOpenin classAbstractItemCountingItemStreamItemReader<T>- Throws:
java.lang.Exception- Allows subclasses to throw checked exceptions for interpretation by the framework
doClose
protected void doClose() throws java.lang.ExceptionDescription copied from class:AbstractItemCountingItemStreamItemReaderClose the resources opened inAbstractItemCountingItemStreamItemReader.doOpen().- Specified by:
doClosein classAbstractItemCountingItemStreamItemReader<T>- Throws:
java.lang.Exception- Allows subclasses to throw checked exceptions for interpretation by the framework
jumpToItem
protected void jumpToItem(int itemIndex) throws java.lang.ExceptionDescription copied from class:AbstractItemCountingItemStreamItemReaderMove to the given item index. Subclasses should override this method if there is a more efficient way of moving to given index than re-reading the input usingAbstractItemCountingItemStreamItemReader.doRead().- Overrides:
jumpToItemin classAbstractItemCountingItemStreamItemReader<T>- Parameters:
itemIndex- index of item (0 based) to jump to.- Throws:
java.lang.Exception- Allows subclasses to throw checked exceptions for interpretation by the framework
doJumpToPage
protected abstract void doJumpToPage(int itemIndex)