diff options
author | Michael Koch <konqueror@gmx.de> | 2004-04-20 12:30:19 +0000 |
---|---|---|
committer | Michael Koch <mkoch@gcc.gnu.org> | 2004-04-20 12:30:19 +0000 |
commit | cf6f7d55897e0c6b1badbcfc241e512a4bb154b8 (patch) | |
tree | d5b22b275323c4e4a0c6ebb05e86b4a087ef279d /libjava/java/lang/reflect/InvocationHandler.java | |
parent | 9f714d5eec05594569dd89920353272606622d8a (diff) | |
download | gcc-cf6f7d55897e0c6b1badbcfc241e512a4bb154b8.zip gcc-cf6f7d55897e0c6b1badbcfc241e512a4bb154b8.tar.gz gcc-cf6f7d55897e0c6b1badbcfc241e512a4bb154b8.tar.bz2 |
Byte.java, [...]: Fixed javadocs, coding style and argument names all over.
2004-04-20 Michael Koch <konqueror@gmx.de>
* java/lang/Byte.java,
java/lang/CharSequence.java,
java/lang/ClassLoader.java,
java/lang/Compiler.java,
java/lang/Double.java,
java/lang/Float.java,
java/lang/Integer.java,
java/lang/Long.java,
java/lang/Math.java,
java/lang/Number.java,
java/lang/Package.java,
java/lang/Runtime.java,
java/lang/RuntimePermission.java,
java/lang/SecurityManager.java,
java/lang/Short.java,
java/lang/StringBuffer.java,
java/lang/System.java,
java/lang/ThreadGroup.java,
java/lang/Throwable.java,
java/lang/reflect/InvocationHandler.java,
java/lang/reflect/Proxy.java:
Fixed javadocs, coding style and argument names all over.
From-SVN: r80899
Diffstat (limited to 'libjava/java/lang/reflect/InvocationHandler.java')
-rw-r--r-- | libjava/java/lang/reflect/InvocationHandler.java | 43 |
1 files changed, 22 insertions, 21 deletions
diff --git a/libjava/java/lang/reflect/InvocationHandler.java b/libjava/java/lang/reflect/InvocationHandler.java index 91907e2..514d943 100644 --- a/libjava/java/lang/reflect/InvocationHandler.java +++ b/libjava/java/lang/reflect/InvocationHandler.java @@ -49,37 +49,38 @@ package java.lang.reflect; * interface. But in order for the proxy instance to do any good, it * needs to know what to do when interface methods are invoked! So, * this interface is basically a cool wrapper that provides runtime - * code generation needed by proxy instances.<p> + * code generation needed by proxy instances. * - * While this interface was designed for use by Proxy, it will also - * work on any object in general.<p> + * <p>While this interface was designed for use by Proxy, it will also + * work on any object in general.</p> * - * Hints for implementing this class:<br> + * <p>Hints for implementing this class:</p> + * * <ul> - * <li>Don't forget that Object.equals, Object.hashCode, and - * Object.toString will call this handler. In particular, - * a naive call to proxy.equals, proxy.hashCode, or proxy.toString - * will put you in an infinite loop. And remember that string - * concatenation also invokes toString.</li> - * <li>Obey the contract of the Method object you are handling, or - * the proxy instance will be forced to throw a - * {@link NullPointerException}, {@link ClassCastException}, - * or {@link UndeclaredThrowableException}.</li> - * <li>Be prepared to wrap/unwrap primitives as necessary.</li> - * <li>The Method object may be owned by a different interface than - * what was actually used as the qualifying type of the method - * invocation in the Java source code. This means that it might - * not always be safe to throw an exception listed as belonging - * to the method's throws clause.</li> + * <li>Don't forget that Object.equals, Object.hashCode, and + * Object.toString will call this handler. In particular, + * a naive call to proxy.equals, proxy.hashCode, or proxy.toString + * will put you in an infinite loop. And remember that string + * concatenation also invokes toString.</li> + * <li>Obey the contract of the Method object you are handling, or + * the proxy instance will be forced to throw a + * {@link NullPointerException}, {@link ClassCastException}, + * or {@link UndeclaredThrowableException}.</li> + * <li>Be prepared to wrap/unwrap primitives as necessary.</li> + * <li>The Method object may be owned by a different interface than + * what was actually used as the qualifying type of the method + * invocation in the Java source code. This means that it might + * not always be safe to throw an exception listed as belonging + * to the method's throws clause.</li> * </ul> * * <p><small>For a fun time, create an InvocationHandler that handles the - * methods of a proxy instance of the InvocationHandler interface!</small> + * methods of a proxy instance of the InvocationHandler interface!</small></p> * * @see Proxy * @see UndeclaredThrowableException * - * @author Eric Blake <ebb9@email.byu.edu> + * @author Eric Blake (ebb9@email.byu.edu) * @since 1.3 * @status updated to 1.4 */ |