net.rim.device.api.database
Class CursorEnumeration

java.lang.Object
  extended by net.rim.device.api.database.CursorEnumeration
All Implemented Interfaces:
Enumeration

public class CursorEnumeration
extends Object
implements Enumeration

Wraps cursor operations in Enumeration interface. Hides all the database errors.

Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 5.0.0

Constructor Summary
Category: Signed CursorEnumeration(Cursor cursor)
          Creates cursor enumeration based on the given cursor.
 
Method Summary
Category: Signed  boolean hasMoreElements()
          Check whether there are more rows in the cursor.
Category: Signed  Object nextElement()
          Navigates to the next row and returns it.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 



Constructor Detail

CursorEnumeration

public CursorEnumeration(Cursor cursor)
                  throws NullPointerException
Creates cursor enumeration based on the given cursor.

Parameters:
cursor - cursor with data.
Throws:
NullPointerException - if the cursor parameter is NULL.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 5.0.0


Method Detail

hasMoreElements

public boolean hasMoreElements()
Check whether there are more rows in the cursor.

It is safe to call this method multiple times as it does not perform any cursor navigations.

Specified by:
hasMoreElements in interface Enumeration
Returns:
true if cursor is not empty and there are more rows to fetch, false otherwise.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 5.0.0

nextElement

public Object nextElement()
                   throws NoSuchElementException
Navigates to the next row and returns it.

Specified by:
nextElement in interface Enumeration
Returns:
a Row instance.
Throws:
NoSuchElementException - if there are no more rows in the cursor.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 5.0.0





Copyright 1999-2010 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A. All Rights Reserved.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark of Sun Microsystems, Inc.