|
Oracle Fusion Middleware Java API Reference for Oracle TopLink 11g Release 1 (11.1.1) B32476-03 |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface CursoredIterator
CursoredIterator provides an interface that conforms to Iterator while providing Cursor behaviour. This interface is returned from an EJB finder method that uses TopLink CursoredStream support. This is TopLink's way of providing cursored support to EJB2.0 finders. Supported methods: close() hasNext() next() next(int) Example: Execute a finder that reads 150 projects. Read the first 50 as singles, then, read the next 50 in bulk. This simulates a screen paging down.
import oracle.toplink.ejb.cmp.*;
import java.util.*;
CursoredIterator cursoredIterator;
ProjectHome projectHome = getProjectHome();
//begin a transaction. Leave this open until done
getTransaction().begin();
System.out.println("Finding multiple Projects...");
Vector projects = new Vector();
cursoredIterator = (CursoredIterator)projectHome.findByNameCursored("proj%").iterator();
for (int index = 0; index < 50; i++) {
Project project = (Project)cursoredIterator.next();
projects.addElement(project);
}
System.out.println("Get the rest all at once ...");
Vector projectsNext50 = cursoredIterator.next(50);
cursoredIterator.close();
//commit transaction, now that we're done
getTransaction().commit();
CursoredStream
,
CursoredCollection
Method Summary | |
---|---|
void |
close()
Close the underlying cursor. |
java.util.Collection |
next(int numberOfElements)
Return the next numberOfElements elements in the underlying cursor. |
Methods inherited from interface java.util.Iterator |
---|
hasNext, next, remove |
Method Detail |
---|
void close()
Close the underlying cursor. This should be invoked when the user is finished using the cursor.
java.util.Collection next(int numberOfElements)
Return the next numberOfElements elements in the underlying cursor.
numberOfElements
- the number of objects to consume from the result set
|
|
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |