RAT (Release Audit Tool) results

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

*****************************************************
Summary
-------
Notes: 3
Binaries: 4
Archives: 0
Standards: 75

Apache Licensed: 67
Generated Documents: 0

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

8 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
  AL    build.properties.default
  AL    build.properties.sample
  AL    build.xml
 !????? doap_modeler.rdf
  N     LICENSE.txt
  AL    maven.xml
 !????? mbeans.xml
  N     NOTICE.txt
  AL    pom.xml
  AL    project.properties
  AL    project.xml
 !????? PROPOSAL.html
 !????? RELEASE-NOTES-1.1.txt
 !????? RELEASE-NOTES-2.0.txt
  N     RELEASE-NOTES.txt
 !????? RELEASE-PLAN-1.1.txt
  AL    src/assembly/bin.xml
  AL    src/assembly/src.xml
 !????? src/conf/MANIFEST.MF
  AL    src/java/org/apache/commons/modeler/ant/ant.properties
  AL    src/java/org/apache/commons/modeler/ant/Arg.java
  AL    src/java/org/apache/commons/modeler/ant/JmxInvoke.java
  AL    src/java/org/apache/commons/modeler/ant/JmxSet.java
  AL    src/java/org/apache/commons/modeler/ant/MLETTask.java
  AL    src/java/org/apache/commons/modeler/ant/ModelerTask.java
  AL    src/java/org/apache/commons/modeler/ant/package.html
  AL    src/java/org/apache/commons/modeler/ant/RegistryTask.java
  AL    src/java/org/apache/commons/modeler/ant/ServiceTask.java
  AL    src/java/org/apache/commons/modeler/AttributeInfo.java
  AL    src/java/org/apache/commons/modeler/BaseAttributeFilter.java
  AL    src/java/org/apache/commons/modeler/BaseModelMBean.java
  AL    src/java/org/apache/commons/modeler/BaseNotification.java
  AL    src/java/org/apache/commons/modeler/BaseNotificationBroadcaster.java
  AL    src/java/org/apache/commons/modeler/ConstructorInfo.java
  AL    src/java/org/apache/commons/modeler/FeatureInfo.java
  AL    src/java/org/apache/commons/modeler/FieldInfo.java
  AL    src/java/org/apache/commons/modeler/FixedNotificationFilter.java
  AL    src/java/org/apache/commons/modeler/JndiJmx.java
  AL    src/java/org/apache/commons/modeler/Main.java
  AL    src/java/org/apache/commons/modeler/ManagedBean.java
  AL    src/java/org/apache/commons/modeler/mbeans/MBeanProxy.java
  AL    src/java/org/apache/commons/modeler/mbeans/SimpleRemoteConnector.java
  AL    src/java/org/apache/commons/modeler/mbeans-descriptors.dtd
  AL    src/java/org/apache/commons/modeler/modules/MbeansDescriptorsDigesterSource.java
  AL    src/java/org/apache/commons/modeler/modules/MbeansDescriptorsDOMSource.java
  AL    src/java/org/apache/commons/modeler/modules/MbeansDescriptorsDynamicMBeanSource.java
  AL    src/java/org/apache/commons/modeler/modules/MbeansDescriptorsIntrospectionSource.java
  AL    src/java/org/apache/commons/modeler/modules/MbeansDescriptorsSerSource.java
  AL    src/java/org/apache/commons/modeler/modules/MbeansSource.java
  AL    src/java/org/apache/commons/modeler/modules/MbeansSourceMBean.java
  AL    src/java/org/apache/commons/modeler/modules/ModelerSource.java
  AL    src/java/org/apache/commons/modeler/modules/package.html
  AL    src/java/org/apache/commons/modeler/NotificationInfo.java
  AL    src/java/org/apache/commons/modeler/OperationInfo.java
  AL    src/java/org/apache/commons/modeler/package.html
  AL    src/java/org/apache/commons/modeler/ParameterInfo.java
  AL    src/java/org/apache/commons/modeler/Registry.java
  AL    src/java/org/apache/commons/modeler/RegistryMBean.java
  AL    src/java/org/apache/commons/modeler/util/DomUtil.java
  AL    src/java/org/apache/commons/modeler/util/IntrospectionUtils.java
  B     src/site/resources/images/modeler-logo-white.png
  B     src/site/resources/images/modeler-logo-white.xcf
  AL    src/site/site.xml
  AL    src/test/org/apache/commons/modeler/demo/Connector.java
  AL    src/test/org/apache/commons/modeler/demo/Container.java
  AL    src/test/org/apache/commons/modeler/demo/Demo.java
  AL    src/test/org/apache/commons/modeler/demo/Engine.java
  AL    src/test/org/apache/commons/modeler/demo/mbeans-descriptors.xml
  AL    src/test/org/apache/commons/modeler/demo/Server.java
  AL    src/test/org/apache/commons/modeler/demo/Service.java
  AL    src/test/org/apache/commons/modeler/mbeans-descriptors.xml
  AL    src/test/org/apache/commons/modeler/RegistryTestCase.java
  AL    xdocs/building.xml
  AL    xdocs/cvs-usage.xml
  AL    xdocs/downloads.xml
  AL    xdocs/download_modeler.xml
  B     xdocs/images/modeler-logo-white.png
  B     xdocs/images/modeler-logo-white.xcf
  AL    xdocs/index.xml
  AL    xdocs/issue-tracking.xml
  AL    xdocs/navigation.xml
 !????? xdocs/style/project.css
 
 *****************************************************
 Printing headers for files without AL header...
 
 
 =======================================================================
 ==doap_modeler.rdf
 =======================================================================
 <?xml version="1.0"?>
