org.jboss.test
Class JBossTestServices

java.lang.Object
  org.jboss.test.JBossTestServices

public class JBossTestServices

extends Object

This is provides services for jboss junit test cases and TestSetups. It supplies access to log4j logging, the jboss jmx server, jndi, and a method for deploying ejb packages. You may supply the JNDI name under which the RMIAdaptor interface is located via the system property jbosstest.server.name default (jmx/rmi/RMIAdaptor) and the directory for deployable packages with the system property jbosstest.deploy.dir (default ../lib). Should be subclassed to derive junit support for specific services integrated into jboss.

Version:

$Revision: 1.3 $

Author:

David Jencks, Christoph G. Jung, Scott.Stark@jboss.org

Field Summary

static int	DEFAULT_BEANCOUNT
static int	DEFAULT_ITERATIONCOUNT
static String	DEFAULT_LOGIN_CONFIG
static String	DEFAULT_PASSWORD
static int	DEFAULT_THREADCOUNT
static String	DEFAULT_USERNAME
static String	DEPLOYER_NAME
protected InitialContext	initialContext
protected Hashtable	jndiEnv
protected LoginContext	lc
protected org.apache.log4j.Category	log
protected javax.management.MBeanServerConnection	server

Constructor Summary

JBossTestServices(String className)
Constructor for the JBossTestCase object

Method Summary

void	deploy(String name) Deploy a package with the main deployer.
protected String	getDeployURL(String filename) Returns the deployment directory to use.
javax.management.MBeanServerConnection	getServer() Gets the Server attribute of the JBossTestCase object
String	getServerHost() Get the JBoss server host from system property "jbosstest.server.host" This defaults to "localhost"
void	init() Lookup the RMIAdaptor interface from JNDI.
protected Object	invoke(javax.management.MBeanServerConnection server, javax.management.ObjectName name, String method, Object[] args, String[] sig)
protected Object	invoke(javax.management.ObjectName name, String method, Object[] args, String[] sig) invoke wraps an invoke call to the mbean server in a lot of exception unwrapping.
void	login() Do a JAAS login with the current username, password and login config.
void	logout()
void	redeploy(String name)
void	reinit()
void	setUp() The JUnit setup method
void	tearDown() The teardown method for JUnit
void	undeploy(String name) Undeploy a package with the main deployer.

Methods inherited from class java.lang.Object

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

Field Detail

DEPLOYER_NAME

public static final String DEPLOYER_NAME

See Also:

Constant Field Values

DEFAULT_USERNAME

public static final String DEFAULT_USERNAME

See Also:

Constant Field Values

DEFAULT_PASSWORD

public static final String DEFAULT_PASSWORD

See Also:

Constant Field Values

DEFAULT_LOGIN_CONFIG

public static final String DEFAULT_LOGIN_CONFIG

See Also:

Constant Field Values

DEFAULT_THREADCOUNT

public static final int DEFAULT_THREADCOUNT

See Also:

Constant Field Values

DEFAULT_ITERATIONCOUNT

public static final int DEFAULT_ITERATIONCOUNT

See Also:

Constant Field Values

DEFAULT_BEANCOUNT

public static final int DEFAULT_BEANCOUNT

See Also:

Constant Field Values

server

protected javax.management.MBeanServerConnection server

log

protected org.apache.log4j.Category log

initialContext

protected InitialContext initialContext

jndiEnv

protected Hashtable jndiEnv

lc

protected LoginContext lc

Constructor Detail

JBossTestServices

public JBossTestServices(String className)

Constructor for the JBossTestCase object

Parameters:

className - Test case name

Method Detail

setUp

public void setUp()
           throws Exception

The JUnit setup method

Throws:

Exception

tearDown

public void tearDown()
              throws Exception

The teardown method for JUnit

Throws:

Exception

getServer

public javax.management.MBeanServerConnection getServer()
                                                 throws Exception

Gets the Server attribute of the JBossTestCase object

Returns:

The Server value

Throws:

Exception

getDeployURL

protected String getDeployURL(String filename)
                       throws MalformedURLException

Returns the deployment directory to use. This does it's best to figure out where you are looking. If you supply a complete url, it returns it. Otherwise, it looks for jbosstest.deploy.dir or if missing ../lib. Then it tries to construct a file url or a url.

Parameters:

filename - name of the file/url you want

Returns:

A more or less canonical string for the url.

Throws:

MalformedURLException - Description of Exception

invoke

protected Object invoke(javax.management.ObjectName name,
                        String method,
                        Object[] args,
                        String[] sig)
                 throws Exception

invoke wraps an invoke call to the mbean server in a lot of exception unwrapping.

Parameters:

name - ObjectName of the mbean to be called

method - mbean method to be called

args - Object[] of arguments for the mbean method.

sig - String[] of types for the mbean methods parameters.

Returns:

Object returned by mbean method invocation.

Throws:

Exception - Description of Exception

invoke

protected Object invoke(javax.management.MBeanServerConnection server,
                        javax.management.ObjectName name,
                        String method,
                        Object[] args,
                        String[] sig)
                 throws Exception

Throws:

Exception

deploy

public void deploy(String name)
            throws Exception

Deploy a package with the main deployer. The supplied name is interpreted as a url, or as a filename in jbosstest.deploy.lib or ../lib.

Parameters:

name - filename/url of package to deploy.

Throws:

Exception - Description of Exception

redeploy

public void redeploy(String name)
              throws Exception

Throws:

Exception

login

public void login()
           throws Exception

Do a JAAS login with the current username, password and login config.

Throws:

Exception

logout

public void logout()

undeploy

public void undeploy(String name)
              throws Exception

Undeploy a package with the main deployer. The supplied name is interpreted as a url, or as a filename in jbosstest.deploy.lib or ../lib.

Parameters:

name - filename/url of package to undeploy.

Throws:

Exception - Description of Exception

init

public void init()
          throws Exception

Lookup the RMIAdaptor interface from JNDI. By default this is bound under "jmx/rmi/RMIAdaptor" and this may be overriden with the jbosstest.server.name system property.

Throws:

Exception

reinit

public void reinit()
            throws Exception

Throws:

Exception

getServerHost

public String getServerHost()

Get the JBoss server host from system property "jbosstest.server.host" This defaults to "localhost"