RAT (Release Audit Tool) results

The following document contains the results of RAT (Release Audit Tool).

*****************************************************
Summary
-------
Notes: 4
Binaries: 4
Archives: 0
Standards: 71

Apache Licensed: 59
Generated Documents: 0

JavaDocs are generated and so license header is optional
Generated files do not required license headers

12 Unknown Licenses

*******************************

Archives (+ indicates readable, $ unreadable): 

 
*****************************************************
  Files with AL headers will be marked L
  Binary files (which do not require AL headers) will be marked B
  Compressed archives will be marked A
  Notices, licenses etc will be marked N
 !????? build.html
 !????? build.properties.sample
 !????? build.xml
 !????? checkstyle.xml
  N     LICENSE.txt
  N     NOTICE.txt
  AL    pom.xml
 !????? project.properties
 !????? project.xml
  N     README.txt
 !????? src/conf/MANIFEST.MF
  AL    src/java/org/apache/commons/scaffold/http/ConnectionServlet.java
  AL    src/java/org/apache/commons/scaffold/http/HttpClient.java
  AL    src/java/org/apache/commons/scaffold/http/ResourceServlet.java
  AL    src/java/org/apache/commons/scaffold/http/SetUp.java
  AL    src/java/org/apache/commons/scaffold/http/SocketUtil.java
  AL    src/java/org/apache/commons/scaffold/lang/BaseException.java
  AL    src/java/org/apache/commons/scaffold/lang/ChainedException.java
  AL    src/java/org/apache/commons/scaffold/lang/ParameterException.java
  AL    src/java/org/apache/commons/scaffold/lang/PopulateException.java
  AL    src/java/org/apache/commons/scaffold/lang/PropertiesException.java
  AL    src/java/org/apache/commons/scaffold/lang/ResourceException.java
  AL    src/java/org/apache/commons/scaffold/lang/TestData.java
  AL    src/java/org/apache/commons/scaffold/lang/Tokens.java
  AL    src/java/org/apache/commons/scaffold/lucene/Engine.java
  AL    src/java/org/apache/commons/scaffold/lucene/SearchUtils.java
  AL    src/java/org/apache/commons/scaffold/sql/AccessBase.java
 !????? src/java/org/apache/commons/scaffold/sql/command.properties.sample.txt
  AL    src/java/org/apache/commons/scaffold/sql/CommandStore.java
  AL    src/java/org/apache/commons/scaffold/sql/ConnectionAdaptor.java
  AL    src/java/org/apache/commons/scaffold/sql/MockAdaptor.java
  AL    src/java/org/apache/commons/scaffold/sql/PoolmanAdaptor.java
  AL    src/java/org/apache/commons/scaffold/sql/ResultSetUtils.java
  AL    src/java/org/apache/commons/scaffold/sql/RowSetUtils.java.text
  AL    src/java/org/apache/commons/scaffold/sql/ScrollerBeanBase.java
  AL    src/java/org/apache/commons/scaffold/sql/ServletAdaptor.java
  AL    src/java/org/apache/commons/scaffold/sql/StatementUtils.java
  AL    src/java/org/apache/commons/scaffold/sql/StorageBeanBase.java
  AL    src/java/org/apache/commons/scaffold/text/ConvertUtils.java
  AL    src/java/org/apache/commons/scaffold/text/Merge.java
  AL    src/java/org/apache/commons/scaffold/util/BizRequest.java
  AL    src/java/org/apache/commons/scaffold/util/BizRequestImpl.java
  AL    src/java/org/apache/commons/scaffold/util/BizResponse.java
  AL    src/java/org/apache/commons/scaffold/util/BizResponseImpl.java
  AL    src/java/org/apache/commons/scaffold/util/BizService.java
  AL    src/java/org/apache/commons/scaffold/util/BizServiceImpl.java
  AL    src/java/org/apache/commons/scaffold/util/Executable.java
  AL    src/java/org/apache/commons/scaffold/util/FunctionBean.java
  AL    src/java/org/apache/commons/scaffold/util/LabelValueBean.java
  AL    src/java/org/apache/commons/scaffold/util/Localized.java
  AL    src/java/org/apache/commons/scaffold/util/Mapped.java
  AL    src/java/org/apache/commons/scaffold/util/Message.java
  AL    src/java/org/apache/commons/scaffold/util/MessageImpl.java
  AL    src/java/org/apache/commons/scaffold/util/Messages.java
  AL    src/java/org/apache/commons/scaffold/util/MessagesImpl.java
  AL    src/java/org/apache/commons/scaffold/util/ProcessBean.java
  AL    src/java/org/apache/commons/scaffold/util/ProcessBeanBase.java
  AL    src/java/org/apache/commons/scaffold/util/ProcessResult.java
  AL    src/java/org/apache/commons/scaffold/util/ProcessResultBase.java
  AL    src/java/org/apache/commons/scaffold/util/ResourceUtils.java
  AL    src/java/org/apache/commons/scaffold/util/ResultList.java
  AL    src/java/org/apache/commons/scaffold/util/ResultListBase.java
  AL    src/java/org/apache/commons/scaffold/util/Scroller.java
  AL    src/java/org/apache/commons/scaffold/util/ScrollerBean.java
  AL    src/java/org/apache/commons/scaffold/util/Storable.java
  AL    src/java/org/apache/commons/scaffold/util/StorageBean.java
 !????? src/java/poolman.xml
  B     src/site/resources/images/scaffold-logo-white.png
  B     src/site/resources/images/scaffold-logo-white.xcf
  AL    src/site/site.xml
 !????? STATUS/STATUS-001.txt
 !????? STATUS/STATUS-002.txt
 !????? STATUS/STATUS-003.txt
  N     STATUS.txt
  AL    xdocs/downloads.xml
  B     xdocs/images/scaffold-logo-white.png
  B     xdocs/images/scaffold-logo-white.xcf
  AL    xdocs/index.xml
  AL    xdocs/navigation.xml
 
 *****************************************************
 Printing headers for files without AL header...
 
 
 =======================================================================
 ==build.html
 =======================================================================
 <html>
