User: allsopp
Date: 01/01/17 23:44:25
Modified: documentation HowTo.css jca_config.html
Log:
A little more documentation. Added an "attributes" table class in the css and
some padding in the colourful lists and footer.
Revision Changes Path
1.3 +20 -0 newsite/documentation/HowTo.css
Index: HowTo.css
===================================================================
RCS file: /products/cvs/ejboss/newsite/documentation/HowTo.css,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- HowTo.css 2001/01/16 05:55:12 1.2
+++ HowTo.css 2001/01/18 07:44:25 1.3
@@ -34,6 +34,8 @@
margin-top:1em;
margin-bottom:1em;
margin-right:0.1in;
+ padding:1em;
+ padding-bottom:1em;
background-color:lightskyblue;
}
DIV OL {
@@ -42,6 +44,8 @@
margin-top:1em;
margin-bottom:1em;
margin-right:0.5in;
+ padding-top:1em;
+ padding-bottom:1em;
background-color:khaki;
}
DIV UL {
@@ -50,6 +54,8 @@
margin-top:1em;
margin-bottom:1em;
margin-right:0.5in;
+ padding-top:1em;
+ padding-bottom:1em;
background-color:lightgreen;
}
DIV B {
@@ -81,4 +87,18 @@
H4 {
font-size:16pt;
margin-left:0.5in;
+}
+TABLE.attributes {
+ /*border:solid 1px;*/
+}
+TABLE.attributes CAPTION {
+ font-weight:bold;
+}
+TABLE.attributes TH {
+ border:solid 1px;
+ padding:1em;
+}
+TABLE.attributes TD {
+ border:solid 1px;
+ padding:1em;
}
1.4 +149 -28 newsite/documentation/jca_config.html
Index: jca_config.html
===================================================================
RCS file: /products/cvs/ejboss/newsite/documentation/jca_config.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- jca_config.html 2001/01/16 08:14:49 1.3
+++ jca_config.html 2001/01/18 07:44:25 1.4
@@ -21,9 +21,24 @@
page</a>.
</div>
- <h2>Terminology</h2>
+ <h2>Contents</h2>
<div class="para">
+ <ul>
+ <li><a href="#terminology">Terminology</a></li>
+
+ <li><a href="#configuration">JBoss Configuration</a></li>
+
+ <li><a href="#example">Example - Black Box Example Adapter from
+ Sun</a></li>
+
+ <li><a href="#status">Implementation Status</a></li>
+ </ul>
+ </div>
+
+ <h2><a name="terminology">Terminology</a></h2>
+
+ <div class="para">
<dl>
<dt>Resource</dt>
<dd>an external system that provides some service to
@@ -45,7 +60,7 @@
</dl>
</div>
- <h2>JBoss Configuration</h2>
+ <h2><a name="configuration">JBoss Configuration</a></h2>
<div class="para">
There are two steps that must be performed to provide access to
@@ -66,23 +81,23 @@
required. The format for this entry is as follows.</div>
<div class="code">
- <mbean code="org.jboss.resource.ConnectionFactoryLoader"
- name="J2EE:service=ConnectionFactoryLoader">
- <!-- General attributes -->
- <attribute name="name">value</attribute>
-
- <!-- Security attributes -->
- <attribute name="name">value</attribute>
-
- <!-- Connection pooling attributes -->
- <attribute name="name">value</attribute>
- </mbean>
+<mbean code="org.jboss.resource.ConnectionFactoryLoader"
+ name="J2EE:service=ConnectionFactoryLoader">
+ <!-- General attributes -->
+ <attribute name="name">value</attribute>
+
+ <!-- Security attributes -->
+ <attribute name="name">value</attribute>
+
+ <!-- Connection pooling attributes -->
+ <attribute name="name">value</attribute>
+</mbean>
</div>
<h4>General Attributes</h4>
<div class="para">
- <table border="1">
+ <table class="attributes">
<caption>General <code>ConnectionFactoryLoader</code> attributes</caption>
<thead>
<tr>
@@ -153,7 +168,7 @@
file.
</div>
- <h2>Example - BlackBox Example Adapter from Sun</h2>
+ <h2><a name="example">Example - Black Box Example Adapter from Sun</a></h2>
<div class="para">
For this example you will need Sun's example resource adapter,
@@ -181,21 +196,113 @@
following in <code>jboss.jcml</code>.
</div>
+ <div class="code">
+<mbean code="org.jboss.jdbc.RawXADataSourceLoader"
+ name="DefaultDomain:service=RawXADataSourceLoader,name=BlackBoxXADS">
+ <attribute name="PoolName">BlackBoxXADS</attribute>
+ <attribute
+
name="DataSourceClass">org.jboss.minerva.xa.XADataSourceImpl</attribute>
+ <attribute name="Properties">
+ URL=jdbc:HypersonicSQL:hsql://localhost:1476
+ </attribute>
+</mbean>
+ </div>
+
+ <div class="para">
+ The <code>RawXADataSourceLoader</code> MBean is very similar to
+ set up to the <code>XADataSourceImpl</code> MBean, but the
+ properties setting is slightly different.
+ </div>
+
+ <div class="para">
+ <table class="attributes">
+ <caption><code>RawXADataSourceLoader</code> attributes</caption>
+ <thead>
+ <tr><th>Name</th><th>Description</th></tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>PoolName</td> <td>The name of this XA data source. The
+ data source will be bound in JNDI
+ under this name, in the
+ <code>java:</code> namespace.</td>
+ </tr>
+ <tr>
+ <td>DataSourceClass</td> <td>The name of the class that
+ implements
+ <code>javax.sql.XADataSource</code>.
+ </td>
+ </tr>
+ <tr>
+ <td>Properties</td> <td>A collection of name=value pairs,
+ one on each line, that specifies
+ the attributes to set on the
+ <code>XADataSource</code>
+ instance. For each pair
+ <code>Name=Value</code>, the
+ method <code>setName(Value)</code>
+ will be called on the
+ <code>XADataSource</code>
+ instance. At the moment it is only
+ possible to set
+ <code>String</code>
+ attributes.<td>
+ </tr>
+ </tbody>
+ </table>
+ </div>
+
+ <div class="para">
+ Once the <code>XADataSource</code> is set up, we need to add the
+ <code>ConnectionFactoryLoader</code> MBean that will create the
+ connection factory from the resource adapter when it is
+ deployed. We will create a connection factory called
+ <code>BlackBoxDS</code> that will appear in JNDI at
+ <code>java:/BlackBoxDS</code>. Below is the MBean definition
+ that we will use.
+ </div>
+
<div class="code">
- <mbean code="org.jboss.jdbc.RawXADataSourceLoader"
- name="DefaultDomain:service=RawXADataSourceLoader,name=BlackBoxXADS">
- <attribute name="PoolName">BlackBoxXADS</attribute>
- <attribute
-
name="DataSourceClass">org.jboss.minerva.xa.XADataSourceImpl</attribute>
- <attribute name="Properties">
- URL=jdbc:HypersonicSQL:hsql://localhost:1476
- </attribute>
- </mbean>
+<mbean code="org.jboss.resource.ConnectionFactoryLoader"
+ name="J2EE:service=ConnectionFactoryLoader">
+ <attribute name="FactoryName">BlackBoxDS</attribute>
+ <attribute name="RARDeployerName">J2EE:service=RARDeployer</attribute>
+ <attribute name="ResourceAdapterName">Black Box XA Adapter</attribute>
+ <attribute
name="Properties">XADataSourceName=java:/BlackBoxXADS</attribute>
+
+ <!-- Principal mapping configuration -->
+ <attribute
name="PrincipalMappingClass">org.jboss.resource.security.ManyToOnePrincipalMapping</attribute>
+ <attribute name="PrincipalMappingProperties">
+ userName=sa
+ password=
+ </attribute>
+
+ <!-- Pool strategy - uncomment to force, otherwise it is automatic
+ <attribute name="PoolStrategy">Single</attribute>
+ -->
+
+ <!-- Connection pooling properties - see
+ org.jboss.minerva.pools.ObjectPool -->
+ <attribute name="MinSize">0</attribute>
+ <attribute name="MaxSize">10</attribute>
+ <attribute name="GCMinIdleTime">1200000</attribute>
+ <attribute name="GCEnabled">false</attribute>
+ <attribute name="InvalidateOnError">false</attribute>
+ <attribute name="TimestampUsed">false</attribute>
+ <attribute name="Blocking">true</attribute>
+ <attribute name="GCInterval">120000</attribute>
+ <attribute name="IdleTimeout">1800000</attribute>
+ <attribute name="IdleTimeoutEnabled">false</attribute>
+ <attribute name="LoggingEnabled">false</attribute>
+ <attribute name="MaxIdleTimeoutPercent">1.0</attribute>
+</mbean>
</div>
- <div class="para">TBD - see <code>jboss.jcml</code> for now.</div>
+ <div class="para">
+ The general attributes should be self explanatory.
+ </div>
- <h2>Implementation Status</h2>
+ <h2><a name="status">Implementation Status</a></h2>
<div class="para">
<em>Note that this section is likely to lag the latest
@@ -220,11 +327,25 @@
<div class="footer">
Author: <a href="mailto:[EMAIL PROTECTED]">Toby Allsopp</a><br/>
- Revision: $Id: jca_config.html,v 1.3 2001/01/16 08:14:49 allsopp Exp $
+ Revision: $Id: jca_config.html,v 1.4 2001/01/18 07:44:25 allsopp Exp $
</div>
</div></body>
</html>
<!-- LocalWords: PRE EE HowTo css JCA JDBC JNDI MBean ConnectionFactoryLoader
+ -->
+<!-- LocalWords: TBD URL RAR RAR CVS href foo mbean FactoryName JBoss XA
+ -->
+<!-- LocalWords: RARDeployerName ResourceAdapterName DefaultDomain BlackBoxDS
+ -->
+<!-- LocalWords: RawXADataSourceLoader BlackBoxXADS DataSourceClass userName
+ -->
+<!-- LocalWords: RARDeployer XADataSourceName PrincipalMappingClass MinSize
+ -->
+<!-- LocalWords: PrincipalMappingProperties PoolStrategy MaxSize GCEnabled
+ -->
+<!-- LocalWords: GCMinIdleTime InvalidateOnError TimestampUsed GCInterval
+ -->
+<!-- LocalWords: IdleTimeout IdleTimeoutEnabled LoggingEnabled
-->
-<!-- LocalWords: TBD URL RAR RAR CVS
+<!-- LocalWords: MaxIdleTimeoutPercent
-->
