SHOW Signed

net.rim.device.api.io.http
Class HttpFilterRegistry

java.lang.Object
  |
  +--net.rim.device.api.io.http.HttpFilterRegistry

public final class HttpFilterRegistry

extends Object

Houses protocol filters associated with fully qualified domain names.

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

Method Summary

	static void	deregisterFilter(String fqdn) Deregisters a previously registered filter.
	static String	getFilter(String fqdn) Retrieves a previously registered package by fully qualified domain name.
	static void	registerFilter(String fqdn, String protocolPackage) Registers a new fully qualified domain name (FQDN) with a package name.

Methods inherited from class java.lang.Object

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

Method Detail

registerFilter

public static void registerFilter(String fqdn,
                                  String protocolPackage)

Registers a new fully qualified domain name (FQDN) with a package name.

Parameters:

fqdn - Fully qualified domain name (eg. www.blackberry.com).

protocolPackage - The java package where the Protocol.java class will be found. (eg. com.yourcompany.somepackage); the package name must have a Protocol java class inside of the package for instantiation.

Throws:

ControlledAccessException - if the calling application is not allowed according to Application Control by the IT Administrator for the device to register a filter. Note that by default all applications are not allowed to register filters. This functionality must be turned on by the IT administrator.

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.

deregisterFilter

public static void deregisterFilter(String fqdn)

Deregisters a previously registered filter.

Parameters:

fqdn - Fully qualified domain name (eg. www.blackberry.com)

Throws:

ControlledAccessException - if the calling application is not allowed according to Application Control by the IT Administrator for the device to deregister a filter. Note that by default all applications are not allowed to deregister filters. This functionality must be turned on by the IT administrator.

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.

getFilter

public static String getFilter(String fqdn)

Retrieves a previously registered package by fully qualified domain name.

Parameters:

fqdn - Fully qualified domain name (eg. www.blackberry.com).

Returns:

Name of package registered for FQDN.

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.