All Downloads are FREE. Search and download functionalities are using the official Maven repository.

org.sqlite.SQLiteDataSource Maven / Gradle / Ivy

There is a newer version: 3.46.1.0
Show newest version
/*--------------------------------------------------------------------------
 *  Copyright 2010 Taro L. Saito
 *
 *  Licensed 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
 *
 *  Unless required by applicable law or agreed to in writing, software
 *  distributed under the License is distributed on an "AS IS" BASIS,
 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *  See the License for the specific language governing permissions and
 *  limitations under the License.
 *--------------------------------------------------------------------------*/
//--------------------------------------
// sqlite-jdbc Project
//
// SQLiteDataSource.java
// Since: Mar 11, 2010
//
// $URL$ 
// $Author$
//--------------------------------------
package org.sqlite;

import org.sqlite.SQLiteConfig.*;

import javax.sql.DataSource;
import java.io.PrintWriter;
import java.sql.Connection;
import java.sql.SQLException;
import java.sql.SQLFeatureNotSupportedException;
import java.util.Properties;
import java.util.logging.Logger;

/**
 * Provides {@link DataSource} API for configuring SQLite database connection
 * 
 * @author leo
 * 
 */
public class SQLiteDataSource implements DataSource
{
    private SQLiteConfig          config;
    private transient PrintWriter logger;
    private int                   loginTimeout = 1;

    private String                url          = JDBC.PREFIX; // use memory database in default
    private String                databaseName = ""; // the name of the current database

    /**
     * Default constructor.
     */
    public SQLiteDataSource() {
        this.config = new SQLiteConfig(); // default configuration
    }

    /**
     * Creates a data source based on the provided configuration.
     * @param config The configuration for the data source.
     */
    public SQLiteDataSource(SQLiteConfig config) {
        this.config = config;
    }

    /**
     * Sets a data source's configuration.
     * @param config The configuration.
     */
    public void setConfig(SQLiteConfig config) {
        this.config = config;
    }

    /**
     * @return The configuration for the data source.
     */
    public SQLiteConfig getConfig() {
        return config;
    }

    /**
     * Sets the location of the database file.
     * @param url The location of the database file.
     */
    public void setUrl(String url) {
        this.url = url;
    }

    /**
     * @return The location of the database file.
     */
    public String getUrl() {
        return url;
    }

    /**
     * Sets the database name.
     * @param databaseName The name of the database
     */
    public void setDatabaseName(String databaseName) {
        this.databaseName = databaseName;
    }

    /**
     * @return The name of the database if one was set.
     * @see SQLiteDataSource#setDatabaseName(String)
     */
    public String getDatabaseName() {
        return databaseName;
    }

    /**
     * Enables or disables the sharing of the database cache and schema data
     * structures between connections to the same database. 
     * @param enable True to enable; false to disable.
     * @see http://www.sqlite.org/c3ref/enable_shared_cache.html
     */
    public void setSharedCache(boolean enable) {
        config.setSharedCache(enable);
    }

    /**
     * Enables or disables extension loading.
     * @param enable True to enable; false to disable.
     * @see http://www.sqlite.org/c3ref/load_extension.html
     */
    public void setLoadExtension(boolean enable) {
        config.enableLoadExtension(enable);
    }

    /**
     * Sets the database to be opened in read-only mode 
     * @param readOnly True to enable; false to disable.
     * @see http://www.sqlite.org/c3ref/c_open_autoproxy.html
     */
    public void setReadOnly(boolean readOnly) {
        config.setReadOnly(readOnly);
    }

    /**
     * Sets the suggested maximum number of database disk pages that SQLite will
     * hold in memory at once per open database file. 
     * @param numberOfPages The number of database disk pages.
     * @see http://www.sqlite.org/pragma.html#pragma_cache_size
     */
    public void setCacheSize(int numberOfPages) {
        config.setCacheSize(numberOfPages);
    }

    /**
     * Enables or disables case sensitivity for the built-in LIKE operator.
     * @param enable True to enable; false to disable.
     * @see http://www.sqlite.org/compile.html#case_sensitive_like
     */
    public void setCaseSensitiveLike(boolean enable) {
        config.enableCaseSensitiveLike(enable);
    }

    /**
     * Enables or disables the count-changes flag. When enabled INSERT, UPDATE
     * and DELETE statements return the number of rows they modified.
     * @param enable True to enable; false to disable.
     * @see http://www.sqlite.org/pragma.html#pragma_count_changes
     */
    public void setCouncChanges(boolean enable) {
        config.enableCountChanges(enable);
    }

    /**
     * Sets the default maximum number of database disk pages that SQLite will
     * hold in memory at once per open database file. 
     * @param numberOfPages The default suggested cache size.
     * @see http://www.sqlite.org/pragma.html#pragma_cache_size
     */
    public void setDefaultCacheSize(int numberOfPages) {
        config.setDefaultCacheSize(numberOfPages);
    }

