Used to provide an aliasing service for the records that are
contained inside the keystore. The AssociatedData
class allows the user to specify what kind of alias they are
using and subsequently allows for more flexible use of this
structure with an Index.
Generating longs for AssociatedData classes
The convention used to generate longs for the associated data
classes, is for example net.rim.device.api.crypto.keystore.EMAIL. Note the
actual data descriptor is in capital letters. This name is then
converted into a long using the function provided in the IDE (right click a
string).
The "common" longs are provided and should be used as much as possible.
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
A long representing the desktop cookie associated data.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
EMAIL
public static final long EMAIL
A long representing the email associated data.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
HISTORICAL_KEY_ID
public static final long HISTORICAL_KEY_ID
If present, indicates the unique identifier for any historical keys.
Since:
JDE 4.1.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
ISSUER
public static final long ISSUER
A long representing the issuer associated data.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
NAME
public static final long NAME
A long representing the name associated data.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
PGP_KEY_ID
public static final long PGP_KEY_ID
A long representing the PGP key ID associated data.
Since:
JDE 4.1.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
PGP_UNIVERSAL_CACHED_KEY_INFO
public static final long PGP_UNIVERSAL_CACHED_KEY_INFO
A long representing the PGP Universal Server cached key information.
Since:
JDE 4.1.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
SERIAL_NUMBER
public static final long SERIAL_NUMBER
A long representing the serial number associated data.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
Constructor Detail
AssociatedData
public AssociatedData(long association,
byte[] data)
Sets the association with the appropriate data
for this class.
Parameters:
association - A long representing the association.
data - A byte array containing the data for the association.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
AssociatedData
public AssociatedData(long association,
byte[][] data)
Sets the association with the appropriate data
for this class.
Parameters:
association - A long representing the association.
data - A two dimensioanl array containing the data for the association.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
Method Detail
getAssociation
public long getAssociation()
Returns the association for this data.
Returns:
A long representing the association.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
getData
public byte[][] getData()
Returns a copy of the data for this association.
Note: This ensures that this class is immutable.
Returns:
A two dimensional array containing the data.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
Copyright 1999-2007 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. Copyright 2002-2003 Nokia Corporation All Rights Reserved. Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.