to specify an instance count for a given service, and a collection of well known tokens which are appended to the
to create property names used to search the test properties for service configuration values.
This class provides two sets of accessors. The first set consists of a collection of protected methods with names of the form getServiceFoo
, where Foo
is a service parameter such as codebase or classpath. Subclasses should call these methods when generating the service descriptors or command lines needed to run the service. There are also a parallel set of public method with names of the form getFoo
, which return the cached values of results previously returned by their getServiceFoo
counterparts. The latter set of methods are intended for debug output, and to allow tests to obtain the parameters actually used to start services. This class provides accessors for the following well-known tokens:
type | the service type |
impl | the back-end implementation class name of the service |
codebase | the codebase for the service |
component | the component name used to reference entries in the services Configuration |
host | the host the service should run on when running in distributed mode. May be an explicit host name or one of 'master', 'slave', or 'slaveN' where N is an integer. If an explicit host is specified, that host name must be present in the system property com.sun.jini.qa.harness.testhosts . |
classpath | the classpath for the service |
policyfile | the security policy file for the service |
serverjvm | the path for the jvm to execute for the service |
serverjvmargs | options and properties for the service vm |
activationhost | the host running the activation system |
activationport | the port for contacting the activation system |
serviceConfiguration | the configuration file for the service |
starterConfiguration | the configuration file for the service starter |
preparername | the fully qualified name of the entry for the ProxyPreparer for the service proxy in the test ConfigurationFile |
dir | a directory specifier (only used by class server) |
port | a port number (only used by reggie) |
tojoin | the set of groups and locators a service should join |
membergroups | the set of groups a lookup service should advertise |
log | a token incorporated into the name of a services persistence log |
integrityhash | if true , the service codebase is to be converted to an httpmd URL. This property is not generally defined, allowing the global com.sun.jini.qa.harness.integrityHhash property to control this behavior. |
autoDestroy | if defined and false , inhibit the automatic termination of the service in the test teardown method. Rarely used to eliminate spurious stack traces in tests which use the service's DestroyAdmin directly. |