OOoRunner: Class BasicHandler

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

OOoRunner test harness

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: INNER | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

basicrunner
Class BasicHandler

basicrunner.BasicHandler

public class BasicHandler

This class is a java-part of BASIC-java interaction "driver" It is used to call Star-Basic's function from java using basic's part of "driver" where listeners are implemented. The instance of the BasicHandler should be added to the MSF that will be used for loading BASIC's part of "driver".
After opening basic's document it creates an instance of the HandlerContainer using BasicHandler. HandlerContainer is a UNO XContainer and XNameContainer. Only one instance of BasicHandler can be used at the moment.

See Also:: com.sun.star.lang.XServiceInfo, XSingleServiceFactory

Constructor Summary
`BasicHandler(TestParameters tParam)` Creates an instance of a HandlerContainer.

Method Summary
`void`	`Connect(String sBasicBridgeURL, TestParameters tParam, XMultiServiceFactory xMSF, LogWriter log)` Establishes a connection between BASIC and Java.
`Object`	`createInstance()` Create an instance of HandlerContainer.
`Object`	`createInstanceWithArguments(Object[] args)` Create an instance of HandlerContainer.
`void`	`dispose()` Dispose the BASIC document.
`String`	`getImplementationName()` Get the implementation name.
`String[]`	`getSupportedServiceNames()` Return all supported service names.
`boolean`	`isUptodate(XMultiServiceFactory xMSF)` Is called by BasicIfcTest to find out if this BasicHandler uses the correct MultiServiceFactory.
`void`	`Log(String info)` Is called when BASIC sends a signal to write some log information.
`PropertyValue`	`perform(String fName, Object params)` Perform a test of a method.
`void`	`setTestedInterface(BasicIfcTest ifc, LogWriter log)` Set the tested interface and a log writer.
`boolean`	`supportsService(String name)` Returns true, if name is a supported service of this class.

Constructor Detail

BasicHandler

public BasicHandler(TestParameters tParam)

Creates an instance of a HandlerContainer. This instance is used from BASIC.

Parameters:: tParam - The test parameters.

Method Detail

setTestedInterface

public void setTestedInterface(BasicIfcTest ifc,
                               LogWriter log)

Set the tested interface and a log writer.

Parameters:: ifc - The test of an interface; log - A log writer.

Log

public void Log(String info)

Is called when BASIC sends a signal to write some log information.

Parameters:: info - The string to write.

isUptodate

public boolean isUptodate(XMultiServiceFactory xMSF)

Is called by BasicIfcTest to find out if this BasicHandler uses the correct MultiServiceFactory.

Parameters:: xMSF - The MultiServiceFactory
Returns:: True, if xMSF is equal to the MultiServiceFactory of this class.
See Also:: XMultiServiceFactory

Connect

public void Connect(String sBasicBridgeURL,
                    TestParameters tParam,
                    XMultiServiceFactory xMSF,
                    LogWriter log)
             throws ConnectionSetupException

Establishes a connection between BASIC and Java. If required, hte BASIC part of the "driver" is loaded.

Parameters:: sBasicBridgeURL - The URL of the basic bridge document (BasicBridge.sxw); tParam - The test parameters.; xMSF - The MultiServiceFactory; log - The log writer.
Throws:: ConnectionSetupException - Exception is thrown, if no connection could be made.
See Also:: XMultiServiceFactory

perform

public PropertyValue perform(String fName,
                             Object params)
                      throws BasicException

Perform a test of a method.

Parameters:: fName - The name of the method to test.; params - The test parameters.
Returns:: A proprty value as result of the test.
Throws:: BasicException - The method could not be executed.

supportsService

public boolean supportsService(String name)

Returns true, if name is a supported service of this class.

Parameters:: name - The service name.
Returns:: True, if the service is supported.

getSupportedServiceNames

public String[] getSupportedServiceNames()

Return all supported service names.

Returns:: All supported services.

getImplementationName

public String getImplementationName()

Get the implementation name.

Returns:: Implementation name.

createInstanceWithArguments

public Object createInstanceWithArguments(Object[] args)

Create an instance of HandlerContainer. Arguments are not supported here, so they will be ignored.

Parameters:: args - The arguments.
Returns:: The instance.

createInstance

public Object createInstance()

Create an instance of HandlerContainer.

Returns:: The instance.

dispose

public void dispose()

Dispose the BASIC document.