first commit for openGauss connector jdbc
This commit is contained in:
44
docs/documentation/94/datasource.md
Normal file
44
docs/documentation/94/datasource.md
Normal file
@ -0,0 +1,44 @@
|
||||
---
|
||||
layout: default_docs
|
||||
title: Chapter 11. Connection Pools and Data Sources
|
||||
header: Chapter 11. Connection Pools and Data Sources
|
||||
resource: media
|
||||
previoustitle: Chapter 10. Using the Driver in a Multithreaded or a Servlet Environment
|
||||
previous: thread.html
|
||||
nexttitle: Application Servers ConnectionPoolDataSource
|
||||
next: ds-cpds.html
|
||||
---
|
||||
|
||||
**Table of Contents**
|
||||
|
||||
* [Overview](datasource.html#ds-intro)
|
||||
* [Application Servers: `ConnectionPoolDataSource`](ds-cpds.html)
|
||||
* [Applications: `DataSource`](ds-ds.html)
|
||||
* [Tomcat setup](tomcat.html)
|
||||
* [Data Sources and JNDI](jndi.html)
|
||||
|
||||
JDBC 2 introduced standard connection pooling features in an add-on API known as
|
||||
the JDBC 2.0 Optional Package (also known as the JDBC 2.0 Standard Extension).
|
||||
These features have since been included in the core JDBC 3 API.
|
||||
|
||||
<a name="ds-intro"></a>
|
||||
# Overview
|
||||
|
||||
The JDBC API provides a client and a server interface for connection pooling.
|
||||
The client interface is `javax.sql.DataSource`, which is what application code
|
||||
will typically use to acquire a pooled database connection. The server interface
|
||||
is `javax.sql.ConnectionPoolDataSource`, which is how most application servers
|
||||
will interface with the PostgreSQL™ JDBC driver.
|
||||
|
||||
In an application server environment, the application server configuration will
|
||||
typically refer to the PostgreSQL™ `ConnectionPoolDataSource` implementation,
|
||||
while the application component code will typically acquire a `DataSource`
|
||||
implementation provided by the application server (not by PostgreSQL™).
|
||||
|
||||
For an environment without an application server, PostgreSQL™ provides two
|
||||
implementations of `DataSource` which an application can use directly. One
|
||||
implementation performs connection pooling, while the other simply provides
|
||||
access to database connections through the `DataSource` interface without any
|
||||
pooling. Again, these implementations should not be used in an application server
|
||||
environment unless the application server does not support the `ConnectionPoolDataSource`
|
||||
interface.
|
||||
Reference in New Issue
Block a user