com.sun.star.comp.beans
Class LocalOfficeConnection

java.lang.Object
  com.sun.star.comp.beans.LocalOfficeConnection

All Implemented Interfaces:

com.sun.star.comp.beans.OfficeConnection, com.sun.star.lang.XComponent, com.sun.star.uno.XInterface

public class LocalOfficeConnection
extends java.lang.Object
implements com.sun.star.comp.beans.OfficeConnection

This class reprecents a connection to the local office application.

Since:

OOo 2.0.0

Field Summary

static java.lang.String	OFFICE_APP_NAME
static java.lang.String	OFFICE_ID_SUFFIX
static java.lang.String	OFFICE_LIB_NAME

Fields inherited from interface com.sun.star.lang.XComponent

UNOTYPEINFO

Constructor Summary

LocalOfficeConnection()
Constructor.

Method Summary

void	addEventListener(com.sun.star.lang.XEventListener listener) Adds an event listener to the object.
com.sun.star.comp.beans.OfficeWindow	createOfficeWindow(java.awt.Container container) Creates an office window.
void	dispose() Closes the connection.
com.sun.star.uno.XComponentContext	getComponentContext() Retrives the UNO component context.
void	removeEventListener(com.sun.star.lang.XEventListener listener) Removes an event listener from the listener list.
void	setContainerFactory(com.sun.star.comp.beans.ContainerFactory containerFactory) Sets an AWT container catory.
void	setUnoUrl(java.lang.String url) Sets a connection URL.

Methods inherited from class java.lang.Object

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

Field Detail

OFFICE_APP_NAME

public static final java.lang.String OFFICE_APP_NAME

See Also:

Constant Field Values

OFFICE_LIB_NAME

public static final java.lang.String OFFICE_LIB_NAME

See Also:

Constant Field Values

OFFICE_ID_SUFFIX

public static final java.lang.String OFFICE_ID_SUFFIX

See Also:

Constant Field Values

Constructor Detail

LocalOfficeConnection

public LocalOfficeConnection()

Constructor. Sets up paths to the office application and native libraries if values are available in OFFICE_PROP_FILE in the user home directory.
"com.sun.star.beans.path" - the office application directory;
"com.sun.star.beans.libpath" - native libraries directory.

Method Detail

setUnoUrl

public void setUnoUrl(java.lang.String url)
               throws java.net.MalformedURLException

Sets a connection URL. This implementation accepts a UNO URL with following format:

 url    := uno:localoffice[,<params>];urp;StarOffice.ServiceManager
 params := <path>[,<pipe>]
 path   := path=<pathv>
 pipe   := pipe=<pipev>
 pathv  := platform_specific_path_to_the_local_office_distribution
 pipev  := local_office_connection_pipe_name
 

Specified by:

setUnoUrl in interface com.sun.star.comp.beans.OfficeConnection

Parameters:

url - This is UNO URL which discribes the type of a connection.

Throws:

java.net.MalformedURLException

setContainerFactory

public void setContainerFactory(com.sun.star.comp.beans.ContainerFactory containerFactory)

Sets an AWT container catory.

Specified by:

setContainerFactory in interface com.sun.star.comp.beans.OfficeConnection

Parameters:

containerFactory - This is a application provided AWT container factory.

getComponentContext

public com.sun.star.uno.XComponentContext getComponentContext()

Retrives the UNO component context. Establishes a connection if necessary and initialises the UNO service manager if it has not already been initialised. This method can return null if it fails to connect to the office application.

Specified by:

getComponentContext in interface com.sun.star.comp.beans.OfficeConnection

Returns:

The office UNO component context.

createOfficeWindow

public com.sun.star.comp.beans.OfficeWindow createOfficeWindow(java.awt.Container container)

Creates an office window. The window is either a sub-class of java.awt.Canvas (local) or java.awt.Container (RVP).

Specified by:

createOfficeWindow in interface com.sun.star.comp.beans.OfficeConnection

Parameters:

container - This is an AWT container.

Returns:

The office window instance.

dispose

public void dispose()

Closes the connection.

Specified by:

dispose in interface com.sun.star.lang.XComponent

addEventListener

public void addEventListener(com.sun.star.lang.XEventListener listener)

Adds an event listener to the object.

Specified by:

addEventListener in interface com.sun.star.lang.XComponent

Parameters:

listener - is a listener object.

removeEventListener

public void removeEventListener(com.sun.star.lang.XEventListener listener)

Removes an event listener from the listener list.

Specified by:

removeEventListener in interface com.sun.star.lang.XComponent

Parameters:

listener - is a listener object.