You are viewing a plain text version of this content. The canonical link for it is here.
Posted to derby-commits@db.apache.org by sc...@apache.org on 2007/04/27 22:24:41 UTC
svn commit: r533210 - in /db/derby/docs/trunk/src/ref: refderby.ditamap
rrefdmdfns1.dita rrefjta16677.dita rrefjta18596.dita rrefjta94396.dita
rrefsql9241891.dita
Author: scotsmatrix
Date: Fri Apr 27 13:24:40 2007
New Revision: 533210
URL: http://svn.apache.org/viewvc?view=rev&rev=533210
Log:
DERBY-1934: Updated URL for J2EE Compliance. Patch derby-1934_4.diff was submitted by me.
Modified:
db/derby/docs/trunk/src/ref/refderby.ditamap
db/derby/docs/trunk/src/ref/rrefdmdfns1.dita
db/derby/docs/trunk/src/ref/rrefjta16677.dita
db/derby/docs/trunk/src/ref/rrefjta18596.dita
db/derby/docs/trunk/src/ref/rrefjta94396.dita
db/derby/docs/trunk/src/ref/rrefsql9241891.dita
Modified: db/derby/docs/trunk/src/ref/refderby.ditamap
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/refderby.ditamap?view=diff&rev=533210&r1=533209&r2=533210
==============================================================================
--- db/derby/docs/trunk/src/ref/refderby.ditamap (original)
+++ db/derby/docs/trunk/src/ref/refderby.ditamap Fri Apr 27 13:24:40 2007
@@ -595,7 +595,7 @@
<topicref href="rrefattrib34183.dita" navtitle="Creating a connection without specifying attributes">
</topicref>
</topicref>
-<topicref collection-type="family" href="rrefjta16677.dita" navtitle="J2EE Compliance: Java Transaction API and javax.sql Extensions">
+<topicref collection-type="family" href="rrefjta16677.dita" navtitle="J2EE Compliance: Java Transaction API and javax.sql Interfaces">
<topicref href="rrefjta94396.dita" navtitle="JVM and libraries for J2EE features">
</topicref>
<topicref collection-type="family" href="rrefjta51021.dita" navtitle="The JTA API ">
@@ -606,7 +606,7 @@
</topicref>
</topicref>
</topicref>
-<topicref href="rrefjta18596.dita" navtitle="javax.sql: JDBC Extensions ">
+<topicref href="rrefjta18596.dita" navtitle="javax.sql: JDBC Interfaces">
</topicref>
</topicref>
<topicref collection-type="family" href="rrefapi10613.dita" navtitle="Derby API">
Modified: db/derby/docs/trunk/src/ref/rrefdmdfns1.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefdmdfns1.dita?view=diff&rev=533210&r1=533209&r2=533210
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefdmdfns1.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefdmdfns1.dita Fri Apr 27 13:24:40 2007
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
-<!--Arbortext, Inc., 1988-2006, v.4002-->
+
<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
"../dtd/reference.dtd">
<!--
Modified: db/derby/docs/trunk/src/ref/rrefjta16677.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefjta16677.dita?view=diff&rev=533210&r1=533209&r2=533210
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefjta16677.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefjta16677.dita Fri Apr 27 13:24:40 2007
@@ -1,4 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
+<!--Arbortext, Inc., 1988-2006, v.4002-->
<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
"../dtd/reference.dtd">
<!--
@@ -18,27 +19,36 @@
limitations under the License.
-->
<reference id="rrefjta16677" xml:lang="en-us">
-<title>J2EE Compliance: Java Transaction API and javax.sql Extensions</title>
+<title>J2EE Compliance: Java Transaction API and javax.sql Interfaces</title>
<prolog><metadata>
<keywords><indexterm>Resource manager<indexterm>Derby as a J2EE system</indexterm><indexterm>JNDI</indexterm><indexterm>javax.sql.DataSource</indexterm
-></indexterm><indexterm>Connection pooling</indexterm><indexterm>javax.sql. ConnectionPoolDataSource</indexterm>
-<indexterm>javax.sql.PooledConnection</indexterm></keywords>
+></indexterm><indexterm>Connection pooling</indexterm><indexterm>javax.sql.
+ConnectionPoolDataSource</indexterm><indexterm>javax.sql.PooledConnection</indexterm>
+<indexterm>XA</indexterm><indexterm>Distributed transaction management</indexterm>
+<indexterm>javax.sql.XAxxx interfaces</indexterm><indexterm>java.transaction.xa
+package</indexterm></keywords>
</metadata></prolog>
<refbody>
-<section><p>J2EE, or the Java 2 Platform, Enterprise Edition, is a standard for development of enterprise applications based on reusable components in a multi-tier environment. In addition to the features of the Java 2 Platform, Standard Edition (J2SE) J2EE adds support for Enterprise Java Beans (EJBs), Java Server Pages (JSPs), Servlets, XML and many more. The J2EE architecture is used to bring together existing technologies and enterprise applications in a single, manageable environment.</p></section>
+<section><p>J2EE, or the Java 2 Platform, Enterprise Edition, is a standard
+for development of enterprise applications based on reusable components in
+a multi-tier environment. In addition to the features of the Java 2 Platform,
+Standard Edition (J2SE) J2EE adds support for Enterprise Java Beans (EJBs),
+Java Server Pages (JSPs), Servlets, XML and many more. The J2EE architecture
+is used to bring together existing technologies and enterprise applications
+in a single, manageable environment.</p></section>
<section><p><ph conref="../conrefs.dita#prod/productshortname"></ph> is a
-J2EE-conformant component in a distributed J2EE system. As such, it is one
-part of a larger system that includes, among other things, a JNDI server,
+J2EE-conformant component in a distributed J2EE system. As such, <ph conref="refconrefs.dita#prod/productshortname"></ph> is
+one part of a larger system that includes, among other things, a JNDI server,
a connection pool module, a transaction manager, a resource manager, and user
applications. Within this system, <ph conref="../conrefs.dita#prod/productshortname"></ph> can
-serve as the resource manager.</p></section>
-<section><p>For more information on J2EE, see the J2EE specification available
-at <i><xref format="html" href="http://java.sun.com/j2ee/docs.html" scope="local">http://java.sun.com/j2ee/docs.html</xref></i>.</p></section>
-<section><p>In order to qualify as a resource manager in a J2EE system, J2EE
-requires these basic areas of support: <ul>
-<li>JNDI support. <p>Allows calling applications to register names for databases
+serve as the resource manager.</p><p>For more information on J2EE, see the
+J2EE specification available at <i><xref href="http://java.sun.com/javaee/reference/"
+scope="external">http://java.sun.com/javaee/reference/ </xref></i>.</p><p>In
+order to qualify as a resource manager in a J2EE system, J2EE requires these
+basic areas of support: <ul>
+<li>JNDI support<p>Allows calling applications to register names for databases
and access them through those names instead of through database connection
-URLs. Implementation of one of the JDBC extensions, <i><xref href="rrefjta18596.dita#rrefjta18596/jta20722">javax.sql.DataSource</xref>,</i> provides
+URLs. Implementation of one of the JDBC interfaces, <i><xref href="rrefjta18596.dita#rrefjta18596/jta20722">javax.sql.DataSource</xref>,</i> provides
this support.</p></li>
<li>Connection pooling <p>A mechanism by which a connection pool server keeps
a set of open connections to a resource manager (<ph conref="../conrefs.dita#prod/productshortname"></ph>).
@@ -46,11 +56,9 @@
the pool. Such a connection pool is useful in client/server environments because
establishing a connection is relatively expensive. In an embedded environment,
connections are much cheaper, making the performance advantage of a connection
-pool negligible. Implementation of two of the JDBC extensions, <i><xref href="rrefjta18596.dita#rrefjta18596/jta96573">javax.sql.ConnectionPoolDataSource
+pool negligible. Implementation of two of the JDBC interfaces, <i><xref href="rrefjta18596.dita#rrefjta18596/jta96573">javax.sql.ConnectionPoolDataSource
and javax.sql.PooledConnection</xref></i>, provide this support.</p></li>
-<li>XA support.<indexterm>XA</indexterm><indexterm>Distributed transaction
-management</indexterm><indexterm>javax.sql.XAxxx interfaces</indexterm><indexterm>java.transaction.xa
-package</indexterm> <p>XA is one of several standards for distributed transaction
+<li>XA support<p>XA is one of several standards for distributed transaction
management. It is based on two-phase commit. The <i>javax.sql.XAxxx</i> interfaces,
along with <i>java.transaction.xa</i> package, are an abstract implementation
of XA. For more information about XA, see <cite>X/Open CAE Specification-Distributed
@@ -61,9 +69,8 @@
href="rrefjta51021.dita#rrefjta51021/jta18387">javax.transaction.xa.XAResource</xref>,</i> <i><xref
href="rrefjta51021.dita#rrefjta51021/jta75105">javax.transaction.xa.Xid</xref>,</i> and <i><xref
href="rrefjta51021.dita#rrefjta51021/jta93666">javax.transaction.xa.XAException</xref></i>),
-provide this support.</p></li>
-</ul></p></section>
-<section><p>With the exception of the core JDBC interfaces, these interfaces
+provides this support.</p></li>
+</ul></p><p>With the exception of the core JDBC interfaces, these interfaces
are not visible to the end-user application; instead, they are used only by
the other back-end components in the system. <note>For information on the
classes that implement these interfaces and how to use <ph conref="../conrefs.dita#prod/productshortname"></ph> as
Modified: db/derby/docs/trunk/src/ref/rrefjta18596.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefjta18596.dita?view=diff&rev=533210&r1=533209&r2=533210
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefjta18596.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefjta18596.dita Fri Apr 27 13:24:40 2007
@@ -1,4 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
+<!--Arbortext, Inc., 1988-2006, v.4002-->
<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
"../dtd/reference.dtd">
<!--
@@ -18,41 +19,39 @@
limitations under the License.
-->
<reference id="rrefjta18596" xml:lang="en-us">
-<title>javax.sql: JDBC Extensions </title>
+<title>javax.sql: JDBC Interfaces</title>
<prolog><metadata>
<keywords><indexterm>javax.sql package</indexterm><indexterm>JDBC 2.0<indexterm>standard
-extensions</indexterm></indexterm>
-<indexterm>javax.sql.PooledConnection</indexterm><indexterm>Connection pooling</indexterm>
-<indexterm>javax.sql.DataSource</indexterm><indexterm>Data sources</indexterm>
-<indexterm>javax.sql.XAConnection</indexterm><indexterm>javax.sql.XADataSource</indexterm>
-<indexterm>Data sources<indexterm>creating a database for</indexterm></indexterm>
-<indexterm>Data sources<indexterm>shutting down a database for</indexterm></indexterm>
-</keywords>
+interfaces</indexterm></indexterm><indexterm>javax.sql.PooledConnection</indexterm>
+<indexterm>Connection pooling</indexterm><indexterm>javax.sql.DataSource</indexterm>
+<indexterm>Data sources</indexterm><indexterm>javax.sql.XAConnection</indexterm>
+<indexterm>javax.sql.XADataSource</indexterm><indexterm>Data sources<indexterm>creating
+a database for</indexterm></indexterm><indexterm>Data sources<indexterm>shutting
+down a database for</indexterm></indexterm></keywords>
</metadata></prolog>
<refbody>
-<section><p>This section documents the JDBC extensions that <ph conref="../conrefs.dita#prod/productshortname"></ph> implements
-for J2EE compliance. (For more details about these extensions, see the API documentation for your version of the Java Development Kit, which you can find at <xref format="html"
-href="http://java.sun.com/javase/reference/api.jsp"
-scope="external"><i>http://java.sun.com/javase/reference/api.jsp</i></xref>).
- <ul id="i1017905">
-<li><i id="jta20722">javax.sql.DataSource</i> <p><ph conref="../conrefs.dita#prod/productshortname"></ph>'s
-implementation of <i>DataSource</i> means that it supports JNDI; as a resource
-manager, it allows a database to be named and registered within a JNDI server.
-This allows the calling application to access the database by a name (as a
-data source) instead of through a database connection URL.</p></li>
-<li><i id="jta96573">javax.sql.ConnectionPoolDataSource and javax.sql.PooledConnection</i>
- <p>Establishing a connection to the database can be a relatively expensive
-operation in client/server environments. Establishing the connection once
-and then using the same connection for multiple requests can dramatically
-improve the performance of a database.</p> <p>The <ph conref="../conrefs.dita#prod/productshortname"></ph> implementation
-of <codeph>ConnectionPoolDataSource</codeph> and <codeph>PooledConnection</codeph> allows
-a connection pool server to maintain a set of such connections to the resource
-manager (<ph conref="../conrefs.dita#prod/productshortname"></ph>). In an
-embedded environment, connections are much cheaper and connection pooling
+<section><p>This section documents the JDBC interfaces that <ph conref="../conrefs.dita#prod/productshortname"></ph> implements
+for J2EE compliance. </p><p>For more details about these interfaces, see the
+API documentation for your version of the Java Development Kit, which you
+can find at <xref format="html" href="http://java.sun.com/javase/reference/api.jsp"
+scope="external">http://java.sun.com/javase/reference/api.jsp</xref>. <ul
+id="i1017905">
+<li><i id="jta20722">javax.sql.DataSource</i> <p>An interface that is a factory
+for connections to the physical data source that the object represents. An
+object that implements the DataSource interface will typically be registered
+with a naming service based on the Java Naming and Directory (JNDI) API.</p></li>
+<li><i id="jta96573">javax.sql.ConnectionPoolDataSource</i> and <i> javax.sql.PooledConnection</i> <p>Establishing
+a connection to the database can be a relatively expensive operation in client/server
+environments. Establishing the connection once and then using the same connection
+for multiple requests can dramatically improve the performance of a database.</p> <p>The <ph
+conref="../conrefs.dita#prod/productshortname"></ph> implementation of <codeph>ConnectionPoolDataSource</codeph> and <codeph>PooledConnection</codeph
+> interfaces allows a connection pool server to maintain a set of such connections
+to the resource manager (<ph conref="../conrefs.dita#prod/productshortname"></ph>).
+In an embedded environment, connections are much cheaper and connection pooling
is not necessary.</p></li>
<li id="i1018049"><i id="jta18170">javax.sql.XAConnection</i> <p>An <i>XAConnection</i> produces
-an <i>XAResource</i>, and, over its lifetime, many <i>Connections</i>. It
-allows for distributed transactions.</p></li>
+an <i>XAResource</i>, and, over its lifetime, many <i>Connections</i>. This
+type of connection allows for distributed transactions.</p></li>
<li id="i1018057"><i id="jta88962">javax.sql.XADataSource</i> <p>An <i>XADataSource</i> is
simply a <i>ConnectionPoolDataSource</i> that produces <i>XAConnections</i>.</p></li>
</ul></p></section>
Modified: db/derby/docs/trunk/src/ref/rrefjta94396.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefjta94396.dita?view=diff&rev=533210&r1=533209&r2=533210
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefjta94396.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefjta94396.dita Fri Apr 27 13:24:40 2007
@@ -1,4 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
+
+<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
@@ -15,19 +18,13 @@
See the License for the specific language governing permissions and
limitations under the License.
-->
-
-<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
- "../dtd/reference.dtd">
<reference id="rrefjta94396" xml:lang="en-us">
<title>JVM and libraries for J2EE features</title>
<refbody>
<section><p>These features require the following: <ul>
<li>Java 2 Platform, Standard Edition v 1.2 (J2SE) environment or greater </li>
-<li><i>javax.sql</i> libraries <p>The JDBC 2.0 standard extension binaries
-are available from <xref format="html" href="http://java.sun.com/products/jdbc/download.html"
-scope="local"><i>http://java.sun.com/products/jdbc/download.html</i></xref>.
-These libraries are part of the standard environment from Java 2 Platform,
-Standard Edition v 1.4 or later. </p></li>
+<li><i>javax.sql</i> libraries <p>These libraries are part of the standard
+environment from Java 2 Platform, Standard Edition v 1.4 or later. </p></li>
<li><i>javax.transaction.xa</i> libraries <p>These libraries are part of the
standard environment from Java 2 Platform, Standard Edition v 1.4 or later.</p> <p>For
the JTA libraries, see <xref format="html" href="http://java.sun.com/products/jta/"
@@ -37,4 +34,3 @@
</ul></p></section>
</refbody>
</reference>
-
Modified: db/derby/docs/trunk/src/ref/rrefsql9241891.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefsql9241891.dita?view=diff&rev=533210&r1=533209&r2=533210
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefsql9241891.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefsql9241891.dita Fri Apr 27 13:24:40 2007
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
-<!--Arbortext, Inc., 1988-2006, v.4002-->
+
<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
"../dtd/reference.dtd">
<!--