GDNetUtility Class Reference

BlackBerry Dynamics proxy infrastructure network utilities. More...

Description

This class contains the programming interface for a network utility provided by the BlackBerry Dynamics proxy infrastructure.

The utility is accessed as a static method on a "singleton class" instance.

Classes
enum	GDNetUtilityErr
	Enumerated constants for BlackBerry Dynamics net utility errors. More...
interface	GDNslookupCallback
	Listener interface for BlackBerry Dynamics name service lookup results. More...
enum	GDNslookupType
	Enumerated constants for use with the BlackBerry Dynamics name service. More...

Public Member Functions
void	nslookup (String host, GDNslookupType type, GDNslookupCallback callback)
	Execute a BlackBerry Dynamics name service lookup. More...
void	setWebProxyAppliedByApp (final boolean appliedByApp)
	Configure usage of a web proxy server for connections through the BlackBerry Dynamics proxy infrastructure. More...

Static Public Member Functions
static synchronized GDNetUtility	getInstance ()
	Get a reference to the BlackBerry Dynamics network utility object. More...

Member Function Documentation

nslookup()

void nslookup	(	String	host,
		GDNslookupType	type,
		GDNslookupCallback	callback
	)

Call this method to execute a BlackBerry Dynamics name service lookup. The lookup can be for canonical name (CNAME) or address record (A record).

The lookup will be executed from an enterprise end point of the BlackBerry Dynamics deployment to which the application is connected. The end point could be a BlackBerry Proxy server located behind the enterprise firewall or in its perimeter network (also known as DMZ, demilitarized zone, and screened subnet). Details for enterprise application servers could be in scope of the lookup, depending on the network configuration at the enterprise.

The lookup is asynchronous. If the lookup succeeds, the results will be passed to the onNslookupResponseSuccess callback in the listener. If the lookup fails, an error code will be passed to the onNslookupResponseFailure callback in the listener instead.

Parameters

host	String containing the name to look up.
type	GDNslookupType specifying the type of result required, either CNAME or A record.
callback	Reference to the results listener.

setWebProxyAppliedByApp()

void setWebProxyAppliedByApp

(

final boolean

appliedByApp

)

The proxy configuration may be specified within the BlackBerry Dynamics management console using either a Proxy Auto-Configuration (PAC) file or manually.

• If appliedByApp set to true, the application should specify its own web proxy server to which web requests (HTTP, HTTPS) should be forwarded.
• If appliedByApp set to false, all web requests through the BlackBerry Dynamics proxy infrastructure will use the web proxy server configuration defined in the BlackBerry Dynamics management console (if any).

The runtime sets this property to false by default

getInstance()

static synchronized GDNetUtility getInstance ( )

static

This method returns a reference to the BlackBerry Dynamics network utility object, which is a "singleton class".

Returns

Reference that can be used to call, for example, the nslookup method.