    /**
     * Sets the text encoding used by the main database. 
     * @param encoding One of "UTF-8", "UTF-16le" (little-endian UTF-16)
     * or "UTF-16be" (big-endian UTF-16).
     * @see 
     * http://www.sqlite.org/pragma.html#pragma_encoding
     */
    public void setEncoding(String encoding) {
        config.setEncoding(Encoding.getEncoding(encoding));
    }

    /**
     * Enables or disables the enforcement of foreign key constraints. 
     * @param enforce True to enable; false to disable.
     * @see 
     * http://www.sqlite.org/pragma.html#pragma_foreign_keys
     */
    public void setEnforceForeinKeys(boolean enforce) {
        config.enforceForeignKeys(enforce);
    }

    /**
     * Enables or disables the full_column_names flag. This flag together with 
     * the short_column_names flag determine the way SQLite assigns names to
     * result columns of SELECT statements.
     * @param enable True to enable; false to disable.
     * @see http://www.sqlite.org/pragma.html#pragma_full_column_names
     */
    public void setFullColumnNames(boolean enable) {
        config.enableFullColumnNames(enable);
    }

    /**
     * Enables or disables the fullfsync flag. This flag determines whether or 
     * not the F_FULLFSYNC syncing method is used on systems that support it.
     * @param enable True to enable; false to disable.
     * @see http://www.sqlite.org/pragma.html#pragma_fullfsync
     */
    public void setFullSync(boolean enable) {
        config.enableFullSync(enable);
    }

    /**
     * Set the incremental_vacuum value that causes up to N pages to be removed
     * from the 
     * http://www.sqlite.org/fileformat2.html#freelist.
     * @param numberOfPagesToBeRemoved 
     * @see 
     * http://www.sqlite.org/pragma.html#pragma_incremental_vacuum
     */
    public void setIncrementalVacuum(int numberOfPagesToBeRemoved) {
        config.incrementalVacuum(numberOfPagesToBeRemoved);
    }

    /**
     * Sets the journal mode for databases associated with the current database
     * connection.
     * @param mode One of DELETE, TRUNCATE, PERSIST, MEMORY, WAL or OFF. 
     * @see 
     * http://www.sqlite.org/pragma.html#pragma_journal_mode
     */
    public void setJournalMode(String mode) {
        config.setJournalMode(JournalMode.valueOf(mode));
    }

    /**
     * Sets the limit of the size of rollback-journal and WAL files left in the
     * file-system after transactions or checkpoints.
     * @param limit The default journal size limit is -1 (no limit).
     * @see 
     * http://www.sqlite.org/pragma.html#pragma_journal_size_limit
     */
    public void setJournalSizeLimit(int limit) {
        config.setJounalSizeLimit(limit);
    }

    /**
     * Set the value of the legacy_file_format flag. When this flag is on, new
     * databases are created in a file format that is readable and writable by
     * all versions of SQLite going back to 3.0.0. When the flag is off, new
     * databases are created using the latest file format which might not be
     * readable or writable by versions of SQLite prior to 3.3.0.
     * @param use True to turn on; false to turn off.
     * @see http://www.sqlite.org/pragma.html#pragma_legacy_file_format
     */
    public void setLegacyFileFormat(boolean use) {
        config.useLegacyFileFormat(use);
    }

    /**
     * Sets the database connection locking-mode.
     * @param mode Either NORMAL or EXCLUSIVE.
     * @see 
     * http://www.sqlite.org/pragma.html#pragma_locking_mode
     */
    public void setLockingMode(String mode) {
        config.setLockingMode(LockingMode.valueOf(mode));
    }

    /**
     * Set the page size of the database.  
     * @param numBytes The page size must be a power of two between 512 and 65536 inclusive.
     * @see 
     * http://www.sqlite.org/pragma.html#pragma_page_size
     */
    public void setPageSize(int numBytes) {
        config.setPageSize(numBytes);
    }

    /**
     * Set the maximum number of pages in the database file.
     * @param numPages The maximum page count cannot be reduced below the current database size. 
     * @see 
     * http://www.sqlite.org/pragma.html#pragma_max_page_count
     */
    public void setMaxPageCount(int numPages) {
        config.setMaxPageCount(numPages);
    }

    /**
     * Set READ UNCOMMITTED isolation
     * @param useReadUncommitedIsolationMode True to turn on; false to turn off. 
     * @see http://www.sqlite.org/pragma.html#pragma_read_uncommitted
     */
    public void setReadUncommited(boolean useReadUncommitedIsolationMode) {
        config.setReadUncommited(useReadUncommitedIsolationMode);
    }

