You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@harmony.apache.org by te...@apache.org on 2008/02/15 13:04:11 UTC
svn commit: r628032 - in /harmony/enhanced/classlib/trunk/modules:
luni-kernel/src/main/java/java/lang/ luni/src/main/java/java/util/
security-kernel/src/main/java/java/security/
Author: tellison
Date: Fri Feb 15 04:04:10 2008
New Revision: 628032
URL: http://svn.apache.org/viewvc?rev=628032&view=rev
Log:
Fixing and formatting JavaDoc comments -- no functional changes.
Modified:
harmony/enhanced/classlib/trunk/modules/luni-kernel/src/main/java/java/lang/Class.java
harmony/enhanced/classlib/trunk/modules/luni-kernel/src/main/java/java/lang/ClassLoader.java
harmony/enhanced/classlib/trunk/modules/luni/src/main/java/java/util/Arrays.java
harmony/enhanced/classlib/trunk/modules/luni/src/main/java/java/util/Collections.java
harmony/enhanced/classlib/trunk/modules/security-kernel/src/main/java/java/security/AccessController.java
Modified: harmony/enhanced/classlib/trunk/modules/luni-kernel/src/main/java/java/lang/Class.java
URL: http://svn.apache.org/viewvc/harmony/enhanced/classlib/trunk/modules/luni-kernel/src/main/java/java/lang/Class.java?rev=628032&r1=628031&r2=628032&view=diff
==============================================================================
--- harmony/enhanced/classlib/trunk/modules/luni-kernel/src/main/java/java/lang/Class.java (original)
+++ harmony/enhanced/classlib/trunk/modules/luni-kernel/src/main/java/java/lang/Class.java Fri Feb 15 04:04:10 2008
@@ -75,12 +75,14 @@
*
* @since 1.0
*/
-public final class Class<T> implements Serializable, AnnotatedElement, GenericDeclaration, Type {
+public final class Class<T> implements Serializable, AnnotatedElement,
+ GenericDeclaration, Type {
private static final long serialVersionUID = 3206093459760846163L;
-
- private Class(){
- //prevent this class to be instantiated, instance should be created by JVM only
+
+ private Class() {
+ // prevent this class to be instantiated, instance should be created by
+ // JVM only
}
/**
@@ -110,8 +112,10 @@
* the caller of this method.</li>
* </ul>
*
- * @param maxDepth maximum depth to walk the stack, -1 for the entire stack
- * @param stopAtPrivileged stop at privileged classes
+ * @param maxDepth
+ * maximum depth to walk the stack, -1 for the entire stack
+ * @param stopAtPrivileged
+ * stop at privileged classes
* @return the array of the most recent classes on the stack
*/
static final Class[] getStackClasses(int maxDepth, boolean stopAtPrivileged) {
@@ -120,32 +124,37 @@
/**
* Answers a Class object which represents the class named by the argument.
+ *
* The name should be the name of a class as described in the class
- * definition of {@link Class}, however Classes representing base types can
- * not be found using this method.
+ * definition of <code>Class</code>, however Classes representing base
+ * types can not be found using this method.
*
- * @param className The name of the non-base type class to find
+ * @param className
+ * The name of the non-base type class to find
* @return the named Class
- * @throws ClassNotFoundException If the class could not be found
- * @see {@link Class}
+ * @throws ClassNotFoundException
+ * If the class could not be found
*/
- public static Class<?> forName(String className) throws ClassNotFoundException {
+ public static Class<?> forName(String className)
+ throws ClassNotFoundException {
return null;
}
/**
* Answers a Class object which represents the class named by the argument.
* The name should be the name of a class as described in the class
- * definition of {@link Class}, however Classes representing base types can
- * not be found using this method. Security rules will be obeyed.
+ * definition of <code>Class</code>, however Classes representing base
+ * types can not be found using this method. Security rules will be obeyed.
*
- * @param className The name of the non-base type class to find
- * @param initializeBoolean A boolean indicating whether the class should be
- * initialized
- * @param classLoader The class loader to use to load the class
+ * @param className
+ * The name of the non-base type class to find
+ * @param initializeBoolean
+ * A boolean indicating whether the class should be initialized
+ * @param classLoader
+ * The class loader to use to load the class
* @return the named class.
- * @throws ClassNotFoundException If the class could not be found
- * @see {@link Class}
+ * @throws ClassNotFoundException
+ * If the class could not be found
*/
public static Class<?> forName(String className, boolean initializeBoolean,
ClassLoader classLoader) throws ClassNotFoundException {
@@ -157,8 +166,8 @@
* the receiver represents and its super classes and interfaces
*
* @return the class' public class members
- * @throws SecurityException If member access is not allowed
- * @see {@link Class}
+ * @throws SecurityException
+ * If member access is not allowed
*/
public Class[] getClasses() {
return null;
@@ -167,7 +176,8 @@
/**
* Verify the specified Class using the VM byte code verifier.
*
- * @throws VerifyError if the Class cannot be verified
+ * @throws VerifyError
+ * if the Class cannot be verified
*/
void verify() {
return;
@@ -177,7 +187,8 @@
* Answers the annotation of the given type. If there is no annotation the
* method returns <code>null</code>.
*
- * @param annotationClass the annotation type.
+ * @param annotationClass
+ * the annotation type.
* @return the annotation of the given type, or <code>null</code> if none.
* @since 1.5
*/
@@ -211,8 +222,7 @@
* the receiver. Answer null if the class was loaded by the system class
* loader
*
- * @return the receiver's class loader or nil
- * @see {@link ClassLoader}
+ * @return the receiver's class loader or null
*/
public ClassLoader getClassLoader() {
return null;
@@ -236,11 +246,10 @@
/**
* Answers a Class object which represents the receiver's component type if
- * the receiver represents an array type. Otherwise answers nil. The
+ * the receiver represents an array type. Otherwise answers null. The
* component type of an array type is the type of the elements of the array.
*
* @return the component type of the receiver.
- * @see {@link Class}
*/
public Class<?> getComponentType() {
return null;
@@ -250,14 +259,17 @@
* Answers a public Constructor object which represents the constructor
* described by the arguments.
*
- * @param parameterTypes the types of the arguments.
+ * @param parameterTypes
+ * the types of the arguments.
* @return the constructor described by the arguments.
- * @throws NoSuchMethodException if the constructor could not be found.
- * @throws SecurityException if member access is not allowed
+ * @throws NoSuchMethodException
+ * if the constructor could not be found.
+ * @throws SecurityException
+ * if member access is not allowed
* @see #getConstructors
*/
- public Constructor<T> getConstructor(Class... parameterTypes) throws NoSuchMethodException,
- SecurityException {
+ public Constructor<T> getConstructor(Class... parameterTypes)
+ throws NoSuchMethodException, SecurityException {
return null;
}
@@ -266,7 +278,8 @@
* constructors which are visible from the current execution context.
*
* @return all visible constructors starting from the receiver.
- * @throws SecurityException if member access is not allowed
+ * @throws SecurityException
+ * if member access is not allowed
* @see #getMethods
*/
public Constructor[] getConstructors() throws SecurityException {
@@ -292,8 +305,8 @@
* not be visible in the current execution context.
*
* @return the class' class members
- * @throws SecurityException if member access is not allowed
- * @see {@link Class}
+ * @throws SecurityException
+ * if member access is not allowed
*/
public Class[] getDeclaredClasses() throws SecurityException {
return new Class[0];
@@ -303,10 +316,13 @@
* Answers a Constructor object which represents the constructor described
* by the arguments.
*
- * @param parameterTypes the types of the arguments.
+ * @param parameterTypes
+ * the types of the arguments.
* @return the constructor described by the arguments.
- * @throws NoSuchMethodException if the constructor could not be found.
- * @throws SecurityException if member access is not allowed
+ * @throws NoSuchMethodException
+ * if the constructor could not be found.
+ * @throws SecurityException
+ * if member access is not allowed
* @see #getConstructors
*/
public Constructor<T> getDeclaredConstructor(Class... parameterTypes)
@@ -321,7 +337,8 @@
* context.
*
* @return the receiver's constructors.
- * @throws SecurityException if member access is not allowed
+ * @throws SecurityException
+ * if member access is not allowed
* @see #getMethods
*/
public Constructor[] getDeclaredConstructors() throws SecurityException {
@@ -333,13 +350,17 @@
* argument. Note that the Constructor may not be visible from the current
* execution context.
*
- * @param name The name of the field to look for.
+ * @param name
+ * The name of the field to look for.
* @return the field in the receiver named by the argument.
- * @throws NoSuchFieldException if the requested field could not be found
- * @throws SecurityException if member access is not allowed
+ * @throws NoSuchFieldException
+ * if the requested field could not be found
+ * @throws SecurityException
+ * if member access is not allowed
* @see #getDeclaredFields
*/
- public Field getDeclaredField(String name) throws NoSuchFieldException, SecurityException {
+ public Field getDeclaredField(String name) throws NoSuchFieldException,
+ SecurityException {
return null;
}
@@ -349,7 +370,8 @@
* may not be visible in the current execution context.
*
* @return the receiver's fields.
- * @throws SecurityException If member access is not allowed
+ * @throws SecurityException
+ * If member access is not allowed
* @see #getFields
*/
public Field[] getDeclaredFields() throws SecurityException {
@@ -361,12 +383,17 @@
* arguments. Note that the associated method may not be visible from the
* current execution context.
*
- * @param name the name of the method
- * @param parameterTypes the types of the arguments.
+ * @param name
+ * the name of the method
+ * @param parameterTypes
+ * the types of the arguments.
* @return the method described by the arguments.
- * @throws NoSuchMethodException if the method could not be found.
- * @throws SecurityException If member access is not allowed
- * @throws NullPointerException if the name parameter is <code>null</code>.
+ * @throws NoSuchMethodException
+ * if the method could not be found.
+ * @throws SecurityException
+ * If member access is not allowed
+ * @throws NullPointerException
+ * if the name parameter is <code>null</code>.
* @see #getMethods
*/
public Method getDeclaredMethod(String name, Class... parameterTypes)
@@ -379,7 +406,8 @@
* are defined by the receiver. Note that some of the methods which are
* returned may not be visible in the current execution context.
*
- * @throws SecurityException if member access is not allowed
+ * @throws SecurityException
+ * if member access is not allowed
* @return the receiver's methods.
* @see #getMethods
*/
@@ -447,13 +475,17 @@
* Answers a Field object describing the field in the receiver named by the
* argument which must be visible from the current execution context.
*
- * @param name The name of the field to look for.
+ * @param name
+ * The name of the field to look for.
* @return the field in the receiver named by the argument.
- * @throws NoSuchFieldException If the given field does not exist
- * @throws SecurityException If access is denied
+ * @throws NoSuchFieldException
+ * If the given field does not exist
+ * @throws SecurityException
+ * If access is denied
* @see #getDeclaredFields
*/
- public Field getField(String name) throws NoSuchFieldException, SecurityException {
+ public Field getField(String name) throws NoSuchFieldException,
+ SecurityException {
return null;
}
@@ -462,7 +494,8 @@
* visible from the current execution context.
*
* @return all visible fields starting from the receiver.
- * @throws SecurityException If member access is not allowed
+ * @throws SecurityException
+ * If member access is not allowed
* @see #getDeclaredFields
*/
public Field[] getFields() throws SecurityException {
@@ -504,15 +537,19 @@
* Answers a Method object which represents the method described by the
* arguments.
*
- * @param name String the name of the method
- * @param parameterTypes Class[] the types of the arguments.
+ * @param name
+ * String the name of the method
+ * @param parameterTypes
+ * Class[] the types of the arguments.
* @return Method the method described by the arguments.
- * @throws NoSuchMethodException if the method could not be found.
- * @throws SecurityException if member access is not allowed
+ * @throws NoSuchMethodException
+ * if the method could not be found.
+ * @throws SecurityException
+ * if member access is not allowed
* @see #getMethods
*/
- public Method getMethod(String name, Class... parameterTypes) throws NoSuchMethodException,
- SecurityException {
+ public Method getMethod(String name, Class... parameterTypes)
+ throws NoSuchMethodException, SecurityException {
return null;
}
@@ -521,7 +558,8 @@
* are visible from the current execution context.
*
* @return Method[] all visible methods starting from the receiver.
- * @throws SecurityException if member access is not allowed
+ * @throws SecurityException
+ * if member access is not allowed
* @see #getDeclaredMethods
*/
public Method[] getMethods() throws SecurityException {
@@ -542,10 +580,9 @@
/**
* Answers the name of the class which the receiver represents. For a
* description of the format which is used, see the class definition of
- * {@link Class}.
+ * <code>Class</code>.
*
* @return the receiver's name.
- * @see {@link Class}
*/
public String getName() {
return null;
@@ -565,7 +602,7 @@
/**
* Answers the ProtectionDomain of the receiver.
- * <p>
+ *
* Note: In order to conserve space in embedded targets, we allow this
* method to answer null for classes in the system protection domain (i.e.
* for system classes). System classes are always given full permissions
@@ -573,7 +610,6 @@
* java.security.Policy.
*
* @return ProtectionDomain the receiver's ProtectionDomain.
- * @see {@link Class}
*/
public ProtectionDomain getProtectionDomain() {
return null;
@@ -581,11 +617,10 @@
/**
* Answers the ProtectionDomain of the receiver.
- * <p>
+ *
* This method is for internal use only.
*
* @return ProtectionDomain the receiver's ProtectionDomain.
- * @see {@link Class}
*/
ProtectionDomain getPDImpl() {
return null;
@@ -596,9 +631,10 @@
* resName. The mapping between the resource name and the stream is managed
* by the class' class loader.
*
- * @param resName the name of the resource.
+ * @param resName
+ * the name of the resource.
* @return a stream on the resource.
- * @see {@link ClassLoader}
+ * @see ClassLoader
*/
public URL getResource(String resName) {
return null;
@@ -609,9 +645,10 @@
* resName. The mapping between the resource name and the stream is managed
* by the class' class loader.
*
- * @param resName the name of the resource.
+ * @param resName
+ * the name of the resource.
* @return a stream on the resource.
- * @see {@link ClassLoader}
+ * @see ClassLoader
*/
public InputStream getResourceAsStream(String resName) {
return null;
@@ -664,12 +701,14 @@
/**
* Indicates whether or not the given annotation is present for this class.
*
- * @param annotationClass The annotation to look for in this class.
+ * @param annotationClass
+ * The annotation to look for in this class.
* @return A value of <code>true</code> if the annotation is present,
* otherwise <code>false</code>.
* @since 1.5
*/
- public boolean isAnnotationPresent(Class<? extends Annotation> annotationClass) {
+ public boolean isAnnotationPresent(
+ Class<? extends Annotation> annotationClass) {
return false;
}
@@ -703,8 +742,10 @@
* @return <code>true</code> the argument can be assigned into the
* receiver <code>false</code> the argument cannot be assigned
* into the receiver
- * @param cls Class the class to test
- * @throws NullPointerException if the parameter is null
+ * @param cls
+ * Class the class to test
+ * @throws NullPointerException
+ * if the parameter is null
*/
public boolean isAssignableFrom(Class<?> cls) {
return false;
@@ -729,7 +770,8 @@
* @return <code>true</code> the argument can be cast to the type of the
* receiver <code>false</code> the argument is null or cannot be
* cast to the type of the receiver
- * @param object Object the object to test
+ * @param object
+ * Object the object to test
*/
public boolean isInstance(Object object) {
return false;
@@ -795,11 +837,13 @@
* IllegalAccessException is thrown.
*
* @return a new instance of the class represented by the receiver.
- * @throws IllegalAccessException if the constructor is not visible to the
- * sender.
- * @throws InstantiationException if the instance could not be created.
+ * @throws IllegalAccessException
+ * if the constructor is not visible to the sender.
+ * @throws InstantiationException
+ * if the instance could not be created.
*/
- public T newInstance() throws IllegalAccessException, InstantiationException {
+ public T newInstance() throws IllegalAccessException,
+ InstantiationException {
return null;
}
@@ -836,26 +880,29 @@
}
/**
- * Casts the receiver to a subclass of the given class. If successful
+ * Casts the receiver to a subclass of the given class. If successful
* answers the receiver, otherwise if the cast cannot be made throws a
* <code>ClassCastException</code>.
*
- * @param clazz the required type.
+ * @param clazz
+ * the required type.
* @return this class cast as a subclass of the given type.
- * @throws ClassCastException if the class cannot be cast to the given type.
+ * @throws ClassCastException
+ * if the class cannot be cast to the given type.
*/
public <U> Class<? extends U> asSubclass(Class<U> clazz) {
return null;
}
/**
- * Cast the given object to the type <code>T</code>.
- * If the object is <code>null</code> the result is also
- * <code>null</code>.
+ * Cast the given object to the type <code>T</code>. If the object is
+ * <code>null</code> the result is also <code>null</code>.
*
- * @param obj the object to cast
+ * @param obj
+ * the object to cast
* @return The object that has been cast.
- * @throws ClassCastException if the object cannot be cast to the given type.
+ * @throws ClassCastException
+ * if the object cannot be cast to the given type.
*/
public T cast(Object obj) {
return null;
Modified: harmony/enhanced/classlib/trunk/modules/luni-kernel/src/main/java/java/lang/ClassLoader.java
URL: http://svn.apache.org/viewvc/harmony/enhanced/classlib/trunk/modules/luni-kernel/src/main/java/java/lang/ClassLoader.java?rev=628032&r1=628031&r2=628032&view=diff
==============================================================================
--- harmony/enhanced/classlib/trunk/modules/luni-kernel/src/main/java/java/lang/ClassLoader.java (original)
+++ harmony/enhanced/classlib/trunk/modules/luni-kernel/src/main/java/java/lang/ClassLoader.java Fri Feb 15 04:04:10 2008
@@ -43,6 +43,7 @@
/**
* The 'System' ClassLoader; also known as the bootstrap ClassLoader.
+ *
* @see #getSystemClassLoader()
*/
static ClassLoader systemClassLoader;
@@ -68,8 +69,9 @@
* thrown.
*
* @return The system classLoader.
- * @throws SecurityException if a security manager exists and it does not
- * allow access to the system class loader.
+ * @throws SecurityException
+ * if a security manager exists and it does not allow access to
+ * the system class loader.
*/
public static ClassLoader getSystemClassLoader() {
return null;
@@ -80,7 +82,8 @@
* resName using the system class loader's resource lookup algorithm.
*
* @return A URL specifying a system resource or null.
- * @param resName The name of the resource to find.
+ * @param resName
+ * The name of the resource to find.
* @see Class#getResource
*/
public static URL getSystemResource(String resName) {
@@ -93,9 +96,13 @@
* lookup algorithm.
*
* @return An Enumeration of URLs containing the system resources
- * @param resName String the name of the resource to find.
+ * @param resName
+ * String the name of the resource to find.
+ * @throws IOException
+ * if an IO exception occurs
*/
- public static Enumeration<URL> getSystemResources(String resName) throws IOException {
+ public static Enumeration<URL> getSystemResources(String resName)
+ throws IOException {
return null;
}
@@ -106,7 +113,8 @@
* matches the specified resource.
*
* @return A stream on the resource or null.
- * @param resName The name of the resource to find.
+ * @param resName
+ * The name of the resource to find.
* @see Class#getResourceAsStream
*/
public static InputStream getSystemResourceAsStream(String resName) {
@@ -117,8 +125,9 @@
* Constructs a new instance of this class with the system class loader as
* its parent.
*
- * @throws SecurityException if a security manager exists and it does not
- * allow the creation of new ClassLoaders.
+ * @throws SecurityException
+ * if a security manager exists and it does not allow the
+ * creation of new ClassLoaders.
*/
protected ClassLoader() {
super();
@@ -128,11 +137,13 @@
* Constructs a new instance of this class with the given class loader as
* its parent.
*
- * @param parentLoader The ClassLoader to use as the new class loaders
- * parent.
- * @throws SecurityException if a security manager exists and it does not
- * allow the creation of new ClassLoaders.
- * @throws NullPointerException if the parent is null.
+ * @param parentLoader
+ * The ClassLoader to use as the new class loaders parent.
+ * @throws SecurityException
+ * if a security manager exists and it does not allow the
+ * creation of new ClassLoaders.
+ * @throws NullPointerException
+ * if the parent is null.
*/
protected ClassLoader(ClassLoader parentLoader) {
super();
@@ -142,9 +153,12 @@
* Constructs a new class from an array of bytes containing a class
* definition in class file format.
*
- * @param classRep A memory image of a class file.
- * @param offset The offset into the classRep.
- * @param length The length of the class file.
+ * @param classRep
+ * A memory image of a class file.
+ * @param offset
+ * The offset into the classRep.
+ * @param length
+ * The length of the class file.
* @deprecated Use defineClass(String, byte[], int, int)
*/
@Deprecated
@@ -157,13 +171,17 @@
* Constructs a new class from an array of bytes containing a class
* definition in class file format.
*
- * @param className The name of the new class
- * @param classRep A memory image of a class file
- * @param offset The offset into the classRep
- * @param length The length of the class file
+ * @param className
+ * The name of the new class
+ * @param classRep
+ * A memory image of a class file
+ * @param offset
+ * The offset into the classRep
+ * @param length
+ * The length of the class file
*/
- protected final Class<?> defineClass(String className, byte[] classRep, int offset,
- int length) throws ClassFormatError {
+ protected final Class<?> defineClass(String className, byte[] classRep,
+ int offset, int length) throws ClassFormatError {
return null;
}
@@ -172,15 +190,20 @@
* definition in class file format and assigns the new class to the
* specified protection domain.
*
- * @param className The name of the new class.
- * @param classRep A memory image of a class file.
- * @param offset The offset into the classRep.
- * @param length The length of the class file.
- * @param protectionDomain The protection domain this class should belongs
- * to.
- */
- protected final Class<?> defineClass(String className, byte[] classRep, int offset,
- int length, ProtectionDomain protectionDomain) throws java.lang.ClassFormatError {
+ * @param className
+ * The name of the new class.
+ * @param classRep
+ * A memory image of a class file.
+ * @param offset
+ * The offset into the classRep.
+ * @param length
+ * The length of the class file.
+ * @param protectionDomain
+ * The protection domain this class should belongs to.
+ */
+ protected final Class<?> defineClass(String className, byte[] classRep,
+ int offset, int length, ProtectionDomain protectionDomain)
+ throws java.lang.ClassFormatError {
return null;
}
@@ -190,11 +213,15 @@
* protection domain.
* </p>
*
- * @param name The name of the class to define.
- * @param b The byte buffer containing the bytecodes of the new class.
- * @param protectionDomain The protection domain this class belongs to.
+ * @param name
+ * The name of the class to define.
+ * @param b
+ * The byte buffer containing the bytecodes of the new class.
+ * @param protectionDomain
+ * The protection domain this class belongs to.
* @return The defined class.
- * @throws ClassFormatError if an invalid class file is defined.
+ * @throws ClassFormatError
+ * if an invalid class file is defined.
* @since 1.5
*/
protected final Class<?> defineClass(String name, ByteBuffer b,
@@ -210,10 +237,13 @@
* to find a loaded class of the same name.
*
* @return The class or null.
- * @param className The name of the class to search for.
- * @throws ClassNotFoundException if the class cannot be found.
+ * @param className
+ * The name of the class to search for.
+ * @throws ClassNotFoundException
+ * if the class cannot be found.
*/
- protected Class<?> findClass(String className) throws ClassNotFoundException {
+ protected Class<?> findClass(String className)
+ throws ClassNotFoundException {
return null;
}
@@ -223,7 +253,8 @@
* caller should call resolveClass() on the result if necessary.
*
* @return The class or null.
- * @param className The name of the class to search for.
+ * @param className
+ * The name of the class to search for.
*/
protected final Class<?> findLoadedClass(String className) {
return null;
@@ -234,10 +265,13 @@
* class has already been been linked.
*
* @return The class which was loaded.
- * @param className The name of the class to search for.
- * @throws ClassNotFoundException if the class cannot be found.
+ * @param className
+ * The name of the class to search for.
+ * @throws ClassNotFoundException
+ * if the class cannot be found.
*/
- protected final Class<?> findSystemClass(String className) throws ClassNotFoundException {
+ protected final Class<?> findSystemClass(String className)
+ throws ClassNotFoundException {
return null;
}
@@ -245,8 +279,9 @@
* Returns the specified ClassLoader's parent.
*
* @return The class or null.
- * @throws SecurityException if a security manager exists and it does not
- * allow the parent loader to be retrieved.
+ * @throws SecurityException
+ * if a security manager exists and it does not allow the parent
+ * loader to be retrieved.
*/
public final ClassLoader getParent() {
return null;
@@ -258,8 +293,9 @@
* behavior is just to return null.
*
* @return The location of the resource.
- * @param resName String the name of the resource to find.
- * @see Class#getResource
+ * @param resName
+ * String the name of the resource to find.
+ * @see Class#getResource(String)
*/
public URL getResource(String resName) {
return null;
@@ -271,7 +307,10 @@
* The default behavior is just to return an empty Enumeration.
*
* @return The location of the resources.
- * @param resName String the name of the resource to find.
+ * @param resName
+ * String the name of the resource to find.
+ * @throws IOException
+ * if an IO exception occurs
*/
public Enumeration<URL> getResources(String resName) throws IOException {
return null;
@@ -283,7 +322,8 @@
* return null.
*
* @return A stream on the resource or null.
- * @param resName String the name of the resource to find.
+ * @param resName
+ * String the name of the resource to find.
* @see Class#getResourceAsStream
*/
public InputStream getResourceAsStream(String resName) {
@@ -295,8 +335,10 @@
* Equivalent to loadClass(className, false);
*
* @return The Class object.
- * @param className The name of the class to search for.
- * @throws ClassNotFoundException if the class could not be found.
+ * @param className
+ * The name of the class to search for.
+ * @throws ClassNotFoundException
+ * if the class could not be found.
*/
public Class<?> loadClass(String className) throws ClassNotFoundException {
return null;
@@ -309,9 +351,12 @@
* loader. 3) Call findClass(className) to find the class
*
* @return The Class object.
- * @param className The name of the class to search for.
- * @param resolveClass Indicates if class should be resolved after loading.
- * @throws ClassNotFoundException if the class could not be found.
+ * @param className
+ * The name of the class to search for.
+ * @param resolveClass
+ * Indicates if class should be resolved after loading.
+ * @throws ClassNotFoundException
+ * if the class could not be found.
*/
protected Class<?> loadClass(String className, boolean resolveClass)
throws ClassNotFoundException {
@@ -322,28 +367,27 @@
* Forces a class to be linked (initialized). If the class has already been
* linked this operation has no effect.
*
- * @param clazz The Class to link.
- * @throws NullPointerException if clazz is null.
- * @see Class#getResource
+ * @param clazz
+ * The Class to link.
+ * @throws NullPointerException
+ * if clazz is null.
*/
protected final void resolveClass(Class<?> clazz) {
return;
}
/**
- * <p>
* This method must be provided by the VM vendor, as it is used by other
* provided class implementations in this package. A sample implementation
* of this method is provided by the reference implementation. This method
* is used by SecurityManager.classLoaderDepth(), currentClassLoader() and
* currentLoadedClass(). Answers true if the receiver is a system class
* loader.
- * </p>
- * <p>
+ *
* Note that this method has package visibility only. It is defined here to
* avoid the security manager check in getSystemClassLoader, which would be
* required to implement this method anywhere else.
- * </p>
+ *
*
* @return <code>true</code> if the receiver is a system class loader
* @see Class#getClassLoaderImpl()
@@ -362,7 +406,8 @@
* implement this method anywhere else.
* </p>
*
- * @param child A child candidate
+ * @param child
+ * A child candidate
* @return <code>true</code> if the receiver is ancestor of the parameter
*/
final boolean isAncestorOf(ClassLoader child) {
@@ -376,7 +421,8 @@
* ClassLoader.
*
* @return The location of the resource.
- * @param resName The name of the resource to find.
+ * @param resName
+ * The name of the resource to find.
*/
protected URL findResource(String resName) {
return null;
@@ -387,11 +433,13 @@
* described by resName, using the class loader's resource lookup algorithm.
* The default behavior is just to return an empty Enumeration.
*
- * @param resName The name of the resource to find.
+ * @param resName
+ * The name of the resource to find.
*
* @return The locations of the resources.
*
- * @throws IOException when an error occurs
+ * @throws IOException
+ * when an error occurs
*/
protected Enumeration<URL> findResources(String resName) throws IOException {
return null;
@@ -403,7 +451,8 @@
* the directories specified by the system property "java.library.path".
*
* @return The library file name or null.
- * @param libName The name of the library to find.
+ * @param libName
+ * The name of the library to find.
*/
protected String findLibrary(String libName) {
return null;
@@ -413,7 +462,8 @@
* Attempt to locate the requested package. If no package information can be
* located, null is returned.
*
- * @param name The name of the package to find
+ * @param name
+ * The name of the package to find
* @return The package requested, or null
*/
protected Package getPackage(String name) {
@@ -432,28 +482,39 @@
/**
* Define a new Package using the specified information.
*
- * @param name The name of the package
- * @param specTitle The title of the specification for the Package
- * @param specVersion The version of the specification for the Package
- * @param specVendor The vendor of the specification for the Package
- * @param implTitle The implementation title of the Package
- * @param implVersion The implementation version of the Package
- * @param implVendor The specification vendor of the Package
- * @param sealBase If sealBase is null, the package is left unsealed.
- * Otherwise, the the package is sealed using this URL.
+ * @param name
+ * The name of the package
+ * @param specTitle
+ * The title of the specification for the Package
+ * @param specVersion
+ * The version of the specification for the Package
+ * @param specVendor
+ * The vendor of the specification for the Package
+ * @param implTitle
+ * The implementation title of the Package
+ * @param implVersion
+ * The implementation version of the Package
+ * @param implVendor
+ * The specification vendor of the Package
+ * @param sealBase
+ * If sealBase is null, the package is left unsealed. Otherwise,
+ * the the package is sealed using this URL.
* @return The Package created
- * @throws IllegalArgumentException if the Package already exists
+ * @throws IllegalArgumentException
+ * if the Package already exists
*/
- protected Package definePackage(String name, String specTitle, String specVersion,
- String specVendor, String implTitle, String implVersion, String implVendor,
- URL sealBase) throws IllegalArgumentException {
+ protected Package definePackage(String name, String specTitle,
+ String specVersion, String specVendor, String implTitle,
+ String implVersion, String implVendor, URL sealBase)
+ throws IllegalArgumentException {
return null;
}
/**
* Gets the signers of a class.
*
- * @param c The Class object
+ * @param c
+ * The Class object
* @return signers The signers for the class
*/
final Object[] getSigners(Class<?> c) {
@@ -463,8 +524,10 @@
/**
* Sets the signers of a class.
*
- * @param c The Class object
- * @param signers The signers for the class
+ * @param c
+ * The Class object
+ * @param signers
+ * The signers for the class
*/
protected final void setSigners(Class<?> c, Object[] signers) {
return;
@@ -496,7 +559,8 @@
* <li>The item at depth zero is the caller of this method</li>
* </ul>
*
- * @param depth the stack depth of the requested ClassLoader
+ * @param depth
+ * the stack depth of the requested ClassLoader
* @return the ClassLoader at the specified depth
*/
static final ClassLoader getStackClassLoader(int depth) {
@@ -524,10 +588,14 @@
* ClassLoader of the calling method. Loads and links the library specified
* by the argument.
*
- * @param libName the name of the library to load
- * @param loader the classloader in which to load the library
- * @throws UnsatisfiedLinkError if the library could not be loaded
- * @throws SecurityException if the library was not allowed to be loaded
+ * @param libName
+ * the name of the library to load
+ * @param loader
+ * the classloader in which to load the library
+ * @throws UnsatisfiedLinkError
+ * if the library could not be loaded
+ * @throws SecurityException
+ * if the library was not allowed to be loaded
*/
static void loadLibraryWithClassLoader(String libName, ClassLoader loader) {
return;
@@ -540,20 +608,27 @@
* and links the library specified by the argument. No security check is
* done.
*
- * @param libName the name of the library to load
- * @param loader the classloader in which to load the library
- * @param libraryPath the library path to search, or null
- * @throws UnsatisfiedLinkError if the library could not be loaded
+ * @param libName
+ * the name of the library to load
+ * @param loader
+ * the classloader in which to load the library
+ * @param libraryPath
+ * the library path to search, or null
+ * @throws UnsatisfiedLinkError
+ * if the library could not be loaded
*/
- static void loadLibraryWithPath(String libName, ClassLoader loader, String libraryPath) {
+ static void loadLibraryWithPath(String libName, ClassLoader loader,
+ String libraryPath) {
return;
}
/**
* Sets the assertion status of a class.
*
- * @param cname Class name
- * @param enable Enable or disable assertion
+ * @param cname
+ * Class name
+ * @param enable
+ * Enable or disable assertion
*/
public void setClassAssertionStatus(String cname, boolean enable) {
return;
@@ -562,8 +637,10 @@
/**
* Sets the assertion status of a package.
*
- * @param pname Package name
- * @param enable Enable or disable assertion
+ * @param pname
+ * Package name
+ * @param enable
+ * Enable or disable assertion
*/
public void setPackageAssertionStatus(String pname, boolean enable) {
return;
@@ -572,7 +649,8 @@
/**
* Sets the default assertion status of a classloader
*
- * @param enable Enable or disable assertion
+ * @param enable
+ * Enable or disable assertion
*/
public void setDefaultAssertionStatus(boolean enable) {
return;
@@ -594,7 +672,8 @@
* 0 for disabled.
*
* @return the assertion status.
- * @param cname the name of class.
+ * @param cname
+ * the name of class.
*/
boolean getClassAssertionStatus(String cname) {
return false;
@@ -607,7 +686,8 @@
* 0 for disabled.
*
* @return the assertion status.
- * @param pname the name of package.
+ * @param pname
+ * the name of package.
*/
boolean getPackageAssertionStatus(String pname) {
return false;
Modified: harmony/enhanced/classlib/trunk/modules/luni/src/main/java/java/util/Arrays.java
URL: http://svn.apache.org/viewvc/harmony/enhanced/classlib/trunk/modules/luni/src/main/java/java/util/Arrays.java?rev=628032&r1=628031&r2=628032&view=diff
==============================================================================
--- harmony/enhanced/classlib/trunk/modules/luni/src/main/java/java/util/Arrays.java (original)
+++ harmony/enhanced/classlib/trunk/modules/luni/src/main/java/java/util/Arrays.java Fri Feb 15 04:04:10 2008
@@ -3037,14 +3037,14 @@
}
/**
- * <p>
* Creates a <code>String</code> representation of the <code>byte[]</code>
- * passed. The result is surrounded by brackets (<code>"[]"</code>),
+ * passed.
+ *
+ * The result is surrounded by brackets (<code>"[]"</code>),
* each element is converted to a <code>String</code> via the
- * {@link String#valueOf(byte)} and separated by <code>", "</code>.
+ * {@link String#valueOf(int)} and separated by <code>", "</code>.
* If the array is <code>null</code>, then <code>"null"</code>
* is returned.
- * </p>
*
* @param array
* The <code>byte</code> array to convert.
@@ -3235,14 +3235,14 @@
}
/**
- * <p>
* Creates a <code>String</code> representation of the
- * <code>short[]</code> passed. The result is surrounded by brackets (<code>"[]"</code>),
+ * <code>short[]</code> passed.
+ *
+ * The result is surrounded by brackets (<code>"[]"</code>),
* each element is converted to a <code>String</code> via the
- * {@link String#valueOf(short)} and separated by
- * <code>", "</code>. If the array is <code>null</code>,
- * then <code>"null"</code> is returned.
- * </p>
+ * {@link String#valueOf(int)} and separated by <code>", "</code>.
+ * If the array is <code>null</code>, then <code>"null"</code>
+ * is returned.
*
* @param array
* The <code>short</code> array to convert.
Modified: harmony/enhanced/classlib/trunk/modules/luni/src/main/java/java/util/Collections.java
URL: http://svn.apache.org/viewvc/harmony/enhanced/classlib/trunk/modules/luni/src/main/java/java/util/Collections.java?rev=628032&r1=628031&r2=628032&view=diff
==============================================================================
--- harmony/enhanced/classlib/trunk/modules/luni/src/main/java/java/util/Collections.java (original)
+++ harmony/enhanced/classlib/trunk/modules/luni/src/main/java/java/util/Collections.java Fri Feb 15 04:04:10 2008
@@ -168,12 +168,27 @@
}
}
+ /**
+ * An immutable, serializable, empty <code>List</code>.
+ *
+ * @see Collections#emptyList()
+ */
@SuppressWarnings("unchecked")
public static final List EMPTY_LIST = new EmptyList();
+ /**
+ * An immutable, serializable, empty <code>Set</code>.
+ *
+ * @see Collections#emptySet()
+ */
@SuppressWarnings("unchecked")
public static final Set EMPTY_SET = new EmptySet();
+ /**
+ * An immutable, serializable, empty <code>Map</code>.
+ *
+ * @see Collections#emptyMap()
+ */
@SuppressWarnings("unchecked")
public static final Map EMPTY_MAP = new EmptyMap();
@@ -1505,6 +1520,8 @@
* Performs a binary search for the specified element in the specified
* sorted List using the specified Comparator.
*
+ * @param <T> The element type
+ *
* @param list
* the sorted List to search
* @param object
@@ -2543,7 +2560,7 @@
/**
* Returns a dynamically typesafe view of the specified set.
*
- * @param c
+ * @param s
* the set
* @param type
* the type of the elements is permitted to insert
@@ -2574,7 +2591,7 @@
/**
* Returns a dynamically typesafe view of the specified sorted set.
*
- * @param c
+ * @param s
* the sorted set
* @param type
* the type of the elements is permitted to insert
@@ -3235,9 +3252,11 @@
* Constructs a dynamically typesafe view of the specified map
* entry.
*
- * @param e -
+ * @param e
* the map entry for which a dynamically typesafe view is
* to be constructed.
+ * @param valueType
+ * the type of the value
*/
public CheckedEntry(Map.Entry<K, V> e, Class<V> valueType) {
if (e == null) {
Modified: harmony/enhanced/classlib/trunk/modules/security-kernel/src/main/java/java/security/AccessController.java
URL: http://svn.apache.org/viewvc/harmony/enhanced/classlib/trunk/modules/security-kernel/src/main/java/java/security/AccessController.java?rev=628032&r1=628031&r2=628032&view=diff
==============================================================================
--- harmony/enhanced/classlib/trunk/modules/security-kernel/src/main/java/java/security/AccessController.java (original)
+++ harmony/enhanced/classlib/trunk/modules/security-kernel/src/main/java/java/security/AccessController.java Fri Feb 15 04:04:10 2008
@@ -23,9 +23,7 @@
*
* Checks access to system resources. Supports marking of code as priveleged.
* Makes context snapshots to allow checking from other contexts.
- *
*/
-
public final class AccessController {
static {
// Initialize vm-internal caches
@@ -193,7 +191,7 @@
/**
* Performs the privileged action specified by <code>action</code>.
- * <p>
+ *
* When permission checks are made, if the permission has been granted by
* all frames below and including the one representing the call to this
* method, then the permission is granted iff it is granted by the
@@ -204,8 +202,7 @@
* Any unchecked exception generated by this method will propagate up the
* chain.
*
- *
- * @see #doPrivileged(PrivilegedAction<T>)
+ * @see #doPrivileged(PrivilegedAction)
*/
public static <T> T doPrivileged(PrivilegedAction<T> action,
AccessControlContext context) {
@@ -216,7 +213,7 @@
/**
* Performs the privileged action specified by <code>action</code>.
- * <p>
+ *
* When permission checks are made, if the permission has been granted by
* all frames below and including the one representing the call to this
* method, then the permission is granted. In otherwords, the check stops
@@ -226,8 +223,7 @@
* chain. However, checked exceptions will be caught an re-thrown as
* PrivilegedActionExceptions
*
- *
- * @see #doPrivileged(PrivilegedAction<T>)
+ * @see #doPrivileged(PrivilegedAction)
*/
public static <T> T doPrivileged(PrivilegedExceptionAction<T> action)
throws PrivilegedActionException {
@@ -242,7 +238,7 @@
/**
* Performs the privileged action specified by <code>action</code>.
- * <p>
+ *
* When permission checks are made, if the permission has been granted by
* all frames below and including the one representing the call to this
* method, then the permission is granted iff it is granted by the
@@ -254,8 +250,7 @@
* chain. However, checked exceptions will be caught an re-thrown as
* PrivilegedActionExceptions
*
- *
- * @see #doPrivileged(PrivilegedAction<T>)
+ * @see #doPrivileged(PrivilegedAction)
*/
public static <T> T doPrivileged(PrivilegedExceptionAction<T> action,
AccessControlContext context) throws PrivilegedActionException {