Examples of com.sun.jini.start.SharedActivatableServiceDescriptor

com.sun.jini.start.SharedActivatableServiceDescriptor

Class used to launch shared, activatable services. Clients construct this object with the details of the service to be launched, then call {@link #create(net.jini.config.Configuration) create(Configuration config) }to launch the service in an existing {@linkplain SharedActivationGroupDescriptor shared activation group}identified by the sharedGroupLog constructor parameter.

This class depends on {@link ActivateWrapper} to provide separation of the import codebase (where the service implementation classes are loaded from) from the export codebase (where service clients should load classes from, for example stubs) as well as providing an independent security policy file for each service object. This functionality allows multiple service objects to be placed in the same activation system group, with each object maintaining distinct export codebase and security policy settings.

Services need to implement the "activatable" constructor required by {@link ActivateWrapper}.

A service implementation can return its service proxy (via the proxy field of the {@link Created Created} object returnedby {@link #create(net.jini.config.Configuration) create}) in the following ways:

Return Inner Proxy

The service's inner proxy is the {@link java.rmi.Remote} object returned from {@link java.rmi.activation.ActivationID#activate(boolean)} using{@link ActivateWrapper} to "wrap" and register the desired servicewith the activation system. A "wrapped" service's inner proxy is returned as follows:

If the newly created service instance implements {@link net.jini.export.ProxyAccessor}, a proxy is obtained by invoking the {@link net.jini.export.ProxyAccessor#getProxy getProxy} method on that instance. If theobtained proxy is not null, that proxy is returned in a {@link java.rmi.MarshalledObject}; otherwise, an {@link java.io.InvalidObjectException} is thrown.
If the newly created instance does not implement {@link net.jini.export.ProxyAccessor}, the instance is returned in a {@link java.rmi.MarshalledObject}. In this case, the instance must be serializable, and marshalling the instance must produce a suitable proxy for the remote object (for example, the object implements {@link java.io.Serializable} and defines a writeReplacemethod that returns the object's proxy).

Return Outer Proxy

The service's outer proxy is the object returned from invoking {@link ServiceProxyAccessor#getServiceProxy()} onthe service's inner proxy.

The following items are discussed below:

Configuring SharedActivatableServiceDescriptor
Logging

Configuring SharedActivatableServiceDescriptor

SharedActivatableServiceDescriptor depends on {@link ActivateWrapper}, which can itself be configured. See {@linkplain ActivateWrapper}'s configuration information for details.

This implementation obtains its configuration entries from the {@link net.jini.config.Configuration Configuration} object passed into the {@link #create(net.jini.config.Configuration) create} method.The following configuration entries use the component prefix "com.sun.jini.start":

•	`activationIdPreparer`
	Type:	{@link net.jini.security.ProxyPreparer}
	Default:	`new {@link net.jini.security.BasicProxyPreparer}()`
	Description:	The proxy preparer for the service's activation ID. The value should not be `null`. This class calls the {@link java.rmi.activation.ActivationID#activate activate} method on instances of {@link java.rmi.activation.ActivationID} when they need to re/activate theservice.

•	`activationSystemPreparer`
	Type:	{@link net.jini.security.ProxyPreparer}
	Default:	`new {@link net.jini.security.BasicProxyPreparer}()`
	Description:	The proxy preparer for the proxy for the activation system. The value should not be `null`. The service starter calls the {@link java.rmi.activation.ActivationSystem#unregisterObject unregisterObject} method on the {@link java.rmi.activation.ActivationSystem} when there is a problemcreating a service.

•	`servicePreparer`
	Type:	{@link net.jini.security.ProxyPreparer}
	Default:	`new {@link net.jini.security.BasicProxyPreparer}()`
	Description:	The default proxy preparer used to prepare service proxies. This value should not be `null`. This entry is obtained during the invocation of {@link #create(net.jini.config.Configuration) create} and is used, to prepare the inner and outer service proxies returned by the service implementation (see service proxy section for details). This entry is superseded by explicitly passing a {@link ProxyPreparer ProxyPreparer} to one of the constructors thataccept a {@linkplain ProxyPreparer proxy preparer} argument.

Loggers and Logging Levels

The implementation uses the {@link java.util.logging.Logger}, named com.sun.jini.start.service.starter. The following table describes the type of information logged as well as the levels of information logged.

**`com.sun.jini.start.service.starter`**
Level	Description
{@link java.util.logging.Level#FINER FINER}	for high level service operation tracing
{@link java.util.logging.Level#FINEST FINEST}	for low level service operation tracing

@author Sun Microsystems, Inc. @since 2.0

                                                       serverCommand,
                                                       serverOptions,
                                                       serverProperties);
            sharedActivationGroupDescriptor.create(starterConfig);
            /* start no-op service in the shared VM just created */
            SharedActivatableServiceDescriptor destroyVMServiceDescriptor =
                new SharedActivatableServiceDescriptor(noopServiceCodebase,
                                                       noopServicePolicyFile,
                                                       noopServiceClasspath,
                                                       noopServiceImplName,
                                                       sharedVMDir,
                                                       noopServiceArgsArray,
                                                       false);
            Created createdObj = (Created)destroyVMServiceDescriptor.create
                                                              (starterConfig);
            vmProxy[v] = (SharedGroup)createdObj.proxy;//to destroy service VM
            /* start TestService-v in same shared VM as no-op service */
            SharedActivatableServiceDescriptor serviceDescriptor =
                new SharedActivatableServiceDescriptor(serviceCodebase,
                                                       servicePolicyFile,
                                                       serviceClasspath,
                                                       serviceImplName,
                                                       sharedVMDir,
                                                       serviceArgsArray,
                                                       false);
            serviceDescriptor.create(starterConfig);
        }//end loop


        /* create SDM to retrieve ref to TestService-i from lookup */
        sdm = new ServiceDiscoveryManager
                                    (ldm, null, sysConfig.getConfiguration());

View Full Code Here

    public void run(EnvCheck envCheck) {
        this.envCheck = envCheck;
  ServiceDescriptor[] d = envCheck.getDescriptors();
  for (int i = 0; i < d.length; i++) {
      if (d[i] instanceof SharedActivatableServiceDescriptor) {
    SharedActivatableServiceDescriptor sd = 
        (SharedActivatableServiceDescriptor) d[i];
    checkDirectory(sd);
      }
  }
    }

View Full Code Here

0 1

TOP

Related Classes of com.sun.jini.start.SharedActivatableServiceDescriptor

com.sun.jini.qa.harness.ActivatableServiceStarterAdmin

com.sun.jini.start.DestroySharedGroup

com.sun.jini.test.impl.joinmanager.LeaseRenewDurRFE

com.sun.jini.test.impl.start.SerializedServiceDescriptors

com.sun.jini.test.impl.start.ServiceDescriptorProxyPreparationTest

com.sun.jini.test.impl.start.ServiceStarterCreateSharedBadActServiceTest

com.sun.jini.test.impl.start.SharedActivatableServiceDescriptorTest

com.sun.jini.test.impl.start.SharedActivatableServiceDescriptorTest2

com.sun.jini.test.impl.start.SharedActivatableServiceDescriptorTest3

com.sun.jini.tool.envcheck.plugins.CheckPersistence

All source code are property of their respective owners. Java is a trademark of Sun Microsystems, Inc and owned by ORACLE Inc. Contact coftware#gmail.com.