public abstract class ConnectionFactory extends Object
Constructor and Description |
---|
ConnectionFactory() |
Modifier and Type | Method and Description |
---|---|
protected void |
closeStream(PGStream newStream)
Safely close the given stream.
|
static ProtocolConnection |
openConnection(HostSpec[] hostSpecs,
String user,
String database,
Properties info,
Logger logger)
Establishes and initializes a new connection.
|
abstract ProtocolConnection |
openConnectionImpl(HostSpec[] hostSpecs,
String user,
String database,
Properties info,
Logger logger)
Implementation of
openConnection(org.postgresql.util.HostSpec[], java.lang.String, java.lang.String, java.util.Properties, org.postgresql.core.Logger) for a particular protocol version. |
public static ProtocolConnection openConnection(HostSpec[] hostSpecs, String user, String database, Properties info, Logger logger) throws SQLException
If the "protocolVersion" property is specified, only that protocol version is tried. Otherwise, all protocols are tried in order, falling back to older protocols as necessary.
Currently, protocol versions 3 (7.4+) and 2 (pre-7.4) are supported.
hostSpecs
- at least one host and port to connect to; multiple elements for round-robin failoveruser
- the username to authenticate with; may not be null.database
- the database on the server to connect to; may not be null.info
- extra properties controlling the connection;
notably, "password" if present supplies the password to authenticate with.logger
- the logger to use for this connectionSQLException
- if the connection could not be established.public abstract ProtocolConnection openConnectionImpl(HostSpec[] hostSpecs, String user, String database, Properties info, Logger logger) throws SQLException
openConnection(org.postgresql.util.HostSpec[], java.lang.String, java.lang.String, java.util.Properties, org.postgresql.core.Logger)
for a particular protocol version.
Implemented by subclasses of ConnectionFactory
.hostSpecs
- at least one host and port to connect to; multiple elements for round-robin failoveruser
- the username to authenticate with; may not be null.database
- the database on the server to connect to; may not be null.info
- extra properties controlling the connection;
notably, "password" if present supplies the password to authenticate with.logger
- the logger to use for this connectionnull
if this protocol
version is not supported by the server.SQLException
- if the connection could not be established for a reason other
than protocol version incompatibility.protected void closeStream(PGStream newStream)
newStream
- The stream to close.Copyright © 2016 PostgreSQL Global Development Group. All rights reserved.