<body>

<p>See the build.xml for requisite JARs.</p>
<ul>

        <pathelement path ="lib/lucene_1_2.jar"/>
        <pathelement path ="lib/poolman_2_0_4.jar"/>
        <pathelement path ="lib/commons-digester.jar"/>
        <pathelement path ="lib/struts_1_0_2.jar"/>
        <pathelement path ="lib/struts-validator_1_0.jar"/>
        <pathelement path ="classes"/>
        <pathelement path ="${classpath}"/>



<li>commons-beanutils.jar - <a href="http://commons.apache.org/downloads/download_beanutils.cgi">Apache Commons BeanUtils</a></li>
<li>commons-collections.jar - <a href="http://commons.apache.org/downloads/download_collections.cgi">Apache Commons Collections</a></li>
<li>commons-digester.jar - <a href="http://commons.apache.org/downloads/download_digester.cgi">Apache Commons Digester</a></li>
<li>commons-scaffold.jar - <a href="http://www.husted.com/builds/scaffold">Apache Commons Scaffold</a></li>
<li>scaffold-struts.jar - <a href="http://www.husted.com/builds/scaffold">Jakarta Struts Scaffold</a></li>
<li>struts.jar - <a href="http://jakarta.apache.org/builds/jakarta-struts/release/">Jakarta Struts 1.0.2</a></li>
<li>lucene.jar - <a href="http://jakarta.apache.org/builds/jakarta-lucene/release/">Jakarta Lucene</a></li>
<li>poolman.jar - <a href="http://sourceforge.net/project/showfiles.php?group_id=4899">SourceForge Poolman</a></li>
<li>struts-validator.jar - <a href="http://www.husted.com/builds/validator">Struts Validator 1.0</a></li>
</ul>

<p>Also these tld's from the Struts distribution (above) placed in the /WEB-INF/lib folder with the JARs</p>
<ul>
<li>struts-bean.tld</li>
<li>struts-html.tld</li>
<li>struts-logic.tld</li>
</ul>

</body>
</html>

 =======================================================================
 ==build.properties.sample
 =======================================================================
 # build.properties.sample -- Sample build.properties for "scaffold"
# $Id: build.properties.sample 155464 2005-02-26 13:26:54Z dirkv $


# Commons Packages
commons.home=../../jakarta-commons
commons-beanutils.jar=${commons.home}/beanutils/dist/commons-beanutils.jar
commons-digester.jar=${commons.home}/beanutils/dist/commons-digester.jar
commons-logging.jar=${commons.home}/commons-logging-1.0.3/commons-logging.jar

