(incubating) | The Free and Open Productivity Suite

Developer's Guide

API

SDK

Tips 'n' Tricks

Miscellaneous

Content for OpenOffice.org version 3.3.

:: com :: sun :: star :: connection ::

interface XAcceptor
Description
allows to passively accept connection attempts from other processes.

This is the counterpart to the XConnector interface.

Developers Guide
ProUNO - Opening a Connection

Methods' Summary
accept accepts an interprocess connection. Waits until someone connects to the resource.  
stopAccepting pushes acceptor out of the accept-call.  
Methods' Details
accept
XConnection
accept( [in] string  sConnectionDescription )
raises( AlreadyAcceptingException,
ConnectionSetupException,
::com::sun::star::lang::IllegalArgumentException );

Description
accepts an interprocess connection. Waits until someone connects to the resource.

After a successful return, the method may be called again to accept further connections, but the parameter string MUST be left unchanged.

Parameter sConnectionDescription
contains the kind of the connection plus a comma seperated list of attributes, e.g., socket,host=localhost,port=2345 for a tcpip connection.
Returns
null reference, stopAccepting was called. Otherwise a valid XConnection reference.
Throws
AlreadyAcceptingException Only one acceptor-thread per instance allowed.
Throws
ConnectionSetupException Problems during setting up the acceptor. (e.g., Security-reasons, socket already busy, etc.)
Throws
com::sun::star::lang::IllegalArgumentException sConnectionDescription could not be interpreted
stopAccepting
void
stopAccepting();

Description
pushes acceptor out of the accept-call.
Top of Page

Apache OpenOffice is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF.

Copyright & License
Apache and the Apache feather logos are trademarks of The Apache Software Foundation. OpenOffice.org and the seagull logo are registered trademarks of The Apache Software Foundation. Other names appearing on the site may be trademarks of their respective owners.