From: chiba Date: Tue, 27 Jul 2004 14:47:30 +0000 (+0000) Subject: updated some javadoc comments. X-Git-Tag: rel_3_17_1_ga~494 X-Git-Url: https://source.dussan.org/?a=commitdiff_plain;h=f4a78cf275e5a1a8f81fed70d73f6273f6f9150f;p=javassist.git updated some javadoc comments. git-svn-id: http://anonsvn.jboss.org/repos/javassist/trunk@119 30ef5769-5b8d-40dd-aea6-55b5d6557bb3 --- diff --git a/src/main/javassist/reflect/Reflection.java b/src/main/javassist/reflect/Reflection.java index 9cb14425..a52351da 100644 --- a/src/main/javassist/reflect/Reflection.java +++ b/src/main/javassist/reflect/Reflection.java @@ -19,7 +19,7 @@ import javassist.*; import javassist.CtMethod.ConstParameter; /** - * The class implementing the reflection mechanism. + * The class implementing the behavioral reflection mechanism. * *

If a class is reflective, * then all the method invocations on every diff --git a/src/main/javassist/reflect/package.html b/src/main/javassist/reflect/package.html index de344d0c..128f186e 100644 --- a/src/main/javassist/reflect/package.html +++ b/src/main/javassist/reflect/package.html @@ -1,11 +1,13 @@ -Runtime Reflection. +Runtime Behavioral Reflection. + +

(also recently known as AOP)

This package enables a metaobject to trap method calls and field accesses on a regular Java object. It provides a class Reflection, which is a main module for implementing -runtime reflection. +runtime behavioral reflection. It also provides a class Loader and Compiler as utilities for dynamically or statically diff --git a/tutorial/tutorial.html b/tutorial/tutorial.html index 6dc7ad14..064f8da8 100644 --- a/tutorial/tutorial.html +++ b/tutorial/tutorial.html @@ -434,10 +434,10 @@ and calls say() on that instance.

Note that the program above depends on the fact that the Hello class is never loaded before toClass() is invoked. If not, the JVM would load the original -Hello class before toClass() request to load -the modified Hello class. Hence loading the modified -Hello class would be failed. -For example, if +Hello class before toClass() requests to +load the modified Hello class. Hence loading the +modified Hello class would be failed +(LinkageError is thrown). For example, if main() in Test is something like this:

@@ -455,12 +455,12 @@ throws an exception since the class loader cannot load two different
 versions of the Hello class at the same time.
 
 If the program is running on some application server such as
-JBoss, the context class loader used by toClass()
-might be inappropriate.  In this case, you would see an unexpected
-ClassCastException.  To avoid this exception, you must
-explicitly give an appropriate class loader to toClass().
-For example, if bean is your session bean object, then the
-following code:
+JBoss and Tomcat, the context class loader used by
+toClass() might be inappropriate.  In this case, you
+would see an unexpected ClassCastException.  To avoid
+this exception, you must explicitly give an appropriate class loader
+to toClass().  For example, if bean is your
+session bean object, then the following code:
 
 
CtClass cc = ...;
 Class c = cc.toClass(bean.getClass().getClassLoader());
diff --git a/tutorial/tutorial2.html b/tutorial/tutorial2.html
index 8dc5f867..937c4427 100644
--- a/tutorial/tutorial2.html
+++ b/tutorial/tutorial2.html
@@ -18,6 +18,7 @@
 Inserting source text at the beginning/end of a method body
 
Altering a method body
 
Adding a new method or field
+
Runtime support classes
 
Limitations
 
 
@@ -1269,8 +1270,22 @@ does not end with a semi colon (;).
 
 

 
+
+
5.4 Runtime support classes

+
+In most cases, a class modified by Javassist does not require
+Javassist to run.  However, some kinds of bytecode generated by the
+Javassist compiler need runtime support classes, which are in the
+javassist.runtime package (for details, please read
+the API reference of that package).  Note that the
+javassist.runtime package is the only package that
+classes modified by Javassist may need for running.  The other
+Javassist classes are never used at runtime of the modified classes.
+
+

+
 
-
5.4 Limitations

+5.5 Limitations
 
 In the current implementation, the Java compiler included in Javassist
 has several limitations with respect to the language that the compiler can