Package org.postgresql.ds.common

Class BaseDataSource

    • Field Detail

      • LOGGER

        private static final java.util.logging.Logger LOGGER

      • serverNames

        private java.lang.String[] serverNames

      • databaseName

        private java.lang.String databaseName

      • user

        private java.lang.String user

      • password

        private java.lang.String password

      • portNumbers

        private int[] portNumbers

      • properties

        private java.util.Properties properties

    • Constructor Detail

      • BaseDataSource

        public BaseDataSource()

    • Method Detail

      • getConnection

        public java.sql.Connection getConnection()
                                  throws java.sql.SQLException
        Gets a connection to the PostgreSQL database. The database is identified by the DataSource properties serverName, databaseName, and portNumber. The user to connect as is identified by the DataSource properties user and password.
        Returns:
        A valid database connection.
        Throws:
        java.sql.SQLException - Occurs when the database connection cannot be established.

      • getConnection

        public java.sql.Connection getConnection​(java.lang.String user,
                                         java.lang.String password)
                                  throws java.sql.SQLException
        Gets a connection to the PostgreSQL database. The database is identified by the DataSource properties serverName, databaseName, and portNumber. The user to connect as is identified by the arguments user and password, which override the DataSource properties by the same name.
        Parameters:
        user - user
        password - password
        Returns:
        A valid database connection.
        Throws:
        java.sql.SQLException - Occurs when the database connection cannot be established.

      • getLogWriter

        public java.io.PrintWriter getLogWriter()
        This implementation don't use a LogWriter.
        Specified by:
        getLogWriter in interface javax.sql.CommonDataSource

      • setLogWriter

        public void setLogWriter​(java.io.PrintWriter printWriter)
        This implementation don't use a LogWriter.
        Specified by:
        setLogWriter in interface javax.sql.CommonDataSource
        Parameters:
        printWriter - Not used

      • getServerName

        @Deprecated
public java.lang.String getServerName()
        Deprecated.
        use getServerNames()
        Gets the name of the host the PostgreSQL database is running on.
        Returns:
        name of the host the PostgreSQL database is running on

      • getServerNames

        public java.lang.String[] getServerNames()
        Gets the name of the host(s) the PostgreSQL database is running on.
        Returns:
        name of the host(s) the PostgreSQL database is running on

      • setServerName

        @Deprecated
public void setServerName​(java.lang.String serverName)
        Deprecated.
        use setServerNames(String[])
        Sets the name of the host the PostgreSQL database is running on. If this is changed, it will only affect future calls to getConnection. The default value is localhost.
        Parameters:
        serverName - name of the host the PostgreSQL database is running on

      • setServerNames

        public void setServerNames​(java.lang.String[] serverNames)
        Sets the name of the host(s) the PostgreSQL database is running on. If this is changed, it will only affect future calls to getConnection. The default value is localhost.
        Parameters:
        serverNames - name of the host(s) the PostgreSQL database is running on

      • getDatabaseName

        public java.lang.String getDatabaseName()
        Gets the name of the PostgreSQL database, running on the server identified by the serverName property.
        Returns:
        name of the PostgreSQL database

      • setDatabaseName

        public void setDatabaseName​(java.lang.String databaseName)
        Sets the name of the PostgreSQL database, running on the server identified by the serverName property. If this is changed, it will only affect future calls to getConnection.
        Parameters:
        databaseName - name of the PostgreSQL database

      • getDescription

        public abstract java.lang.String getDescription()
        Gets a description of this DataSource-ish thing. Must be customized by subclasses.
        Returns:
        description of this DataSource-ish thing

      • getUser

        public java.lang.String getUser()
        Gets the user to connect as by default. If this is not specified, you must use the getConnection method which takes a user and password as parameters.
        Returns:
        user to connect as by default

      • setUser

        public void setUser​(java.lang.String user)
        Sets the user to connect as by default. If this is not specified, you must use the getConnection method which takes a user and password as parameters. If this is changed, it will only affect future calls to getConnection.
        Parameters:
        user - user to connect as by default

      • getPassword

        public java.lang.String getPassword()
        Gets the password to connect with by default. If this is not specified but a password is needed to log in, you must use the getConnection method which takes a user and password as parameters.
        Returns:
        password to connect with by default

      • setPassword

        public void setPassword​(java.lang.String password)
        Sets the password to connect with by default. If this is not specified but a password is needed to log in, you must use the getConnection method which takes a user and password as parameters. If this is changed, it will only affect future calls to getConnection.
        Parameters:
        password - password to connect with by default

      • getPortNumber

        @Deprecated
