org.safs.jvmagent

Class LocalAgentFactoryImpl

java.lang.Object

org.safs.jvmagent.LocalAgentFactoryImpl

All Implemented Interfaces:

LocalAgentFactory

public class LocalAgentFactoryImpl
extends java.lang.Object
implements LocalAgentFactory

Since:

Feb 17, 2005

Author:

Carl Nagle

Field Summary

Fields inherited from interface org.safs.jvmagent.LocalAgentFactory

DEFAULT_AGENT_NAME, DEFAULT_AGENT_PACKAGE

Constructor Summary

Constructors

Constructor and Description
LocalAgentFactoryImpl() Constructor for LocalAgentFactoryImpl.
LocalAgentFactoryImpl(java.lang.String agentpackage) Constructor for LocalAgentFactoryImpl.

Method Summary

Modifier and Type	Method and Description
LocalAgent	getAgent(java.lang.String agentname) Locate and return the LocalAgent using the stored agentpackage and provided agentname.
LocalAgent	getDefaultAgent() By default we attempt to return a DEFAULT_AGENT_NAME instance from agentpackage.
LocalAgent	getDerivedAgent(java.lang.Object testobject) Locate and return the LocalAgent most appropriate for the testobject target.
LocalAgent	getLocalAgent(java.lang.String fullclassname) Return the LocalAgent for the fully specified agentclass.
void	setAgentPackage(java.lang.String agentpackage) Override the DEFAULT_AGENT_PACKAGE setting for instantiating local agent helpers.
void	setDefaultAgentName(java.lang.String agentname) Override the DEFAULT_AGENT_NAME setting for instantiating the default agent helper.

Methods inherited from class java.lang.Object

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

Constructor Detail

LocalAgentFactoryImpl

public LocalAgentFactoryImpl()

Constructor for LocalAgentFactoryImpl.

LocalAgentFactoryImpl

public LocalAgentFactoryImpl(java.lang.String agentpackage)

Constructor for LocalAgentFactoryImpl.

Method Detail

setAgentPackage

public void setAgentPackage(java.lang.String agentpackage)

Description copied from interface: LocalAgentFactory

Override the DEFAULT_AGENT_PACKAGE setting for instantiating local agent helpers.

Specified by:

setAgentPackage in interface LocalAgentFactory

See Also:

LocalAgentFactory.setAgentPackage(String)

setDefaultAgentName

public void setDefaultAgentName(java.lang.String agentname)

Description copied from interface: LocalAgentFactory

Override the DEFAULT_AGENT_NAME setting for instantiating the default agent helper.

Specified by:

setDefaultAgentName in interface LocalAgentFactory

See Also:

LocalAgentFactory.setDefaultAgentName(String)

getAgent

public LocalAgent getAgent(java.lang.String agentname)
                    throws InvalidAgentException

Description copied from interface: LocalAgentFactory

Locate and return the LocalAgent using the stored agentpackage and provided agentname. Ex: If agentname = "ComponentAgent" and stored agentpackage = "org.safs.jvmagent" then we will attempt to return "org.safs.jvmagent.ComponentAgent".

Specified by:

getAgent in interface LocalAgentFactory

Returns:

LocalAgent

Throws:

InvalidAgentException - if agent cannot be found/created/returned.

See Also:

LocalAgentFactory.getAgent(String)

getDerivedAgent

public LocalAgent getDerivedAgent(java.lang.Object testobject)
                           throws InvalidAgentException

Description copied from interface: LocalAgentFactory

Locate and return the LocalAgent most appropriate for the testobject target. For example, if the testobject is a Swing JFrame we would return the LocalAgent from the current agent package that knows how to handle JFrames.

Specified by:

getDerivedAgent in interface LocalAgentFactory

Returns:

LocalAgent

Throws:

InvalidAgentException - if agent cannot be found/created/returned.

See Also:

LocalAgentFactory.getDerivedAgent(Object)

getDefaultAgent

public LocalAgent getDefaultAgent()
                           throws InvalidAgentException

By default we attempt to return a DEFAULT_AGENT_NAME instance from agentpackage.

Specified by:

getDefaultAgent in interface LocalAgentFactory

Returns:

LocalAgent

Throws:

InvalidAgentException - if agent cannot be found/created/returned.

See Also:

LocalAgentFactory.getDefaultAgent()

getLocalAgent

public LocalAgent getLocalAgent(java.lang.String fullclassname)
                         throws InvalidAgentException

Return the LocalAgent for the fully specified agentclass.

Specified by:

getLocalAgent in interface LocalAgentFactory

Parameters:

agentclass - the full proper class name for the desired LocalAgent. The internal agent package is ignored.

Returns:

LocalAgent

Throws:

InvalidAgentException - if agent cannot be found/created/returned.