net.rim.device.api.crypto.transcoder
Class TranscoderManager

java.lang.Object
  net.rim.device.api.crypto.transcoder.TranscoderManager

public final class TranscoderManager
extends Object

Provides methods for managing the transcoders on the device.

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 4.5.0

Method Summary
	static void	register(Transcoder transcoder) Registers a Transcoder.

Methods inherited from class java.lang.Object

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

Method Detail

register

public static void register(Transcoder transcoder)
                     throws TranscoderRegistrationException

Registers a Transcoder. Once a transcoder has been registered, any messages sent from the device will be passed into its encode(...) method for encoding. Similarly, any messages sent to the device will be passed into its decode(...) method for decoding. A transcoder must re-register on device reset.

The registration will fail if

1. the transcoder to register is null, or
2. another transcoder is already registered, or
3. the calling application does not have permission to register a transcoder. The permission to register a transcoder is granted by the BES administrator.

Parameters:

transcoder - the transcoder to register

Throws:

IllegalArgumentException - if transcoder is null.

TranscoderRegistrationException - if registration cannot be completed

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 4.5.0