net.rim.device.api.database
Class Row

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

public class Row
extends Object

Collection of variables and values associated by column names. It is used to define cell values in columns and rows of tables.

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 column value by index.
Category: Signed  InputStream getBlobStream(int index)
          Retrieves column value by index.
Category: Signed  boolean getBoolean(int index)
          Retrieves column value by index.
Category: Signed  byte getByte(int index)
          Retrieves column value by index.
Category: Signed  int getColumnIndex(String name)
          Computes column index for a given column name.
Category: Signed  String[] getColumnNames()
          Returns all column names in row.
Category: Signed  double getDouble(int index)
          Retrieves column value by index.
Category: Signed  float getFloat(int index)
          Retrieves column value by index.
Category: Signed  int getInteger(int index)
          Retrieves column value by index.
Category: Signed  long getLong(int index)
          Retrieves column value by index.
Category: Signed  Object getObject(int index)
          Retrieves column value as it is represented in the DB.
Category: Signed  short getShort(int index)
          Retrieves column value by index.
Category: Signed  String getString(int index)
          Retrieves 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 row.

Returns:
Enumeration of all column names in 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 column index for a given column name.

Returns:
column index, or -1 if 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 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 column value by index.

Parameters:
index - Index of the column.
Returns:
short 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 column value by index.

Parameters:
index - Index of the column.
Returns:
byte 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 column value by index.

Parameters:
index - Index of the column.
Returns:
string 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 column value by index.

Parameters:
index - Index of the column.
Returns:
long 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 column value by index.

Parameters:
index - Index of the column.
Returns:
boolean 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 column value by index.

Parameters:
index - Index of the column.
Returns:
float 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 column value by index.

Parameters:
index - Index of the column.
Returns:
double 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 column value by index.

Parameters:
index - Index of the column.
Returns:
input-stream 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 column value by index.

Parameters:
index - Index of the column.
Returns:
byte [] 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 column value as it is represented in the DB.

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

Parameters:
index - Index of the column.
Returns:
column value as 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.