# JDBC 2.0 Standard Extensions (javax.sql) JAR File
jdbc20ext.jar=/classes/jdbc20ext.jar


# Lucene (Version 1.2 or later).  For more informaiton, see
# <http://jakarta.apache.org/lucene/>.
lucene.home=/usr/local/lucene-1.2
lucene.jar=${lucene.home}/lucene-1.2.jar


# MockObjects (Version 0.07 or later).  For more information, see
# <http://www.mockobjects.com>.  The "mockobjects-core.jar" property
# should point at the core JAR file from the MockObjects distribution,
# while the "mockobjects-j2ee.jar" property should point at the appropriate
# JAR file for the combination of J2SE and J2EE level you are using.  The
# example below would be for J2EE 1.3 (i.e. Servlet 2.3 and JSP 1.2) running
# in conjunction with J2SE 1.4.
mockobjects.home=/usr/local/mockobjects-0.07
mockobjects-core.jar=${mockobjects.home}/mockobjects-0.07-core.jar
mockobjects-j2ee.jar=${mockobjects.home}/mockobjects-0.07-j1.4-j2ee1.3.jar


# PoolMan (version 2.0.4 or later).  For more information, see
# <http://sourceforge.net/projects/poolman/>.
poolman.home=/usr/local/poolman-2.0.4
poolman.jar=${poolman.home}/lib/poolman.jar


# Servlet 2.3 / JSP 1.2 API Classes
servlet.jar=/classes/servlet.jar

 =======================================================================
 ==build.xml
 =======================================================================
 <!--
@author Ted Husted
@author Craig McClanahan
@author Steve Raeburn
@version $Revision: 155464 $ $Date: 2005-02-26 13:26:54 +0000 (Sat, 26 Feb 2005) $
-->

<project name="scaffold" default="compile">


    <!-- ========== Initialize User Preferences =========================== -->
    <!-- See "build.properties.sample" for the preferences you can set      -->

    <property file="build.properties"/>               <!-- Component local  -->
    <property file="../build.properties"/>            <!-- Commons local    -->
    <property file="${user.home}/build.properties"/>  <!-- User local       -->


    <!-- ========== External Dependencies ================================= -->
    <!-- These defaults may be overridden by user preferences from above    -->

    <property name="commons.home"            value="../../jakarta-commons"/>
    <property name="commons-beanutils.jar"   value="${commons.home}/beanutils/dist/commons-beanutils.jar"/>
    <property name="commons-digester.jar"    value="${commons.home}/digester/dist/commons-digester.jar"/>
    <property name="commons-loggging.jar"    value="${commons.home}/commons-logging-1.0.3/commons-logging.jar"/>

    <property name="jdbc20ext.jar"           value="/classes/jdbc20ext.jar"/>

    <property name="lucene.home"             value="/usr/local/lucene-1.2"/>
    <property name="lucene.jar"              value="${lucene.home}/lucene-1.2.jar"/>

    <property name="mockobjects.home"        value="/usr/local/mockobjects-0.07"/>
    <property name="mockobjects-core.jar"    value="${mockobjects.home}/mockobjects-0.07-core.jar"/>
    <property name="mockobjects-j2ee.jar"    value="${mockobjects.home}/mockobjects-0.07-j1.4-j2ee1.3.jar"/>

    <property name="poolman.home"            value="/usr/local/poolman-2.0.4"/>
    <property name="poolman.jar"             value="${poolman.home}/lib/poolman.jar"/>

    <property name="servlet.jar"             value="/classes/servlet.jar"/>


    <!-- ========== Local System Paths ==================================== -->

    <property name="build.home"              value="target"/>
    <property name="conf.home"               value="src/conf"/>
    <property name="dist.home"               value="dist"/>
    <property name="source.home"             value="src/java"/>


    <!-- ========== Java Compilation Defaults ============================= -->

 =======================================================================
 ==checkstyle.xml
 =======================================================================
 <?xml version="1.0"?>
<!DOCTYPE module PUBLIC
    "-//Puppy Crawl//DTD Check Configuration 1.1//EN"
    "http://www.puppycrawl.com/dtds/configuration_1_1.dtd">

