User: d_jencks
Date: 01/11/20 10:35:30
Modified: src/xdocs jbossdocs.xml resource.xml
Removed: src/xdocs jdbc-database.xml
Log:
Added Sybase ConnectionFactoryLoader example and removed 2.4-specific db
documentation.
Revision Changes Path
3.1 +2 -26 manual/src/xdocs/jbossdocs.xml
Index: jbossdocs.xml
===================================================================
RCS file: /cvsroot/jboss/manual/src/xdocs/jbossdocs.xml,v
retrieving revision 3.0
retrieving revision 3.1
diff -u -r3.0 -r3.1
--- jbossdocs.xml 2001/11/18 20:10:57 3.0
+++ jbossdocs.xml 2001/11/20 18:35:29 3.1
@@ -1,12 +1,11 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Id: jbossdocs.xml,v 3.0 2001/11/18 20:10:57 gropi Exp $ -->
+<!-- $Id: jbossdocs.xml,v 3.1 2001/11/20 18:35:29 d_jencks Exp $ -->
<!DOCTYPE book SYSTEM "file:@oasis.docbook.xml.root@/docbookx.dtd" [
<!ENTITY preface.xml SYSTEM "preface.xml">
<!ENTITY jbossintro.xml SYSTEM "jbossintro.xml">
<!ENTITY cmp.xml SYSTEM "cmp.xml">
<!ENTITY customizingjaws.xml SYSTEM "customizingjaws.xml">
<!ENTITY advconfig.xml SYSTEM "advconfig.xml">
- <!ENTITY jdbc-database.xml SYSTEM "jdbc-database.xml">
<!ENTITY designnotes.xml SYSTEM "designnotes.xml">
<!ENTITY production.xml SYSTEM "production.xml">
<!ENTITY basicconfiguration.xml SYSTEM "basicconfiguration.xml">
@@ -14,7 +13,6 @@
<!ENTITY jbosssx.xml SYSTEM "jbosssx.xml">
<!ENTITY webconfig.xml SYSTEM "webconfig.xml">
<!ENTITY resource.xml SYSTEM "resource.xml">
- <!ENTITY howtomssql.xml SYSTEM "howto/howtomssql.xml">
<!ENTITY howtojmx.xml SYSTEM "howto/howtojmx.xml">
<!ENTITY howtotimer.xml SYSTEM "howto/howtotimer.xml">
<!ENTITY howtotimer.2.xml SYSTEM "howto/howtotimer.2.xml">
@@ -23,7 +21,6 @@
<!ENTITY howtojavamail.xml SYSTEM "howto/howtojavamail.xml">
<!ENTITY howtojbuilderdebug.xml SYSTEM "howto/howtojbuilderdebug.xml">
<!ENTITY howtoejx.xml SYSTEM "howto/howtoejx.xml">
- <!ENTITY howtojca.xml SYSTEM "howto/howtojca.xml">
<!ENTITY howtojndiexternal.xml SYSTEM "howto/howtojndi_external.xml">
<!ENTITY howtosocketfactories.xml SYSTEM "howto/howto_socketfactories.xml">
<!ENTITY howtojaxp.xml SYSTEM "howto/howtojaxp.xml">
@@ -48,7 +45,7 @@
<book>
<bookinfo>
- <title>JBoss 2.2+ Documentation</title>
+ <title>JBoss 3.0 Documentation</title>
<copyright>
<year>2000</year>
<year>2001</year>
@@ -61,26 +58,6 @@
&jbossintro.xml;
&basicconfiguration.xml;
&resource.xml;
-
- <chapter id="jdbc">
- <title>JDBC</title>
- <para>
- <author>
- <firstname>Aaron</firstname>
- <surname>Mulder</surname>
- </author>
- <email>[EMAIL PROTECTED]</email>
- <author>
- <firstname>Fernando</firstname>
- <surname>Garcia-Loygorri</surname>
- </author>
- <email>[EMAIL PROTECTED]</email>
- </para>
-
- &jdbc-database.xml;
- &howtomssql.xml;
- </chapter>
-
&cmp.xml;
&customizingjaws.xml;
&advconfig.xml;
@@ -117,7 +94,6 @@
&howtojaas.xml;
&howtojavamail.xml;
&howtoejx.xml;
- &howtojca.xml;
&howtojndiexternal.xml;
&howtosocketfactories.xml;
&howtojaxp.xml;
3.1 +59 -3 manual/src/xdocs/resource.xml
Index: resource.xml
===================================================================
RCS file: /cvsroot/jboss/manual/src/xdocs/resource.xml,v
retrieving revision 3.0
retrieving revision 3.1
diff -u -r3.0 -r3.1
--- resource.xml 2001/11/18 20:10:57 3.0
+++ resource.xml 2001/11/20 18:35:29 3.1
@@ -14,7 +14,7 @@
<section id="resource-intro-access">
<title>Access to Resource Managers</title>
<para>This chapter is primarily relevant to jboss 3.0 (rabbithole)</para>
- <para>In order for your ejbs to do much useful work, they will need to
communicate with a transactional resource manager such as a relational database,
transactional message queue, or other enterprise information system. Jboss now
supports all such communication using Resource Adapters following the jca 1.0
specification (NEED LINK). This technology provides a uniform way to combine the
application server's transaction management and connection pooling functionalities
with a resource adapter's ability to connect to and do work with a resource
manager.</para>
+ <para>In order for your ejbs to do much useful work, they will need to
communicate with a transactional resource manager such as a relational database,
transactional message queue, or other enterprise information system. Jboss now
supports all such communication using Resource Adapters following the <ulink url =
"http://java.sun.com/j2ee/connector/";><citetitle>jca 1.0
specification</citetitle></ulink>. This technology provides a uniform way to combine
the application server's transaction management and connection pooling functionalities
with a resource adapter's ability to connect to and do work with a resource
manager.</para>
<para>Jboss provides the ability to deploy any compliant resource adapter,
and connections from any adapter may be pooled by jboss, obtained from connection
factories bound in jndi, and used by client code. At the moment, however, only
connection factories implementing javax.sql.DataSource and connections implementing
java.sql.Connection may be used with CMP beans and JAWS to automate database
access.</para>
<para>Since few database vendors have supplied resource adapters for their
database products, the usual strategy for accessing relational databases consists of
using a generic resource adapter that wraps a jdbc driver into a jca resource adapter.
Jboss comes with two such adapters, one for jdbc 1 drivers without xa transaction
support, and one for jdbc 2 drivers implementing xa support with XADataSource and
XAConnection.</para>
<para>As well as providing a systematic, well thought out framework for
pooling and transaction control that can be used for relational databases, jca also
provides another specification ("cci") for connection factories and connections
unrelated to jdbc. An adaptor could use these to provide predefined access to stored
procedures in a relational database, or these could be used to access a message que,
or enterprise information system such as CICS or SAP. Although there are no
particular conceptual difficulties in using such resource adapters to automatically
manage persistence of CMP beans, support for this is not yet integrated into jboss.
</para>
@@ -248,7 +248,7 @@
<!-- -->
<!-- ===================================================================== -->
-<!-- $Id: resource.xml,v 3.0 2001/11/18 20:10:57 gropi Exp $ -->
+<!-- $Id: resource.xml,v 3.1 2001/11/20 18:35:29 d_jencks Exp $ -->
<server>
@@ -307,7 +307,7 @@
<!-- -->
<!-- ===================================================================== -->
-<!-- $Id: resource.xml,v 3.0 2001/11/18 20:10:57 gropi Exp $ -->
+<!-- $Id: resource.xml,v 3.1 2001/11/20 18:35:29 d_jencks Exp $ -->
<server>
@@ -345,6 +345,62 @@
</mbean>
</server>
+]]></programlisting>
+</para>
+ </section>
+ <section id="Sybase">
+ <title>Postgres</title>
+ <para>Here is a sample sybase-service.xml configuration file contributed by
+ <author>
+ <firstname>Peter</firstname>
+ <surname>Levart</surname>
+ </author>
+ <email>[EMAIL PROTECTED]</email>
+<programlisting><![CDATA[<?xml version="1.0" encoding="UTF-8"?>
+
+<server>
+
+ <!-- put jconn2.jar from the Sybase jConnect 5.x into the JBoss lib/ext
+directory !!! -->
+ <classpath archives="jconn2.jar"/>
+
+ <mbean code="org.jboss.resource.ConnectionFactoryLoader"
+ name="JBOSS-SYSTEM:service=ConnectionFactoryLoader,name=Sybase_J2EETEST">
+
+ <attribute
name="ManagedConnectionFactoryProperties">ConnectionURL=jdbc:sybase:Tds:vino:4100
+ DriverClass=com.sybase.jdbc2.jdbc.SybDriver
+ UserName=j2eetest
+ Password=j2eetest</attribute>
+
+ <attribute name="JndiName">Sybase_J2EETEST</attribute>
+
+ <attribute name="TransactionManagerName">java:/TransactionManager</attribute>
+
+ <mbean-ref name="ResourceAdapterName">JCA:service=RARDeployment,name=Minerva
+JDBC LocalTransaction ResourceAdapter</mbean-ref>
+ <mbean-ref
name="ConnectionManagerFactoryLoaderName">JCA:service=ConnectionManagerFactoryLoader,name=MinervaSharedLocalCMFactory</mbean-ref>
+
+ <attribute name="ConnectionManagerProperties">#
+ #Wed Aug 15 16:17:29 EDT 2001
+ MinSize=0
+ MaxSize=10
+ BlockingTimeoutMillis=5000
+ IdleTimeoutMinutes=30
+ CleanupIntervalMinutes=10
+ MaxIdleTimeoutPercent=1.0
+ </attribute>
+
+ <attribute name="PrincipalMappingClass">
+ org.jboss.resource.security.ManyToOnePrincipalMapping
+ </attribute>
+
+ <attribute name="PrincipalMappingProperties"/>
+
+ </mbean>
+
+</server>
+
+
]]></programlisting>
</para>
</section>
_______________________________________________
Jboss-development mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/jboss-development
