User: fleury
Date: 01/02/07 21:31:46
Modified: minerva deprecated-list.html help-doc.html index-all.html
minerva.htm overview-frame.html
overview-summary.html overview-tree.html
serialized-form.html
Log:
jBoss -> JBoss
Revision Changes Path
1.2 +2 -2 newsite/minerva/deprecated-list.html
Index: deprecated-list.html
===================================================================
RCS file: /products/cvs/ejboss/newsite/minerva/deprecated-list.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- deprecated-list.html 2000/11/12 20:34:24 1.1
+++ deprecated-list.html 2001/02/08 05:31:45 1.2
@@ -27,7 +27,7 @@
</tr>
</table>
</td>
- <td align="right" valign="top" rowspan="3"><em>Part of
the <a href="http://www.jboss.org/" target="_top">jBoss Project</a></em></td>
+ <td align="right" valign="top" rowspan="3"><em>Part of
the <a href="http://www.jboss.org/" target="_top">JBoss Project</a></em></td>
</tr>
<tr>
<td bgcolor="white" class="NavBarCell2"><font
size="-2"> PREV NEXT</font></td>
@@ -59,7 +59,7 @@
</tr>
</table>
</td>
- <td align="right" valign="top" rowspan="3"><em>Part of
the <a href="http://www.jboss.org/" target="_top">jBoss Project</a></em></td>
+ <td align="right" valign="top" rowspan="3"><em>Part of
the <a href="http://www.jboss.org/" target="_top">JBoss Project</a></em></td>
</tr>
<tr>
<td bgcolor="white" class="NavBarCell2"><font
size="-2"> PREV NEXT</font></td>
1.2 +2 -2 newsite/minerva/help-doc.html
Index: help-doc.html
===================================================================
RCS file: /products/cvs/ejboss/newsite/minerva/help-doc.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- help-doc.html 2000/11/12 20:34:24 1.1
+++ help-doc.html 2001/02/08 05:31:45 1.2
@@ -27,7 +27,7 @@
</tr>
</table>
</td>
- <td align="right" valign="top" rowspan="3"><em>Part of
the <a href="http://www.jboss.org/" target="_top">jBoss Project</a></em></td>
+ <td align="right" valign="top" rowspan="3"><em>Part of
the <a href="http://www.jboss.org/" target="_top">JBoss Project</a></em></td>
</tr>
<tr>
<td bgcolor="white" class="NavBarCell2"><font
size="-2"> PREV NEXT</font></td>
@@ -116,7 +116,7 @@
</tr>
</table>
</td>
- <td align="right" valign="top" rowspan="3"><em>Part of
the <a href="http://www.jboss.org/" target="_top">jBoss Project</a></em></td>
+ <td align="right" valign="top" rowspan="3"><em>Part of
the <a href="http://www.jboss.org/" target="_top">JBoss Project</a></em></td>
</tr>
<tr>
<td bgcolor="white" class="NavBarCell2"><font
size="-2"> PREV NEXT</font></td>
1.2 +2 -2 newsite/minerva/index-all.html
Index: index-all.html
===================================================================
RCS file: /products/cvs/ejboss/newsite/minerva/index-all.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- index-all.html 2000/11/12 20:34:36 1.1
+++ index-all.html 2001/02/08 05:31:45 1.2
@@ -27,7 +27,7 @@
</tr>
</table>
</td>
- <td align="right" valign="top" rowspan="3"><em>Part of
the <a href="http://www.jboss.org/" target="_top">jBoss Project</a></em></td>
+ <td align="right" valign="top" rowspan="3"><em>Part of
the <a href="http://www.jboss.org/" target="_top">JBoss Project</a></em></td>
</tr>
<tr>
<td bgcolor="white" class="NavBarCell2"><font
size="-2"> PREV NEXT</font></td>
@@ -1266,7 +1266,7 @@
</tr>
</table>
</td>
- <td align="right" valign="top" rowspan="3"><em>Part of
the <a href="http://www.jboss.org/" target="_top">jBoss Project</a></em></td>
+ <td align="right" valign="top" rowspan="3"><em>Part of
the <a href="http://www.jboss.org/" target="_top">JBoss Project</a></em></td>
</tr>
<tr>
<td bgcolor="white" class="NavBarCell2"><font
size="-2"> PREV NEXT</font></td>
1.2 +18 -18 newsite/minerva/minerva.htm
Index: minerva.htm
===================================================================
RCS file: /products/cvs/ejboss/newsite/minerva/minerva.htm,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- minerva.htm 2000/11/12 20:34:58 1.1
+++ minerva.htm 2001/02/08 05:31:45 1.2
@@ -61,9 +61,9 @@
</ul>
<li><a href="#j1pools">Using Minerva JDBC 1/2 Pools</a>
<li><a href="#j2epools">Using Minerva JDBC 2 Standard Extension Pools</a>
-
<li><a href="#jboss">Using Minerva JDBC Pools with jBoss 2.0</a>
+
<li><a href="#jboss">Using Minerva JDBC Pools with JBoss 2.0</a>
<ul>
-
<li><a href="examples/index.html">Minerva & jBoss Complete Example</a>
+
<li><a href="examples/index.html">Minerva & JBoss Complete Example</a>
</ul>
<li><a href="#j2ee">Using Minerva JDBC Pools with Other J2EE Containers</a>
<li><a href="#obpools">Using Minerva Object pools</a>
@@ -78,10 +78,10 @@
<li><a href="#ex6">Getting a JDBC S.E. Pool connection directly</a>
<li><a href="#ex7">Getting a JDBC S.E. Pool connection from JNDI</a>
<li><a href="#ex8">Getting a JDBC S.E. Pool connection from the
DriverManager</a>
-
<li><a href="#ex9">Configuring a JDBC S.E. Pool with jBoss and a JDBC S.E.
Driver</a>
-
<li><a href="#ex10">Configuring a JDBC S.E. Pool with jBoss and a JDBC 1/2
Driver</a>
+
<li><a href="#ex9">Configuring a JDBC S.E. Pool with JBoss and a JDBC S.E.
Driver</a>
+
<li><a href="#ex10">Configuring a JDBC S.E. Pool with JBoss and a JDBC 1/2
Driver</a>
<li><a href="#ex11">Configuring an Enterprise Java Bean with a DataSource</a>
-
<li><a href="#ex12">Linking the EJB DataSource to a Minerva Pool with
jBoss</a>
+
<li><a href="#ex12">Linking the EJB DataSource to a Minerva Pool with
JBoss</a>
<li><a href="#ex13">Getting a connection in an EJB implementation</a>
<li><a href="#ex14">Creating a pool for a generic Object type</a>
<li><a href="#ex15">Getting and returning Objects</a>
@@ -133,10 +133,10 @@
<tr>
<td
valign="top" width="648"><font face="Myriad Web,Arial">
<h3>About Minerva</h3>
- <p>The
Minerva library is a multi-layered set of classes that can manage pools of Java
objects. At the lowest level, this can be any type of Java object. At a higher level,
it provides implementations for database connections. It is part of the jBoss project
(an open-source J2EE server), but does not depend on jBoss - it can be used
independently in any Java 2 environment. You will need the JDBC 2 Standard Extension,
JNDI, and JTA to take full advantage of the J2EE JDBC features, but you can ignore all
that if you just want a simple object or database pool (you may still need the jdbc 2
standard extension and JNDI jars at runtime, but you won't have to use them
directly).</p>
- <p>The
rest of this document is devoted to the different uses of the Minerva pools - J2EE
connections, plain JDBC connections, objects, etc. There's a section on integrating
the Minerva pools with jBoss, which you should read if you're using jBoss, and skip if
you're not.</p>
+ <p>The
Minerva library is a multi-layered set of classes that can manage pools of Java
objects. At the lowest level, this can be any type of Java object. At a higher level,
it provides implementations for database connections. It is part of the JBoss project
(an open-source J2EE server), but does not depend on JBoss - it can be used
independently in any Java 2 environment. You will need the JDBC 2 Standard Extension,
JNDI, and JTA to take full advantage of the J2EE JDBC features, but you can ignore all
that if you just want a simple object or database pool (you may still need the jdbc 2
standard extension and JNDI jars at runtime, but you won't have to use them
directly).</p>
+ <p>The
rest of this document is devoted to the different uses of the Minerva pools - J2EE
connections, plain JDBC connections, objects, etc. There's a section on integrating
the Minerva pools with JBoss, which you should read if you're using JBoss, and skip if
you're not.</p>
<h3>Download</h3>
- <p>The
source and classes for Minerva are integrated with jBoss, so you don't need to do
anything to use Minerva with jBoss. If you'd like to use Minerva standalone, you can
download the following files:</p>
+ <p>The
source and classes for Minerva are integrated with JBoss, so you don't need to do
anything to use Minerva with JBoss. If you'd like to use Minerva standalone, you can
download the following files:</p>
<ul>
<li><a href="minerva-0.99.jar">minerva-0.99.jar</a>
<li><a href="minerva-0.99-doc.zip">minerva-0.99-doc.zip</a>
@@ -320,7 +320,7 @@
<table border="0" cellpadding="0"
cellspacing="0" width="100%">
<tbody>
<tr bgcolor="#99cc66">
- <td
width="100%"><font color="white" face="Myriad Web,Arial" size="3"><b><a
name="jboss">Using Minerva JDBC Pools with jBoss 2.0</a></b></font></td>
+ <td
width="100%"><font color="white" face="Myriad Web,Arial" size="3"><b><a
name="jboss">Using Minerva JDBC Pools with JBoss 2.0</a></b></font></td>
</tr>
</tbody>
</table>
@@ -334,7 +334,7 @@
<table border="0" cellpadding="0"
cellspacing="0" width="100%" height="89">
<tbody>
<tr>
- <td
valign="top" width="648"><font face="Myriad Web,Arial">There are several steps
required to use Minerva pools with jBoss 2.0:
+ <td
valign="top" width="648"><font face="Myriad Web,Arial">There are several steps
required to use Minerva pools with JBoss 2.0:
<ol>
<li>Add your database driver to jboss.properties
<blockquote>
@@ -346,7 +346,7 @@
<li>Add the pool's specific configuration to jboss.jcml
<blockquote>
See the example below for <a href="#ex9">native Standard Extension</a> or <a
href="#ex10">JDBC 1/2</a> drivers.</blockquote>
-
<li>Add a resource reference to your EJB's ejb-jar.xml (not jBoss specific)
+
<li>Add a resource reference to your EJB's ejb-jar.xml (not JBoss specific)
<blockquote>
See the <a href="#ex11">example below</a>.</blockquote>
<li>Add a resource manager to your EJB's jboss.xml
@@ -354,7 +354,7 @@
See the <a href="#ex12">example below</a>.</blockquote>
</ol>
<p>You
can use more than one Minerva pool at the same time, and even from the same bean.
You'd have to repeat all the steps for each one, unless they use the same drivers
(only add it once to jboss.properties). Once you have a pool set up, you can refer to
it from additional beans by repeating the last 2 steps for each bean.</p>
- <p>You
may want to look at the <a href="examples/index.html">Minerva & jBoss Complete
Example</a> if you're having trouble.</p>
+ <p>You
may want to look at the <a href="examples/index.html">Minerva & JBoss Complete
Example</a> if you're having trouble.</p>
</font></td>
<td
valign="top" width="10"> </td>
<td
align="right" valign="top" width="10"> </td>
@@ -397,7 +397,7 @@
<table border="0" cellpadding="0"
cellspacing="0" width="100%" height="89">
<tbody>
<tr>
- <td
valign="top" width="648"><font face="Myriad Web,Arial">The only real requirement here
is that the TransactionManager for the container must be in JNDI, so the pools can
find it and register connections as they are used. You'll need to find out how to
start a service for the container, and probably provide a skeletal class that lets the
user set all the configuration parameters. You can use the JMX classes to load Minerva
pools in jBoss as a reference (see org.jboss.jdbc.*). There would be a different way
to link an EJB DataSource reference to the actual DataSource implementation, but the
container vendor probably has a GUI tool for deployment like EJX. </font></td>
+ <td
valign="top" width="648"><font face="Myriad Web,Arial">The only real requirement here
is that the TransactionManager for the container must be in JNDI, so the pools can
find it and register connections as they are used. You'll need to find out how to
start a service for the container, and probably provide a skeletal class that lets the
user set all the configuration parameters. You can use the JMX classes to load Minerva
pools in JBoss as a reference (see org.jboss.jdbc.*). There would be a different way
to link an EJB DataSource reference to the actual DataSource implementation, but the
container vendor probably has a GUI tool for deployment like EJX. </font></td>
<td
valign="top" width="10"> </td>
<td
align="right" valign="top" width="10"> </td>
</tr>
@@ -628,7 +628,7 @@
XAPoolDataSource = ...
Connection con = DriverManager.getConnection("jdbc:minerva:PoolName");
</pre>
- <h4><a
name="ex9">Configuring a JDBC S.E. Pool with jBoss and a JDBC S.E. Driver</a></h4>
+ <h4><a
name="ex9">Configuring a JDBC S.E. Pool with JBoss and a JDBC S.E. Driver</a></h4>
<p>This will result in the pool's DataSource living in JNDI under the name
<b>PoolName</b>.</p>
<p>In
<b>jboss.conf</b>:</p>
<pre>
@@ -645,8 +645,8 @@
<attribute name="Password">password</attribute>
</mbean>
</pre>
-
<p>You'll notice that after you run jBoss with a jboss.jcml like the one above, it
will update your jboss.jcml to list all the available properties for the XADataSource,
with their default values. If the vendor uses properties other than URL, username, and
password to configure their XADataSource, you'll have to use the
"properties" attribute to list them (in the form
"name=value;name=value" etc.).</p>
- <h4><a
name="ex10">Configuring a JDBC S.E. Pool with jBoss and a JDBC 1/2 Driver</a></h4>
+
<p>You'll notice that after you run JBoss with a jboss.jcml like the one above, it
will update your jboss.jcml to list all the available properties for the XADataSource,
with their default values. If the vendor uses properties other than URL, username, and
password to configure their XADataSource, you'll have to use the
"properties" attribute to list them (in the form
"name=value;name=value" etc.).</p>
+ <h4><a
name="ex10">Configuring a JDBC S.E. Pool with JBoss and a JDBC 1/2 Driver</a></h4>
<p>This will result in the pool's DataSource living in JNDI under the name
<b>PoolName</b>.</p>
<p>In
<b>jboss.conf</b>:</p>
<pre>
@@ -663,7 +663,7 @@
<attribute name="Password">password</attribute>
</mbean>
</pre>
-
<p>You'll notice that after you run jBoss with a jboss.jcml like the one above, it
will update your jboss.jcml to list all the available properties for the XADataSource,
with their default values. If the JDBC 1/2 driver uses properties other than URL,
username, and password to connect, you'll have to use the "properties"
attribute to list them (in the form "name=value;name=value" etc.).</p>
+
<p>You'll notice that after you run JBoss with a jboss.jcml like the one above, it
will update your jboss.jcml to list all the available properties for the XADataSource,
with their default values. If the JDBC 1/2 driver uses properties other than URL,
username, and password to connect, you'll have to use the "properties"
attribute to list them (in the form "name=value;name=value" etc.).</p>
<h4><a
name="ex11">Configuring an Enterprise Java Bean with a DataSource</a></h4>
<p>You
need to add a resource reference to your ejb-jar.xml file. The requirement and XML
syntax is standard across all containers - but each container has a different GUI for
configuring this if you don't do it manually. The key parts here are that you specify
a resource reference of type <b>javax.sql.DataSource</b>, and you give it the name you
expect to see in JNDI. So, in the example below, if you call it <b>TestDB</b>, it will
be in JNDI under <b>java:comp/env/TestDB</b>. However, you'll need to do something
container-specific to match this up with a specific database pool.</p>
<pre>
@@ -674,7 +674,7 @@
<res-auth>Container</res-auth>
</resource-ref>
</pre>
- <h4><a
name="ex12">Linking the EJB DataSource to a Minerva Pool with jBoss</a></h4>
+ <h4><a
name="ex12">Linking the EJB DataSource to a Minerva Pool with JBoss</a></h4>
<p>The
easiest way to do this is to use EJX. You need to add a resource manager that links
the EJB ref-name (<a href="#ex11">see example above</a>) to the database pool JNDI
name (<a href="#ex9">see example above</a>). Since the database pool JNDI name is
<i>PoolName</i> that should be your resource jndi name, and the name in ejb-jar.xml
should be the resource name.</p>
<p>If
you don't use EJX, you will need to add the reference manually in two places - first
at the top level of jboss.xml, and then again at the bean level for each bean that
uses the resource. Technically you can give the resource manager a different name that
the bean expects, and use the bean-specific name with the resource manager name in the
bean-level entry. This is only recommended if you have multiple beans in the JAR that
have different resource names but can all be served by the same database pool.</p>
<pre>
1.2 +1 -1 newsite/minerva/overview-frame.html
Index: overview-frame.html
===================================================================
RCS file: /products/cvs/ejboss/newsite/minerva/overview-frame.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- overview-frame.html 2000/11/12 20:34:58 1.1
+++ overview-frame.html 2001/02/08 05:31:45 1.2
@@ -10,7 +10,7 @@
<body bgcolor="white">
<table border="0" width="100%">
<tr>
- <td nowrap><font size="+1"
class="FrameTitleFont"><b>Part of the <a href="http://www.jboss.org/"
target="_top">jBoss Project</a></b></font></td>
+ <td nowrap><font size="+1"
class="FrameTitleFont"><b>Part of the <a href="http://www.jboss.org/"
target="_top">JBoss Project</a></b></font></td>
</tr>
</table>
<table border="0" width="100%">
1.2 +18 -18 newsite/minerva/overview-summary.html
Index: overview-summary.html
===================================================================
RCS file: /products/cvs/ejboss/newsite/minerva/overview-summary.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- overview-summary.html 2000/11/12 20:35:00 1.1
+++ overview-summary.html 2001/02/08 05:31:45 1.2
@@ -27,7 +27,7 @@
</tr>
</table>
</td>
- <td align="right" valign="top" rowspan="3"><em>Part of
the <a href="http://www.jboss.org/" target="_top">jBoss Project</a></em></td>
+ <td align="right" valign="top" rowspan="3"><em>Part of
the <a href="http://www.jboss.org/" target="_top">JBoss Project</a></em></td>
</tr>
<tr>
<td bgcolor="white" class="NavBarCell2"><font
size="-2"> PREV NEXT</font></td>
@@ -79,7 +79,7 @@
</ul>
<li><a href="#j1pools">Using Minerva JDBC 1/2 Pools</a>
<li><a href="#j2epools">Using Minerva JDBC 2 Standard
Extension Pools</a>
- <li><a href="#jboss">Using Minerva JDBC Pools with jBoss
2.0</a>
+ <li><a href="#jboss">Using Minerva JDBC Pools with JBoss
2.0</a>
<li><a href="#j2ee">Using Minerva JDBC Pools with Other J2EE
Containers</a>
<li><a href="#obpools">Using Minerva Object pools</a>
<li><a href="#arch">Minerva Architecture</a>
@@ -93,10 +93,10 @@
<li><a href="#ex6">Getting a JDBC S.E. Pool connection
directly</a>
<li><a href="#ex7">Getting a JDBC S.E. Pool connection
from JNDI</a>
<li><a href="#ex8">Getting a JDBC S.E. Pool connection
from the DriverManager</a>
- <li><a href="#ex9">Configuring a JDBC S.E. Pool with
jBoss and a JDBC S.E. Driver</a>
- <li><a href="#ex10">Configuring a JDBC S.E. Pool with
jBoss and a JDBC 1/2 Driver</a>
+ <li><a href="#ex9">Configuring a JDBC S.E. Pool with
JBoss and a JDBC S.E. Driver</a>
+ <li><a href="#ex10">Configuring a JDBC S.E. Pool with
JBoss and a JDBC 1/2 Driver</a>
<li><a href="#ex11">Configuring an Enterprise Java
Bean with a DataSource</a>
- <li><a href="#ex12">Linking the EJB DataSource to a
Minerva Pool with jBoss</a>
+ <li><a href="#ex12">Linking the EJB DataSource to a
Minerva Pool with JBoss</a>
<li><a href="#ex13">Getting a connection in an EJB
implementation</a>
<li><a href="#ex14">Creating a pool for a generic
Object type</a>
<li><a href="#ex15">Getting and returning Objects</a>
@@ -107,8 +107,8 @@
<hr>
<br>
<h2><a name="intro">Introduction to Minerva</a></h2>
- <p>The Minerva library is a multi-layered set of classes that can
manage pools of Java objects. At the lowest level, this can be any type of Java
object. At a higher level, it provides implementations for database connections. It is
part of the jBoss project (an open-source J2EE server), but does not depend on jBoss -
it can be used independently in any Java 2 environment. You will need the JDBC 2
Standard Extension, JNDI, and JTA to take full advantage of the J2EE JDBC features,
but you can ignore all that if you just want a simple object or database pool (you may
still need the jdbc 2 standard extension and JNDI jars at runtime, but you won't have
to use them directly).</p>
- <p>The rest of this document is devoted to the different uses of the
Minerva pools - J2EE connections, plain JDBC connections, objects, etc. There's a
section on integrating the Minerva pools with jBoss, which you should read if you're
using jBoss, and skip if you're not.</p>
+ <p>The Minerva library is a multi-layered set of classes that can
manage pools of Java objects. At the lowest level, this can be any type of Java
object. At a higher level, it provides implementations for database connections. It is
part of the JBoss project (an open-source J2EE server), but does not depend on JBoss -
it can be used independently in any Java 2 environment. You will need the JDBC 2
Standard Extension, JNDI, and JTA to take full advantage of the J2EE JDBC features,
but you can ignore all that if you just want a simple object or database pool (you may
still need the jdbc 2 standard extension and JNDI jars at runtime, but you won't have
to use them directly).</p>
+ <p>The rest of this document is devoted to the different uses of the
Minerva pools - J2EE connections, plain JDBC connections, objects, etc. There's a
section on integrating the Minerva pools with JBoss, which you should read if you're
using JBoss, and skip if you're not.</p>
<hr>
<br>
<h2><a name="jdbc">JDBC 1/2 vs the JDBC Standard Extension</a></h2>
@@ -135,8 +135,8 @@
<p>Finally, if you want to interact with the pool directly rather than
using the DataSource or DriverManager interfaces, you can use the Object pools with
the object factory org.jboss.minerva.factories.XAConnectionFactory. Take a look at the
source code for XAPoolDataSource if it's not clear.</p>
<hr>
<br>
- <h2><a name="jboss">Using Minerva JDBC Pools with jBoss 2.0</a></h2>
- <p>There are several steps required to use Minerva pools with jBoss
2.0:</p>
+ <h2><a name="jboss">Using Minerva JDBC Pools with JBoss 2.0</a></h2>
+ <p>There are several steps required to use Minerva pools with JBoss
2.0:</p>
<ol>
<li>Add your database driver to jboss.properties
<blockquote>
@@ -148,7 +148,7 @@
<li>Add the pool's specific configuration to jboss.jcml
<blockquote>
See the example below for <a href="#ex9">Standard
Extension drivers</a> or <a href="#ex10">JDBC 1/2 drivers</a>.</blockquote>
- <li>Add a resource reference to your EJB's ejb-jar.xml (not
jBoss specific)
+ <li>Add a resource reference to your EJB's ejb-jar.xml (not
JBoss specific)
<blockquote>
See the <a href="#ex11">example below</a>.</blockquote>
<li>Add a resource manager to your EJB's jboss.xml
@@ -159,7 +159,7 @@
<hr>
<br>
<h2><a name="j2ee">Using Minerva JDBC Pools with Other J2EE
Containers</a></h2>
- <p>The only real requirement here is that the TransactionManager for
the container must be in JNDI, so the pools can find it and register connections as
they are used. You'll need to find out how to start a service for the container, and
probably provide a skeletal class that lets the user set all the configuration
parameters. You can use the JMX classes to load Minerva pools in jBoss as a reference
(see org.jboss.jdbc.*). There would be a different way to link an EJB DataSource
reference to the actual DataSource implementation, but the container vendor probably
has a GUI tool for deployment like EJX.
+ <p>The only real requirement here is that the TransactionManager for
the container must be in JNDI, so the pools can find it and register connections as
they are used. You'll need to find out how to start a service for the container, and
probably provide a skeletal class that lets the user set all the configuration
parameters. You can use the JMX classes to load Minerva pools in JBoss as a reference
(see org.jboss.jdbc.*). There would be a different way to link an EJB DataSource
reference to the actual DataSource implementation, but the container vendor probably
has a GUI tool for deployment like EJX.
<hr>
<br>
<h2><a name="obpools">Using Minerva Object pools</a></h2>
@@ -169,7 +169,7 @@
<hr>
<br>
<h2><a name="arch">Minerva Architecture</a></h2>
- <p>All the Minerva classes have JavaDoc comments, and you can see the
JavaDoc output online on the <a href="http://www.jboss.org/Jaws.htm">jBoss JAWS
page</a>.</p>
+ <p>All the Minerva classes have JavaDoc comments, and you can see the
JavaDoc output online on the <a href="http://www.jboss.org/Jaws.htm">JBoss JAWS
page</a>.</p>
<h3>Overview</h3>
<p>There are five packages under minerva:</p>
<table border="1">
@@ -272,7 +272,7 @@
XAPoolDataSource = ...
Connection con = DriverManager.getConnection("jdbc:minervaxa:PoolName");
</pre>
- <h4><a name="ex9">Configuring a JDBC S.E. Pool with jBoss and a JDBC
S.E. Driver</a></h4>
+ <h4><a name="ex9">Configuring a JDBC S.E. Pool with JBoss and a JDBC
S.E. Driver</a></h4>
<p>This will result in the pool's DataSource living in JNDI under the
name <b>xa.PoolName</b>.</p>
<p>In <b>jboss.conf</b>:</p>
<pre>
@@ -289,8 +289,8 @@
<attribute name="Password">password</attribute>
</mbean>
</pre>
- <p>You'll notice that after you run jBoss with a jboss.jcml like the
one above, it will update your jboss.jcml to list all the available properties for the
XADataSource, with their default values. If the vendor uses properties other than URL,
username, and password to configure their XADataSource, you'll have to use the
"properties" attribute to list them (in the form
"name=value;name=value" etc.).</p>
- <h4><a name="ex10">Configuring a JDBC S.E. Pool with jBoss and a JDBC
1/2 Driver</a></h4>
+ <p>You'll notice that after you run JBoss with a jboss.jcml like the
one above, it will update your jboss.jcml to list all the available properties for the
XADataSource, with their default values. If the vendor uses properties other than URL,
username, and password to configure their XADataSource, you'll have to use the
"properties" attribute to list them (in the form
"name=value;name=value" etc.).</p>
+ <h4><a name="ex10">Configuring a JDBC S.E. Pool with JBoss and a JDBC
1/2 Driver</a></h4>
<p>This will result in the pool's DataSource living in JNDI under the
name <b>xa.PoolName</b>.</p>
<p>In <b>jboss.conf</b>:</p>
<pre>
@@ -307,7 +307,7 @@
<attribute name="Password">password</attribute>
</mbean>
</pre>
- <p>You'll notice that after you run jBoss with a jboss.jcml like the
one above, it will update your jboss.jcml to list all the available properties for the
XADataSource, with their default values. If the JDBC 1/2 driver uses properties other
than URL, username, and password to connect, you'll have to use the
"properties" attribute to list them (in the form
"name=value;name=value" etc.).</p>
+ <p>You'll notice that after you run JBoss with a jboss.jcml like the
one above, it will update your jboss.jcml to list all the available properties for the
XADataSource, with their default values. If the JDBC 1/2 driver uses properties other
than URL, username, and password to connect, you'll have to use the
"properties" attribute to list them (in the form
"name=value;name=value" etc.).</p>
<h4><a name="ex11">Configuring an Enterprise Java Bean with a
DataSource</a></h4>
<p>You need to add a resource reference to your ejb-jar.xml file. The
requirement and XML syntax is standard across all containers - but each container has
a different GUI for configuring this if you don't do it manually. The key parts here
are that you specify a resource reference of type <b>javax.sql.DataSource</b>, and you
give it the name you expect to see in JNDI. So, in the example below, if you call it
<b>TestDB</b>, it will be in JNDI under <b>java:comp/env/TestDB</b>. However, you'll
need to do something container-specific to match this up with a specific database
pool.</p>
<pre>
@@ -318,7 +318,7 @@
<res-auth>Container</res-auth>
</resource-ref>
</pre>
- <h4><a name="ex12">Linking the EJB DataSource to a Minerva Pool with
jBoss</a></h4>
+ <h4><a name="ex12">Linking the EJB DataSource to a Minerva Pool with
JBoss</a></h4>
<p>The easiest way to do this is to use EJX. You need to add a
resource manager that links the EJB ref-name (<a href="#ex11">see example above</a>)
to the database pool JNDI name (<a href="#ex9">see example above</a>). Since the
database pool JNDI name is <i>xa.PoolName</i> that should be your resource jndi name,
and the name in ejb-jar.xml should be the resource name.</p>
<p>If you don't use EJX, you will need to add the reference manually
in two places - first at the top level of jboss.xml, and then again at the bean level
for each bean that uses the resource. Technically you can give the resource manager a
different name that the bean expects, and use the bean-specific name with the resource
manager name in the bean-level entry. This is only recommended if you have multiple
beans in the JAR that have different resource names but can all be served by the same
database pool.</p>
<pre>
@@ -400,7 +400,7 @@
</tr>
</table>
</td>
- <td align="right" valign="top" rowspan="3"><em>Part of
the <a href="http://www.jboss.org/" target="_top">jBoss Project</a></em></td>
+ <td align="right" valign="top" rowspan="3"><em>Part of
the <a href="http://www.jboss.org/" target="_top">JBoss Project</a></em></td>
</tr>
<tr>
<td bgcolor="white" class="NavBarCell2"><font
size="-2"> PREV NEXT</font></td>
1.2 +2 -2 newsite/minerva/overview-tree.html
Index: overview-tree.html
===================================================================
RCS file: /products/cvs/ejboss/newsite/minerva/overview-tree.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- overview-tree.html 2000/11/12 20:35:01 1.1
+++ overview-tree.html 2001/02/08 05:31:45 1.2
@@ -27,7 +27,7 @@
</tr>
</table>
</td>
- <td align="right" valign="top" rowspan="3"><em>Part of
the <a href="http://www.jboss.org/" target="_top">jBoss Project</a></em></td>
+ <td align="right" valign="top" rowspan="3"><em>Part of
the <a href="http://www.jboss.org/" target="_top">JBoss Project</a></em></td>
</tr>
<tr>
<td bgcolor="white" class="NavBarCell2"><font
size="-2"> PREV NEXT</font></td>
@@ -104,7 +104,7 @@
</tr>
</table>
</td>
- <td align="right" valign="top" rowspan="3"><em>Part of
the <a href="http://www.jboss.org/" target="_top">jBoss Project</a></em></td>
+ <td align="right" valign="top" rowspan="3"><em>Part of
the <a href="http://www.jboss.org/" target="_top">JBoss Project</a></em></td>
</tr>
<tr>
<td bgcolor="white" class="NavBarCell2"><font
size="-2"> PREV NEXT</font></td>
1.2 +2 -2 newsite/minerva/serialized-form.html
Index: serialized-form.html
===================================================================
RCS file: /products/cvs/ejboss/newsite/minerva/serialized-form.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- serialized-form.html 2000/11/12 20:35:02 1.1
+++ serialized-form.html 2001/02/08 05:31:45 1.2
@@ -27,7 +27,7 @@
</tr>
</table>
</td>
- <td align="right" valign="top" rowspan="3"><em>Part of
the <a href="http://www.jboss.org/" target="_top">jBoss Project</a></em></td>
+ <td align="right" valign="top" rowspan="3"><em>Part of
the <a href="http://www.jboss.org/" target="_top">JBoss Project</a></em></td>
</tr>
<tr>
<td bgcolor="white" class="NavBarCell2"><font
size="-2"> PREV NEXT</font></td>
@@ -91,7 +91,7 @@
</tr>
</table>
</td>
- <td align="right" valign="top" rowspan="3"><em>Part of
the <a href="http://www.jboss.org/" target="_top">jBoss Project</a></em></td>
+ <td align="right" valign="top" rowspan="3"><em>Part of
the <a href="http://www.jboss.org/" target="_top">JBoss Project</a></em></td>
</tr>
<tr>
<td bgcolor="white" class="NavBarCell2"><font
size="-2"> PREV NEXT</font></td>
