All Packages Class Hierarchy This Package Previous Next Index
Applications use the getProvider() method on this interface to obtain new Provider objects. Each implementation may support one or more different "services" (e.g. for different types of underlying network substrate). A list of available services can be obtained via the getServices() method.
Applications may also supply optional arguments to the Provider. These arguments are appended to the string argument passed to the getProvider() method. The string argument has the following format:
< service name > ; arg1 = val1; arg2 = val2; ...
Where < service name > is not optional, and each optional argument pair which follows is separated by a semi-colon. The keys for these arguments is implementation specific, except for two standard-defined keys:
public abstract String getName() throws PlatformException
public abstract String[] getServices() throws PlatformException
public abstract Provider getProvider(String providerString) throws PlatformException
< service name > ; arg1 = val1; arg2 = val2; ...
Where < service name > is not optional, and each optional argument pair which follows is separated by a semi-colon. The keys for these arguments is implementation specific, except for two standard-defined keys:
If the argument is null, this method returns some default Provider as determined by the object which implements this interface.
The Provider returned is in the Provider.OUT_OF_SERVICE state, leading to the following post-conditions:
All Packages Class Hierarchy This Package Previous Next Index