/**************************************************************
*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
*
*************************************************************/
package com.sun.star.lib.connections.pipe;
import com.sun.star.comp.loader.FactoryHelper;
import com.sun.star.connection.AlreadyAcceptingException;
import com.sun.star.connection.ConnectionSetupException;
import com.sun.star.connection.XAcceptor;
import com.sun.star.connection.XConnection;
import com.sun.star.lang.XMultiServiceFactory;
import com.sun.star.lang.XSingleServiceFactory;
import com.sun.star.registry.XRegistryKey;
/**
* A component that implements the XAcceptor
interface.
*
*
The pipeAcceptor
is a specialized component that uses TCP
* pipes for communication. The pipeAcceptor
is generally used
* by the com.sun.star.connection.Acceptor
service.
The JavaLoader
acceses this through reflection.
This method is called by the JavaLoader
.
XSingleServiceFactory
for creating the component.
*
* @see com.sun.star.comp.loader.JavaLoader
*/
public static XSingleServiceFactory __getServiceFactory(
String implName, XMultiServiceFactory multiFactory, XRegistryKey regKey)
{
return implName.equals(pipeAcceptor.class.getName())
? FactoryHelper.getServiceFactory(
pipeAcceptor.class, __serviceName, multiFactory, regKey)
: null;
}
/**
* Accepts a connection request via the described pipe.
*
* This call blocks until a connection has been established.
* *The connection description has the following format:
* type
*(key=value
),
* where type
should be pipe
* (ignoring case). Supported keys (ignoring case) currently are
*
host
* 0
, meaning any interface).
* port
* 6001
).
* backlog
* 50
).
* tcpnodelay
* 0
/1
) enabling or disabling Nagle's
* algorithm on the resulting connection.
* XConnection
to the client.
*
* @see com.sun.star.connections.XConnection
* @see com.sun.star.connections.XConnector
*/
public XConnection accept(String connectionDescription) throws
AlreadyAcceptingException, ConnectionSetupException,
com.sun.star.lang.IllegalArgumentException
{
throw new java.lang.NoSuchMethodError( "pipeAcceptor not fully implemented yet" );
//try { return new PipeConnection( connectionDescription ); }
//catch ( java.io.IOException e ) { return null; }
}
// see com.sun.star.connection.XAcceptor#stopAccepting
public void stopAccepting() {
}
private static final boolean DEBUG = false;
}