Interface ServiceManager

    • Method Summary

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      java.lang.String getAuthPlugins()
      Get the list of authentication plugins to try.
      java.lang.String getCharSet()  
      java.lang.String getDatabase()
      Returns the database path for the connection to the service manager.
      java.lang.String getDbCryptConfig()
      Get the database encryption plugin configuration.
      java.lang.String getHost()
      Returns the host for the connection to the service manager.
      java.io.OutputStream getLogger()
      Returns the logger for the connection to the service manager.
      java.lang.String getPassword()
      Returns the password for the connection to the service manager.
      int getPort()
      Returns the port for the connection to the service manager.
      GDSServerVersion getServerVersion()
      Obtains the server version through a service call.
      java.lang.String getUser()
      Returns the username for the connection to the service manager.
      WireCrypt getWireCrypt()
      Get the wire encryption level.
      boolean isWireCompression()
      Get if wire compression should be enabled.
      void setAuthPlugins​(java.lang.String authPlugins)
      Sets the authentication plugins to try.
      void setCharSet​(java.lang.String charSet)
      Sets the encoding used for encoding or decoding string values.
      void setDatabase​(java.lang.String database)
      Sets the database path for the connection to the service manager.
      void setDbCryptConfig​(java.lang.String dbCryptConfig)
      Sets the database encryption plugin configuration.
      void setHost​(java.lang.String host)
      Sets the host for the connection to the service manager.
      void setLogger​(java.io.OutputStream logger)
      Sets the logger for the connection to the service manager.
      void setPassword​(java.lang.String password)
      Sets the password for the connection to the service manager.
      void setPort​(int port)
      Sets the port for the connection to the service manager.
      void setUser​(java.lang.String user)
      Sets the username for the connection to the service manager.
      void setWireCompression​(boolean wireCompression)
      Sets if the connection should try to enable wire compression.
      void setWireCrypt​(WireCrypt wireCrypt)
      Set the wire encryption level.
    • Method Detail

      • setCharSet

        void setCharSet​(java.lang.String charSet)
        Sets the encoding used for encoding or decoding string values.

        If not set (or null), defaults to the value of system property file.encoding/

        Parameters:
        charSet - Java charset name.
      • getCharSet

        java.lang.String getCharSet()
      • setUser

        void setUser​(java.lang.String user)
        Sets the username for the connection to the service manager.
        Parameters:
        user - for the connection to the service manager.
      • getUser

        java.lang.String getUser()
        Returns the username for the connection to the service manager.
        Returns:
        the username for the connection to the service manager.
      • setPassword

        void setPassword​(java.lang.String password)
        Sets the password for the connection to the service manager.
        Parameters:
        password - for the connection to the service manager.
      • getPassword

        java.lang.String getPassword()
        Returns the password for the connection to the service manager.
        Returns:
        the password for the connection to the service manager.
      • setDatabase

        void setDatabase​(java.lang.String database)
        Sets the database path for the connection to the service manager.
        Parameters:
        database - path for the connection to the service manager.
      • getDatabase

        java.lang.String getDatabase()
        Returns the database path for the connection to the service manager.
        Returns:
        the database path for the connection to the service manager.
      • getHost

        java.lang.String getHost()
        Returns the host for the connection to the service manager.
        Returns:
        the host for the connection to the service manager.
      • setHost

        void setHost​(java.lang.String host)
        Sets the host for the connection to the service manager.
        Parameters:
        host - for the connection to the service manager.
      • getPort

        int getPort()
        Returns the port for the connection to the service manager.
        Returns:
        the port for the connection to the service manager.
      • setPort

        void setPort​(int port)
        Sets the port for the connection to the service manager.
        Parameters:
        port - for the connection to the service manager.
      • getWireCrypt

        WireCrypt getWireCrypt()
        Get the wire encryption level.
        Returns:
        Wire encryption level
        Since:
        4.0
      • setWireCrypt

        void setWireCrypt​(WireCrypt wireCrypt)
        Set the wire encryption level.
        Parameters:
        wireCrypt - Wire encryption level (null not allowed)
        Since:
        4.0
      • getDbCryptConfig

        java.lang.String getDbCryptConfig()
        Get the database encryption plugin configuration.
        Returns:
        Database encryption plugin configuration, meaning plugin specific
        Since:
        3.0.4
      • setDbCryptConfig

        void setDbCryptConfig​(java.lang.String dbCryptConfig)
        Sets the database encryption plugin configuration.
        Parameters:
        dbCryptConfig - Database encryption plugin configuration, meaning plugin specific
        Since:
        3.0.4
      • getAuthPlugins

        java.lang.String getAuthPlugins()
        Get the list of authentication plugins to try.
        Returns:
        comma-separated list of authentication plugins, or null for driver default
        Since:
        4.0
      • setAuthPlugins

        void setAuthPlugins​(java.lang.String authPlugins)
        Sets the authentication plugins to try.

        Invalid names are skipped during authentication.

        Parameters:
        authPlugins - comma-separated list of authentication plugins, or null for driver default
        Since:
        4.0
      • isWireCompression

        boolean isWireCompression()
        Get if wire compression should be enabled.

        Wire compression requires Firebird 3 or higher, and the server must have the zlib library. If compression cannot be negotiated, the connection will be made without wire compression.

        This property will be ignored for native connections. For native connections, the configuration in firebird.conf read by the client library will be used.

        Returns:
        true wire compression enabled
        Since:
        4.0
      • setWireCompression

        void setWireCompression​(boolean wireCompression)
        Sets if the connection should try to enable wire compression.
        Parameters:
        wireCompression - true enable wire compression, false disable wire compression (the default)
        Since:
        4.0
        See Also:
        isWireCompression()
      • getLogger

        java.io.OutputStream getLogger()
        Returns the logger for the connection to the service manager.
        Returns:
        the logger for the connection to the service manager.
      • setLogger

        void setLogger​(java.io.OutputStream logger)
        Sets the logger for the connection to the service manager.
        Parameters:
        logger - for the connection to the service manager.
      • getServerVersion

        GDSServerVersion getServerVersion()
                                   throws java.sql.SQLException
        Obtains the server version through a service call.
        Returns:
        Parsed server version, or GDSServerVersion.INVALID_VERSION if parsing failed.
        Throws:
        java.sql.SQLException - For errors connecting to the service manager.