SHOW Signed

net.rim.device.api.crypto.keystore
Class AssociatedData

java.lang.Object
  |
  +--net.rim.device.api.crypto.keystore.AssociatedData

All Implemented Interfaces:

net.rim.vm.Persistable, Persistable

public class AssociatedData

extends Object

implements Persistable

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.

Since:

JDE 3.6.0

See Also:

AssociatedDataKeyStoreIndex

Field Summary

	static long	DESKTOP_COOKIE A long representing the desktop cookie associated data.
	static long	EMAIL A long representing the email associated data.
	static long	ISSUER A long representing the issuer associated data.
	static long	NAME A long representing the name associated data.
	static long	SERIAL_NUMBER A long representing the serial number associated data.
	static long	SMART_CARD_KEY If present, indicates that this key resides on a smart card

Constructor Summary

	AssociatedData(long association, byte[] data) Sets the association with the appropriate data for this class.
	AssociatedData(long association, byte[][] data) Sets the association with the appropriate data for this class.

Method Summary

	long	getAssociation() Returns the association for this data.
	byte[][]	getData() Returns a copy of the data for this association.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

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.

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.

DESKTOP_COOKIE

public static final long DESKTOP_COOKIE

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.

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.

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.

SMART_CARD_KEY

public static final long SMART_CARD_KEY

If present, indicates that this key resides on a smart card

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.