パッケージ org.postgresql.core

インタフェース BaseConnection

すべてのスーパーインタフェース:
AutoCloseable, Connection, PGConnection, Wrapper
既知の実装クラスのリスト:
PgConnection

public interface BaseConnection extends PGConnection, Connection
Driver-internal connection interface. Application code should not use this interface.
  • メソッドの詳細

    • cancelQuery

      void cancelQuery() throws SQLException
      Cancel the current query executing on this connection.
      定義:
      cancelQuery インタフェース内 PGConnection
      例外:
      SQLException - if something goes wrong.
    • execSQLQuery

      ResultSet execSQLQuery(String s) throws SQLException
      Execute a SQL query that returns a single resultset. Never causes a new transaction to be started regardless of the autocommit setting.
      パラメータ:
      s - the query to execute
      戻り値:
      the (non-null) returned resultset
      例外:
      SQLException - if something goes wrong.
    • execSQLQuery

      ResultSet execSQLQuery(String s, int resultSetType, int resultSetConcurrency) throws SQLException
      例外:
      SQLException
    • execSQLUpdate

      void execSQLUpdate(String s) throws SQLException
      Execute a SQL query that does not return results. Never causes a new transaction to be started regardless of the autocommit setting.
      パラメータ:
      s - the query to execute
      例外:
      SQLException - if something goes wrong.
    • getQueryExecutor

      QueryExecutor getQueryExecutor()
      Get the QueryExecutor implementation for this connection.
      戻り値:
      the (non-null) executor
    • getReplicationProtocol

      ReplicationProtocol getReplicationProtocol()
      Internal protocol for work with physical and logical replication. Physical replication available only since PostgreSQL version 9.1. Logical replication available only since PostgreSQL version 9.4.
      戻り値:
      not null replication protocol
    • getObject

      Object getObject(String type, @Nullable String value, byte @Nullable [] byteValue) throws SQLException

      Construct and return an appropriate object for the given type and value. This only considers the types registered via PGConnection.addDataType(String, Class) and PGConnection.addDataType(String, String).

      If no class is registered as handling the given type, then a generic PGobject instance is returned.

      value or byteValue must be non-null

      パラメータ:
      type - the backend typename
      value - the type-specific string representation of the value
      byteValue - the type-specific binary representation of the value
      戻り値:
      an appropriate object; never null.
      例外:
      SQLException - if something goes wrong
    • getEncoding

      @Pure Encoding getEncoding() throws SQLException
      例外:
      SQLException
    • getTypeInfo

      TypeInfo getTypeInfo()
    • haveMinimumServerVersion

      boolean haveMinimumServerVersion(int ver)

      Check if we have at least a particular server version.

      The input version is of the form xxyyzz, matching a PostgreSQL version like xx.yy.zz. So 9.0.12 is 90012.

      パラメータ:
      ver - the server version to check, of the form xxyyzz eg 90401
      戻り値:
      true if the server version is at least "ver".
    • haveMinimumServerVersion

      boolean haveMinimumServerVersion(Version ver)

      Check if we have at least a particular server version.

      The input version is of the form xxyyzz, matching a PostgreSQL version like xx.yy.zz. So 9.0.12 is 90012.

      パラメータ:
      ver - the server version to check
      戻り値:
      true if the server version is at least "ver".
    • encodeString

      byte @PolyNull [] encodeString(@PolyNull String str) throws SQLException
      Encode a string using the database's client_encoding (usually UTF8, but can vary on older server versions). This is used when constructing synthetic resultsets (for example, in metadata methods).
      パラメータ:
      str - the string to encode
      戻り値:
      an encoded representation of the string
      例外:
      SQLException - if something goes wrong.
    • escapeString

      String escapeString(String str) throws SQLException
      Escapes a string for use as string-literal within an SQL command. The method chooses the applicable escaping rules based on the value of getStandardConformingStrings().
      パラメータ:
      str - a string value
      戻り値:
      the escaped representation of the string
      例外:
      SQLException - if the string contains a \0 character
    • getStandardConformingStrings

      boolean getStandardConformingStrings()
      Returns whether the server treats string-literals according to the SQL standard or if it uses traditional PostgreSQL escaping rules. Versions up to 8.1 always treated backslashes as escape characters in string-literals. Since 8.2, this depends on the value of the standard_conforming_strings server variable.
      戻り値:
      true if the server treats string literals according to the SQL standard
      関連項目:
    • getTimestampUtils

      @Deprecated TimestampUtils getTimestampUtils()
      推奨されていません。
    • getLogger

      Logger getLogger()
    • getStringVarcharFlag

      boolean getStringVarcharFlag()
    • getTransactionState

      TransactionState getTransactionState()
      Get the current transaction state of this connection.
      戻り値:
      current transaction state of this connection
    • binaryTransferSend

      boolean binaryTransferSend(int oid)
      Returns true if value for the given oid should be sent using binary transfer. False if value should be sent using text transfer.
      パラメータ:
      oid - The oid to check.
      戻り値:
      True for binary transfer, false for text transfer.
    • isColumnSanitiserDisabled

      boolean isColumnSanitiserDisabled()
      Return whether to disable column name sanitation.
      戻り値:
      true column sanitizer is disabled
    • addTimerTask

      void addTimerTask(TimerTask timerTask, long milliSeconds)
      Schedule a TimerTask for later execution. The task will be scheduled with the shared Timer for this connection.
      パラメータ:
      timerTask - timer task to schedule
      milliSeconds - delay in milliseconds
    • purgeTimerTasks

      void purgeTimerTasks()
      Invoke purge() on the underlying shared Timer so that internal resources will be released.
    • getFieldMetadataCache

      LruCache<FieldMetadata.Key,FieldMetadata> getFieldMetadataCache()
      Return metadata cache for given connection.
      戻り値:
      metadata cache
    • createQuery

      CachedQuery createQuery(String sql, boolean escapeProcessing, boolean isParameterized, String... columnNames) throws SQLException
      例外:
      SQLException
    • setFlushCacheOnDeallocate

      void setFlushCacheOnDeallocate(boolean flushCacheOnDeallocate)
      By default, the connection resets statement cache in case deallocate all/discard all message is observed. This API allows to disable that feature for testing purposes.
      パラメータ:
      flushCacheOnDeallocate - true if statement cache should be reset when "deallocate/discard" message observed
    • hintReadOnly

      boolean hintReadOnly()
      Indicates if statements to backend should be hinted as read only.
      戻り値:
      Indication if hints to backend (such as when transaction begins) should be read only.
      関連項目:
    • getXmlFactoryFactory

      PGXmlFactoryFactory getXmlFactoryFactory() throws SQLException
      Retrieve the factory to instantiate XML processing factories.
      戻り値:
      The factory to use to instantiate XML processing factories
      例外:
      SQLException - if the class cannot be found or instantiated.
    • getLogServerErrorDetail

      boolean getLogServerErrorDetail()
      Indicates if error details from server used in included in logging and exceptions.
      戻り値:
      true if should be included and passed on to other exceptions