/* -*- Mode: Java; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
/*
* This file is part of the LibreOffice project.
*
* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/.
*
* This file incorporates work covered by the following license notice:
*
* 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 .
*/
package com.sun.star.lib.connections.pipe;
import com.sun.star.comp.loader.FactoryHelper;
import com.sun.star.connection.ConnectionSetupException;
import com.sun.star.connection.NoConnectException;
import com.sun.star.connection.XConnection;
import com.sun.star.connection.XConnector;
import com.sun.star.lang.XMultiServiceFactory;
import com.sun.star.lang.XSingleServiceFactory;
import com.sun.star.registry.XRegistryKey;
/**
* A component that implements the XConnector
interface.
*
*
The pipeConnector
is a specialized component that uses TCP
* pipes for communication. The pipeConnector
is generally
* used by the com.sun.star.connection.Connector
service.
The JavaLoader
accesses 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(pipeConnector.class.getName())
? FactoryHelper.getServiceFactory(pipeConnector.class,
__serviceName, multiFactory,
regKey)
: null;
}
/**
* Connects via the described pipe to a waiting server.
*
* The connection description has the following format:
* type
*(key=value
),
* where type
should be pipe
* (ignoring case). Supported keys (ignoring case) currently are
host
* port
* 6001
).
* tcpnodelay
* 0
/1
) enabling or disabling Nagle's
* algorithm on the resulting connection.
* XConnection
to the server.
*
* @see com.sun.star.connection.XAcceptor
* @see com.sun.star.connection.XConnection
*/
public synchronized XConnection connect(String connectionDescription)
throws NoConnectException, ConnectionSetupException
{
if (bConnected)
throw new ConnectionSetupException("already connected");
try {
XConnection xConn = new PipeConnection( connectionDescription );
bConnected = true;
return xConn;
} catch ( java.io.IOException e ) {
throw new NoConnectException(e);
}
}
private boolean bConnected = false;
}
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */