ggregory 2003/11/02 16:21:19
Modified: lang/src/java/org/apache/commons/lang/builder
ReflectionToStringBuilder.java
Log:
Remove convenience toStringWithStatics APIs.
Revision Changes Path
1.14 +1 -86
jakarta-commons/lang/src/java/org/apache/commons/lang/builder/ReflectionToStringBuilder.java
Index: ReflectionToStringBuilder.java
===================================================================
RCS file:
/home/cvs/jakarta-commons/lang/src/java/org/apache/commons/lang/builder/ReflectionToStringBuilder.java,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -r1.13 -r1.14
--- ReflectionToStringBuilder.java 23 Oct 2003 22:27:45 -0000 1.13
+++ ReflectionToStringBuilder.java 3 Nov 2003 00:21:19 -0000 1.14
@@ -336,91 +336,6 @@
}
/**
- * TODO: Is this convenience API really needed?
- *
- * <p>This method uses reflection to build a suitable
- * <code>toString</code> value which includes static fields.</p>
- *
- * <p>It uses <code>AccessibleObject.setAccessible</code> to gain access to
private
- * fields. This means that it will throw a security exception if run
- * under a security manager, if the permissions are not set up correctly.
- * It is also not as efficient as testing explicitly. </p>
- *
- * <p>Transient fields are not output.</p>
- *
- * <p>Superclass fields will be appended up to and including
- * <code>java.lang.Object</code>.</p>
- *
- * <p>The default <code>ToStringStyle</code> is used.</p>
- *
- * @param object the Object to be output
- * @return the String result
- * @throws IllegalArgumentException if the Object is <code>null</code>
- */
- public static Object toStringWithStatics(Object object) {
- return toString(object, null, false, true, null);
- }
-
- /**
- * TODO: Is this convenience API really needed?
- *
- * <p>This method uses reflection to build a suitable
- * <code>toString</code> value which includes static fields.</p>
- *
- * <p>It uses <code>AccessibleObject.setAccessible</code> to gain access to
private
- * fields. This means that it will throw a security exception if run
- * under a security manager, if the permissions are not set up correctly.
- * It is also not as efficient as testing explicitly. </p>
- *
- * <p>Transient fields are not output.</p>
- *
- * <p>Superclass fields will be appended up to and including the specified
superclass.
- * A null superclass is treated as <code>java.lang.Object</code>.</p>
- *
- * <p>The default <code>ToStringStyle</code> is used.</p>
- *
- * @param object the Object to be output
- * @param reflectUpToClass the superclass to reflect up to (inclusive),
- * may be <code>null</code>
- * @return the String result
- * @throws IllegalArgumentException if the Object is <code>null</code>
- */
- public static Object toStringWithStatics(Object object, Class reflectUpToClass)
{
- return toString(object, null, false, true, reflectUpToClass);
- }
-
- /**
- * TODO: Is this convenience API really needed?
- *
- * <p>This method uses reflection to build a suitable
- * <code>toString</code> value which includes static fields.</p>
- *
- * <p>It uses <code>AccessibleObject.setAccessible</code> to gain access to
private
- * fields. This means that it will throw a security exception if run
- * under a security manager, if the permissions are not set up correctly.
- * It is also not as efficient as testing explicitly. </p>
- *
- * <p>Transient fields are not output.</p>
- *
- * <p>Superclass fields will be appended up to and including the specified
superclass.
- * A null superclass is treated as <code>java.lang.Object</code>.</p>
- *
- * <p>If the style is <code>null</code>, the default
- * <code>ToStringStyle</code> is used.</p>
- *
- * @param object the Object to be output
- * @param style the style of the <code>toString</code> to create,
- * may be <code>null</code>
- * @param reflectUpToClass the superclass to reflect up to (inclusive),
- * may be <code>null</code>
- * @return the String result
- * @throws IllegalArgumentException if the Object is <code>null</code>
- */
- public static Object toStringWithStatics(Object object, ToStringStyle style,
Class reflectUpToClass) {
- return toString(object, style, false, true, reflectUpToClass);
- }
-
- /**
* <p>Unregisters the given object.</p>
*
* <p>Used by the reflection methods to avoid infinite loops.</p>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
