com.sun.messaging.BasicConnectionFactory Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of mq-client Show documentation
The newest version!
/*
 * Copyright (c) 2000, 2020 Oracle and/or its affiliates. All rights reserved.
 * Copyright (c) 2021, 2022 Contributors to the Eclipse Foundation
 *
 * This program and the accompanying materials are made available under the
 * terms of the Eclipse Public License v. 2.0, which is available at
 * http://www.eclipse.org/legal/epl-2.0.
 *
 * This Source Code may also be made available under the following Secondary
 * Licenses when the conditions for such availability set forth in the
 * Eclipse Public License v. 2.0 are satisfied: GNU General Public License,
 * version 2 with the GNU Classpath Exception, which is available at
 * https://www.gnu.org/software/classpath/license.html.
 *
 * SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
 */

package com.sun.messaging;

import com.sun.messaging.jmq.jmsclient.ContainerType;
import com.sun.messaging.jmq.jmsclient.JMSContextImpl;
import com.sun.messaging.jmq.jmsclient.UnifiedConnectionImpl;
import com.sun.messaging.jmq.ClientConstants;
import java.util.Properties;
import jakarta.jms.*;

import java.io.IOException;

/**
 * A BasicConnectionFactory encapsulates OpenMQ specific configuration information for OpenMQ
 * ConnectionFactory objects and is used to create Connections with a OpenMQ Jakarta Messaging
 * provider.
 *
 * @see jakarta.jms.ConnectionFactory jakarta.jms.ConnectionFactory
 * @see com.sun.messaging.ConnectionConfiguration com.sun.messaging.ConnectionConfiguration
 */
public class BasicConnectionFactory extends com.sun.messaging.AdministeredObject implements jakarta.jms.ConnectionFactory {

    private static final long serialVersionUID = 8164883087551643143L;

    /** The default basename for AdministeredObject initialization */
    private static final String defaultsBase = "ConnectionFactory";

    /** The default Connection Handler classname for clients */
    private static final String DEFAULT_IMQ_CONNECTION_HANDLER = "com.sun.messaging.jmq.jmsclient.protocol.tcp.TCPStreamHandler";

    /** The default ConnectionHandler Label */
    private static final String DEFAULT_IMQ_CONNECTION_HANDLER_LABEL = "Connection Handler Classname";

    /** The default Username and Password for OpenMQ client authentication */
    private static final String DEFAULT_IMQ_USERNAME_PASSWORD = "guest";

    /** The default Username Label */
    private static final String DEFAULT_IMQ_USERNAME_LABEL = "Default Username";

    /** The default Password Label */
    private static final String DEFAULT_IMQ_PASSWORD_LABEL = "Default Password";

    /** The default Acknowledgement Timeout for responses from the MQ Message Service */
    private static final String DEFAULT_IMQ_ACKTIMEOUT = "0";

    /** The default Async Send Completion Wait Timeout */
    private static final String DEFAULT_IMQ_ASYNC_SEND_COMPLETION_WAIT_TIMEOUT = "180000";

    /** The default AckTimeout Label */
    private static final String DEFAULT_IMQ_ACKTIMEOUT_LABEL = "Acknowledgement Timeout";

    /** The default AsyncSendCompletionWaitTimeout Label */
    private static final String DEFAULT_IMQ_ASYNC_SEND_COMPLETION_WAIT_TIMEOUT_LABEL = "Async Send Completion Wait Timeout";

    /** The type of connections created */
    private transient String connectionType = ClientConstants.CONNECTIONTYPE_NORMAL;

    /**
     * Constructs a BasicConnectionFactory with the default configuration.
     *
     */
    public BasicConnectionFactory() {
        super(defaultsBase);
    }

    /**
     * Constructs a BasicConnectionFactory with the specified configuration.
     *
     */
    protected BasicConnectionFactory(String defaultsBase) {
        super(defaultsBase);
    }

    private void readObject(java.io.ObjectInputStream ois) throws IOException, ClassNotFoundException {
        ois.defaultReadObject();
        connectionType = ClientConstants.CONNECTIONTYPE_NORMAL;
    }

    /**
     * Creates a Connection with the default user identity. The default user identity is defined by the
     * ConnectionFactory properties imqDefaultUsername and
     * imqDefaultPassword
     *
     * @return a newly created Connection.
     *
     * @exception JMSException if a JMS error occurs.
     * @see ConnectionConfiguration#imqDefaultUsername
     * @see ConnectionConfiguration#imqDefaultPassword
     */
    @Override
    public Connection createConnection() throws JMSException {
        return createConnection(getProperty(ConnectionConfiguration.imqDefaultUsername), getProperty(ConnectionConfiguration.imqDefaultPassword));
    }

