• Implement extension to extension point org.eclipse.hyades.execution.testService

Link to published extension point schema.

• Implement ITestService class [optionally extend AbstractTestService]

All TestServices must implement the ITestService interface, which declares a single run method. Implementors are encouraged to extend the AbstractTestService class, which implements the run method, parses apart the method names and argument list, attempts to reflectively invoke the named service, expecting the following signature: String serviceName(Agent agent, String args, StringBuffer errorBuffer); and returns the appropriate exception or result.

• Implement service methods within ITestService [optionally adhere to reflected method signature]

As mentioned above, if your test service extends AbstractTestService, your service's method signature should be String serviceName(Agent agent, String args, StringBuffer errorBuffer); When your service is invoked, you are expected to perform the service and either return a String containing the result of the service (which will be interpretable by your agent side wrapper if you have provided one) or return null and populate the errorBuffer with the error description. If you return null and pass back an error description, the AbstractTestService will prepend "Exception:" to your description, indicating that your service wrapper (if you provided one) should throw an exception.

Note that it is not explicitly necessary to have code on the agent side in order to invoke a service. You can use the ServiceInvoker class to directly invoke a service. However, since the parameter passing is string based, one would certainly expect that any services invoked from a test itself would be wrapped on the agent side by a more friendly API. In either case, a test service is invoked by calling ServiceInvoker.invokeService(String serviceName, String args); All service calls are currently synchronous, so the invokeService() method will not return until the service call is complete, and it will return a string containing either the return result of the service, or a String beginning with "Exception:", followed