com.sun.star.comp.connections

Class Acceptor

java.lang.Object

com.sun.star.comp.connections.Acceptor

public final class Acceptor
extends java.lang.Object

A component that implements the XAcceptor interface.

The Acceptor is a general component, that uses less general components (like com.sun.star.connection.socketAcceptor) to implement its functionality.

Since:

UDK 1.0

See Also:

com.sun.star.connections.XAcceptor, com.sun.star.connections.XConnection, com.sun.star.connections.XConnector, com.sun.star.loader.JavaLoader

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	__serviceName The name of the service.

Constructor Summary

Constructors

Constructor and Description
Acceptor(XMultiServiceFactory serviceFactory) Constructs a new Acceptor that uses the given service factory to create a specific XAcceptor.

Method Summary

Modifier and Type	Method and Description
static XSingleServiceFactory	__getServiceFactory(java.lang.String implName, XMultiServiceFactory multiFactory, XRegistryKey regKey) Returns a factory for creating the service.
XConnection	accept(java.lang.String connectionDescription) Accepts a connection request via the given connection type.
void	stopAccepting()

Methods inherited from class java.lang.Object

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

Field Detail

__serviceName

public static final java.lang.String __serviceName

The name of the service.

The JavaLoader acceses this through reflection.

See Also:

JavaLoader, Constant Field Values

Constructor Detail

Acceptor

public Acceptor(XMultiServiceFactory serviceFactory)

Constructs a new Acceptor that uses the given service factory to create a specific XAcceptor.

Parameters:

serviceFactory - the service factory to use.

Method Detail

__getServiceFactory

public static XSingleServiceFactory __getServiceFactory(java.lang.String implName,
                                                        XMultiServiceFactory multiFactory,
                                                        XRegistryKey regKey)

Returns a factory for creating the service.

This method is called by the JavaLoader.

Parameters:

implName - the name of the implementation for which a service is requested.

multiFactory - the service manager to be used (if needed).

regKey - the registry key.

Returns:

an XSingleServiceFactory for creating the component.

See Also:

JavaLoader

accept

public XConnection accept(java.lang.String connectionDescription)
                   throws AlreadyAcceptingException,
                          ConnectionSetupException,
                          com.sun.star.lang.IllegalArgumentException

Accepts a connection request via the given connection type.

This call blocks until a connection has been established.

The connection description has the following format: type*(key=value). The specific XAcceptor implementation is instantiated through the service factory as com.sun.star.connection.typeAcceptor (with type in lower case).

Parameters:

connectionDescription - the description of the connection.

Returns:

an XConnection to the client.

Throws:

AlreadyAcceptingException

ConnectionSetupException

com.sun.star.lang.IllegalArgumentException

See Also:

com.sun.star.connections.XConnection, com.sun.star.connections.XConnector

stopAccepting

public void stopAccepting()