Class Database

CodenameOne/src/com/codename1/db/Database.java:69–386

///
/// @author Chen
public abstract class Database {

    /// Checks if this platform supports custom database paths.  On platforms that
    /// support this, you can pass a file path to `#openOrCreate(java.lang.String)`, `#exists(java.lang.String)`,
    /// `#delete(java.lang.String)`, and `#getDatabasePath(java.lang.String)`.
    ///
    /// #### Returns
    ///
    /// True on platorms that support custom database paths.
    public static boolean isCustomPathSupported() {
        return Display.getInstance().isDatabaseCustomPathSupported();
    }

    private static void validateDatabaseNameArgument(String databaseName) {
        // PMD Fix (CollapsibleIfStatements): Merge the custom path support and separator checks into one condition.
        if (!isCustomPathSupported() && (databaseName.indexOf("/") != -1 || databaseName.indexOf("\\") != -1)) {
            throw new IllegalArgumentException("This platform does not support custom database paths.  The database name cannot contain file separators.");
        }
    }

    /// Opens a database or create one if not exists.
    ///
    /// #### Parameters
    ///
    /// - `databaseName`: @param databaseName the name of the database.  Platforms that support custom database
    ///                     paths (i.e. `#isCustomPathSupported()` return true), will also accept a file path here.
    ///
    /// #### Returns
    ///
    /// Database Object or null if not supported on the platform
    ///
    /// #### Throws
    ///
    /// - `IOException`: if database cannot be created
    public static Database openOrCreate(String databaseName) throws IOException {
        validateDatabaseNameArgument(databaseName);
        return Display.getInstance().openOrCreate(databaseName);
    }

    /// Indicates weather a database exists
    ///
    /// **NOTE:** Not supported in the  Javascript port.  Will always return false.
    ///
    /// #### Parameters
    ///
    /// - `databaseName`: @param databaseName the name of the database.  Platforms that support custom database
    ///                     paths (i.e. `#isCustomPathSupported()` return true), will also accept a file path here.
    ///
    /// #### Returns
    ///
    /// true if database exists
    public static boolean exists(String databaseName) {
        validateDatabaseNameArgument(databaseName);
        return Display.getInstance().exists(databaseName);
    }

    /// Deletes database
    ///