<!--
  Checkstyle checks configured for Maven.
-->

<module name="Checker">

    <!-- Checks that a package.html file exists for each package.     -->
    <!-- See http://checkstyle.sf.net/config_javadoc.html#PackageHtml -->
    <module name="PackageHtml"/>

    <!-- Checks whether files end with a new line.                        -->
    <!-- See http://checkstyle.sf.net/config_misc.html#NewlineAtEndOfFile -->
    <module name="NewlineAtEndOfFile"/>

    <!-- Checks that property files contain the same keys.         -->
    <!-- See http://checkstyle.sf.net/config_misc.html#Translation -->
    <module name="Translation"/>

    <module name="TreeWalker">

        <property name="cacheFile" value="${checkstyle.cache.file}"/>

        <!-- ************************************************************** -->
        <!-- Checks that are different from the sun coding conventions ones -->
        <!-- ************************************************************** -->
        <module name="Header">
            <property name="headerFile" value="${basedir}/LICENSE.txt"/>
            <property name="ignoreLines" value="2,3,4,10"/>
        </module>
        <property name="tabWidth" value="4"/>
        <module name="LeftCurly">
          <property name="option" value="eol"/>
        </module>
        <module name="RightCurly">
          <property name="option" value="alone"/>
        </module>
        <module name="LineLength">
          <property name="max" value="132"/>
        </module>
        <module name="MethodLength">
          <property name="max" value="175"/>
        </module>
        <!-- No Paren pad check
        <module name="ParenPad"/>
        -->

 =======================================================================
 ==project.properties
 =======================================================================
 maven.checkstyle.properties = checkstyle.xml

# uncomment the next line to work in offline mode (no jar download & no linkcheck)
#maven.mode.online=
maven.changelog.factory=org.apache.maven.svnlib.SvnChangeLogFactory

maven.javadoc.author=false
maven.javadoc.links=http://java.sun.com/products/jdk/1.4/docs/api

maven.xdoc.jsl=../commons-build/commons-site.jsl
maven.xdoc.date=bottom
maven.xdoc.poweredby.image=maven-feather.png
maven.xdoc.version=${pom.currentVersion}
maven.xdoc.developmentProcessUrl=http://commons.apache.org/charter.html
maven.xdoc.includeProjectDocumentation=yes

maven.compile.debug=on
maven.compile.deprecation=off
maven.compile.optimize=off

maven.jarResources.basedir=src/java
maven.jar.excludes=**/package.html
maven.junit.fork=true
maven.junit.sysproperties=org.xml.sax.driver
org.xml.sax.driver=org.apache.xerces.parsers.SAXParser

clover.excludes=**/Test*.java

 =======================================================================
 ==project.xml
 =======================================================================
 <?xml version="1.0"?>
<project>
  <extend>../commons-build/sandbox-project.xml</extend>
  <name>Commons Scaffold</name>
  <id>commons-scaffold</id>
  <logo>/images/scaffold-logo-white.png</logo>
  <url>http://commons.apache.org/scaffold/</url>
  <inceptionYear>2002</inceptionYear>
  <shortDescription>Commons Scaffold</shortDescription>
  <description>Commons Scaffold</description>

  <currentVersion>0.1-dev</currentVersion>
  <versions>
  </versions>
  <branches>
  </branches>

  <developers>
    <developer>
      <name>Ted Husted</name>
      <id>husted</id>
      <email></email>
      <organization></organization>
    </developer>
  </developers>
  
  <dependencies>
    <dependency>
      <id>servletapi</id>
      <version>2.3</version>
    </dependency>
    <dependency>
      <id>struts</id>
      <version>1.1</version>
    </dependency>
    <dependency>
      <id>commons-beanutils</id>
      <version>1.6</version>
    </dependency>
    <dependency>
      <id>lucene</id>
      <version>1.2</version>
    </dependency>
    <dependency>
      <groupId>mockobjects</groupId>
      <artifactId>mockobjects-jdk1.4-j2ee1.3</artifactId>
      <version>0.09</version>
    </dependency>
    <dependency>
      <groupId>mockobjects</groupId>

 =======================================================================
 ==src/conf/MANIFEST.MF
 =======================================================================
 Extension-Name: org.apache.commons.@name@
