1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
|
/*-------------------------------------------------------------------------
*
* Copyright (c) 2004-2008, PostgreSQL Global Development Group
* Copyright (c) 2004, Open Cloud Limited.
*
* IDENTIFICATION
* $PostgreSQL: pgjdbc/org/postgresql/core/ConnectionFactory.java,v 1.9 2008/01/08 06:56:27 jurka Exp $
*
*-------------------------------------------------------------------------
*/
package org.postgresql.core;
import java.util.Properties;
import java.sql.SQLException;
import org.postgresql.util.PSQLException;
import org.postgresql.util.GT;
import org.postgresql.util.PSQLState;
/**
* Handles protocol-specific connection setup.
*
* @author Oliver Jowett (oliver@opencloud.com)
*/
public abstract class ConnectionFactory {
/**
* Protocol version to implementation instance map.
* If no protocol version is specified, instances are
* tried in order until an exception is thrown or a non-null
* connection is returned.
*/
private static final Object[][] versions = {
{ "3", new org.postgresql.core.v3.ConnectionFactoryImpl() },
{ "2", new org.postgresql.core.v2.ConnectionFactoryImpl() },
};
/**
* Establishes and initializes a new connection.
*<p>
* 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.
*<p>
* Currently, protocol versions 3 (7.4+) and 2 (pre-7.4) are supported.
*
* @param host the host to connect to
* @param port the port to connect to
* @param user the username to authenticate with; may not be null.
* @param database the database on the server to connect to; may not be null.
* @param info extra properties controlling the connection;
* notably, "password" if present supplies the password to authenticate with.
* @param logger the logger to use for this connection
* @return the new, initialized, connection
* @throws SQLException if the connection could not be established.
*/
public static ProtocolConnection openConnection(String host, int port, String user, String database, Properties info, Logger logger) throws SQLException {
String protoName = info.getProperty("protocolVersion");
for (int i = 0; i < versions.length; ++i)
{
String versionProtoName = (String) versions[i][0];
if (protoName != null && !protoName.equals(versionProtoName))
continue;
ConnectionFactory factory = (ConnectionFactory) versions[i][1];
ProtocolConnection connection = factory.openConnectionImpl(host, port, user, database, info, logger);
if (connection != null)
return connection;
}
throw new PSQLException(GT.tr("A connection could not be made using the requested protocol {0}.", protoName),
PSQLState.CONNECTION_UNABLE_TO_CONNECT);
}
/**
* Implementation of {@link #openConnection} for a particular protocol version.
* Implemented by subclasses of {@link ConnectionFactory}.
*
* @param host the host to connect to
* @param port the port to connect to
* @param user the username to authenticate with; may not be null.
* @param database the database on the server to connect to; may not be null.
* @param info extra properties controlling the connection;
* notably, "password" if present supplies the password to authenticate with.
* @param logger the logger to use for this connection
* @return the new, initialized, connection, or <code>null</code> if this protocol
* version is not supported by the server.
* @throws SQLException if the connection could not be established for a reason other
* than protocol version incompatibility.
*/
public abstract ProtocolConnection openConnectionImpl(String host, int port, String user, String database, Properties info, Logger logger) throws SQLException;
}
|
