Service provider details. More...
This class is used to return information about a service provider. See GDAndroid.getServiceProvidersFor. An instance of this class either represents an application or a server.
The information returned for an application could be used to send a service request to the service provider using AppKinetics. See the icc package reference for details of AppKinetics.
The information returned for a server could be used to establish HTTP or TCP socket communications with an instance of the server.
Public Member Functions | |
String | getIdentifier () |
Get the BlackBerry Dynamics entitlement identifier of the service provider. More... | |
String | getVersion () |
Get the BlackBerry Dynamics entitlement version of the service provider. More... | |
String | getName () |
Get the display name of the service provider. More... | |
String | getAddress () |
Get the native application identifier of the service provider. More... | |
Bitmap | getIcon () |
Get the application icon of the service provider, if it has been retrieved. More... | |
boolean | getIconPending () |
Check whether there is an application icon that has not yet been retrieved. More... | |
Vector< GDAppServer > | getServerCluster () |
Get server details. More... | |
Vector< GDServiceDetail > | getServices () |
Get details of provided services. More... | |
String getIdentifier | ( | ) |
String
containing the BlackBerry Dynamics entitlement identifier of the service provider. String getVersion | ( | ) |
String
containing the BlackBerry Dynamics entitlement version of the service provider. String getName | ( | ) |
String
containing the display name of the service provider. String getAddress | ( | ) |
Call this method to get the native application identifier of the service provider, if it is an application. The returned address is the value that would be passed as the application
parameter in a call to sendTo (GDServiceClient) .
String
containing the native application identifier. Bitmap getIcon | ( | ) |
Call this method to get the application icon of the service provider. This method returns a Bitmap
object if all the following conditions are met.
Otherwise, this method returns null
.
See also the getIconPending
method, below.
Bitmap
containing the application icon, or null
. boolean getIconPending | ( | ) |
Call this method to check whether there is application icon that hasn't yet been retrieved, if getIcon
returns null
.
If there is an icon for the service provider that has not yet been retrieved by the BlackBerry Dynamics runtime, this method returns true
. A GDAppEvent of type GDAppEventServicesUpdate
event will be dispatched when the icon has been retrieved.
If getIcon
returns null
, and this method returns false
, it means that there is no application icon.
true
if there is an icon for the service provider that hasn't yet been retrieved. false
otherwise. Vector<GDAppServer> getServerCluster | ( | ) |
Vector
of GDAppServer
objects, each representing an instance of a server that provides the service. If there is more than one then the application should use a server selection algorithm, such as that outlined under the Application Server Selection heading in the GDAndroid.getApplicationConfig documentation. Vector<GDServiceDetail> getServices | ( | ) |
Vector
of GDServiceDetail
objects, each representing a provided shared service.