/*
* 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.comp.connections;
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 Connector
is a general component, that uses less general
* components (like com.sun.star.connection.socketConnector
) to
* implement its functionality.
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(Connector.class.getName())
? FactoryHelper.getServiceFactory(Connector.class, __serviceName,
multiFactory, regKey)
: null;
}
/**
* Constructs a new Connector
that uses the given service
* factory to create a specific XConnector
.
*
* @param serviceFactory the service factory to use.
*/
public Connector(XMultiServiceFactory serviceFactory) {
this.serviceFactory = serviceFactory;
}
/**
* Connects via the given connection type to a waiting server.
*
* The connection description has the following format:
* type
*(key=value
).
* The specific XConnector
implementation is instantiated
* through the service factory as
* com.sun.star.connection.typeConnector
(with
* type
in lower case).
XConnection
to the server.
*
* @see com.sun.star.connections.XAcceptor
* @see com.sun.star.connections.XConnection
*/
public synchronized XConnection connect(String connectionDescription)
throws NoConnectException, ConnectionSetupException
{
if (DEBUG) {
System.err.println("##### " + getClass().getName() + ".connect("
+ connectionDescription + ")");
}
if (connected) {
throw new ConnectionSetupException("already connected");
}
XConnection con
= ((XConnector) Implementation.getConnectionService(
serviceFactory, connectionDescription, XConnector.class,
"Connector")).connect(connectionDescription);
connected = true;
return con;
}
private static final boolean DEBUG = false;
private final XMultiServiceFactory serviceFactory;
private boolean connected = false;
}