| java.lang.Object
 javax.media.jai.registry.RemoteCRIFRegistry
| RemoteCRIFRegistry | | final public class RemoteCRIFRegistry (Code) | | Utility class to provide type-safe interaction with the
OperationRegistry for RemoteCRIF objects.
If the OperationRegistry specified as an argument to the
methods in this class is null, then JAI.getOperationRegistry()
will be used.
since:
JAI 1.1 |
| Method Summary | |
| public static RemoteRenderedImage | create(OperationRegistry registry, String protocolName, String serverName, String operationName, RenderContext renderContext, ParameterBlock paramBlock)
Creates a rendering remotely, given the serverName, protocolName,
name of the operation to be performed, a RenderContext and
a ParameterBlock containing the operation's sources
and parameters. | | public static RemoteCRIF | get(OperationRegistry registry, String protocolName)
Returns the RemoteCRIF registered under the given
protocol name in the specified OperationRegistry.
Parameters:
registry - The OperationRegistry to use. | | public static void | register(OperationRegistry registry, String protocolName, RemoteCRIF rcrif)
Registers the given RemoteCRIF with the given
OperationRegistry under the given protocolName
Parameters:
registry - The OperationRegistry to register the RemoteCRIF with. | | public static void | unregister(OperationRegistry registry, String protocolName, RemoteCRIF rcrif)
Unregisters the given RemoteCRIF previously registered
under the given protocolName in the given
OperationRegistry.
Parameters:
registry - The OperationRegistry to unregister the RemoteCRIF from. |
| create | | public static RemoteRenderedImage create(OperationRegistry registry, String protocolName, String serverName, String operationName, RenderContext renderContext, ParameterBlock paramBlock)(Code) | | Creates a rendering remotely, given the serverName, protocolName,
name of the operation to be performed, a RenderContext and
a ParameterBlock containing the operation's sources
and parameters. The registry is used to determine the
RemoteCRIF to be used to instantiate the operation.
Since this class is a simple type-safe wrapper around
OperationRegistry's type-unsafe methods, no additional
argument validation is performed in this method. Thus errors/exceptions
may occur if incorrect values are provided for the input arguments.
If argument validation is desired as part of creating a rendering,
RemoteJAI.createRenderable() may be used instead to
create a RemoteRenderableOp which can then be asked for
a rendering.
Exceptions thrown by the RemoteRIFs used to create
the rendering will be caught by this method and will not be propagated.
Parameters:
registry - The OperationRegistry to use tocreate the rendering. If this isnull, then JAI.getDefaultInstance().getOperationRegistry()will be used.
Parameters:
protocolName - The protocol to be used for remote imaging.
Parameters:
serverName - The name of the server.
Parameters:
operationName - The name of the operation to be performed remotely.
Parameters:
renderContext - A RenderContext specifying thecontext in which the rendering should be requested.
Parameters:
paramBlock - The ParameterBlock specifying thesources and parameters required for the operation.
throws:
IllegalArgumentException - if protocolName is null.
throws:
IllegalArgumentException - if there is no RemoteDescriptor registered against the givenprotocolName. |
| get | | public static RemoteCRIF get(OperationRegistry registry, String protocolName)(Code) | | Returns the RemoteCRIF registered under the given
protocol name in the specified OperationRegistry.
Parameters:
registry - The OperationRegistry to use. If this is null, then JAI.getDefaultInstance().getOperationRegistry()will be used.
Parameters:
protocolName - The name of the remote imaging protocol.
throws:
IllegalArgumentException - if protocolName is null.
throws:
IllegalArgumentException - if there is noRemoteDescriptor registered against the givenprotocolName. |
| register | | public static void register(OperationRegistry registry, String protocolName, RemoteCRIF rcrif)(Code) | | Registers the given RemoteCRIF with the given
OperationRegistry under the given protocolName
Parameters:
registry - The OperationRegistry to register the RemoteCRIF with. If this isnull, then JAI.getDefaultInstance().getOperationRegistry()will be used.
Parameters:
protocolName - The protocolName to register the RemoteCRIF under.
Parameters:
rcrif - The RemoteCRIF to register.
throws:
IllegalArgumentException - if protocolName is null.
throws:
IllegalArgumentException - if rcrif is null.
throws:
IllegalArgumentException - if there is no RemoteDescriptor registered against the given protocolName. |
| unregister | | public static void unregister(OperationRegistry registry, String protocolName, RemoteCRIF rcrif)(Code) | | Unregisters the given RemoteCRIF previously registered
under the given protocolName in the given
OperationRegistry.
Parameters:
registry - The OperationRegistry to unregister the RemoteCRIF from. If this isnull, then JAI.getDefaultInstance().getOperationRegistry()will be used.
Parameters:
protocolName - The protocolName to unregister theRemoteCRIF from under.
Parameters:
rcrif - The RemoteCRIF to unregister.
throws:
IllegalArgumentException - if protocolName is null.
throws:
IllegalArgumentException - if rcrif is null.
throws:
IllegalArgumentException - if there is no RemoteDescriptor registered against the given protocolName.
throws:
IllegalArgumentException - if the rcrif was not previouslyregistered against protocolName. |
|
|