Skip to content

Commit c97a770

Browse files
author
Nirmala Sundarappa
committed
Checking in the code samples under JDBC
1 parent 8c4c981 commit c97a770

File tree

1 file changed

+2
-55
lines changed

1 file changed

+2
-55
lines changed

java/jdbc/Readme.md

Lines changed: 2 additions & 55 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ Oracle Database and explain use-cases to be considered while choosing the
2121
connection management strategy. The section below provides more details on
2222
specific connection management strategy.
2323

24-
============================================================================
24+
----
2525
## InternalT2Driver.sql & InternalT2Driver.java:
2626
The server-side Type 2 (T2S) driver (aka KPRB driver) is for Java in the
2727
database. It uses database session directly for accessing local data.
@@ -49,65 +49,12 @@ the user being proxied for.
4949
(c) CERTIFICATE:More encrypted way of passing the credentials of the user,
5050
who is to be proxied, to the database.
5151

52-
## UCPSample.java:
53-
Universal Connection Pool (UCP) is a client side connection pool. UCP
54-
furnishes a rich set of features to support scalability in single database
55-
instance as well as built-in features to support high-availability and
56-
scalability in RAC and Active Data Guard environments. UCP along with RAC,
57-
RAC One and ADG is a tested and certified combination for handling database
58-
failovers. Refer to this sample for using UCP and setting UCP properties
59-
such as `minPoolSize`, `maxPoolSize`, etc.
60-
61-
## UCPWithTimeoutProperties.java:
62-
UCP furnishes a set of TimeOut properties which can be used to tune
63-
performance. The sample demonstrates using some of UCP's important Timeout
64-
properties, such as `InactivityTimeout`, `AbandonedConnectionTimeout`,
65-
`TimeToLiveTimeout`, and `connectionWaitTimeout`. Each one of the UCP timeout
66-
property can be run independently. Refer to the sample for more details.
67-
68-
## UCPWebSessionAffinitySample.java:
69-
Web-Session Affinity is a scalability feature of UCP in RAC and Active Data
70-
Guard environment which attempts to allocate connections from the same RAC
71-
instance during the life of a Web application. UCP tries to do a best try
72-
effort, but, there is no guarantee to get a connection to the same instance.
73-
UCP Web-Session Affinity is used in applications which expect short lived
74-
connections to any database instance.
75-
76-
## UCPConnectionLabelingSample.java:
77-
Connection Labelling allows applications to set custom states ("labels")
78-
then retrieve connections based on these pre-set states thereby avoiding the
79-
cost of resetting these states. The sample uses `applyConnectionLabel()` to
80-
apply a connection label and retrieves a connection using `getConnection(label)`
81-
by specifying the created label.
82-
83-
## UCPConnectionHarvestingSample.java:
84-
UCP's Connection Harvesting allows UCP to pro-actively reclaim borrowed
85-
connections based on pool requirements at run-time, while still giving
86-
applications control over which borrowed connections should not be reclaimed.
87-
The sample uses `registerConnectionHarvestingCallback` to register a connection
88-
harvesting callback.
89-
90-
## UCPWithDRCPSample.java:
91-
Database Resident Connection Pool (DRCP) is the server side connection pool.
92-
DRCP should be used in a scenario when there are a number of middle tiers but
93-
the number of active connections is fairly less than the number of open
94-
connections.
95-
DRCP when used along with and Universal Connection Pool(UCP) as the client
96-
side connection pool improves the performance. The sample shows UCP with DRCP
97-
in action. The purpose of the client-side pooling mechanism is to maintain the
98-
connections to Connection Broker. Client-side connection pools must attach and
99-
detach connections to the connection broker through `attachServerConnection()`
100-
and `detachServerConnection()`. DRCP should be used in a scenario when there are
101-
a number of middle tiers but the number of active connections is fairly less
102-
than the number of open connections.
103-
10452
## DRCPSample.java:
10553
DRCP can be used with or without a client side connection pool.
10654
Either UCP or any other third party connection pool (eg., C3P0) can be used as
10755
client side pool. Note that, when UCP is used, it takes care of attaching and
10856
releasing server connections. There is no need to explicitly call
10957
`attachServerConnection()`/`detachServerConnection()` with UCP.
11058

111-
============================================================================
112-
59+
----
11360

0 commit comments

Comments
 (0)