SHOW Signed

net.rim.device.api.system
Interface PersistentContentListener

All Known Implementing Classes:

ContentProtectedVector, ContentProtectedHashtable

public interface PersistentContentListener

A listener class for persistent content events.

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 4.0.0

See Also:

PersistentContent

Field Summary

	static int	PERSISTENT_CONTENT_LOCKED_INSECURE Indicates that data on the device is not secured.
	static int	PERSISTENT_CONTENT_LOCKED_SECURE Indicates that data on the device is secured.
	static int	PERSISTENT_CONTENT_LOCKING Indicates that the device is locking.
	static int	PERSISTENT_CONTENT_UNLOCKED Indicates that the device is currently unlocked.

Method Summary

	void	persistentContentModeChanged(int generation) Invoked when the persistent content mode changes.
	void	persistentContentStateChanged(int state) Invoked when the persistent content state changes.

Field Detail

PERSISTENT_CONTENT_UNLOCKED

public static final int PERSISTENT_CONTENT_UNLOCKED

Indicates that the device is currently unlocked.

Content may be encrypted when the device is unlocked or locked. However, content may not be decrypted if the device is locked.

Since:

JDE 4.0.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.

PERSISTENT_CONTENT_LOCKING

public static final int PERSISTENT_CONTENT_LOCKING

Indicates that the device is locking.

Content may be encrypted when the device is unlocked or locked. However, content may not be decrypted if the device is locked.

Since:

JDE 4.0.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.

PERSISTENT_CONTENT_LOCKED_SECURE

public static final int PERSISTENT_CONTENT_LOCKED_SECURE

Indicates that data on the device is secured.

Since:

JDE 4.0.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.

PERSISTENT_CONTENT_LOCKED_INSECURE

public static final int PERSISTENT_CONTENT_LOCKED_INSECURE

Indicates that data on the device is not secured.

This occurs if data is received while the device is locked.

Since:

JDE 4.0.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

persistentContentStateChanged

public void persistentContentStateChanged(int state)

Invoked when the persistent content state changes.

Listeners should periodically compare the state parameter to PersistentContent.getLockGeneration(). If they are different, then the listener may wish to terminate its processing.

Parameters:

state - New state.

Since:

JDE 4.0.2

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.

persistentContentModeChanged

public void persistentContentModeChanged(int generation)

Invoked when the persistent content mode changes.

Listeners should call PersistentContent.checkEncoding(java.lang.Object) to see if they need to call PersistentContent.reEncode(java.lang.Object).

Listeners should periodically compare the generation parameter to PersistentContent.getModeGeneration(). If they are different, then the listener should terminate their checkEncoding/reEncoding loop.

Parameters:

generation - Used to determine if the user has changed the content protection settings since the listener was notified.

Since:

JDE 4.0.2

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.