<rdf:RDF xmlns="http://usefulinc.com/ns/doap#" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:asfext="http://projects.apache.org/ns/asfext#" xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#" xmlns:doap="http://usefulinc.com/ns/doap#" xml:lang="en">
  <Project rdf:about="http://commons.apache.org/modeler/">
    <name>Apache Commons Modeler</name>
    <homepage rdf:resource="http://commons.apache.org/modeler/"/>
    <programming-language>Java</programming-language>
    <category rdf:resource="http://projects.apache.org/category/library"/>
    <license rdf:resource="http://usefulinc.com/doap/licenses/asl20"/>
    <bug-database rdf:resource="http://issues.apache.org/jira/browse/MODELER"/>
    <download-page rdf:resource="http://jakarta.apache.org/site/downloads/downloads_commons-modeler.cgi"/>
    <asfext:pmc rdf:resource="http://commons.apache.org/"/>
    <shortdesc xml:lang="en">Commons Modeler</shortdesc>
    <description xml:lang="en">
    Commons Modeler
  </description>
    <repository>
      <SVNRepository>
        <browse rdf:resource="http://svn.apache.org/repos/asf/commons/proper/modeler/trunk"/>
        <location rdf:resource="http://svn.apache.org/repos/asf/commons/proper/modeler"/>
      </SVNRepository>
    </repository>
    <release>
      <Version>
        <name>2.0.1</name>
        <created>2007-06-25</created>
        <revision>2.0.1</revision>
      </Version>
      <Version>
        <name>2.0</name>
        <created>2006-07-31</created>
        <revision>2.0</revision>
      </Version>
      <Version>
        <name>1.1</name>
        <created>2003-08-10</created>
        <revision>1.1</revision>
      </Version>
      <Version>
        <name>1.0</name>
        <created>2002-12-27</created>
        <revision>1.0</revision>
      </Version>
    </release>
    <mailing-list rdf:resource="http://commons.apache.org/mail-lists.html"/>
  </Project>
