net.rim.device.api.database
Class Row

java.lang.Object
  extended by net.rim.device.api.database.Row

public class Row
extends Object

A collection of variables and values, associated by column names, that is used to define cell values in columns and rows.

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 Summary
Category: Signed  byte[] getBlobBytes(int index)
          Retrieves a column value by index.
Category: Signed  InputStream getBlobStream(int index)
          Retrieves a column value by index.
Category: Signed  boolean getBoolean(int index)
          Retrieves a column value by index.
Category: Signed  byte getByte(int index)
          Retrieves a column value by index.
Category: Signed  int getColumnIndex(String name)
          Computes a column index for a given column name.
Category: Signed  String[] getColumnNames()
          Returns all column names in a row.
Category: Signed  double getDouble(int index)
          Retrieves a column value by index.
Category: Signed  float getFloat(int index)
          Retrieves a column value by index.
Category: Signed  int getInteger(int index)
          Retrieves a column value by index.
Category: Signed  long getLong(int index)
          Retrieves a column value by index.
Category: Signed  Object getObject(int index)
          Retrieves a column value as it is represented in the database.
Category: Signed  short getShort(int index)
          Retrieves a column value by index.
Category: Signed  String getString(int index)
          Retrieves a column value by index.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 



Method Detail

getColumnNames

public String[] getColumnNames()
Returns all column names in a row.

Returns:
Enumeration of all column names in the row.
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

getColumnIndex

public int getColumnIndex(String name)
Computes a column index for a given column name.

Parameters:
name - Column name.
Returns:
Column index, or -1 if the column name is not present.
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

getInteger

public int getInteger(int index)
               throws DataTypeException
Retrieves a column value by index.

Parameters:
index - Index of the column.
Returns:
int Value of the column.
Throws:
DataTypeException
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

getShort

public short getShort(int index)
               throws DataTypeException
Retrieves a column value by index.

Parameters:
index - Index of the column.
Returns:
Value of the column.
Throws:
DataTypeException
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

getByte

public byte getByte(int index)
             throws DataTypeException
Retrieves a column value by index.

Parameters:
index - Index of the column.
Returns:
Value of the column.
Throws:
DataTypeException
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

getString

public String getString(int index)
                 throws DataTypeException
Retrieves a column value by index.

Parameters:
index - Index of the column.
Returns:
Value of the column.
Throws:
DataTypeException
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

getLong

public long getLong(int index)
             throws DataTypeException
Retrieves a column value by index.

Parameters:
index - Index of the column.
Returns:
Value of the column.
Throws:
DataTypeException
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

getBoolean

public boolean getBoolean(int index)
                   throws DataTypeException
Retrieves a column value by index.

Parameters:
index - Index of the column.
Returns:
Value of the column.
Throws:
DataTypeException
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

getFloat

public float getFloat(int index)
               throws DataTypeException
Retrieves a column value by index.

Parameters:
index - Index of the column.
Returns:
Value of the column.
Throws:
DataTypeException
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

getDouble

public double getDouble(int index)
                 throws DataTypeException
Retrieves a column value by index.

Parameters:
index - Index of the column.
Returns:
Value of the column.
Throws:
DataTypeException
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

getBlobStream

public InputStream getBlobStream(int index)
                          throws DataTypeException
Retrieves a column value by index.

Parameters:
index - Index of the column.
Returns:
Value of the column.
Throws:
DataTypeException
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

getBlobBytes

public byte[] getBlobBytes(int index)
                    throws DataTypeException
Retrieves a column value by index.

Parameters:
index - Index of the column.
Returns:
Value of the column.
Throws:
DataTypeException
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

getObject

public Object getObject(int index)
                 throws DataTypeException
Retrieves a column value as it is represented in the database.

Note that the element returned is database-dependent. Numeric values may be represented by 1 or 2 internal data structures. It is advised to check the class of the returned object through the instanceof directive.

Parameters:
index - Index of the column.
Returns:
Value as a Java object.
Throws:
DataTypeException
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.