textbender.a.r.desk
Interface HostServiceRegistry

All Superinterfaces:
Remote
All Known Implementing Classes:
HostServiceRegistry1

public interface HostServiceRegistry
extends Remote

Registry of services for this host. The shared instance of the registry is bound in the RMI boot-registry (at the standard port) and may be obtained via X.findRegistry().


Nested Class Summary
static class HostServiceRegistry.UniqueID
          An identifier, each instance of which is guaranteed to be unique within a single run of the desk daemon.
static class HostServiceRegistry.X
          Service registry utilities.
 
Method Summary
 File allInOneJar()
          Returns the file path of an all-in-one textbender JAR, suitable as a codebase for applets and applications.
<S extends Remote>
S
getService(Class<S> serviceInterface)
          Returns an instance of the specified service.
 HostServiceRegistry.UniqueID nextUniqueID()
          Returns the next unique identifier.
 URL resolveJarURL()
          Deprecated. 
 

Method Detail

allInOneJar

@ThreadSafe
File allInOneJar()
                 throws IOException
Returns the file path of an all-in-one textbender JAR, suitable as a codebase for applets and applications. This JAR is intended for use by boot applets that would otherwise lack a local codebase, and is available only in demo installations of the desk daemon (in normal installations, demo texts ought to boot like any other, with no need of this facility).

Throws:
IOException - if the JAR is unavailable, or the JAR file cannot be created
See Also:
BootApplet

getService

@ThreadSafe
<S extends Remote> S getService(Class<S> serviceInterface)
                            throws RemoteException
Returns an instance of the specified service.

Parameters:
serviceInterface - specifying the service
Throws:
AccessException - if the caller is from another host. Services are provided only to the local host.
RemoteException

nextUniqueID

@ThreadSafe
HostServiceRegistry.UniqueID nextUniqueID()
                                          throws RemoteException
Returns the next unique identifier.

Throws:
RemoteException

resolveJarURL

@Deprecated
@ThreadSafe
URL resolveJarURL()
                  throws IOException
Deprecated. 

Resolves and returns the URL of the desk daemon's runtime JAR.

Throws:
IOException
See Also:
allInOneJar()