com.kabira.test.management

Class Client

java.lang.Object

com.kabira.test.management.Client

public class Client
extends java.lang.Object

Provides a mechanism for calling administration targets from test code.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	Client.Configuration Provides a mechanism for loading and managing configuration data.

Constructor Summary

Constructors

Constructor and Description
Client(java.lang.String userName, java.lang.String password) Create a new Client instance using the given userName and password.

Method Summary

Modifier and Type	Method and Description
protected void	finalize()
java.lang.String[]	runCommand(java.lang.String command, java.lang.String target, java.util.HashMap<java.lang.String,java.lang.String> parameters) Execute an administration command.
void	tearDown() performs cleanup action.

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Client

public Client(java.lang.String userName,
              java.lang.String password)

Create a new Client instance using the given userName and password.

Parameters:

userName - a configured principal on the node

password - the text credential for the principal

Method Detail

runCommand

public java.lang.String[] runCommand(java.lang.String command,
                                     java.lang.String target,
                                     java.util.HashMap<java.lang.String,java.lang.String> parameters)
                              throws CommandFailed,
                                     Transaction.InvalidTransactionState

Execute an administration command. All administration targets and commands are supported except "load configuration", which is supported by the nested Configuration class, and "loadactivate configuration", which is not supported. The administration target will always run on the same node as the application calling runCommand.

Parameters:

command - the command name

target - the target name

parameters - a map containing parameter names and values

Returns:

The output of the command

Throws:

CommandFailed - an unsupported command was specified or the invocation of the command failed.

Transaction.InvalidTransactionState - called from a transactional context.

tearDown

public void tearDown()

performs cleanup action. closes jmx connection, if not done already this is generally called by finalize method which is called by garbage collector to do cleanup; this is made public so that calling class can do cleanup to release resources without having to wait for garbage collector.

finalize

protected void finalize()
                 throws java.lang.Throwable

Overrides:

finalize in class java.lang.Object

Throws:

java.lang.Throwable