interface XSimpleTest in module com::sun::star::test::

(Global Index)

Syntax

interface XSimpleTest : com::sun::star::uno::XInterface ;

Description

A simple interface to test a service or interface implementation.

Method Summary

testInvariant Test the object TestObject against the test specified with TestName. This test does not change the semantic state of the object, so it can be called on a existing component that will used further on. Note : This can be a strong test limitation. There are some components, that cannot perform their full test scenario.

test Test the object TestObject against the test specified with TestName. This test changes the state of the object. The object may be useless afterwards. (e.g. a closed XOutputStream). The method in general may be called multipe times with a new test object instance. Note : These tests should include the testInvariant test. Note : Each test scenario should be independent of each other, so even if a scenario didn't pass the test, the other test can still be performed. The error messages are cumulative.

testPassed States if one of the last test has failed. This is cumulative.

getErrors

getErrorExceptions

getWarnings

Method Details



testInvariant

Syntax

void testInvariant (
string TestName,
com::sun::star::uno::XInterface TestObject )
raises ( com::sun::star::lang::IllegalArgumentException );

Description

Test the object TestObject against the test specified with TestName. This test does not change the semantic state of the object, so it can be called on a existing component that will used further on. Note : This can be a strong test limitation. There are some components, that cannot perform their full test scenario.

Parameter TestName

the name of the test. Must be an interface, service or implementation name. Note : The name is only used by the test component to distinguish between test scenarios.

Parameter TestObject

The instance to be tested.

Throws

IllegalArgumentException if the test does not support TestName or TestObject is null.

test

Syntax

long test (
string TestName,
com::sun::star::uno::XInterface TestObject,
long hTestHandle )
raises ( com::sun::star::lang::IllegalArgumentException );

Description

Test the object TestObject against the test specified with TestName. This test changes the state of the object. The object may be useless afterwards. (e.g. a closed XOutputStream). The method in general may be called multipe times with a new test object instance. Note : These tests should include the testInvariant test. Note : Each test scenario should be independent of each other, so even if a scenario didn't pass the test, the other test can still be performed. The error messages are cumulative.

Parameter TestName

The name of the test. Must be an interface, service or implementation name. Note : The name is only used by the test component to distinguish between test scenarios.

Parameter TestObject

The instance to be tested.

Parameter hTestHandle

Internal test handle. Handle for first test is always 0. Handle of next test is returned by the method.

Returns

Handle of the next test. -1 if this was the last test.

Throws

IllegalArgumentException if the test does not support TestName or TestObject is null.

testPassed

Syntax

boolean testPassed ();

Description

States if one of the last test has failed. This is cumulative.

Returns

true if all test have been passed succesfully. false if an error has occured.

getErrors

Syntax

sequence< string > getErrors ();

getErrorExceptions

Syntax

sequence< any > getErrorExceptions ();

getWarnings

Syntax

sequence< string > getWarnings ();
Top of Page