    /**
     * Creates a Connection with a specified user identity.
     *
     * @param username the caller's user name
     * @param password the caller's password
     *
     * @return a newly created connection.
     *
     * @exception JMSException if a JMS error occurs.
     */
    @Override
    public Connection createConnection(String username, String password) throws JMSException {
        return new UnifiedConnectionImpl(getCurrentConfiguration(), username, password, getConnectionType());
    }

    @Override
    public JMSContext createContext() {
        return new JMSContextImpl(this, getContainerType());
    }

    @Override
    public JMSContext createContext(String userName, String password) {
        return new JMSContextImpl(this, getContainerType(), userName, password);
    }

    @Override
    public JMSContext createContext(String userName, String password, int sessionMode) {
        return new JMSContextImpl(this, getContainerType(), userName, password, sessionMode);
    }

    @Override
    public JMSContext createContext(int sessionMode) {
        return new JMSContextImpl(this, getContainerType(), sessionMode);
    }

    protected static ContainerType getContainerType() {
        // this is overridden in the subtype XAConnectionFactory
        return ContainerType.JavaSE;
    }

    /**
     * Sets the type of connections created by this BasicConnectionFactory.
     *
     * @param type The type of connections created by this BasicConnectionFactory.
     */
    public final void setConnectionType(String type) {
        if (ClientConstants.CONNECTIONTYPE_ADMINKEY.equals(type) || ClientConstants.CONNECTIONTYPE_ADMIN.equals(type)) {
            connectionType = type;
        } else {
            connectionType = ClientConstants.CONNECTIONTYPE_NORMAL;
        }
    }

    /**
     * Returns the type of connections created by this BasicConnectionFactory.
     *
     * @return The type of connections created by this BasicConnectionFactory.
     */
    public final String getConnectionType() {
        // Protect against NPE if a BasicConnectionFactory Object is restored
        // using a non-standard way
        if (connectionType == null) {
            connectionType = ClientConstants.CONNECTIONTYPE_NORMAL;
        }
        return connectionType;
    }

    /**
     * Returns a pretty printed version of the provider specific information for this ConnectionFactory object.
     *
     * @return the pretty printed string.
     */
    @Override
    public String toString() {
        return ("Eclipse OpenMQ(tm) ConnectionFactory" + super.toString());
    }

    /**
     * Sets the minimum BasicConnectionFactory configuration defaults required to connect to the OpenMQ
     * Service.
     */
    @Override
    public void setDefaultConfiguration() {
        configuration = new Properties();
        configurationTypes = new Properties();
        configurationLabels = new Properties();

        configuration.put(ConnectionConfiguration.imqConnectionHandler, DEFAULT_IMQ_CONNECTION_HANDLER);
        configurationTypes.put(ConnectionConfiguration.imqConnectionHandler, AO_PROPERTY_TYPE_PROPERTYOWNER);
        configurationLabels.put(ConnectionConfiguration.imqConnectionHandler, DEFAULT_IMQ_CONNECTION_HANDLER_LABEL);

        configuration.put(ConnectionConfiguration.imqDefaultUsername, DEFAULT_IMQ_USERNAME_PASSWORD);
        configurationTypes.put(ConnectionConfiguration.imqDefaultUsername, AO_PROPERTY_TYPE_STRING);
        configurationLabels.put(ConnectionConfiguration.imqDefaultUsername, DEFAULT_IMQ_USERNAME_LABEL);

        configuration.put(ConnectionConfiguration.imqDefaultPassword, DEFAULT_IMQ_USERNAME_PASSWORD);
        configurationTypes.put(ConnectionConfiguration.imqDefaultPassword, AO_PROPERTY_TYPE_STRING);
        configurationLabels.put(ConnectionConfiguration.imqDefaultPassword, DEFAULT_IMQ_PASSWORD_LABEL);

        configuration.put(ConnectionConfiguration.imqAckTimeout, DEFAULT_IMQ_ACKTIMEOUT);
        configuration.put(ConnectionConfiguration.imqAsyncSendCompletionWaitTimeout, DEFAULT_IMQ_ASYNC_SEND_COMPLETION_WAIT_TIMEOUT);
        configurationTypes.put(ConnectionConfiguration.imqAckTimeout, AO_PROPERTY_TYPE_INTEGER);
        configurationTypes.put(ConnectionConfiguration.imqAsyncSendCompletionWaitTimeout, AO_PROPERTY_TYPE_LONG);
        configurationLabels.put(ConnectionConfiguration.imqAckTimeout, DEFAULT_IMQ_ACKTIMEOUT_LABEL);
        configurationLabels.put(ConnectionConfiguration.imqAsyncSendCompletionWaitTimeout, DEFAULT_IMQ_ASYNC_SEND_COMPLETION_WAIT_TIMEOUT_LABEL);
    }

}