db-derby-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From scotsmat...@apache.org
Subject svn commit: r533210 - in /db/derby/docs/trunk/src/ref: refderby.ditamap rrefdmdfns1.dita rrefjta16677.dita rrefjta18596.dita rrefjta94396.dita rrefsql9241891.dita
Date Fri, 27 Apr 2007 20:24:41 GMT
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">
 <!-- 



Mime
View raw message