commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From nia...@apache.org
Subject svn commit: r555824 [1/3] - in /jakarta/commons/proper/beanutils/trunk: ./ optional/bean-collections/src/java/ optional/bean-collections/src/java/org/apache/commons/beanutils/ src/java/ src/java/org/apache/commons/beanutils/ src/java/org/apache/commons...
Date Fri, 13 Jul 2007 00:27:20 GMT
Author: niallp
Date: Thu Jul 12 17:27:15 2007
New Revision: 555824

URL: http://svn.apache.org/viewvc?view=rev&rev=555824
Log:
BEANUTILS-254 - fix checkstyle type issues:
- fix javadoc issues
- make source file headers uniform
- add some missing source file headers
- remove tab characters
- fix static names where possible (i.e. when they're private)

Modified:
    jakarta/commons/proper/beanutils/trunk/doap_beanutils.rdf
    jakarta/commons/proper/beanutils/trunk/optional/bean-collections/src/java/org/apache/commons/beanutils/BeanComparator.java
    jakarta/commons/proper/beanutils/trunk/optional/bean-collections/src/java/org/apache/commons/beanutils/BeanMap.java
    jakarta/commons/proper/beanutils/trunk/optional/bean-collections/src/java/org/apache/commons/beanutils/BeanPredicate.java
    jakarta/commons/proper/beanutils/trunk/optional/bean-collections/src/java/org/apache/commons/beanutils/BeanPropertyValueChangeClosure.java
    jakarta/commons/proper/beanutils/trunk/optional/bean-collections/src/java/org/apache/commons/beanutils/BeanPropertyValueEqualsPredicate.java
    jakarta/commons/proper/beanutils/trunk/optional/bean-collections/src/java/org/apache/commons/beanutils/BeanToPropertyValueTransformer.java
    jakarta/commons/proper/beanutils/trunk/optional/bean-collections/src/java/overview.html
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/BasicDynaBean.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/BasicDynaClass.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/BeanAccessLanguageException.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/BeanUtils.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/BeanUtilsBean.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ConstructorUtils.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ContextClassLoaderLocal.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ConversionException.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ConvertUtils.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ConvertUtilsBean.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/Converter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ConvertingWrapDynaBean.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/DynaBean.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/DynaClass.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/DynaProperty.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/JDBCDynaClass.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/LazyDynaBean.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/LazyDynaClass.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/LazyDynaList.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/LazyDynaMap.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/MappedPropertyDescriptor.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/MethodUtils.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/MutableDynaClass.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/NestedNullException.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/PropertyUtils.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/PropertyUtilsBean.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ResultSetDynaClass.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ResultSetIterator.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/RowSetDynaClass.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/WrapDynaBean.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/WrapDynaClass.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/converters/AbstractArrayConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/converters/AbstractConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/converters/ArrayConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/converters/BigDecimalConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/converters/BigIntegerConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/converters/BooleanArrayConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/converters/BooleanConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/converters/ByteArrayConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/converters/ByteConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/converters/CalendarConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/converters/CharacterArrayConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/converters/CharacterConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/converters/ClassConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/converters/DateConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/converters/DateTimeConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/converters/DoubleArrayConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/converters/DoubleConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/converters/FileConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/converters/FloatArrayConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/converters/FloatConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/converters/IntegerArrayConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/converters/IntegerConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/converters/LongArrayConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/converters/LongConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/converters/NumberConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/converters/ShortArrayConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/converters/ShortConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/converters/StringArrayConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/converters/StringConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/converters/URLConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/converters/package.html
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/expression/package.html
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/locale/BaseLocaleConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/locale/LocaleBeanUtils.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/locale/LocaleBeanUtilsBean.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/locale/LocaleConvertUtils.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/locale/LocaleConvertUtilsBean.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/locale/LocaleConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/locale/converters/BigDecimalLocaleConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/locale/converters/BigIntegerLocaleConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/locale/converters/ByteLocaleConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/locale/converters/DateLocaleConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/locale/converters/DecimalLocaleConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/locale/converters/DoubleLocaleConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/locale/converters/FloatLocaleConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/locale/converters/IntegerLocaleConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/locale/converters/LongLocaleConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/locale/converters/ShortLocaleConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/locale/converters/SqlDateLocaleConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/locale/converters/SqlTimeLocaleConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/locale/converters/SqlTimestampLocaleConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/locale/converters/StringLocaleConverter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/locale/converters/package.html
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/locale/package.html
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/package.html
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/collections/ArrayStack.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/collections/Buffer.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/collections/BufferUnderflowException.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/collections/FastHashMap.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/collections/package.html
    jakarta/commons/proper/beanutils/trunk/src/java/overview.html
    jakarta/commons/proper/beanutils/trunk/src/test/org/apache/commons/beanutils/PropsFirstPropertyUtilsBean.java

Modified: jakarta/commons/proper/beanutils/trunk/doap_beanutils.rdf
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/doap_beanutils.rdf?view=diff&rev=555824&r1=555823&r2=555824
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/doap_beanutils.rdf (original)
+++ jakarta/commons/proper/beanutils/trunk/doap_beanutils.rdf Thu Jul 12 17:27:15 2007
@@ -1,4 +1,20 @@
 <?xml version="1.0"?>
+<!--
+   Licensed to the Apache Software Foundation (ASF) under one or more
+   contributor license agreements.  See the NOTICE file distributed with
+   this work for additional information regarding copyright ownership.
+   The ASF licenses this file to You under the Apache License, Version 2.0
+   (the "License"); you may not use this file except in compliance with
+   the License.  You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+-->
 <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://jakarta.apache.org/commons/beanutils/index.html">
     <name>Apache Jakarta Commons BeanUtils</name>

Modified: jakarta/commons/proper/beanutils/trunk/optional/bean-collections/src/java/org/apache/commons/beanutils/BeanComparator.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/optional/bean-collections/src/java/org/apache/commons/beanutils/BeanComparator.java?view=diff&rev=555824&r1=555823&r2=555824
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/optional/bean-collections/src/java/org/apache/commons/beanutils/BeanComparator.java (original)
+++ jakarta/commons/proper/beanutils/trunk/optional/bean-collections/src/java/org/apache/commons/beanutils/BeanComparator.java Thu Jul 12 17:27:15 2007
@@ -5,15 +5,15 @@
  * The ASF licenses this file to You under the Apache License, Version 2.0
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
- * 
+ *
  *      http://www.apache.org/licenses/LICENSE-2.0
- * 
+ *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
- */ 
+ */
 
 package org.apache.commons.beanutils;
 
@@ -131,6 +131,8 @@
 
     /**
      * Gets the Comparator being used to compare beans.
+     *
+     * @return the Comparator being used to compare beans 
      */
     public Comparator getComparator() {
         return comparator;
@@ -172,6 +174,8 @@
      * Two <code>BeanComparator</code>'s are equals if and only if
      * the wrapped comparators and the property names to be compared
      * are equal.
+     * @param  o Comparator to compare to
+     * @return whether the the comparators are equal or not
      */
     public boolean equals(Object o) {
         if (this == o) return true;
@@ -194,6 +198,7 @@
 
     /**
      * Hashcode compatible with equals.
+     * @return the hash code for this comparator
      */ 
     public int hashCode() {
         int result;

Modified: jakarta/commons/proper/beanutils/trunk/optional/bean-collections/src/java/org/apache/commons/beanutils/BeanMap.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/optional/bean-collections/src/java/org/apache/commons/beanutils/BeanMap.java?view=diff&rev=555824&r1=555823&r2=555824
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/optional/bean-collections/src/java/org/apache/commons/beanutils/BeanMap.java (original)
+++ jakarta/commons/proper/beanutils/trunk/optional/bean-collections/src/java/org/apache/commons/beanutils/BeanMap.java Thu Jul 12 17:27:15 2007
@@ -6,7 +6,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
  *
- *     http://www.apache.org/licenses/LICENSE-2.0
+ *      http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
@@ -241,6 +241,10 @@
      * CloneNotSupportedException.
      *
      * <ul>
+     *
+     * @return a cloned instance of this bean map
+     * @throws CloneNotSupportedException if the underlying bean
+     * cannot be cloned
      */
     public Object clone() throws CloneNotSupportedException {
         BeanMap newMap = (BeanMap)super.clone();
@@ -411,6 +415,7 @@
      *   if the given name is not a {@link String}; if the bean doesn't
      *   define a property with that name; or if the bean property with
      *   that name is read-only
+     * @throws ClassCastException if an error occurs creating the method args
      */
     public Object put(Object name, Object value) throws IllegalArgumentException, ClassCastException {
         if ( bean != null ) {
@@ -744,6 +749,7 @@
      *   raises it
      * @throws IllegalArgumentException if any other exception is raised
      *   by {@link #convertType(Class,Object)}
+     * @throws ClassCastException if an error occurs creating the method args
      */
     protected Object[] createWriteMethodArguments( Method method, Object value ) throws IllegalAccessException, ClassCastException {            
         try {

Modified: jakarta/commons/proper/beanutils/trunk/optional/bean-collections/src/java/org/apache/commons/beanutils/BeanPredicate.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/optional/bean-collections/src/java/org/apache/commons/beanutils/BeanPredicate.java?view=diff&rev=555824&r1=555823&r2=555824
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/optional/bean-collections/src/java/org/apache/commons/beanutils/BeanPredicate.java (original)
+++ jakarta/commons/proper/beanutils/trunk/optional/bean-collections/src/java/org/apache/commons/beanutils/BeanPredicate.java Thu Jul 12 17:27:15 2007
@@ -5,9 +5,9 @@
  * The ASF licenses this file to You under the Apache License, Version 2.0
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
- * 
+ *
  *      http://www.apache.org/licenses/LICENSE-2.0
- * 
+ *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
@@ -53,7 +53,10 @@
     /**
      * Evaluates the given object by applying the {@link #getPredicate()}
      * to a property value named by {@link #getPropertyName()}.
-     * @throws IllegalAccessException when the property cannot be evaluated
+     *
+     * @param object The object being evaluated
+     * @return the result of the predicate evaluation
+     * @throws IllegalArgumentException when the property cannot be evaluated
      */
     public boolean evaluate(Object object) {
        

Modified: jakarta/commons/proper/beanutils/trunk/optional/bean-collections/src/java/org/apache/commons/beanutils/BeanPropertyValueChangeClosure.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/optional/bean-collections/src/java/org/apache/commons/beanutils/BeanPropertyValueChangeClosure.java?view=diff&rev=555824&r1=555823&r2=555824
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/optional/bean-collections/src/java/org/apache/commons/beanutils/BeanPropertyValueChangeClosure.java (original)
+++ jakarta/commons/proper/beanutils/trunk/optional/bean-collections/src/java/org/apache/commons/beanutils/BeanPropertyValueChangeClosure.java Thu Jul 12 17:27:15 2007
@@ -5,15 +5,15 @@
  * The ASF licenses this file to You under the Apache License, Version 2.0
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
- * 
+ *
  *      http://www.apache.org/licenses/LICENSE-2.0
- * 
+ *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
- */ 
+ */
  
 package org.apache.commons.beanutils;
 

Modified: jakarta/commons/proper/beanutils/trunk/optional/bean-collections/src/java/org/apache/commons/beanutils/BeanPropertyValueEqualsPredicate.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/optional/bean-collections/src/java/org/apache/commons/beanutils/BeanPropertyValueEqualsPredicate.java?view=diff&rev=555824&r1=555823&r2=555824
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/optional/bean-collections/src/java/org/apache/commons/beanutils/BeanPropertyValueEqualsPredicate.java (original)
+++ jakarta/commons/proper/beanutils/trunk/optional/bean-collections/src/java/org/apache/commons/beanutils/BeanPropertyValueEqualsPredicate.java Thu Jul 12 17:27:15 2007
@@ -5,15 +5,15 @@
  * The ASF licenses this file to You under the Apache License, Version 2.0
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
- * 
+ *
  *      http://www.apache.org/licenses/LICENSE-2.0
- * 
+ *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
- */ 
+ */
  
 package org.apache.commons.beanutils;
 

Modified: jakarta/commons/proper/beanutils/trunk/optional/bean-collections/src/java/org/apache/commons/beanutils/BeanToPropertyValueTransformer.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/optional/bean-collections/src/java/org/apache/commons/beanutils/BeanToPropertyValueTransformer.java?view=diff&rev=555824&r1=555823&r2=555824
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/optional/bean-collections/src/java/org/apache/commons/beanutils/BeanToPropertyValueTransformer.java (original)
+++ jakarta/commons/proper/beanutils/trunk/optional/bean-collections/src/java/org/apache/commons/beanutils/BeanToPropertyValueTransformer.java Thu Jul 12 17:27:15 2007
@@ -5,15 +5,15 @@
  * The ASF licenses this file to You under the Apache License, Version 2.0
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
- * 
+ *
  *      http://www.apache.org/licenses/LICENSE-2.0
- * 
+ *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
- */ 
+ */
  
 package org.apache.commons.beanutils;
 

Modified: jakarta/commons/proper/beanutils/trunk/optional/bean-collections/src/java/overview.html
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/optional/bean-collections/src/java/overview.html?view=diff&rev=555824&r1=555823&r2=555824
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/optional/bean-collections/src/java/overview.html (original)
+++ jakarta/commons/proper/beanutils/trunk/optional/bean-collections/src/java/overview.html Thu Jul 12 17:27:15 2007
@@ -1,3 +1,19 @@
+<!--
+   Licensed to the Apache Software Foundation (ASF) under one or more
+   contributor license agreements.  See the NOTICE file distributed with
+   this work for additional information regarding copyright ownership.
+   The ASF licenses this file to You under the Apache License, Version 2.0
+   (the "License"); you may not use this file except in compliance with
+   the License.  You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+-->
 <html>
 <head>
 <title>Overview Documentation for COMMONS-BEANUTILS BEAN COLLECTIONS</title>

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/BasicDynaBean.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/BasicDynaBean.java?view=diff&rev=555824&r1=555823&r2=555824
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/BasicDynaBean.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/BasicDynaBean.java Thu Jul 12 17:27:15 2007
@@ -5,15 +5,15 @@
  * The ASF licenses this file to You under the Apache License, Version 2.0
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
- * 
+ *
  *      http://www.apache.org/licenses/LICENSE-2.0
- * 
+ *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
- */ 
+ */
 
 
 package org.apache.commons.beanutils;
@@ -107,6 +107,8 @@
      *
      * @param name Name of the property to check
      * @param key Name of the key to check
+     * @return <code>true<code> if the mapped property contains a value for
+     * the specified key, otherwise <code>false</code>
      *
      * @exception IllegalArgumentException if there is no property
      *  of the specified name
@@ -131,6 +133,7 @@
      * Return the value of a simple property with the specified name.
      *
      * @param name Name of the property whose value is to be retrieved
+     * @return The property's value
      *
      * @exception IllegalArgumentException if there is no property
      *  of the specified name
@@ -178,6 +181,7 @@
      *
      * @param name Name of the property whose value is to be retrieved
      * @param index Index of the value to be retrieved
+     * @return The indexed property's value
      *
      * @exception IllegalArgumentException if there is no property
      *  of the specified name
@@ -212,6 +216,7 @@
      *
      * @param name Name of the property whose value is to be retrieved
      * @param key Key of the value to be retrieved
+     * @return The mapped property's value
      *
      * @exception IllegalArgumentException if there is no property
      *  of the specified name
@@ -237,6 +242,8 @@
     /**
      * Return the <code>DynaClass</code> instance that describes the set of
      * properties available for this DynaBean.
+     *
+     * @return The associated DynaClass
      */
     public DynaClass getDynaClass() {
 

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/BasicDynaClass.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/BasicDynaClass.java?view=diff&rev=555824&r1=555823&r2=555824
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/BasicDynaClass.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/BasicDynaClass.java Thu Jul 12 17:27:15 2007
@@ -5,15 +5,15 @@
  * The ASF licenses this file to You under the Apache License, Version 2.0
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
- * 
+ *
  *      http://www.apache.org/licenses/LICENSE-2.0
- * 
+ *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
- */ 
+ */
 
 
 package org.apache.commons.beanutils;
@@ -147,6 +147,8 @@
      * <code>getName()</code> method of <code>java.lang.Class</code), which
      * allows the same <code>DynaClass</code> implementation class to support
      * different dynamic classes, with different sets of properties.
+     *
+     * @return the name of the DynaClass
      */
     public String getName() {
 
@@ -161,6 +163,7 @@
      *
      * @param name Name of the dynamic property for which a descriptor
      *  is requested
+     * @return The descriptor for the specified property
      *
      * @exception IllegalArgumentException if no property name is specified
      */
@@ -183,6 +186,8 @@
      * <p><strong>FIXME</strong> - Should we really be implementing
      * <code>getBeanInfo()</code> instead, which returns property descriptors
      * and a bunch of other stuff?</p>
+     *
+     * @return the set of properties for this DynaClass
      */
     public DynaProperty[] getDynaProperties() {
 
@@ -195,6 +200,7 @@
      * Instantiate and return a new DynaBean instance, associated
      * with this DynaClass.
      *
+     * @return A new <code>DynaBean</code> instance
      * @exception IllegalAccessException if the Class or the appropriate
      *  constructor is not accessible
      * @exception InstantiationException if this Class represents an abstract

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/BeanAccessLanguageException.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/BeanAccessLanguageException.java?view=diff&rev=555824&r1=555823&r2=555824
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/BeanAccessLanguageException.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/BeanAccessLanguageException.java Thu Jul 12 17:27:15 2007
@@ -5,15 +5,15 @@
  * The ASF licenses this file to You under the Apache License, Version 2.0
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
- * 
+ *
  *      http://www.apache.org/licenses/LICENSE-2.0
- * 
+ *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
- */ 
+ */
 
 package org.apache.commons.beanutils;
 

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/BeanUtils.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/BeanUtils.java?view=diff&rev=555824&r1=555823&r2=555824
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/BeanUtils.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/BeanUtils.java Thu Jul 12 17:27:15 2007
@@ -5,15 +5,15 @@
  * The ASF licenses this file to You under the Apache License, Version 2.0
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
- * 
+ *
  *      http://www.apache.org/licenses/LICENSE-2.0
- * 
+ *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
- */ 
+ */
 
 
 package org.apache.commons.beanutils;
@@ -265,7 +265,7 @@
             throws IllegalAccessException, InvocationTargetException,
             NoSuchMethodException {
 
-	return BeanUtilsBean.getInstance().getIndexedProperty(bean, name, index);
+        return BeanUtilsBean.getInstance().getIndexedProperty(bean, name, index);
 
     }
 
@@ -351,7 +351,7 @@
             throws IllegalAccessException, InvocationTargetException,
             NoSuchMethodException {
 
-	return BeanUtilsBean.getInstance().getNestedProperty(bean, name);
+        return BeanUtilsBean.getInstance().getNestedProperty(bean, name);
 
     }
 
@@ -406,7 +406,7 @@
             throws IllegalAccessException, InvocationTargetException,
             NoSuchMethodException {
 
-	return BeanUtilsBean.getInstance().getSimpleProperty(bean, name);
+        return BeanUtilsBean.getInstance().getSimpleProperty(bean, name);
 
     }
 

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/BeanUtilsBean.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/BeanUtilsBean.java?view=diff&rev=555824&r1=555823&r2=555824
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/BeanUtilsBean.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/BeanUtilsBean.java Thu Jul 12 17:27:15 2007
@@ -5,15 +5,15 @@
  * The ASF licenses this file to You under the Apache License, Version 2.0
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
- * 
+ *
  *      http://www.apache.org/licenses/LICENSE-2.0
- * 
+ *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
- */ 
+ */
 
 
 package org.apache.commons.beanutils;
@@ -62,7 +62,7 @@
      * Contains <code>BeanUtilsBean</code> instances indexed by context classloader.
      */
     private static final ContextClassLoaderLocal 
-            beansByClassLoader = new ContextClassLoaderLocal() {
+            BEANS_BY_CLASSLOADER = new ContextClassLoaderLocal() {
                         // Creates the default instance used when the context classloader is unavailable
                         protected Object initialValue() {
                             return new BeanUtilsBean();
@@ -77,7 +77,7 @@
      * @return The (pseudo-singleton) BeanUtils bean instance
      */
     public static BeanUtilsBean getInstance() {
-        return (BeanUtilsBean) beansByClassLoader.get();
+        return (BeanUtilsBean) BEANS_BY_CLASSLOADER.get();
     }
 
     /** 
@@ -88,7 +88,7 @@
      * @param newInstance The (pseudo-singleton) BeanUtils bean instance
      */
     public static void setInstance(BeanUtilsBean newInstance) {
-        beansByClassLoader.set(newInstance);
+        BEANS_BY_CLASSLOADER.set(newInstance);
     }
 
     // --------------------------------------------------------- Attributes
@@ -138,7 +138,7 @@
      * @param propertyUtilsBean use this <code>PropertyUtilsBean</code>
      * to access properties
      */
-    public BeanUtilsBean(		
+    public BeanUtilsBean(
                             ConvertUtilsBean convertUtilsBean, 
                             PropertyUtilsBean propertyUtilsBean) {
                             
@@ -1056,6 +1056,7 @@
                 INIT_CAUSE_METHOD.invoke(throwable, new Object[] { cause });
                 return true;
             } catch (Throwable e) {
+                return false; // can't initialize cause
             }
         }
         return false;

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ConstructorUtils.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ConstructorUtils.java?view=diff&rev=555824&r1=555823&r2=555824
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ConstructorUtils.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ConstructorUtils.java Thu Jul 12 17:27:15 2007
@@ -5,15 +5,15 @@
  * The ASF licenses this file to You under the Apache License, Version 2.0
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
- * 
+ *
  *      http://www.apache.org/licenses/LICENSE-2.0
- * 
+ *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
- */ 
+ */
 
 package org.apache.commons.beanutils;
 
@@ -50,9 +50,9 @@
 
     // --------------------------------------------------------- Private Members
     /** An empty class array */
-    private static final Class[] emptyClassArray = new Class[0];
+    private static final Class[] EMPTY_CLASS_PARAMETERS = new Class[0];
     /** An empty object array */
-    private static final Object[] emptyObjectArray = new Object[0];
+    private static final Object[] EMPTY_OBJECT_ARRAY = new Object[0];
 
     // --------------------------------------------------------- Public Methods
 
@@ -112,7 +112,7 @@
             InstantiationException {
 
         if (null == args) {
-            args = emptyObjectArray;
+            args = EMPTY_OBJECT_ARRAY;
         }
         int arguments = args.length;
         Class parameterTypes[] = new Class[arguments];
@@ -151,10 +151,10 @@
             InstantiationException {
 
         if (parameterTypes == null) {
-            parameterTypes = emptyClassArray;
+            parameterTypes = EMPTY_CLASS_PARAMETERS;
         }
         if (args == null) {
-            args = emptyObjectArray;
+            args = EMPTY_OBJECT_ARRAY;
         }
 
         Constructor ctor =
@@ -222,7 +222,7 @@
             InvocationTargetException,
             InstantiationException {
         if (null == args) {
-            args = emptyObjectArray;
+            args = EMPTY_OBJECT_ARRAY;
         }
         int arguments = args.length;
         Class parameterTypes[] = new Class[arguments];
@@ -262,11 +262,11 @@
             InstantiationException {
 
         if (args == null) {
-            args = emptyObjectArray;
+            args = EMPTY_OBJECT_ARRAY;
         }
 
         if (parameterTypes == null) {
-            parameterTypes = emptyClassArray;
+            parameterTypes = EMPTY_CLASS_PARAMETERS;
         }
 
         Constructor ctor = getAccessibleConstructor(klass, parameterTypes);

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ContextClassLoaderLocal.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ContextClassLoaderLocal.java?view=diff&rev=555824&r1=555823&r2=555824
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ContextClassLoaderLocal.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ContextClassLoaderLocal.java Thu Jul 12 17:27:15 2007
@@ -5,15 +5,15 @@
  * The ASF licenses this file to You under the Apache License, Version 2.0
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
- * 
+ *
  *      http://www.apache.org/licenses/LICENSE-2.0
- * 
+ *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
- */ 
+ */
  
 package org.apache.commons.beanutils;
 

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ConversionException.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ConversionException.java?view=diff&rev=555824&r1=555823&r2=555824
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ConversionException.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ConversionException.java Thu Jul 12 17:27:15 2007
@@ -5,15 +5,15 @@
  * The ASF licenses this file to You under the Apache License, Version 2.0
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
- * 
+ *
  *      http://www.apache.org/licenses/LICENSE-2.0
- * 
+ *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
- */ 
+ */
 
 
 package org.apache.commons.beanutils;
@@ -82,6 +82,10 @@
      */
     protected Throwable cause = null;
 
+    /**
+     * Return the root cause of this conversion exception.
+     * @return the root cause of this conversion exception
+     */
     public Throwable getCause() {
         return (this.cause);
     }

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ConvertUtils.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ConvertUtils.java?view=diff&rev=555824&r1=555823&r2=555824
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ConvertUtils.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ConvertUtils.java Thu Jul 12 17:27:15 2007
@@ -5,15 +5,15 @@
  * The ASF licenses this file to You under the Apache License, Version 2.0
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
- * 
+ *
  *      http://www.apache.org/licenses/LICENSE-2.0
- * 
+ *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
- */ 
+ */
 
 
 package org.apache.commons.beanutils;

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ConvertUtilsBean.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ConvertUtilsBean.java?view=diff&rev=555824&r1=555823&r2=555824
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ConvertUtilsBean.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ConvertUtilsBean.java Thu Jul 12 17:27:15 2007
@@ -5,15 +5,15 @@
  * The ASF licenses this file to You under the Apache License, Version 2.0
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
- * 
+ *
  *      http://www.apache.org/licenses/LICENSE-2.0
- * 
+ *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
- */ 
+ */
 
 
 package org.apache.commons.beanutils;
@@ -189,7 +189,7 @@
      *  Boolean.class instead
      */
     public void setDefaultBoolean(boolean newDefaultBoolean) {
-        defaultBoolean = new Boolean(newDefaultBoolean);
+        defaultBoolean = (newDefaultBoolean ? Boolean.TRUE : Boolean.FALSE);
         register(new BooleanConverter(defaultBoolean), Boolean.TYPE);
         register(new BooleanConverter(defaultBoolean), Boolean.class);
     }
@@ -252,7 +252,7 @@
         defaultCharacter = new Character(newDefaultCharacter);
         register(new CharacterConverter(defaultCharacter),
                     Character.TYPE);
-        register(new CharacterConverter(defaultCharacter),	
+        register(new CharacterConverter(defaultCharacter),
                     Character.class);
     }
 
@@ -571,7 +571,7 @@
      */
     public void deregister() {
 
-		converters.clear();
+        converters.clear();
         
         registerPrimitives(false);
         registerStandard(false, false);

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/Converter.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/Converter.java?view=diff&rev=555824&r1=555823&r2=555824
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/Converter.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/Converter.java Thu Jul 12 17:27:15 2007
@@ -5,15 +5,15 @@
  * The ASF licenses this file to You under the Apache License, Version 2.0
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
- * 
+ *
  *      http://www.apache.org/licenses/LICENSE-2.0
- * 
+ *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
- */ 
+ */
 
 
 package org.apache.commons.beanutils;

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ConvertingWrapDynaBean.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ConvertingWrapDynaBean.java?view=diff&rev=555824&r1=555823&r2=555824
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ConvertingWrapDynaBean.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ConvertingWrapDynaBean.java Thu Jul 12 17:27:15 2007
@@ -5,15 +5,15 @@
  * The ASF licenses this file to You under the Apache License, Version 2.0
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
- * 
+ *
  *      http://www.apache.org/licenses/LICENSE-2.0
- * 
+ *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
- */ 
+ */
 
 package org.apache.commons.beanutils;
 

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/DynaBean.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/DynaBean.java?view=diff&rev=555824&r1=555823&r2=555824
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/DynaBean.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/DynaBean.java Thu Jul 12 17:27:15 2007
@@ -5,15 +5,15 @@
  * The ASF licenses this file to You under the Apache License, Version 2.0
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
- * 
+ *
  *      http://www.apache.org/licenses/LICENSE-2.0
- * 
+ *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
- */ 
+ */
 
 
 package org.apache.commons.beanutils;

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/DynaClass.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/DynaClass.java?view=diff&rev=555824&r1=555823&r2=555824
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/DynaClass.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/DynaClass.java Thu Jul 12 17:27:15 2007
@@ -5,15 +5,15 @@
  * The ASF licenses this file to You under the Apache License, Version 2.0
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
- * 
+ *
  *      http://www.apache.org/licenses/LICENSE-2.0
- * 
+ *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
- */ 
+ */
 
 
 package org.apache.commons.beanutils;

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/DynaProperty.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/DynaProperty.java?view=diff&rev=555824&r1=555823&r2=555824
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/DynaProperty.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/DynaProperty.java Thu Jul 12 17:27:15 2007
@@ -5,15 +5,15 @@
  * The ASF licenses this file to You under the Apache License, Version 2.0
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
- * 
+ *
  *      http://www.apache.org/licenses/LICENSE-2.0
- * 
+ *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
- */ 
+ */
 
 
 package org.apache.commons.beanutils;
@@ -204,6 +204,9 @@
     /**
      * Checks this instance against the specified Object for equality. Overrides the
      * default refererence test for equality provided by {@link java.lang.Object#equals(Object)}  
+     * @param obj The object to compare to
+     * @return <code>true</code> if object is a dyna property with the same name
+     * type and content type, otherwise <code>false</code>
      */
     public boolean equals(final Object obj) {
 
@@ -223,6 +226,7 @@
     }
 
     /**
+     * @return the hashcode for this dyna property
      * @see java.lang.Object#hashCode
      */
     public int hashCode() {
@@ -238,6 +242,7 @@
 
     /**
      * Return a String representation of this Object.
+     * @return a String representation of the dyna property
      */
     public String toString() {
 
@@ -295,7 +300,7 @@
             primitiveType = LONG_TYPE;
         } else if (Short.TYPE.equals(clazz)) {
             primitiveType = SHORT_TYPE;
-        }	
+        }
         
         if (primitiveType == 0) {
             // then it's not a primitive type

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/JDBCDynaClass.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/JDBCDynaClass.java?view=diff&rev=555824&r1=555823&r2=555824
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/JDBCDynaClass.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/JDBCDynaClass.java Thu Jul 12 17:27:15 2007
@@ -5,15 +5,15 @@
  * The ASF licenses this file to You under the Apache License, Version 2.0
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
- * 
+ *
  *      http://www.apache.org/licenses/LICENSE-2.0
- * 
+ *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
- */ 
+ */
 
 package org.apache.commons.beanutils;
 

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/LazyDynaBean.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/LazyDynaBean.java?view=diff&rev=555824&r1=555823&r2=555824
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/LazyDynaBean.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/LazyDynaBean.java Thu Jul 12 17:27:15 2007
@@ -249,6 +249,8 @@
      *
      * @param name Name of the property to check
      * @param key Name of the key to check
+     * @return <code>true<code> if the mapped property contains a value for
+     * the specified key, otherwise <code>false</code>
      *
      * @exception IllegalArgumentException if no property name is specified
      */
@@ -278,6 +280,7 @@
      *  of the specified name.</p>
      *
      * @param name Name of the property whose value is to be retrieved.
+     * @return The property's value
      * @exception IllegalArgumentException if no property name is specified
      */
     public Object get(String name) {
@@ -316,6 +319,7 @@
      *
      * @param name Name of the property whose value is to be retrieved
      * @param index Index of the value to be retrieved
+     * @return The indexed property's value
      *
      * @exception IllegalArgumentException if the specified property
      *  exists, but is not indexed
@@ -363,6 +367,7 @@
      *
      * @param name Name of the property whose value is to be retrieved
      * @param key Key of the value to be retrieved
+     * @return The mapped property's value
      *
      * @exception IllegalArgumentException if the specified property
      *  exists, but is not mapped
@@ -399,6 +404,8 @@
     /**
      * Return the <code>DynaClass</code> instance that describes the set of
      * properties available for this DynaBean.
+     *
+     * @return The associated DynaClass
      */
     public DynaClass getDynaClass() {
         return dynaClass;

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/LazyDynaClass.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/LazyDynaClass.java?view=diff&rev=555824&r1=555823&r2=555824
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/LazyDynaClass.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/LazyDynaClass.java Thu Jul 12 17:27:15 2007
@@ -108,6 +108,8 @@
      * <p>Is this DynaClass currently restricted.</p>
      * <p>If restricted, no changes to the existing registration of
      *  property names, data types, readability, or writeability are allowed.</p>
+     * @return <code>true</code> if this {@link MutableDynaClass} cannot be changed
+     * otherwise <code>false</code>
      */
     public boolean isRestricted() {
         return restricted;
@@ -117,6 +119,8 @@
      * <p>Set whether this DynaClass is currently restricted.</p>
      * <p>If restricted, no changes to the existing registration of
      *  property names, data types, readability, or writeability are allowed.</p>
+     * @param restricted <code>true</code> if this {@link MutableDynaClass} cannot
+     * be changed otherwise <code>false</code>
      */
     public void setRestricted(boolean restricted) {
         this.restricted = restricted;
@@ -305,6 +309,7 @@
      *
      * @param name Name of the dynamic property for which a descriptor
      *  is requested
+     * @return The dyna property for the specified name
      *
      * @exception IllegalArgumentException if no property name is specified
      */

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/LazyDynaList.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/LazyDynaList.java?view=diff&rev=555824&r1=555823&r2=555824
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/LazyDynaList.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/LazyDynaList.java Thu Jul 12 17:27:15 2007
@@ -428,6 +428,7 @@
     /**
      * <p>Converts the List to an Array of the specified type.</p>
      *
+     * @param model The model for the type of array to return
      * @return An Array of the elements in this List.
      */
     public Object[] toArray(Object[] model) {

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/LazyDynaMap.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/LazyDynaMap.java?view=diff&rev=555824&r1=555823&r2=555824
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/LazyDynaMap.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/LazyDynaMap.java Thu Jul 12 17:27:15 2007
@@ -182,6 +182,8 @@
     /**
      * Return the name of this DynaClass (analogous to the
      * <code>getName()</code> method of <code>java.lang.Class</code)
+     *
+     * @return the name of the DynaClass
      */
     public String getName() {
         return this.name;
@@ -206,6 +208,7 @@
      *
      * @param name Name of the dynamic property for which a descriptor
      *  is requested
+     * @return The descriptor for the specified property
      *
      * @exception IllegalArgumentException if no property name is specified
      */
@@ -238,6 +241,7 @@
      * <p><strong>FIXME</strong> - Should we really be implementing
      * <code>getBeanInfo()</code> instead, which returns property descriptors
      * and a bunch of other stuff?</p>
+     * @return the set of properties for this DynaClass
      */
     public DynaProperty[] getDynaProperties() {
 
@@ -258,6 +262,7 @@
     /**
      * Instantiate and return a new DynaBean instance, associated
      * with this DynaClass.
+     * @return A new <code>DynaBean</code> instance
      */
     public DynaBean newInstance()  {
 
@@ -287,6 +292,9 @@
      * <p>Is this DynaClass currently restricted.</p>
      * <p>If restricted, no changes to the existing registration of
      *  property names, data types, readability, or writeability are allowed.</p>
+     *
+     * @return <code>true</code> if this Mutable {@link DynaClass} is restricted,
+     * otherwise <code>false</code>
      */
     public boolean isRestricted() {
         return restricted;
@@ -296,6 +304,8 @@
      * <p>Set whether this DynaClass is currently restricted.</p>
      * <p>If restricted, no changes to the existing registration of
      *  property names, data types, readability, or writeability are allowed.</p>
+     *
+     * @param restricted The new restricted state
      */
     public void setRestricted(boolean restricted) {
         this.restricted = restricted;
@@ -449,6 +459,9 @@
      * return a DynaProperty if it doesn't exist (depending on the
      * <code>returnNull</code> indicator).</p>
      *
+     * @param name Name of the dynamic property
+     * @return <code>true</code> if the property exists,
+     * otherwise <code>false</code>
      * @exception IllegalArgumentException if no property name is specified
      */
     protected boolean isDynaProperty(String name) {

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/MappedPropertyDescriptor.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/MappedPropertyDescriptor.java?view=diff&rev=555824&r1=555823&r2=555824
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/MappedPropertyDescriptor.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/MappedPropertyDescriptor.java Thu Jul 12 17:27:15 2007
@@ -5,15 +5,15 @@
  * The ASF licenses this file to You under the Apache License, Version 2.0
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
- * 
+ *
  *      http://www.apache.org/licenses/LICENSE-2.0
- * 
+ *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
- */ 
+ */
 
 package org.apache.commons.beanutils;
 
@@ -64,7 +64,7 @@
     /**
      * The parameter types array for the reader method signature.
      */
-    private static final Class[] stringClassArray = new Class[]{String.class};
+    private static final Class[] STRING_CLASS_PARAMETER = new Class[]{String.class};
 
     // ----------------------------------------------------------- Constructors
 
@@ -79,7 +79,7 @@
      *
      * @param propertyName The programmatic name of the property.
      * @param beanClass The Class object for the target bean.  For
-     *		example sun.beans.OurButton.class.
+     *        example sun.beans.OurButton.class.
      *
      * @exception IntrospectionException if an exception occurs during
      *              introspection.
@@ -101,10 +101,10 @@
         try {
             try {
                 mappedReadMethod = getMethod(beanClass, "get" + base,
-                        stringClassArray);
+                        STRING_CLASS_PARAMETER);
             } catch (IntrospectionException e) {
                 mappedReadMethod = getMethod(beanClass, "is" + base,
-                        stringClassArray);
+                        STRING_CLASS_PARAMETER);
             }
             Class params[] = { String.class, mappedReadMethod.getReturnType() };
             mappedWriteMethod = getMethod(beanClass, "set" + base, params);
@@ -135,7 +135,7 @@
      *
      * @param propertyName The programmatic name of the property.
      * @param beanClass The Class object for the target bean.  For
-     *		example sun.beans.OurButton.class.
+     *        example sun.beans.OurButton.class.
      * @param mappedGetterName The name of the method used for
      *          reading one of the property values.  May be null if the
      *          property is write-only.
@@ -160,7 +160,7 @@
 
         // search the mapped get and set methods
         mappedReadMethod =
-            getMethod(beanClass, mappedGetterName, stringClassArray);
+            getMethod(beanClass, mappedGetterName, STRING_CLASS_PARAMETER);
 
         if (mappedReadMethod != null) {
             Class params[] = { String.class, mappedReadMethod.getReturnType() };

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/MethodUtils.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/MethodUtils.java?view=diff&rev=555824&r1=555823&r2=555824
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/MethodUtils.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/MethodUtils.java Thu Jul 12 17:27:15 2007
@@ -5,15 +5,15 @@
  * The ASF licenses this file to You under the Apache License, Version 2.0
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
- * 
+ *
  *      http://www.apache.org/licenses/LICENSE-2.0
- * 
+ *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
- */ 
+ */
 
 package org.apache.commons.beanutils;
 
@@ -70,9 +70,9 @@
     private static boolean loggedAccessibleWarning = false;
 
     /** An empty class array */
-    private static final Class[] emptyClassArray = new Class[0];
+    private static final Class[] EMPTY_CLASS_PARAMETERS = new Class[0];
     /** An empty object array */
-    private static final Object[] emptyObjectArray = new Object[0];
+    private static final Object[] EMPTY_OBJECT_ARRAY = new Object[0];
 
     /**
      * Stores a cache of MethodDescriptor -> Method in a WeakHashMap.
@@ -177,7 +177,7 @@
             InvocationTargetException {
         
         if (args == null) {
-            args = emptyObjectArray;
+            args = EMPTY_OBJECT_ARRAY;
         }  
         int arguments = args.length;
         Class parameterTypes [] = new Class[arguments];
@@ -226,10 +226,10 @@
                     InvocationTargetException {
                     
         if (parameterTypes == null) {
-            parameterTypes = emptyClassArray;
+            parameterTypes = EMPTY_CLASS_PARAMETERS;
         }        
         if (args == null) {
-            args = emptyObjectArray;
+            args = EMPTY_OBJECT_ARRAY;
         }  
 
         Method method = getMatchingAccessibleMethod(
@@ -304,7 +304,7 @@
             IllegalAccessException,
             InvocationTargetException {
         if (args == null) {
-            args = emptyObjectArray;
+            args = EMPTY_OBJECT_ARRAY;
         }  
         int arguments = args.length;
         Class parameterTypes [] = new Class[arguments];
@@ -346,11 +346,11 @@
             InvocationTargetException {
         
         if (args == null) {
-            args = emptyObjectArray;
+            args = EMPTY_OBJECT_ARRAY;
         }  
                 
         if (parameterTypes == null) {
-            parameterTypes = emptyClassArray;
+            parameterTypes = EMPTY_CLASS_PARAMETERS;
         }
 
         Method method = getAccessibleMethod(
@@ -375,6 +375,7 @@
      * @param methodName get method with this name
      * @param args use these arguments - treat null as empty array
      * @param parameterTypes match these parameters - treat null as empty array
+     * @return The value returned by the invoked method
      *
      * @throws NoSuchMethodException if there is no such accessible method
      * @throws InvocationTargetException wraps an exception thrown by the
@@ -393,11 +394,11 @@
             InvocationTargetException {
         
         if (args == null) {
-            args = emptyObjectArray;
+            args = EMPTY_OBJECT_ARRAY;
         }  
                 
         if (parameterTypes == null) {
-            parameterTypes = emptyClassArray;
+            parameterTypes = EMPTY_CLASS_PARAMETERS;
         }
 
         Method method = getAccessibleMethod(
@@ -430,6 +431,7 @@
      * @param objectClass invoke static method on this class
      * @param methodName get method with this name
      * @param arg use this argument
+     * @return The value returned by the invoked method
      *
      * @throws NoSuchMethodException if there is no such accessible method
      * @throws InvocationTargetException wraps an exception thrown by the
@@ -471,6 +473,7 @@
      * @param objectClass invoke static method on this class
      * @param methodName get method with this name
      * @param args use these arguments - treat null as empty array
+     * @return The value returned by the invoked method
      *
      * @throws NoSuchMethodException if there is no such accessible method
      * @throws InvocationTargetException wraps an exception thrown by the
@@ -488,7 +491,7 @@
             InvocationTargetException {
         
         if (args == null) {
-            args = emptyObjectArray;
+            args = EMPTY_OBJECT_ARRAY;
         }  
         int arguments = args.length;
         Class parameterTypes [] = new Class[arguments];
@@ -518,6 +521,7 @@
      * @param methodName get method with this name
      * @param args use these arguments - treat null as empty array
      * @param parameterTypes match these parameters - treat null as empty array
+     * @return The value returned by the invoked method
      *
      * @throws NoSuchMethodException if there is no such accessible method
      * @throws InvocationTargetException wraps an exception thrown by the
@@ -536,10 +540,10 @@
                     InvocationTargetException {
                     
         if (parameterTypes == null) {
-            parameterTypes = emptyClassArray;
+            parameterTypes = EMPTY_CLASS_PARAMETERS;
         }        
         if (args == null) {
-            args = emptyObjectArray;
+            args = EMPTY_OBJECT_ARRAY;
         }  
 
         Method method = getMatchingAccessibleMethod(
@@ -564,6 +568,7 @@
      * @param objectClass invoke static method on this class
      * @param methodName get method with this name
      * @param arg use this argument
+     * @return The value returned by the invoked method
      *
      * @throws NoSuchMethodException if there is no such accessible method
      * @throws InvocationTargetException wraps an exception thrown by the
@@ -596,6 +601,7 @@
      * @param objectClass invoke static method on this class
      * @param methodName get method with this name
      * @param args use these arguments - treat null as empty array
+     * @return The value returned by the invoked method
      *
      * @throws NoSuchMethodException if there is no such accessible method
      * @throws InvocationTargetException wraps an exception thrown by the
@@ -612,7 +618,7 @@
             IllegalAccessException,
             InvocationTargetException {
         if (args == null) {
-            args = emptyObjectArray;
+            args = EMPTY_OBJECT_ARRAY;
         }  
         int arguments = args.length;
         Class parameterTypes [] = new Class[arguments];
@@ -930,7 +936,7 @@
         float bestMatchCost = Float.MAX_VALUE;
         float myCost = Float.MAX_VALUE;
         for (int i = 0, size = methods.length; i < size ; i++) {
-            if (methods[i].getName().equals(methodName)) {	
+            if (methods[i].getName().equals(methodName)) {
                 // log some trace information
                 if (log.isTraceEnabled()) {
                     log.trace("Found matching name:");
@@ -1207,7 +1213,7 @@
                 throw new IllegalArgumentException("Method Name cannot be null");
             }
             if (paramTypes == null) {
-                paramTypes = emptyClassArray;
+                paramTypes = EMPTY_CLASS_PARAMETERS;
             }
 
             this.cls = cls;

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/MutableDynaClass.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/MutableDynaClass.java?view=diff&rev=555824&r1=555823&r2=555824
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/MutableDynaClass.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/MutableDynaClass.java Thu Jul 12 17:27:15 2007
@@ -5,15 +5,15 @@
  * The ASF licenses this file to You under the Apache License, Version 2.0
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
- * 
+ *
  *      http://www.apache.org/licenses/LICENSE-2.0
- * 
+ *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
- */ 
+ */
 
 package org.apache.commons.beanutils;
 

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/NestedNullException.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/NestedNullException.java?view=diff&rev=555824&r1=555823&r2=555824
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/NestedNullException.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/NestedNullException.java Thu Jul 12 17:27:15 2007
@@ -5,15 +5,15 @@
  * The ASF licenses this file to You under the Apache License, Version 2.0
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
- * 
+ *
  *      http://www.apache.org/licenses/LICENSE-2.0
- * 
+ *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
- */ 
+ */
  
 package org.apache.commons.beanutils;
 

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/PropertyUtils.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/PropertyUtils.java?view=diff&rev=555824&r1=555823&r2=555824
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/PropertyUtils.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/PropertyUtils.java Thu Jul 12 17:27:15 2007
@@ -5,15 +5,15 @@
  * The ASF licenses this file to You under the Apache License, Version 2.0
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
- * 
+ *
  *      http://www.apache.org/licenses/LICENSE-2.0
- * 
+ *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
- */ 
+ */
 
 
 package org.apache.commons.beanutils;
@@ -145,7 +145,7 @@
      * @see PropertyUtilsBean#clearDescriptors  
      */
     public static void clearDescriptors() {
-	
+
         PropertyUtilsBean.getInstance().clearDescriptors();
 
     }
@@ -339,7 +339,7 @@
      * @deprecated This method should not be exposed
      */
     public static FastHashMap getMappedPropertyDescriptors(Class beanClass) {
-	
+
         return PropertyUtilsBean.getInstance().getMappedPropertyDescriptors(beanClass);
 
     }
@@ -357,7 +357,7 @@
      */
     public static FastHashMap getMappedPropertyDescriptors(Object bean) {
 
-	return PropertyUtilsBean.getInstance().getMappedPropertyDescriptors(bean);
+        return PropertyUtilsBean.getInstance().getMappedPropertyDescriptors(bean);
 
     }
 
@@ -524,7 +524,7 @@
             throws IllegalAccessException, InvocationTargetException,
             NoSuchMethodException {
 
-	return PropertyUtilsBean.getInstance().getPropertyEditorClass(bean, name);
+        return PropertyUtilsBean.getInstance().getPropertyEditorClass(bean, name);
 
     }
 
@@ -668,7 +668,7 @@
      */
     public static boolean isWriteable(Object bean, String name) {
 
-	return PropertyUtilsBean.getInstance().isWriteable(bean, name);
+        return PropertyUtilsBean.getInstance().isWriteable(bean, name);
     }
 
 

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/PropertyUtilsBean.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/PropertyUtilsBean.java?view=diff&rev=555824&r1=555823&r2=555824
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/PropertyUtilsBean.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/PropertyUtilsBean.java Thu Jul 12 17:27:15 2007
@@ -5,15 +5,15 @@
  * The ASF licenses this file to You under the Apache License, Version 2.0
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
- * 
+ *
  *      http://www.apache.org/licenses/LICENSE-2.0
- * 
+ *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
- */ 
+ */
 
 package org.apache.commons.beanutils;
 
@@ -123,8 +123,8 @@
      */
     private FastHashMap descriptorsCache = null;
     private FastHashMap mappedDescriptorsCache = null;
-    private static final Class[] indexedListGetterArgs = new Class[0];
-    private static final Class[] indexedListSetterArgs = new Class[] {java.util.List.class};
+    private static final Class[] EMPTY_CLASS_PARAMETERS = new Class[0];
+    private static final Class[] LIST_CLASS_PARAMETER = new Class[] {java.util.List.class};
     
     /** Log instance */
     private Log log = LogFactory.getLog(PropertyUtils.class);
@@ -1001,7 +1001,7 @@
                                         : "get" + propName;
                     Method readMethod = MethodUtils.getMatchingAccessibleMethod(beanClass,
                                                             methodName,
-                                                            indexedListGetterArgs);
+                                                            EMPTY_CLASS_PARAMETERS);
                     if (readMethod != null) {
                         try {
                             descriptor.setReadMethod(readMethod);
@@ -1016,7 +1016,7 @@
                                       : "set" + propName;
                     Method writeMethod = MethodUtils.getMatchingAccessibleMethod(beanClass,
                                                             methodName,
-                                                            indexedListSetterArgs);
+                                                            LIST_CLASS_PARAMETER);
                     if (writeMethod == null) {
                         Method[] methods = beanClass.getMethods();
                         for (int j = 0; j < methods.length; j++) {

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ResultSetDynaClass.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ResultSetDynaClass.java?view=diff&rev=555824&r1=555823&r2=555824
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ResultSetDynaClass.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ResultSetDynaClass.java Thu Jul 12 17:27:15 2007
@@ -5,9 +5,9 @@
  * The ASF licenses this file to You under the Apache License, Version 2.0
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
- * 
+ *
  *      http://www.apache.org/licenses/LICENSE-2.0
- * 
+ *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
@@ -187,6 +187,9 @@
      * Dervations of this class could implement alternative class loading policies such as
      * using custom ClassLoader or using the Threads's context class loader etc.
      * </p>
+     * @param className The name of the class to load
+     * @return The loaded class
+     * @throws SQLException if the class cannot be loaded
      */        
     protected Class loadClass(String className) throws SQLException {
 

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ResultSetIterator.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ResultSetIterator.java?view=diff&rev=555824&r1=555823&r2=555824
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ResultSetIterator.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ResultSetIterator.java Thu Jul 12 17:27:15 2007
@@ -5,15 +5,15 @@
  * The ASF licenses this file to You under the Apache License, Version 2.0
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
- * 
+ *
  *      http://www.apache.org/licenses/LICENSE-2.0
- * 
+ *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
- */ 
+ */
 
 
 package org.apache.commons.beanutils;
@@ -87,6 +87,8 @@
      *
      * @param name Name of the property to check
      * @param key Name of the key to check
+     * @return <code>true<code> if the mapped property contains a value for
+     * the specified key, otherwise <code>false</code>
      *
      * @exception IllegalArgumentException if there is no property
      *  of the specified name
@@ -103,6 +105,7 @@
      * Return the value of a simple property with the specified name.
      *
      * @param name Name of the property whose value is to be retrieved
+     * @return The property's value
      *
      * @exception IllegalArgumentException if there is no property
      *  of the specified name
@@ -127,6 +130,7 @@
      *
      * @param name Name of the property whose value is to be retrieved
      * @param index Index of the value to be retrieved
+     * @return The indexed property's value
      *
      * @exception IllegalArgumentException if there is no property
      *  of the specified name
@@ -151,6 +155,7 @@
      *
      * @param name Name of the property whose value is to be retrieved
      * @param key Key of the value to be retrieved
+     * @return The mapped property's value
      *
      * @exception IllegalArgumentException if there is no property
      *  of the specified name
@@ -168,6 +173,8 @@
     /**
      * Return the <code>DynaClass</code> instance that describes the set of
      * properties available for this DynaBean.
+     *
+     * @return The associated DynaClass
      */
     public DynaClass getDynaClass() {
 
@@ -274,6 +281,9 @@
 
     /**
      * <p>Return <code>true</code> if the iteration has more elements.</p>
+     *
+     * @return <code>true</code> if the result set has another
+     * row, otherwise <code>false</code>
      */
     public boolean hasNext() {
 
@@ -289,6 +299,8 @@
 
     /**
      * <p>Return the next element in the iteration.</p>
+     *
+     * @return advance to the new row and return this
      */
     public Object next() {
 

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/RowSetDynaClass.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/RowSetDynaClass.java?view=diff&rev=555824&r1=555823&r2=555824
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/RowSetDynaClass.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/RowSetDynaClass.java Thu Jul 12 17:27:15 2007
@@ -5,15 +5,15 @@
  * The ASF licenses this file to You under the Apache License, Version 2.0
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
- * 
+ *
  *      http://www.apache.org/licenses/LICENSE-2.0
- * 
+ *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
- */ 
+ */
 
 
 package org.apache.commons.beanutils;
@@ -152,7 +152,7 @@
         this(resultSet, lowerCase, -1);
 
     }
-	
+
     /**
      * <p>Construct a new {@link RowSetDynaClass} for the specified
      * <code>ResultSet</code>.  The property names corresponding
@@ -225,7 +225,7 @@
     protected void copy(ResultSet resultSet) throws SQLException {
 
         int cnt = 0;
-        while (resultSet.next() && (limit < 0  || cnt++ < limit) ) {	
+        while (resultSet.next() && (limit < 0  || cnt++ < limit) ) {
             DynaBean bean = createDynaBean();
             for (int i = 0; i < properties.length; i++) {
                 String name = properties[i].getName();



---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org


Mime
View raw message