public int getPortNumber()
        Deprecated.
        use getPortNumbers()
        Gets the port which the PostgreSQL server is listening on for TCP/IP connections.
        Returns:
        The port, or 0 if the default port will be used.

      • getPortNumbers

        public int[] getPortNumbers()
        Gets the port(s) which the PostgreSQL server is listening on for TCP/IP connections.
        Returns:
        The port(s), or 0 if the default port will be used.

      • setPortNumber

        @Deprecated
public void setPortNumber​(int portNumber)
        Deprecated.
        use setPortNumbers(int[])
        Sets the port which the PostgreSQL server is listening on for TCP/IP connections. Be sure the -i flag is passed to postmaster when PostgreSQL is started. If this is not set, or set to 0, the default port will be used.
        Parameters:
        portNumber - port which the PostgreSQL server is listening on for TCP/IP

      • setPortNumbers

        public void setPortNumbers​(int[] portNumbers)
        Sets the port(s) which the PostgreSQL server is listening on for TCP/IP connections. Be sure the -i flag is passed to postmaster when PostgreSQL is started. If this is not set, or set to 0, the default port will be used.
        Parameters:
        portNumbers - port(s) which the PostgreSQL server is listening on for TCP/IP

      • getOptions

        public java.lang.String getOptions()
        Returns:
        command line options for this connection

      • setOptions

        public void setOptions​(java.lang.String options)
        Set command line options for this connection
        Parameters:
        options - string to set options to

      • getLoginTimeout

        public int getLoginTimeout()
        Specified by:
        getLoginTimeout in interface javax.sql.CommonDataSource
        Returns:
        login timeout
        See Also:
        PGProperty.LOGIN_TIMEOUT

      • setLoginTimeout

        public void setLoginTimeout​(int loginTimeout)
        Specified by:
        setLoginTimeout in interface javax.sql.CommonDataSource
        Parameters:
        loginTimeout - login timeout
        See Also:
        PGProperty.LOGIN_TIMEOUT

      • setConnectTimeout

        public void setConnectTimeout​(int connectTimeout)
        Parameters:
        connectTimeout - connect timeout
        See Also:
        PGProperty.CONNECT_TIMEOUT

      • setGssResponseTimeout

        public void setGssResponseTimeout​(int gssResponseTimeout)
        Parameters:
        gssResponseTimeout - gss response timeout
        See Also:
        PGProperty.GSS_RESPONSE_TIMEOUT

      • setSslResponseTimeout

        public void setSslResponseTimeout​(int sslResponseTimeout)
        Parameters:
        sslResponseTimeout - ssl response timeout
        See Also:
        PGProperty.SSL_RESPONSE_TIMEOUT

      • setProtocolVersion

        public void setProtocolVersion​(int protocolVersion)
        Parameters:
        protocolVersion - protocol version
        See Also:
        PGProperty.PROTOCOL_VERSION

      • setQuoteReturningIdentifiers

        public void setQuoteReturningIdentifiers​(boolean quoteIdentifiers)
        Parameters:
        quoteIdentifiers - indicate whether to quote identifiers
        See Also:
        PGProperty.QUOTE_RETURNING_IDENTIFIERS

      • setReceiveBufferSize

        public void setReceiveBufferSize​(int nbytes)
        Parameters:
        nbytes - receive buffer size
        See Also:
        PGProperty.RECEIVE_BUFFER_SIZE

      • setSendBufferSize

        public void setSendBufferSize​(int nbytes)
        Parameters:
        nbytes - send buffer size
        See Also:
        PGProperty.SEND_BUFFER_SIZE

      • setMaxSendBufferSize

        public void setMaxSendBufferSize​(int nbytes)
        Parameters:
        nbytes - send max buffer size
        See Also:
        PGProperty.MAX_SEND_BUFFER_SIZE

      • setPrepareThreshold

        public void setPrepareThreshold​(int count)
        Parameters:
        count - prepare threshold
        See Also:
        PGProperty.PREPARE_THRESHOLD

      • setPreparedStatementCacheQueries

        public void setPreparedStatementCacheQueries​(int cacheSize)
        Parameters:
        cacheSize - prepared statement cache size (number of statements per connection)
        See Also:
        PGProperty.PREPARED_STATEMENT_CACHE_QUERIES

      • setPreparedStatementCacheSizeMiB

        public void setPreparedStatementCacheSizeMiB​(int cacheSize)
        Parameters:
        cacheSize - statement cache size (number of megabytes per connection)
        See Also:
        PGProperty.PREPARED_STATEMENT_CACHE_SIZE_MIB

      • getDatabaseMetadataCacheFields

        public int getDatabaseMetadataCacheFields()
        Returns:
        database metadata cache fields size (number of fields cached per connection)
        See Also:
        PGProperty.DATABASE_METADATA_CACHE_FIELDS

      • setDatabaseMetadataCacheFields

        public void setDatabaseMetadataCacheFields​(int cacheSize)
        Parameters:
        cacheSize - database metadata cache fields size (number of fields cached per connection)
        See Also:
        PGProperty.DATABASE_METADATA_CACHE_FIELDS

      • setDatabaseMetadataCacheFieldsMiB

        public void setDatabaseMetadataCacheFieldsMiB​(int cacheSize)
        Parameters:
        cacheSize - database metadata cache fields size (number of megabytes per connection)
        See Also:
        PGProperty.DATABASE_METADATA_CACHE_FIELDS_MIB

      • setDefaultRowFetchSize

        public void setDefaultRowFetchSize​(int fetchSize)
        Parameters:
        fetchSize - default fetch size
        See Also:
        PGProperty.DEFAULT_ROW_FETCH_SIZE

      • setUnknownLength

        public void setUnknownLength​(int unknownLength)
        Parameters:
        unknownLength - unknown length
        See Also:
        PGProperty.UNKNOWN_LENGTH

      • setSocketTimeout

        public void setSocketTimeout​(int seconds)
        Parameters:
        seconds - socket timeout
        See Also:
        PGProperty.SOCKET_TIMEOUT

      • setCancelSignalTimeout

        public void setCancelSignalTimeout​(int seconds)
        Parameters:
        seconds - timeout that is used for sending cancel command
        See Also:
        PGProperty.CANCEL_SIGNAL_TIMEOUT

      • getCancelSignalTimeout

        public int getCancelSignalTimeout()
        Returns:
        timeout that is used for sending cancel command in seconds
        See Also:
        PGProperty.CANCEL_SIGNAL_TIMEOUT

      • setSsl

        public void setSsl​(boolean enabled)
        Parameters:
        enabled - if SSL is enabled
        See Also:
        PGProperty.SSL

      • getSsl

        public boolean getSsl()
        Returns:
        true if SSL is enabled
        See Also:
        PGProperty.SSL

      • setSslfactory

        public void setSslfactory​(java.lang.String classname)
        Parameters:
        classname - SSL factory class name
        See Also:
        PGProperty.SSL_FACTORY

      • getSslfactory

        public java.lang.String getSslfactory()
        Returns:
        SSL factory class name
        See Also:
        PGProperty.SSL_FACTORY

      • getSslMode

        public java.lang.String getSslMode()
        Returns:
        SSL mode
        See Also:
        PGProperty.SSL_MODE

      • setSslMode

        public void setSslMode​(java.lang.String mode)
        Parameters:
        mode - SSL mode
        See Also:
        PGProperty.SSL_MODE

      • setSslFactoryArg

        public void setSslFactoryArg​(java.lang.String arg)
        Parameters:
        arg - argument forwarded to SSL factory
        See Also:
        PGProperty.SSL_FACTORY_ARG

      • getSslHostnameVerifier

        public java.lang.String getSslHostnameVerifier()
        Returns:
        argument forwarded to SSL factory
        See Also:
        PGProperty.SSL_HOSTNAME_VERIFIER

      • setSslHostnameVerifier

        public void setSslHostnameVerifier​(java.lang.String className)
        Parameters:
        className - SSL hostname verifier
        See Also:
        PGProperty.SSL_HOSTNAME_VERIFIER

      • getSslCert

        public java.lang.String getSslCert()
        Returns:
        className SSL hostname verifier
        See Also:
        PGProperty.SSL_CERT

      • setSslCert

        public void setSslCert​(java.lang.String file)
        Parameters:
        file - SSL certificate
        See Also:
        PGProperty.SSL_CERT

      • getSslKey

        public java.lang.String getSslKey()
        Returns:
        SSL certificate
        See Also:
        PGProperty.SSL_KEY

      • setSslKey

        public void setSslKey​(java.lang.String file)
        Parameters:
        file - SSL key
        See Also:
        PGProperty.SSL_KEY

      • getSslRootCert

        public java.lang.String getSslRootCert()
        Returns:
        SSL root certificate
        See Also:
        PGProperty.SSL_ROOT_CERT

      • setSslRootCert

        public void setSslRootCert​(java.lang.String file)
        Parameters:
        file - SSL root certificate
        See Also:
        PGProperty.SSL_ROOT_CERT

      • setSslNegotiation

        public void setSslNegotiation​(java.lang.String sslNegotiation)
        Parameters:
        sslNegotiation - one of SSLNegotiation.POSTGRES or SSLNegotiation.DIRECT
        See Also:
        PGProperty.SSL_NEGOTIATION

      • getSslNegotiation

        public java.lang.String getSslNegotiation()
        Returns:
        SSL Negotiation scheme
        See Also:
        PGProperty.SSL_NEGOTIATION

      • getSslPassword

        public java.lang.String getSslPassword()
        Returns:
        SSL password
        See Also:
        PGProperty.SSL_PASSWORD

      • setSslPassword

        public void setSslPassword​(java.lang.String password)
        Parameters:
        password - SSL password
        See Also:
        PGProperty.SSL_PASSWORD

      • setSslPasswordCallback

        public void setSslPasswordCallback​(java.lang.String className)
        Parameters:
        className - SSL password callback class name
        See Also:
        PGProperty.SSL_PASSWORD_CALLBACK

      • setApplicationName

        public void setApplicationName​(java.lang.String applicationName)
        Parameters:
        applicationName - application name
        See Also:
        PGProperty.APPLICATION_NAME

      • setTargetServerType

        public void setTargetServerType​(java.lang.String targetServerType)
        Parameters:
        targetServerType - target server type
        See Also:
        PGProperty.TARGET_SERVER_TYPE

      • setLoadBalanceHosts

        public void setLoadBalanceHosts​(boolean loadBalanceHosts)
        Parameters:
        loadBalanceHosts - load balance hosts
        See Also:
        PGProperty.LOAD_BALANCE_HOSTS

      • setHostRecheckSeconds

        public void setHostRecheckSeconds​(int hostRecheckSeconds)
        Parameters:
        hostRecheckSeconds - host recheck seconds
        See Also:
        PGProperty.HOST_RECHECK_SECONDS

      • setTcpKeepAlive

        public void setTcpKeepAlive​(boolean enabled)
        Parameters:
        enabled - if TCP keep alive should be enabled
        See Also:
        PGProperty.TCP_KEEP_ALIVE

      • getTcpKeepAlive

        public boolean getTcpKeepAlive()
        Returns:
        true if TCP keep alive is enabled
        See Also:
        PGProperty.TCP_KEEP_ALIVE

      • setTcpNoDelay

        public void setTcpNoDelay​(boolean enabled)
        Parameters:
        enabled - if TCP no delay should be enabled
        See Also:
        PGProperty.TCP_NO_DELAY

      • getTcpNoDelay

        public boolean getTcpNoDelay()
        Returns:
        true if TCP no delay is enabled
        See Also:
        PGProperty.TCP_NO_DELAY

      • setBinaryTransfer

        public void setBinaryTransfer​(boolean enabled)
        Parameters:
        enabled - if binary transfer should be enabled
        See Also:
        PGProperty.BINARY_TRANSFER

      • getBinaryTransfer

        public boolean getBinaryTransfer()
        Returns:
        true if binary transfer is enabled
        See Also:
        PGProperty.BINARY_TRANSFER

      • setBinaryTransferEnable

        public void setBinaryTransferEnable​(java.lang.String oidList)
        Parameters:
        oidList - list of OIDs that are allowed to use binary transfer
        See Also:
        PGProperty.BINARY_TRANSFER_ENABLE

      • getBinaryTransferEnable

        public java.lang.String getBinaryTransferEnable()
        Returns:
        list of OIDs that are allowed to use binary transfer
        See Also:
        PGProperty.BINARY_TRANSFER_ENABLE

      • setBinaryTransferDisable

        public void setBinaryTransferDisable​(java.lang.String oidList)
        Parameters:
        oidList - list of OIDs that are not allowed to use binary transfer
        See Also:
        PGProperty.BINARY_TRANSFER_DISABLE

      • getBinaryTransferDisable

        public java.lang.String getBinaryTransferDisable()
        Returns:
        list of OIDs that are not allowed to use binary transfer
        See Also:
        PGProperty.BINARY_TRANSFER_DISABLE

      • getStringType

        public java.lang.String getStringType()
        Returns:
        string type
        See Also:
        PGProperty.STRING_TYPE

      • setStringType

        public void setStringType​(java.lang.String stringType)
        Parameters:
        stringType - string type
        See Also:
        PGProperty.STRING_TYPE

      • setDisableColumnSanitiser

        public void setDisableColumnSanitiser​(boolean disableColumnSanitiser)
        Parameters:
        disableColumnSanitiser - if column sanitizer should be disabled
        See Also:
        PGProperty.DISABLE_COLUMN_SANITISER

      • setCurrentSchema

        public void setCurrentSchema​(java.lang.String currentSchema)
        Parameters:
        currentSchema - current schema
        See Also:
        PGProperty.CURRENT_SCHEMA

      • getReadOnly

        public boolean getReadOnly()
        Returns:
        true if connection is readonly
        See Also:
        PGProperty.READ_ONLY

      • setReadOnly

        public void setReadOnly​(boolean readOnly)
        Parameters:
        readOnly - if connection should be readonly
        See Also:
        PGProperty.READ_ONLY

      • getReadOnlyMode

        public java.lang.String getReadOnlyMode()
        Returns:
        The behavior when set read only
        See Also:
        PGProperty.READ_ONLY_MODE

      • setReadOnlyMode

        public void setReadOnlyMode​(java.lang.String mode)
        Parameters:
        mode - the behavior when set read only
        See Also:
        PGProperty.READ_ONLY_MODE

      • setLogUnclosedConnections

        public void setLogUnclosedConnections​(boolean enabled)
        Parameters:
        enabled - true if driver should log unclosed connections
        See Also:
        PGProperty.LOG_UNCLOSED_CONNECTIONS

      • getLogServerErrorDetail

        public boolean getLogServerErrorDetail()
        Returns:
        true if driver should log include detail in server error messages
        See Also:
        PGProperty.LOG_SERVER_ERROR_DETAIL

      • setLogServerErrorDetail

        public void setLogServerErrorDetail​(boolean enabled)
        Parameters:
        enabled - true if driver should include detail in server error messages
        See Also:
        PGProperty.LOG_SERVER_ERROR_DETAIL

      • setAssumeMinServerVersion

        public void setAssumeMinServerVersion​(java.lang.String minVersion)
        Parameters:
        minVersion - assumed minimal server version
        See Also:
        PGProperty.ASSUME_MIN_SERVER_VERSION

      • getGroupStartupParameters

        @Deprecated