    /**
     * Enables or disables the recursive trigger capability. Changing the
     * recursive_triggers setting affects the execution of all statements
     * prepared using the database connection, including those prepared before
     * the setting was changed.
     * @param enable True to enable; fase to disable.
     * @see http://www.sqlite.org/pragma.html#pragma_recursive_triggers
     */
    public void setRecursiveTriggers(boolean enable) {
        config.enableRecursiveTriggers(enable);
    }

    /**
     * Enables or disables the reverse_unordered_selects flag. When enabled it
     * causes SELECT statements without an ORDER BY clause to emit their results
     * in the reverse order of what they normally would.
     * @param enable True to enable; fase to disable.
     * @see http://www.sqlite.org/pragma.html#pragma_reverse_unordered_selects
     */
    public void setReverseUnorderedSelects(boolean enable) {
        config.enableReverseUnorderedSelects(enable);
    }

    /**
     * Enables or disables the short_column_names flag. This flag affects the
     * way SQLite names columns of data returned by SELECT statements.
     * @param enable True to enable; fase to disable.
     * @see http://www.sqlite.org/pragma.html#pragma_short_column_names
     * @see http://www.sqlite.org/pragma.html#pragma_fullfsync
     */
    public void setShortColumnNames(boolean enable) {
        config.enableShortColumnNames(enable);
    }

    /**
     * Sets the setting of the "synchronous" flag.
     * @param mode One of OFF, NORMAL or FULL;
     * @see 
     * http://www.sqlite.org/pragma.html#pragma_synchronous
     */
    public void setSynchronous(String mode) {
        config.setSynchronous(SynchronousMode.valueOf(mode));
    }

    /**
     * Set the temp_store type which is used to determine where temporary tables
     * and indices are stored.
     * @param storeType One of "DEFAULT", "FILE", "MEMORY"
     * @see http://www.sqlite.org/pragma.html#pragma_temp_store
     */
    public void setTempStore(String storeType) {
        config.setTempStore(TempStore.valueOf(storeType));
    }

    /**
     * Set the value of the sqlite3_temp_directory global variable, which many
     * operating-system interface backends use to determine where to store
     * temporary tables and indices.
     * @param directoryName The temporary directory name.
     * @see http://www.sqlite.org/pragma.html#pragma_temp_store_directory
     */
    public void setTempStoreDirectory(String directoryName) {
        config.setTempStoreDirectory(directoryName);
    }

    /**
     * Sets the mode that will be used to start transactions for this database.
     * @param transactionMode One of DEFFERED, IMMEDIATE or EXCLUSIVE.
     * @see http://www.sqlite.org/lang_transaction.html
     */
    public void setTransactionMode(String transactionMode) {
        config.setTransactionMode(transactionMode);
    }

    /**
     * Sets the value of the user-version. It is a big-endian 32-bit signed
     * integer stored in the database header at offset 60. 
     * @param version
     * @see http://www.sqlite.org/pragma.html#pragma_schema_version
     */
    public void setUserVersion(int version) {
        config.setUserVersion(version);
    }

    // codes for the DataSource interface    

    /**
     * @see javax.sql.DataSource#getConnection()
     */
    public Connection getConnection() throws SQLException {
        return getConnection(null, null);
    }

    /**
     * @see javax.sql.DataSource#getConnection(java.lang.String, java.lang.String)
     */
    public Connection getConnection(String username, String password) throws SQLException {
        Properties p = config.toProperties();
        if (username != null)
            p.put("user", username);
        if (password != null)
            p.put("pass", password);
        return JDBC.createConnection(url, p);
    }

    /**
     * @see javax.sql.DataSource#getLogWriter()
     */
    public PrintWriter getLogWriter() throws SQLException {
        return logger;
    }

    /**
     * @see javax.sql.DataSource#getLoginTimeout()
     */
    public int getLoginTimeout() throws SQLException {
        return loginTimeout;
    }

    public Logger getParentLogger() throws SQLFeatureNotSupportedException {
        throw new SQLFeatureNotSupportedException("getParentLogger");
    }

    /**
     * @see javax.sql.DataSource#setLogWriter(java.io.PrintWriter)
     */
    public void setLogWriter(PrintWriter out) throws SQLException {
        this.logger = out;
    }

    /**
     * @see javax.sql.DataSource#setLoginTimeout(int)
     */
    public void setLoginTimeout(int seconds) throws SQLException {
        loginTimeout = seconds;
    }

    /**
     * Determines if this object wraps a given class.
     * @param iface The class to check.
     * @return True if it is an instance of the current class; false otherwise.
     * @throws SQLException
     */
    public boolean isWrapperFor(Class< ? > iface) throws SQLException {
        return iface.isInstance(this);
    }

    /**
     * Casts this object to the given class.
     * @param iface The class to cast to.
     * @return The casted class.
     * @throws SQLException
     */
    @SuppressWarnings("unchecked")
    public  T unwrap(Class iface) throws SQLException {
        return (T) this;
    }

}




© 2015 - 2024 Weber Informatics LLC | Privacy Policy