</rdf:RDF>

 =======================================================================
 ==mbeans.xml
 =======================================================================
 <server>

  <!-- 
  -->
    
    <mbean name="Http:name=HttpAdaptor"
	 code="mx4j.adaptor.http.HttpAdaptor">
    <attribute name="Port" value="9999" type="int" />  
  </mbean>

  <mbean name="Http:name=XSLTProcessor"
         code="mx4j.adaptor.http.XSLTProcessor"/>

  <jmx-attribute objectName="Http:name=HttpAdaptor"
		 name="ProcessorName"
		 type="ObjectName"
                 value="Http:name=XSLTProcessor"/>

  <jmx-operation objectName="Http:name=HttpAdaptor"
                 operation="start" />


  <!-- MX4J RMI
  -->
          
  <MLET name="Naming:name=rmiregistry" 
        code="mx4j.tools.naming.NamingService" >
  </MLET>

  <jmx-operation objectName="Naming:name=rmiregistry"
                 operation="start" />

  <mbean name="Adaptor:protocol=jrmp"
         code="mx4j.adaptor.rmi.jrmp.JRMPAdaptor">
    <attribute name="JNDIName" value="jrmp" />
  </mbean>
            
  <jmx-operation objectName="Adaptor:protocol=jrmp"
                 operation="putNamingProperty" >
    <arg type="java.lang.Object">java.naming.factory.initial</arg>
    <arg type="java.lang.Object">com.sun.jndi.rmi.registry.RegistryContextFactory</arg>
  </jmx-operation>

  <jmx-operation objectName="Adaptor:protocol=jrmp"
                 operation="putNamingProperty" >
    <arg type="java.lang.Object">java.naming.provider.url</arg>
    <arg type="java.lang.Object">rmi://localhost:1099</arg>
  </jmx-operation>

  <jmx-operation objectName="Adaptor:protocol=jrmp"

 =======================================================================
 ==PROPOSAL.html
 =======================================================================
 <html>
<head>
<title>Proposal for Modeler Package</title>
</head>
<body bgcolor="white">

<div align="center">
<h1>Proposal for <em>Modeler</em> Package</h1>
</div>

<h3>(0) Rationale</h3>

