Datasource, DBCP documentation woes, suggested documentation fix

[Rick Hightower <rh...@triveratech.com>]

You need booth commons-pooling and commons-dbcp to get Struts Datasources to
work, but this is not mentioned in the documentation and the required jar
files do not ship with Blank.war. In fact in Struts 1.1., you also need
Struts Legacy jar file as well. Of course, if you are using Tomcat then both
commons-pooling and commons-dbcp ship in the shared folder but you do need
to download them if you are using another application server. You do need to
download them if you are going to use Struts Datasources.

 

I think either

http://jakarta.apache.org/struts/userGuide/configuration.html#data-source_co
nfig

 

or 

 

http://jakarta.apache.org/struts/faqs/database.html

 

should make note of this.

 

Here is a stab at it.

 

Struts Datasources require commons-pooling and commons-dbcp. The blank.war
does not have commons-pooling or commons-dbcp. If you want to use Struts
datasource, you will need to download commons-pooling and commons-dbcp from
the following locations:

 

http://jakarta.apache.org/site/binindex.cgi#commons-dbcp

http://jakarta.apache.org/site/binindex.cgi#commons-pool

 

 

Download the above archives and un-archive them. Then copy the jar files
commons-pool-1.1.jar, and commons-dbcp-1.1.jar into the WEB-INF/lib
directory of your web application. Note that Tomcat 5 ships with
commons-dbcp and commons-pool so you do not need to download and install
commons-dbcp and commons-pool if you are using Tomcat.

 

In addition to the above two jar files, you will need to use the
struts-legacy.jar jar file that ships with Struts 1.1. Copy the
struts-legacy.jar file to the WEB-INF/lib directory of your web application.

 

This might be a moot point depending on how soon Struts 1.2 comes out, and
if commons-pooling and commons-dbcp ship with Struts.

 

Rick Hightower

Chief Technology Officer

ArcMind

"Know the Next!"

http://www.arc-mind.com <http://www.arc-mind.com/> 

520 290 6855 (Phone)

520 661 6753 (Mobile)