Specification-Vendor: Apache Software Foundation
Specification-Version: 1.0
Implementation-Vendor: Apache Software Foundation
Implementation-Version: @version@


 =======================================================================
 ==src/java/org/apache/commons/scaffold/sql/command.properties.sample.txt
 =======================================================================
 # /**
#  * Sample SQL Commands
#  *
#  * @author Ted Husted
#  * @version $Revision: 155464 $ $Date: 2005-02-26 13:26:54 +0000 (Sat, 26 Feb 2005) $
#  * @license <a href="http://apache.org/LICENSE">Apache License</a>
#  */
# 
keys.table = nextKeys
keys.first = 101
keys.table.create = CREATE TABLE nextKeys (name char(32) NOT NULL PRIMARY KEY,marked smallint(1) NOT NULL DEFAULT 0,next int(11) NOT NULL DEFAULT 0);
keys.next = SELECT next FROM nextKeys WHERE name=?;
keys.inc = UPDATE nextKeys SET next=next+1 WHERE name=?;
# // command.properties

 =======================================================================
 ==src/java/poolman.xml
 =======================================================================
 <?xml version="1.0" encoding="UTF-8"?>

<poolman>

  <management-mode>local</management-mode>

  <!-- ========================================================== -->
  <!-- These entries are an example of JDBC Connection pooling.   -->
  <!-- Many of the parameters are optional. Consult the           -->
  <!-- UsersGuide.html doument and the poolman.xml.template file  -->
  <!-- for guidance and element definitions.                      -->
  <!-- ========================================================== -->

  <datasource>

    <!-- ============================== -->
    <!-- Physical Connection Attributes -->
    <!-- ============================== -->

    <!-- Standard JDBC Driver info -->

    <dbname>jdbc-artimus</dbname>
    <jndiName>jndi-artimus</jndiName>
    <driver>org.gjt.mm.mysql.Driver</driver>
    <url>jdbc:mysql://localhost:3306/artimus</url>

    <username>root</username>
    <password></password>

    <minimumSize>0</minimumSize>
    <maximumSize>10</maximumSize>
    <connectionTimeout>600</connectionTimeout>
    <userTimeout>12</userTimeout>
    <shrinkBy>10</shrinkBy>

    <logFile>/var/applogs/poolman-artimus.log</logFile>
    <debugging>false</debugging>

    <!-- Query Cache Attributes-->

    <cacheEnabled>true</cacheEnabled>
    <cacheSize>20</cacheSize>
    <cacheRefreshInterval>120</cacheRefreshInterval>

  </datasource>

  <!-- DISABLED FOR PRODUCTION
  <admin-agent>
    <class>com.sun.jdmk.comm.HtmlAdaptorServer</class>
    <name>Adaptor:name=html</name>

 =======================================================================
 ==STATUS/STATUS-001.txt
 =======================================================================
 SCAFFOLD STATUS
=======================================================================
[Ordering is LIFO. Last thing done for a day is the first item listed.]


// ------------------------------------------------------------ CHANGES

08-OCT-01
---------
+ AccessBean: refactor getMap(int) method.
+ AccessBean,AccessBeanList: Add first() method
+ client: refactor to call performCrud on ancestor.
+ ext.http.Access: add performCrud method.

27-SEP-01
---------
+ Access,AccessBean: General refactoring.
+ ArticleForm: Remove toMap method in favor of ancestor.
+ AccessBean: Conform to new DataBeanBase source.
+ DataBeanBase: Add default behavior for toMap using BeanUtil.describe
+ Convert MapAccess to DataBean, and refactor. Add getKeyInt,setKeyInt methods.
+ *: Review and revise Javadoc.


