/*
* JBoss, Home of Professional Open Source
* Copyright 2008, Red Hat, Inc., and others contributors as indicated
* by the @authors tag. All rights reserved.
* See the copyright.txt in the distribution for a
* full listing of individual contributors.
* This copyrighted material is made available to anyone wishing to use,
* modify, copy, or redistribute it subject to the terms and conditions
* of the GNU Lesser General Public License, v. 2.1.
* This program is distributed in the hope that it will be useful, but WITHOUT A
* WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
* PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
* You should have received a copy of the GNU Lesser General Public License,
* v.2.1 along with this distribution; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
* MA 02110-1301, USA.
*/
package org.jboss.narayana.blacktie.jatmibroker.jab.factory;
import java.util.HashMap;
import java.util.Map;
import org.jboss.narayana.blacktie.jatmibroker.core.conf.ConfigurationException;
import org.jboss.narayana.blacktie.jatmibroker.jab.JABException;
import org.jboss.narayana.blacktie.jatmibroker.jab.JABSession;
import org.jboss.narayana.blacktie.jatmibroker.jab.JABSessionAttributes;
import org.jboss.narayana.blacktie.jatmibroker.xatmi.Connection;
import org.jboss.narayana.blacktie.jatmibroker.xatmi.ConnectionFactory;
/**
* The connection factory is the entry point into the JAB API for client
* applications. It is a singleton class which is accessed via the
* JABConnectionFactory.getInstance() method. Connections obtained via the
* getConnection(String) method, should be closed via the
* closeConnection(String) method.
*/
public class JABConnectionFactory {
/**
* The instance
*/
private static JABConnectionFactory instance;
/**
* The list of open connections
*/
private Map<String, JABConnection> connections = new HashMap<String, JABConnection>();
private ConnectionFactory connectionFactory;
private JABSession session;
/**
* The constructor is not intended to be invoked by clients of the factory
*
* @throws JABException
* In case the connection factory cannot be created
*/
public JABConnectionFactory(String applicationName) throws JABException {
try {
connectionFactory = ConnectionFactory.getConnectionFactory();
} catch (ConfigurationException e) {
throw new JABException("Could not create the connection factory: "
+ e.getMessage(), e);
}
JABSessionAttributes attributes = new JABSessionAttributes();
session = new JABSession(attributes);
}
/**
* Obtain a reference to the connection identified by the parameter
*
* @param connectionName
* The name of the connection to retrieve
* @return The single connection named connectionName
* @throws JABException
* If the connection cannot be created
*/
public JABConnection getConnection(String connectionName)
throws JABException {
JABConnection toReturn = connections.get(connectionName);
if (toReturn == null) {
try {
Connection connection = connectionFactory.getConnection();
toReturn = new JABConnection(connection, session);
connections.put(connectionName, toReturn);
} catch (ConfigurationException e) {
throw new JABException(e.getMessage());
}
}
return toReturn;
}
/**
* Close the JAB connection to the server
*
* @param connectionName
* The name of the connection to close
* @throws JABException
* In case the connection cannot be closed
*/
public void closeConnection(String connectionName) throws JABException {
JABConnection connection = connections.remove(connectionName);
if (connection != null) {
connection.close();
}
}
}