<p>Among the myriad of Java APIs available is the
<a href="http://java.sun.com/products/JavaManagement/">Java Management
Extensions</a> (JMX) APIs, which define "an architecture, the design patterns,
the APIs, and the services for application and network management in the
Java programming language."  These APIs include standards for designing
"Managed Beans" (MBeans) that are associated with components of your
application that you wish to make manageable via a variety of tools (either
local or remote.</p>

<p>The JMX architecture includes a variety of design patterns for MBeans.  The
two most commonly used patterns are:</p>
<ul>
<li><em>Standard MBeans</em> - The developer designs an interface that
    corresponds with the class for each managed resource, exposing only the
    attributes and operations required for management.  The managed resource
    class must implement this interface, according to standard Java
    language rules, for this resource to become manageable.</li>
<li><em>Model MBeans</em> - A generic, configurable MBean which can be
    used to make almost any resource manageable.  Rather than relying on
    implementing a Java interface, Model MBeans utilize <em>metadata</em>
    about the constructors, attributes, and operations that are supported
    to make calls on the managed resource's class, using Java's reflection
    APIs to call arbitrary methods with arbitrary arguments.</li>
</ul>

<p>At first glance, Model MBeans sound incredibly useful -- they require no
changes at all to the Java class representing the managed resource, and you
can use a standard base class provided with the JMX implementation to perform
almost all of your management requirements.  However, the developer is still
required to provide the metadata, which can be tedious to create when there
are many managed resources, with many attributes and operations made available
by those resources.  This is where the <strong>Modeler</strong> comes in.</p>

<p><strong>Modeler</strong> provides the following services to the application
developer who wishes to make their applications manageable via JMX:</p>
<ul>
<li>Reads an XML-based description of the Model MBeans to be provided for a
    set of managed resource classes, defining all of the constructors,

 =======================================================================
 ==RELEASE-NOTES-1.1.txt
 =======================================================================
 $Id: RELEASE-NOTES-1.1.txt 155428 2005-02-26 13:12:25Z dirkv $

                          Commons Modeler Package
                                Version 1.1
                               Release Notes


INTRODUCTION:
============

This document contains the release notes for this version of the Commons
Modeler package, and highlights changes since the previous version.


NEW FEATURES:
============

* Support for components that are not explicitely declared. Introspection and common
patterns are used to expose all attributes and simple methods with known type.

* New parser using DOM. That reduces the dependencies, is a bit faster and allows more
flexibility in processing the input,
 
* Support serialization of the model, and loading the .ser format. Serialization is 
implemented using an ant task, and all objects in the model are serializable. Reading the
.ser form is much faster than processing the XML.

* A set of ant tasks that use modeler to load metadata and operate on mbeans. The tasks
can be used with any JMX component, not only with modeler. An example use is tomcat5.

* Support for loading extended mlet files, with a syntax consistent with the ant tasks
and JBoss ( and other ). 

* Helper to perform lifecycle operations on sets of mbeans.

* A small startup program ( org.apache.commons.modeler.Main ) capable of loading an mlet
file and performing init/start on all components. This can help in testing and jumpstarting
small applications.

* Cleaner APIs, with deprecation of static methods.

* New methods to access the Registry, with support for container application separation.

* (Experimental) support for remote mbeans, allowing management of non-local mbeans. 

* (Experimental) support for persistence for mbeans loaded from the mbeans file. Modification of attributes will be saved, however adding new mbeans is not yet implemented.

* The distribution package includes commons-modeler-src.jar which can be used in IDEs to 
quickly see the sources when debugging and to do small builds.


 =======================================================================
 ==RELEASE-NOTES-2.0.txt
 =======================================================================
 $Id: RELEASE-NOTES-2.0.txt 549466 2007-06-21 13:10:59Z niallp $

                          Commons Modeler Package
                                Version 2.0
                               Release Notes


INTRODUCTION:
============

This document contains the release notes for this version of the Commons
Modeler package, and highlights changes since the previous version.

For more information on Jakarta Commons Modeler, see
o http://jakarta.apache.org/commons/modeler/

API CHANGES:
============
o In org.apache.commons.modeler.BaseModelMBean, getObjectName's method 
  signature was as follows:
    public javax.management.ObjectName getObjectName() 
  Now it has been changed to 
    public String getObjectName() 
  NOTE: This was not logged as a modeler bug. More information can be 
  found at the Sun Bug Database:
    http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=4909041
o In org.apache.commons.modeler.BaseModelMBean, Folks who need the 
  ObjectName can now use the new method:
    public javax.management.ObjectName getJmxName()
  NOTE: This was not logged as a modeler bug. More information can be 
  found at the Sun Bug Database:
    http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=4909041
o In org.apache.commons.modeler.util.IntrospectionUtils, A new method 
  clear has been added:
    public void clear()
  NOTE: This was done as part of fix for MODELER-15

BUG REPORTS ADDRESSED:
=====================

o MODELER-18 	 support for general descriptors
o MODELER-17 	 [modeler] MbeansSource don't use args at mbeans and operations
o MODELER-16 	 [modeler] download links broken  
o MODELER-15 	 [modeler] IntrospectionUtils memory leak  
o MODELER-14 	 After setting an Attribute the Notification Listener will not performed  
o MODELER-13 	 [modeler] BaseModelMBean class setModeledType method should be setModelerType  
o MODELER-12 	 [modeler] ManagedBean uses the wrong case for ObjectReference  
o MODELER-11 	 [modeler] Null Pointer Exception - Non-Singleton Registry  
o MODELER-10 	 [modeler] DTD violation when using simple wrapping  
o MODELER-9 	 [modeler] Registry.convertValue doesn't support longs  

 =======================================================================
 ==RELEASE-PLAN-1.1.txt
 =======================================================================
                       Release Plan for Jakarta Commons Modeler 1.1                                            ============================================


Introduction:
------------

This document is a release plan for the final release of Jakarta
Commons Modeler 1.1.  The 1.1-M1 release has been available for
several weeks now, with no bugs reported against it.  A final
stable release is desired for Tomcat 5.

The release notes are in this directory's RELEASE-NOTES-1.1.txt
file.

This Release Plan the following prospective target dates:

  2003-07-29: commons-dev vote on this Release Plan

Assuming this plan is approved by committer majority:
  2003-08-03: Code freeze for modeler 1.1
  2003-08-04: Modeler 1.1 final build built and tagged in CVS

This release plan is subject should change should bugs be
reported against the 1.1-M1 release of Modeler.

 =======================================================================
 ==src/conf/MANIFEST.MF
 =======================================================================
 Manifest-version: 1.1
Extension-Name: org.apache.commons.modeler
Specification-Title: Commons Modeler
Specification-Vendor: Apache Software Foundation
Specification-Version: 2.1-SNAPSHOT
Implementation-Vendor-Id: org.apache
Implementation-Vendor: Apache Software Foundation
Implementation-Version: 2.1-SNAPSHOT

 =======================================================================
 ==xdocs/style/project.css
 =======================================================================
 @import url("http://commons.apache.org/style/commons-maven.css");