Interface ServiceManager

All Known Subinterfaces:
BackupManager, MaintenanceManager, NBackupManager, StatisticsManager, TraceManager, UserManager
All Known Implementing Classes:
FBBackupManager, FBBackupManagerBase, FBMaintenanceManager, FBNBackupManager, FBServiceManager, FBStatisticsManager, FBStreamingBackupManager, FBTraceManager, FBUserManager

public interface ServiceManager
The base Firebird Service API functionality.
Author:
Roman Rokytskyy, Steven Jardine, Mark Rotteveel
  • Method Details

    • setCharSet

      void setCharSet(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

      String getCharSet()
    • setUser

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

      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(String password)
      Sets the password for the connection to the service manager.
      Parameters:
      password - for the connection to the service manager.
    • getPassword

      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(String database)
      Sets the database path for the connection to the service manager.
      Parameters:
      database - path for the connection to the service manager.
    • getDatabase

      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

      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(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

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

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

      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(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:
    • getLogger

      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(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 SQLException
      Obtains the server version through a service call.
      Returns:
      Parsed server version, or GDSServerVersion.INVALID_VERSION if parsing failed.
      Throws:
      SQLException - For errors connecting to the service manager.