26-SEP-01
---------
+ AccessBeanMap: Remove unused class.
+ AccessBean,AccessBeanList: Remove methods not used in current version of application.
+ Access,Client: Refactor SaveConfirm method from ancestor Client class.
+ ArticleHelper: Move call to allocateKey from Access.crud.
+ ArticleHelper: Add loops around update,insert for multiple forms.
+ README.TXT: Update for Tomcat 4.0 production release.
+ ConnectionPool: Eliminate unnecessary statics
+ build.xml: Add Javadoc targete
+ com/*: Shorten package name to proweb
+ src/*: Move source under java, per new conventions.
+ WEB-INF/pages/*: Move pages to root; add stylesheet.


18-SEP-01
---------
+ ApplicationResources: Add missingHTML markup to error tags.
+ Engine: Update path for index (/var/lucene/articles)
+ poolman.xml


13-SEP-01
---------
+ LuceneUtils


 =======================================================================
 ==STATUS/STATUS-002.txt
 =======================================================================
 SCAFFOLD STATUS
=======================================================================
[Ordering is LIFO. Last thing done for a day is the first item listed.]


// ------------------------------------------------------------ CHANGES

01-AUG-2002
-----------
+ resources/application.properties: Add stub file for messages in lang.TOKENS.
+ lang.Token: Add PROCESS_COMPLETE
+ struts.BaseAction.createHelper: Change to throw runtime exception if helper fails.
+ sql_article: Add "article.insert.welcome"
+ README.txt: Update to match current status.


31-JUL-2002
-----------

[port updates from 1.0]
+ text.ConvertUtils: Add isUpperOrNull.
+ Deprecate sql.CreateTable
+ sql.StatementUtil: Deprcate CreateTable in favor of AccessBase.executeUpdate.
+ sql.AccessBase: Add new utility with commonly-used methods for store, delete, restore, et al.


1_0 <-> 1_1
+ // imports in lucene,model,struts,util packages; 

19-JUN-2002
-----------
+ struts.ProcessResult: Add check for null form-bean. Will pass null or map for profile bean, if any.

18-JUN-2002
-----------
+ lang.Tokens: Add terms for ERROR_CANCEL, ERROR_TOKEN.
+ stuts.BaseAction,ProcessAction: Remove cancel,token handling to ProcessAction


17-JUNE-2002
------------
+ struts/BaseAction: Add isStruts_1_0() method to expose/not expose MESSAGES.

13-JUN-2002
-----------
+ struts: add CheckAttributeAction and RemoveAttributeAction.
+ move deprecated struts classes in an "attic" subfolder.
+ move scaffold/struts package into its own folder.



 =======================================================================
 ==STATUS/STATUS-003.txt
 =======================================================================
 
[SCAFFOLD]
=======================================================================
[Ordering is LIFO. Last thing done for a day is the first item listed.]


// --------------------------------------------------------------- TODO

- ResourceServlet: Add a message resource bundle for internal messages
- ResourceServlet: The PROPERTIES_KEY could be made configurable,
- BaseException: Add message bundle to package and localized messages.
- Engine: Make singleton instead of static
- CommandStore: Refactor to use Collection based on preface.
- CommandStore: Refactor to make appending preface.key optional
- ConnectionAdaptor: Add Map to store reference to other datasources.
- ConnectionAdaptor: Add cache to store references to the datasources by key.
- StorageBeanBase: Use reflection to read parameter key and make array from
- StorageBeanBase: Check for key.paramlist then paramlist.
- StorageBeanBase: Permit each subclass to have its own properties (collection
- StorageBeanBase: Switch to CommandStore (or eliminate that object if not
- StorageBeanBase: Change from BeanUtil.populate to copyProperties in 1.1
+ StorageBeanBean: Define underlying interface
- StorageBeanBean: Javadocs for new classes

- i18n exception messages.

- Add support for Tokens.INPUT

// ------------------------------------------------------------ CHANGES


[2002-11-20]
+ StorageBeanBase: Add support for reading command parameters from 
a *.param line for each query.
+ StorageBean*: Add paramList property (to ease migration to Commons.SQL)
+ StorageBean*,ProcessBean*: Move Remote* properties to ProcessBean.
+ ResultSetUtils: Deprecate setProperties in favor of BeanUtils.copyProperties.

[2002-11-19]
+ StorageBeanBase: isNew: change to use String or Number validation
when value is not null; store: Fix to use isNew.

[2002-11-13]
+ ConvertUtils: Add and refactor some Timestamp methods.

[2002-10-30]
+ ScrollerBean: Change getParameters to scrollerParams to avoid conflict with StorageBean method. Add scrollOffset property. Change searchKey to searchValue to avoid confusion as to purpose. Change return type to Object for using with non-string fields.
+ StatementUtils: Add like method for wrapping strings; remove *Like methods.
+ ScrollerBean: streamline interface and implementation; change to use standard calls rather than like
+ Scroller/ScrollerBeanBase: change to use count and collection rather than *like.