com.togethersoft.testing.host
Interface ITestHost

public interface ITestHost

Interface which provides general services for managing test assets

public void addTestHostListener(ITestHostListener listener)

Deprecated.

public IAssertion createAsserion(String assertionType)
                           throws TestHostException

Creates new assertion if given type.
Assertion task must be registered with registerTask( ICategory cat, TaskDefinition taskDef )

public ITestAssetReference createReference(ITestAssetRO asset)
                                     throws TestHostException

Creates a new reference to be pasted into some target.

public ITarget createTarget()

Creates new suite target

public ITestCollection createTestCollection(String name)
                                      throws TestHostException

Create test collection. It should be pasted later to other collection.
You can modify collection before pasting.

public ITestResultAsset createTestResult(String name)
                                   throws TestHostException

Create test result. It should be pasted later to test collection.
You can modify result before pasting.

public IElementRO find(String refid)

finds test element with specified reference id .

public IElementRO find(ITestCollection collection, String refid)

Deprecated.

public String[] findResults(String refId)

Returns: array of rsult ref ids, sorted by date, last result - at index 0.

public ICategory[] getAssertionCategories()

Returns an array of known assertion categories

public ICategory[] getAssetCategories()

Returns an array of known asset categories

public IEnvironment getEnvironment()

Deprecated.

public IProgressMonitor getProgress()

Deprecated.

public IResource getResource(URL location)

Returns resource at given URL

public ITestCollection getResultCollection()

Returns ITestCollection containing test results.

public ICategory[] getTaskCategories()

Returns an array of task categories

public TaskDefinition getTaskDefinition(ICategory cat)

Returns a task definition for given category

public ITestAssetFactory getTestAssetFactory(ICategory cat)

Used to get asset factory of registered ICategory cat

public ITestProject getTestProject()

Returns: ITestProject - framework project - a set of roots

public boolean isInitialized()

Deprecated.

public void registerAsset(ICategory cat, Class factoryClass)

Parameters:

cat - new category

factoryClass - class of test asset factory ( should implement ITestAssetFactory)
register new test asset (step/suite) with specified category

public void registerTask(ICategory cat, TaskDefinition taskDef)

Registration of a task for a Suite (ant project).
Using this method should be registered all assertion and step running tasks.

See Also:

com.togethersoft.testing.shared.ITestCategories.TASK_ASSERTION, ITestCategories#TASK_STEP_RUNNER

Example:

public void removeTestHostListener(ITestHostListener listener)

Deprecated.

public boolean run(ITestAsset asset, ITestResultAsset result)
             throws TestHostException

Parameters:

asset - existing and generated test asset (step/suite)

result - new ( or existing) test result.
Runs a test asset (step/suite). IServerResultListener should be attached to result if notifications about testing progress are required.

public void runInCommandThread(Runnable runnable, String name, boolean wait)

Runs given command in command thread

public boolean runSuite(ITestSuite suite, ITestResultAsset result, String[] target)
                  throws TestHostException

Parameters:

suite - existing and generated test suite

result - new ( or existing) test result.

target - array of targets names. If target.length == 0 then default target will be run.
Runs a test suite with specified set of targets . IServerResultListener should be attached to result if notifications about testing progress are required.