• BlackBerry Dynamics
  • Runtime library for Android applications
  • 12.1.1.43
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
hostString containing the name to look up.
typeGDNslookupType specifying the type of result required, either CNAME or A record.
callbackReference 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.