Quadcap Embeddable Server

com/quadcap/services/DataSource.java

Go to the documentation of this file.

package com.quadcap.services;

/* Copyright 1999 - 2003 Quadcap Software.  All rights reserved.
 *
 * This software is distributed under the Quadcap Free Software License.
 * This software may be used or modified for any purpose, personal or
 * commercial.  Open Source redistributions are permitted.  Commercial
 * redistribution of larger works derived from, or works which bundle
 * this software requires a "Commercial Redistribution License"; see
 * http://www.quadcap.com/purchase.
 *
 * Redistributions qualify as "Open Source" under  one of the following terms:
 *   
 *    Redistributions are made at no charge beyond the reasonable cost of
 *    materials and delivery.
 *
 *    Redistributions are accompanied by a copy of the Source Code or by an
 *    irrevocable offer to provide a copy of the Source Code for up to three
 *    years at the cost of materials and delivery.  Such redistributions
 *    must allow further use, modification, and redistribution of the Source
 *    Code under substantially the same terms as this license.
 *
 * Redistributions of source code must retain the copyright notices as they
 * appear in each source code file, these license terms, and the
 * disclaimer/limitation of liability set forth as paragraph 6 below.
 *
 * Redistributions in binary form must reproduce this Copyright Notice,
 * these license terms, and the disclaimer/limitation of liability set
 * forth as paragraph 6 below, in the documentation and/or other materials
 * provided with the distribution.
 *
 * The Software is provided on an "AS IS" basis.  No warranty is
 * provided that the Software is free of defects, or fit for a
 * particular purpose.  
 *
 * Limitation of Liability. Quadcap Software shall not be liable
 * for any damages suffered by the Licensee or any third party resulting
 * from use of the Software.
 */

import java.io.PrintWriter;

import java.util.Properties;

import java.sql.Driver;
import java.sql.DriverManager;
import java.sql.SQLException;

import javax.naming.Reference;
import javax.naming.Referenceable;
import javax.naming.StringRefAddr;

/**
 * This class implements the <code>javax.sql.DataSource</code> interface,
 * which provides a mechanism for obtaining <code>Connection</code>
 * objects.
 *
 * @author Stan Bailes
 */
public class DataSource implements javax.sql.DataSource, Referenceable {
    String                      name;
    String                      driverClass = null;
    PrintWriter                 logWriter               = null;
    int                         loginTimeout            = 0;
    String                      url;
    Properties                  props                   = new Properties();
    Driver                      driver                  = null;

    /**
     * Default conctructor
     */
    public DataSource() {
    }

    public void setName(String name) {
        this.name = name;
    }

    public String getName() {
        return name;
    }

    public void setDriverClass(String s) {
        this.driverClass = s;
        try {
            Class.forName(driverClass);
        } catch (Throwable t) {
        }
    }

    public String getDriverClass() {
        return driverClass;
    }

    /**
     * Return the URL to which this data source is bound.
     */
    public String getUrl() { return url; }

    /**
     * Setter method for specifing this data source's URL.
     */
    public void setUrl(String url) {
        this.url = url;
    }

    /**
     * Add a connection property for this data source.
     *
     * @param name the connection property's name
     * @param val the connection property's value
     */
    public void addConnectionProperty(String name, String val) {
        props.setProperty(name, val);
    }

    /**
     * Get a new Connection bound to this data source.
     *
     * @return a new Connection
     * @exception SQLException may be thrown
     */
    public java.sql.Connection getConnection()
        throws SQLException
    {
        return getDriver().connect(url, props);
    }

    /**
     * Get a new Connection bound to this data source.
     *
     * @param username the database user for whom the connection is being
     *          made.
     * @param password the user's password.
     *
     * @return a new Connection
     * @exception SQLException may be thrown
     */
    public java.sql.Connection getConnection(String username, String password)
        throws SQLException
    {
        Properties p = new Properties(props);
        p.setProperty("user", username);
        p.setProperty("password", password);
        return getDriver().connect(url, p);
    }

    /**
     * Get the log writer for messages associated with this data source
     */
    public PrintWriter getLogWriter() {
        return logWriter;
    }

    /**
     * Set the log writer for debugging messages associated with this
     * data source.
     *
     * <p>Note: this writer isn't used for anything in this release
     * of QED.
     *
     * @param w the writer
     */
    public void setLogWriter(PrintWriter w) {
        this.logWriter = w;
    }

    /**
     * Get the login timeout.
     *
     * <p>Not implemented in this QED release.
     */
    public int getLoginTimeout() {
        return loginTimeout;
    }

    /**
     * Set the login timeout.
     *
     * <p>Not implemented in this QED release.
     *
     * @param timeout the timeout in seconds
     */
    public void setLoginTimeout(int timeout) {
        this.loginTimeout = timeout;
    }

    public Reference getReference() {
        Reference ref = new Reference(DataSource.class.getName(),
                                      "com.quadcap.services.DataSources",
                                      null);
        ref.add(new StringRefAddr("name", name));
        return ref;
    }

    final private Driver getDriver() throws SQLException {
        if (driver == null) {
            driver = DriverManager.getDriver(url);
        }
        return driver;
    }
}