org.apache.openjpa.jdbc.kernel
Class PagingResultObjectProvider

java.lang.Object
  extended by org.apache.openjpa.jdbc.kernel.SelectResultObjectProvider
      extended by org.apache.openjpa.jdbc.kernel.PagingResultObjectProvider
All Implemented Interfaces:
org.apache.openjpa.lib.rop.ResultObjectProvider, org.apache.openjpa.lib.util.Closeable

public class PagingResultObjectProvider
extends SelectResultObjectProvider

Object provider implementation that fetches one page of results at a a time as it scrolls. If the getPagedFields(org.apache.openjpa.jdbc.sql.Select, org.apache.openjpa.jdbc.meta.ClassMapping, org.apache.openjpa.jdbc.kernel.JDBCStore, org.apache.openjpa.jdbc.kernel.JDBCFetchConfiguration, int, long) method returns a non-null bit set, this this provider is a good fit for your configuration. The method tests the following conditions:

To use this provider, select the candidate mapping with eager fetch mode set to join. This provider will take care of performing parallel mode batch selects for each page it reads.

Author:
Abe White

Constructor Summary
PagingResultObjectProvider(SelectExecutor sel, ClassMapping[] mappings, JDBCStore store, JDBCFetchConfiguration fetch, java.util.BitSet[] paged, long size)
          Constructor.
PagingResultObjectProvider(SelectExecutor sel, ClassMapping mapping, JDBCStore store, JDBCFetchConfiguration fetch, java.util.BitSet paged, long size)
          Constructor.
 
Method Summary
 boolean absolute(int pos)
           
static java.util.BitSet getPagedFields(Select sel, ClassMapping mapping, JDBCStore store, JDBCFetchConfiguration fetch, int eagerMode, long size)
          Return a bit set representing batch select fields that will be paged, or null if no fields need paging, which indicates that this provider should not be used.
 int getPageSize()
          Return the page size in use.
 java.lang.Object getResultObject()
           
 boolean next()
           
 void open()
           
 
Methods inherited from class org.apache.openjpa.jdbc.kernel.SelectResultObjectProvider
close, getFetchConfiguration, getResult, getSelect, getStore, handleCheckedException, reset, setSize, size, supportsRandomAccess
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

PagingResultObjectProvider

public PagingResultObjectProvider(SelectExecutor sel,
                                  ClassMapping mapping,
                                  JDBCStore store,
                                  JDBCFetchConfiguration fetch,
                                  java.util.BitSet paged,
                                  long size)
Constructor.

Parameters:
sel - the select to execute
mapping - the mapping of the result objects
store - the store manager to delegate loading to
fetch - the fetch configuration, or null for default
paged - the bit set returned from getPagedFields(org.apache.openjpa.jdbc.sql.Select, org.apache.openjpa.jdbc.meta.ClassMapping, org.apache.openjpa.jdbc.kernel.JDBCStore, org.apache.openjpa.jdbc.kernel.JDBCFetchConfiguration, int, long)
size - the known maximum size of the result, or Long.MAX_VALUE for no known limit

PagingResultObjectProvider

public PagingResultObjectProvider(SelectExecutor sel,
                                  ClassMapping[] mappings,
                                  JDBCStore store,
                                  JDBCFetchConfiguration fetch,
                                  java.util.BitSet[] paged,
                                  long size)
Constructor.

Parameters:
sel - the select to execute
mappings - the mappings for the independent classes of the result objects
store - the store manager to delegate loading to
fetch - the fetch configuration, or null for default
paged - the bit sets returned from getPagedFields(org.apache.openjpa.jdbc.sql.Select, org.apache.openjpa.jdbc.meta.ClassMapping, org.apache.openjpa.jdbc.kernel.JDBCStore, org.apache.openjpa.jdbc.kernel.JDBCFetchConfiguration, int, long) for each select in the possible union
size - the known maximum size of the result, or Long.MAX_VALUE for no known limit
Method Detail

getPagedFields

public static java.util.BitSet getPagedFields(Select sel,
                                              ClassMapping mapping,
                                              JDBCStore store,
                                              JDBCFetchConfiguration fetch,
                                              int eagerMode,
                                              long size)
Return a bit set representing batch select fields that will be paged, or null if no fields need paging, which indicates that this provider should not be used.

See Also:
PagingResultObjectProvider(org.apache.openjpa.jdbc.sql.SelectExecutor, org.apache.openjpa.jdbc.meta.ClassMapping[], org.apache.openjpa.jdbc.kernel.JDBCStore, org.apache.openjpa.jdbc.kernel.JDBCFetchConfiguration, java.util.BitSet[], long)

getPageSize

public int getPageSize()
Return the page size in use.


open

public void open()
          throws java.sql.SQLException
Specified by:
open in interface org.apache.openjpa.lib.rop.ResultObjectProvider
Overrides:
open in class SelectResultObjectProvider
Throws:
java.sql.SQLException

next

public boolean next()
             throws java.sql.SQLException
Specified by:
next in interface org.apache.openjpa.lib.rop.ResultObjectProvider
Overrides:
next in class SelectResultObjectProvider
Throws:
java.sql.SQLException

absolute

public boolean absolute(int pos)
                 throws java.sql.SQLException
Specified by:
absolute in interface org.apache.openjpa.lib.rop.ResultObjectProvider
Overrides:
absolute in class SelectResultObjectProvider
Throws:
java.sql.SQLException

getResultObject

public java.lang.Object getResultObject()
                                 throws java.sql.SQLException
Throws:
java.sql.SQLException