Debian Codegraph @

src/java/org/apache/commons/dbcp/managed/package.html

raw
1 <!--
2 Licensed to the Apache Software Foundation (ASF) under one or more
3 contributor license agreements. See the NOTICE file distributed with
4 this work for additional information regarding copyright ownership.
5 The ASF licenses this file to You under the Apache License, Version 2.0
6 (the "License"); you may not use this file except in compliance with
7 the License. You may obtain a copy of the License at
8
9 http://www.apache.org/licenses/LICENSE-2.0
10
11 Unless required by applicable law or agreed to in writing, software
12 distributed under the License is distributed on an "AS IS" BASIS,
13 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 See the License for the specific language governing permissions and
15 limitations under the License.
16 -->
17 <html>
18 <body>
19
20 <p>
21 This package provides support for pooling of ManagedConnections. A managed
22 connection is responsible for managing a database connection in a
23 transactional environment (typically called <i>Container Managed</i>).
24 A managed connection opperates like any other connection when no gloabal
25 transaction (a.k.a. XA transaction or JTA Transaction) is in progress.
26 When a global transaction is active a single physical connection to the
27 database is used by all ManagedConnections accessed in the scope of the
28 transaction. Connection sharing means that all data access during a
29 transaction has a consistent view of the database. When the global
30 transaction is committed or rolled back the enlisted connections are
31 committed or rolled back.
32 </p>
33
34 <p>
35 This package supports full XADataSources and non-XA data sources using
36 local transaction semantics. non-XA data sources commit and rollback as
37 part of the transaction but are not recoverable in the case of an error
38 because they do not implement the two-phase commit protocol.
39 </p>
40
41 </body>
42 </html>