public boolean getGroupStartupParameters()
        Deprecated.
        since we can send the startup parameters as a multistatment transaction
        This is important in pool-by-transaction scenarios in order to make sure that all the statements reaches the same connection that is being initialized. If set then we will group the startup parameters in a transaction
        Returns:
        whether to group startup parameters or not
        See Also:
        PGProperty.GROUP_STARTUP_PARAMETERS

      • setGroupStartupParameters

        @Deprecated
public void setGroupStartupParameters​(boolean groupStartupParameters)
        Deprecated.
        since we can send the startup parameters as a multistatment transaction
        Parameters:
        groupStartupParameters - whether to group startup Parameters in a transaction or not
        See Also:
        PGProperty.GROUP_STARTUP_PARAMETERS

      • setJaasApplicationName

        public void setJaasApplicationName​(java.lang.String name)
        Parameters:
        name - JAAS application name
        See Also:
        PGProperty.JAAS_APPLICATION_NAME

      • getJaasLogin

        public boolean getJaasLogin()
        Returns:
        true if perform JAAS login before GSS authentication
        See Also:
        PGProperty.JAAS_LOGIN

      • setJaasLogin

        public void setJaasLogin​(boolean doLogin)
        Parameters:
        doLogin - true if perform JAAS login before GSS authentication
        See Also:
        PGProperty.JAAS_LOGIN

      • setGssUseDefaultCreds

        public void setGssUseDefaultCreds​(boolean gssUseDefaultCreds)
        Parameters:
        gssUseDefaultCreds - true if using default GSS credentials
        See Also:
        PGProperty.GSS_USE_DEFAULT_CREDS

      • setKerberosServerName

        public void setKerberosServerName​(java.lang.String serverName)
        Parameters:
        serverName - Kerberos server name
        See Also:
        PGProperty.KERBEROS_SERVER_NAME

      • getUseSpNego

        public boolean getUseSpNego()
        Returns:
        true if use SPNEGO
        See Also:
        PGProperty.USE_SPNEGO

      • setUseSpNego

        public void setUseSpNego​(boolean use)
        Parameters:
        use - true if use SPNEGO
        See Also:
        PGProperty.USE_SPNEGO

      • getGssLib

        public java.lang.String getGssLib()
        Returns:
        GSS mode: auto, sspi, or gssapi
        See Also:
        PGProperty.GSS_LIB

      • setGssLib

        public void setGssLib​(java.lang.String lib)
        Parameters:
        lib - GSS mode: auto, sspi, or gssapi
        See Also:
        PGProperty.GSS_LIB

      • getGssEncMode

        public java.lang.String getGssEncMode()
        Returns:
        GSS encryption mode: disable, prefer or require

      • setGssEncMode

        public void setGssEncMode​(java.lang.String mode)
        Parameters:
        mode - encryption mode: disable, prefer or require

      • setSspiServiceClass

        public void setSspiServiceClass​(java.lang.String serviceClass)
        Parameters:
        serviceClass - SSPI service class
        See Also:
        PGProperty.SSPI_SERVICE_CLASS

      • setAllowEncodingChanges

        public void setAllowEncodingChanges​(boolean allow)
        Parameters:
        allow - if connection allows encoding changes
        See Also:
        PGProperty.ALLOW_ENCODING_CHANGES

      • getSocketFactory

        public java.lang.String getSocketFactory()
        Returns:
        socket factory class name
        See Also:
        PGProperty.SOCKET_FACTORY

      • setSocketFactory

        public void setSocketFactory​(java.lang.String socketFactoryClassName)
        Parameters:
        socketFactoryClassName - socket factory class name
        See Also:
        PGProperty.SOCKET_FACTORY

      • setSocketFactoryArg

        public void setSocketFactoryArg​(java.lang.String socketFactoryArg)
        Parameters:
        socketFactoryArg - socket factory argument
        See Also:
        PGProperty.SOCKET_FACTORY_ARG

      • setReplication

        public void setReplication​(java.lang.String replication)
        Parameters:
        replication - set to 'database' for logical replication or 'true' for physical replication
        See Also:
        PGProperty.REPLICATION

      • setEscapeSyntaxCallMode

        public void setEscapeSyntaxCallMode​(java.lang.String callMode)
        Parameters:
        callMode - the call mode to use for JDBC escape call syntax
        See Also:
        PGProperty.ESCAPE_SYNTAX_CALL_MODE

      • getReplication

        public java.lang.String getReplication()
        Returns:
        null, 'database', or 'true
        See Also:
        PGProperty.REPLICATION

      • setLocalSocketAddress

        public void setLocalSocketAddress​(java.lang.String localSocketAddress)
        Parameters:
        localSocketAddress - local address to bind client side to
        See Also:
        PGProperty.LOCAL_SOCKET_ADDRESS

      • getLoggerLevel

        @Deprecated
