ch.vorburger.mariadb4j.DBConfiguration Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of mariaDB4j-core Show documentation
There is a newer version: 3.1.0.3
/*
 * #%L
 * MariaDB4j
 * %%
 * Copyright (C) 2012 - 2014 Michael Vorburger
 * %%
 * 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.
 * #L%
 */
package ch.vorburger.mariadb4j;

import ch.vorburger.exec.ManagedProcessListener;
import java.util.List;
import java.util.function.Function;

/**
 * Enables passing in custom options when starting up the database server This is the analog to
 * my.cnf
 */
public interface DBConfiguration {

    /**
     * TCP Port to start DB server on.
     * @return returns port value
     **/
    int getPort();

    /**
     * UNIX Socket to start DB server on (ignored on Windows).
     * @return returns socket value
     **/
    String getSocket();

    /**
     * Where from on the classpath should the binaries be extracted to the file system.
     * @return null (not empty) if nothing should be extracted.
     */
    String getBinariesClassPathLocation();

    /**
     * Base directory where DB binaries are expected to be found.
     * @return returns base directory value
     **/
    String getBaseDir();

    String getLibDir();

    /**
     * Base directory for DB's actual data files.
     * @return returns data directory value
     **/
    String getDataDir();

    /**
     * Whether to delete the base and data directory on shutdown,
     * if it is in a temporary directory. NB: If you've set the
     * base and data directories to non temporary directories,
     * then they'll never get deleted.
     * @return returns value of isDeletingTemporaryBaseAndDataDirsOnShutdown
     */
    boolean isDeletingTemporaryBaseAndDataDirsOnShutdown();

    /**
     * Whether running on Windows (some start-up parameters are different).
     * @return returns boolean isWindows
     **/
    boolean isWindows();

    List getArgs();

    String getOSLibraryEnvironmentVarName();

    /**
     * Returns an instance of @ManagedProcessListener class.
     * @return Process callback when DB process is killed or is completed
     */
    ManagedProcessListener getProcessListener();

    /**
     * Whether to to "--skip-grant-tables".
     * @return returns boolean isSecurityDisabled value
     **/
    boolean isSecurityDisabled();

    /**
     * Returns default root password.
     *
     * @return default root password
     */
    String getDefaultRootPassword();

    /**
     * Returns driver class name.
     * @return driver class name
     */
    String getDriverClassName();

    String getURL(String dbName);

    static class Impl implements DBConfiguration {

        private final int port;
        private final String socket;
        private final String binariesClassPathLocation;
        private final String baseDir;
        private final String libDir;
        private final String dataDir;
        private final boolean isDeletingTemporaryBaseAndDataDirsOnShutdown;
        private final boolean isWindows;
        private final List args;
        private final String osLibraryEnvironmentVarName;
        private final ManagedProcessListener listener;
        private final boolean isSecurityDisabled;
        private final Function getURL;
        private final String defaultRootPassword;
        private final String driverClassName;

        Impl(int port, String socket, String binariesClassPathLocation, String baseDir, String libDir, String dataDir,
             boolean isWindows, List args, String osLibraryEnvironmentVarName, boolean isSecurityDisabled,
             boolean isDeletingTemporaryBaseAndDataDirsOnShutdown, Function getURL, ManagedProcessListener listener,
             String defaultRootPassword, String driverClassName) {
            super();
            this.port = port;
            this.socket = socket;
            this.binariesClassPathLocation = binariesClassPathLocation;
            this.baseDir = baseDir;
            this.libDir = libDir;
            this.dataDir = dataDir;
            this.isDeletingTemporaryBaseAndDataDirsOnShutdown = isDeletingTemporaryBaseAndDataDirsOnShutdown;
            this.isWindows = isWindows;
            this.args = args;
            this.osLibraryEnvironmentVarName = osLibraryEnvironmentVarName;
            this.isSecurityDisabled = isSecurityDisabled;
            this.getURL = getURL;
            this.listener = listener;
            this.defaultRootPassword = defaultRootPassword;
            this.driverClassName = driverClassName;
        }

        @Override
        public int getPort() {
            return port;
        }

        @Override
        public String getSocket() {
            return socket;
        }

        @Override
        public String getBinariesClassPathLocation() {
            return binariesClassPathLocation;
        }

        @Override
        public String getBaseDir() {
            return baseDir;
        }

        @Override
        public String getLibDir() {
            return libDir;
        }

        @Override
        public String getDataDir() {
            return dataDir;
        }

        @Override
        public boolean isDeletingTemporaryBaseAndDataDirsOnShutdown() {
            return isDeletingTemporaryBaseAndDataDirsOnShutdown;
        }

        @Override
        public boolean isWindows() {
            return isWindows;
        }

        @Override
        public List getArgs() {
            return args;
        }

        @Override
        public String getOSLibraryEnvironmentVarName() {
            return osLibraryEnvironmentVarName;
        }

        @Override
        public boolean isSecurityDisabled() {
            return isSecurityDisabled;
        }

        @Override
        public String getURL(String dbName) {
            return getURL.apply(dbName);
        }

        @Override
        public ManagedProcessListener getProcessListener() {
            return listener;
        }

        @Override
        public String getDefaultRootPassword() {
            return defaultRootPassword;
        }

        @Override
        public String getDriverClassName() {
            return driverClassName;
        }
    }

}