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
 Category: Signed static int PERSISTENT_CONTENT_LOCKED_INSECURE
          Indicates that data on the device is not secured.
 Category: Signed static int PERSISTENT_CONTENT_LOCKED_SECURE
          Indicates that data on the device is secured.
 Category: Signed static int PERSISTENT_CONTENT_LOCKING
          Indicates that the device is locking.
 Category: Signed static int PERSISTENT_CONTENT_UNLOCKED
          Indicates that the device is currently unlocked.
 
Method Summary
 Category: Signed  void persistentContentModeChanged(int generation)
          Invoked when the persistent content mode changes.
 Category: Signed  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.


Copyright 1999-2004 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.