public java.lang.String getLoggerLevel()
        Deprecated.
        Configure via java.util.logging
        This property is no longer used by the driver and will be ignored.
        Returns:
        loggerLevel in properties

      • setLoggerLevel

        @Deprecated
public void setLoggerLevel​(java.lang.String loggerLevel)
        Deprecated.
        Configure via java.util.logging
        This property is no longer used by the driver and will be ignored.
        Parameters:
        loggerLevel - loggerLevel to set, will be ignored

      • getLoggerFile

        @Deprecated
public java.lang.String getLoggerFile()
        Deprecated.
        Configure via java.util.logging
        This property is no longer used by the driver and will be ignored.
        Returns:
        loggerFile in properties

      • setLoggerFile

        @Deprecated
public void setLoggerFile​(java.lang.String loggerFile)
        Deprecated.
        Configure via java.util.logging
        This property is no longer used by the driver and will be ignored.
        Parameters:
        loggerFile - will be ignored

      • getChannelBinding

        public java.lang.String getChannelBinding()
        Returns:
        Channel binding option
        See Also:
        PGProperty.CHANNEL_BINDING

      • setChannelBinding

        public void setChannelBinding​(java.lang.String channelBinding)
        Parameters:
        channelBinding - Channel binding option
        See Also:
        PGProperty.CHANNEL_BINDING

      • getUrl

        public java.lang.String getUrl()
        Generates a DriverManager URL from the other properties supplied.
        Returns:
        DriverManager URL from the other properties supplied

      • getURL

        public java.lang.String getURL()
        Generates a DriverManager URL from the other properties supplied.
        Returns:
        DriverManager URL from the other properties supplied

      • setUrl

        public void setUrl​(java.lang.String url)
        Sets properties from a DriverManager URL.
        Parameters:
        url - properties to set

      • setURL

        public void setURL​(java.lang.String url)
        Sets properties from a DriverManager URL. Added to follow convention used in other DBMS.
        Parameters:
        url - properties to set

      • getAuthenticationPluginClassName

        public java.lang.String getAuthenticationPluginClassName()
        Returns:
        the class name to use for the Authentication Plugin. This can be null in which case the default password authentication plugin will be used

      • setAuthenticationPluginClassName

        public void setAuthenticationPluginClassName​(java.lang.String className)
        Parameters:
        className - name of a class which implements AuthenticationPlugin This class will be used to get the encoded bytes to be sent to the server as the password to authenticate the user.

      • getProperty

        public java.lang.String getProperty​(java.lang.String name)
                             throws java.sql.SQLException
        Throws:
        java.sql.SQLException

      • setProperty

        public void setProperty​(java.lang.String name,
                        java.lang.String value)
                 throws java.sql.SQLException
        Throws:
        java.sql.SQLException

      • getProperty

        public java.lang.String getProperty​(PGProperty property)

      • setProperty

        public void setProperty​(PGProperty property,
                        java.lang.String value)

      • createReference

        protected javax.naming.Reference createReference()
        Generates a reference using the appropriate object factory.
        Returns:
        reference using the appropriate object factory

      • getReference

        public javax.naming.Reference getReference()
                                    throws javax.naming.NamingException
        Specified by:
        getReference in interface javax.naming.Referenceable
        Throws:
        javax.naming.NamingException

      • setFromReference

        public void setFromReference​(javax.naming.Reference ref)

      • getReferenceProperty

        private static java.lang.String getReferenceProperty​(javax.naming.Reference ref,
                                                     java.lang.String propertyName)

      • writeBaseObject

        protected void writeBaseObject​(java.io.ObjectOutputStream out)
                        throws java.io.IOException
        Throws:
        java.io.IOException

      • readBaseObject

        protected void readBaseObject​(java.io.ObjectInputStream in)
                       throws java.io.IOException,
                              java.lang.ClassNotFoundException
        Throws:
        java.io.IOException
        java.lang.ClassNotFoundException

      • initializeFrom

        public void initializeFrom​(BaseDataSource source)
                    throws java.io.IOException,
                           java.lang.ClassNotFoundException
        Throws:
        java.io.IOException
        java.lang.ClassNotFoundException

      • setPreferQueryMode

        public void setPreferQueryMode​(PreferQueryMode preferQueryMode)
        Parameters:
        preferQueryMode - extended, simple, extendedForPrepared, or extendedCacheEverything
        See Also:
        PGProperty.PREFER_QUERY_MODE

      • getAutosave

        public AutoSave getAutosave()
        Returns:
        connection configuration regarding automatic per-query savepoints
        See Also:
        PGProperty.AUTOSAVE

      • setAutosave

        public void setAutosave​(AutoSave autoSave)
        Parameters:
        autoSave - connection configuration regarding automatic per-query savepoints
        See Also:
        PGProperty.AUTOSAVE

      • getCleanupSavepoints

        public boolean getCleanupSavepoints()
        see PGProperty#CLEANUP_SAVEPOINTS
        Returns:
        boolean indicating property set

      • setCleanupSavepoints

        public void setCleanupSavepoints​(boolean cleanupSavepoints)
        see PGProperty#CLEANUP_SAVEPOINTS
        Parameters:
        cleanupSavepoints - will cleanup savepoints after a successful transaction

      • getReWriteBatchedInserts

        public boolean getReWriteBatchedInserts()
        Returns:
        boolean indicating property is enabled or not.
        See Also:
        PGProperty.REWRITE_BATCHED_INSERTS

      • setReWriteBatchedInserts

        public void setReWriteBatchedInserts​(boolean reWrite)
        Parameters:
        reWrite - boolean value to set the property in the properties collection
        See Also:
        PGProperty.REWRITE_BATCHED_INSERTS

      • setHideUnprivilegedObjects

        public void setHideUnprivilegedObjects​(boolean hideUnprivileged)
        Parameters:
        hideUnprivileged - boolean value to set the property in the properties collection
        See Also:
        PGProperty.HIDE_UNPRIVILEGED_OBJECTS

      • getMaxResultBuffer

        public java.lang.String getMaxResultBuffer()

      • setMaxResultBuffer

        public void setMaxResultBuffer​(java.lang.String maxResultBuffer)

      • getAdaptiveFetch

        public boolean getAdaptiveFetch()

      • setAdaptiveFetch

        public void setAdaptiveFetch​(boolean adaptiveFetch)

      • getAdaptiveFetchMaximum

        public int getAdaptiveFetchMaximum()

      • setAdaptiveFetchMaximum

        public void setAdaptiveFetchMaximum​(int adaptiveFetchMaximum)

      • getAdaptiveFetchMinimum

        public int getAdaptiveFetchMinimum()

      • setAdaptiveFetchMinimum

        public void setAdaptiveFetchMinimum​(int adaptiveFetchMinimum)

      • getParentLogger

        public java.util.logging.Logger getParentLogger()
        Specified by:
        getParentLogger in interface javax.sql.CommonDataSource

      • getXmlFactoryFactory

        public java.lang.String getXmlFactoryFactory()

      • setXmlFactoryFactory

        public void setXmlFactoryFactory​(java.lang.String xmlFactoryFactory)

      • isSsl

        public boolean isSsl()

      • getSslfactoryarg

        public java.lang.String getSslfactoryarg()

      • setSslfactoryarg

        public void setSslfactoryarg​(java.lang.String arg)

      • getSslcert

        public java.lang.String getSslcert()

      • setSslcert

        public void setSslcert​(java.lang.String file)

      • getSslmode

        public java.lang.String getSslmode()

      • setSslmode

        public void setSslmode​(java.lang.String mode)

      • getSslhostnameverifier

        public java.lang.String getSslhostnameverifier()

      • setSslhostnameverifier

        public void setSslhostnameverifier​(java.lang.String className)

      • getSslkey

        public java.lang.String getSslkey()

      • setSslkey

        public void setSslkey​(java.lang.String file)

      • getSslrootcert

        public java.lang.String getSslrootcert()

      • setSslrootcert

        public void setSslrootcert​(java.lang.String file)

      • getSslpasswordcallback

        public java.lang.String getSslpasswordcallback()

      • setSslpasswordcallback

        public void setSslpasswordcallback​(java.lang.String className)

      • getSslpassword

        public java.lang.String getSslpassword()

      • setSslpassword

        public void setSslpassword​(java.lang.String sslpassword)

      • getRecvBufferSize

        public int getRecvBufferSize()

      • setRecvBufferSize

        public void setRecvBufferSize​(int nbytes)

      • isAllowEncodingChanges

        public boolean isAllowEncodingChanges()

      • isLogUnclosedConnections

        public boolean isLogUnclosedConnections()

      • isTcpKeepAlive

        public boolean isTcpKeepAlive()

      • isReadOnly

        public boolean isReadOnly()

      • isDisableColumnSanitiser

        public boolean isDisableColumnSanitiser()

      • isLoadBalanceHosts

        public boolean isLoadBalanceHosts()

      • isCleanupSavePoints

        public boolean isCleanupSavePoints()

      • setCleanupSavePoints

        public void setCleanupSavePoints​(boolean cleanupSavepoints)

      • isReWriteBatchedInserts

        public boolean isReWriteBatchedInserts()