|
/*
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
*
* Copyright 1997-2007 Sun Microsystems, Inc. All rights reserved.
*
* The contents of this file are subject to the terms of either the GNU
* General Public License Version 2 only ("GPL") or the Common Development
* and Distribution License("CDDL") (collectively, the "License"). You
* may not use this file except in compliance with the License. You can obtain
* a copy of the License at https://glassfish.dev.java.net/public/CDDL+GPL.html
* or glassfish/bootstrap/legal/LICENSE.txt. See the License for the specific
* language governing permissions and limitations under the License.
*
* When distributing the software, include this License Header Notice in each
* file and include the License file at glassfish/bootstrap/legal/LICENSE.txt.
* Sun designates this particular file as subject to the "Classpath" exception
* as provided by Sun in the GPL Version 2 section of the License file that
* accompanied this code. If applicable, add the following below the License
* Header, with the fields enclosed by brackets [] replaced by your own
* identifying information: "Portions Copyrighted [year]
* [name of copyright owner]"
*
* Contributor(s):
*
* If you wish your version of this file to be governed by only the CDDL or
* only the GPL Version 2, indicate your decision by adding "[Contributor]
* elects to include this software in this distribution under the [CDDL or GPL
* Version 2] license." If you don't indicate a single choice of license, a
* recipient has the option to distribute your version of this file under
* either the CDDL, the GPL Version 2 or to extend the choice of license to
* its licensees as provided above. However, if you add GPL Version 2 code
* and therefore, elected the GPL Version 2 license, then the option applies
* only if the new code is made subject to such option by the copyright
* holder.
*/
/*
Copyright (c) 2003, theshoemakers.org
All rights reserved.
Redistribution and use in source and binary forms, with or without modification,
are permitted provided that the following conditions are met:
* Redistributions of source code must retain the above copyright notice, this
list of conditions and the following disclaimer.
* Redistributions in binary form must reproduce the above copyright notice,
this list of conditions and the following disclaimer in the documentation
and/or other materials provided with the distribution.
* Neither the name of the theshoemakers.org nor the names of its contributors
may be used to endorse or promote products derived from this software without
specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
OF SUCH DAMAGE.
*/
import java.io.File;
import java.net.URL;
import java.net.URLClassLoader;
import java.util.StringTokenizer;
/**
* Find occurrencens of a particular classname in the system classpath
* or the specified ClassLoader.
*
* This class can be run in command-line mode to search your system
* classpath for all occurrences of the specified classname.
*
* This class can also be used programmatically to search a particular
* ClassLoader for the first occurrence of the specified classname.
* <p>
* Revision: $Revision: 1.2 $
*
* @author <a href="mailto:Ryan.Shoemaker@Sun.COM">Ryan Shoemaker</a>, Sun Microsystems, Inc.
* @version 0.1
*/
public class Which4J {
private static boolean debug = false;
/**
* Main method used in command-line mode for searching the system
* classpath for <em>all</em> occurrences of the specified classname.
*
* @param args command-line arguments (run "<code>java org.theshoemakers.tools.which4j.Which4J
* -help</code>" for a detailed description).
*/
public static void main(String[] args) {
if (args.length == 2) {
if (args[0].equals("-debug")) {
debug = true;
findIt(args[1]);
} else {
System.err.println(
"error: unrecognized \"" + args[0] + "\" option ");
System.exit(-1);
}
} else if (args.length == 1 && args[0].equals("-help")) {
usage();
} else if (args.length == 1) {
findIt(args[0]);
} else {
usage();
}
System.exit(0);
}
private static void usage() {
System.err.println(
"usage: java Which4J [-debug] <classname>"
+ "\n\tThe commandline version of Which4J will search the system"
+ "\tclasspath defined in your environment for all occurences"
+ "\tof the class. Alternatively, you can use this class"
+ "\tprogrammatically to search the current (or any) ClassLoader."
+ "\tSee the javadoc for more detail."
+ "\n\t"
+ "\n\tNote: if the name of the jar file listed after \"found in:\""
+ "\tdoesn't match the name of the jar listed next to \"url:\", then "
+ "\tthere is likely a \"Class-Path\" entry in the jar manifest "
+ "\tthat is causing the classloader to indirectly find the class.");
System.exit(-1);
}
/**
* Iterate over the system classpath defined by "java.class.path" searching
* for all occurrances of the given class name.
*
* @param classname the fully qualified class name to search for
*/
private static void findIt(String classname) {
try {
// get the system classpath
String classpath = System.getProperty("java.class.path", "");
if (classpath.equals("")) {
System.err.println("error: classpath is not set");
}
if (debug) {
System.out.println("classname: " + classname);
System.out.println("system classpath = " + classpath);
}
if (isPrimitiveOrVoid(classname)) {
System.out.println("'" + classname + "' primitive");
return;
}
StringTokenizer st =
new StringTokenizer(classpath, File.pathSeparator);
while (st.hasMoreTokens()) {
String token = st.nextToken();
File classpathElement = new File(token);
if (debug)
System.out.println(
classpathElement.isDirectory()
? "dir: " + token
: "jar: " + token);
URL[] url = { classpathElement.toURL()};
URLClassLoader cl = URLClassLoader.newInstance(url, null);
String classnameAsResource =
classname.replace('.', '/') + ".class";
URL it = cl.findResource(classnameAsResource);
if (it != null) {
System.out.println("found in: " + token);
System.out.println(" url: " + it.toString());
System.out.println("");
}
}
} catch (Exception e) {
e.printStackTrace();
}
}
/**
* Search the current classloader for the given classname.
*
* Equivalent to calling which( String classname, Which4J.class.getClassLoader ).
*
* @param classname the fully qualified name of the class to search for
* @return the source location of the resource, or null if it wasn't found
*/
public static String which(String classname) {
return which(classname, Which4J.class.getClassLoader());
}
/**
* Search the specified classloader for the given classname.
*
* @param classname the fully qualified name of the class to search for
* @param loader the classloader to search
* @return the source location of the resource, or null if it wasn't found
*/
public static String which(String classname, ClassLoader loader) {
if (isArrayType(classname)) {
classname = getElementType(classname);
}
if (isPrimitiveOrVoid(classname)) {
return "'" + classname + "' primitive";
}
String classnameAsResource = classname.replace('.', '/') + ".class";
if (loader == null) {
// some VM's return null from getClassLoader to indicate that
// the class was loaded by the bootstrap class loader
loader = ClassLoader.getSystemClassLoader();
}
URL it = loader.getResource(classnameAsResource);
if (it != null) {
return it.toString();
} else {
return null;
}
}
/**
* Search the current classloader for the given classname.
*
* Equivalent to calling which( Class clazz, Which4J.class.getClassLoader ).
*
* @param clazz the class object to search for
* @return the source location of the resource, or null if it wasn't found
*/
public static String which(Class clazz) {
return which(clazz, clazz.getClassLoader());
}
/**
* Search the specified classloader for the given class object.
*
* @param clazz the class object to search for
* @param loader the classloader to search
* @return the source location of the resource, or null if it wasn't found
*/
public static String which(Class clazz, ClassLoader loader) {
return which(clazz.getName(), loader);
}
/**
* Determine if the class name corresponds to a primitive Java datatype or
* the void datatype.
*
* @param classname the name of the class
* @return true iff the classname corresponds to a primitive Java datatype
* or the void datatype, false otherwise.
*/
private static boolean isPrimitiveOrVoid(String classname) {
return (
classname.equals("boolean")
|| classname.equals("byte")
|| classname.equals("char")
|| classname.equals("double")
|| classname.equals("float")
|| classname.equals("int")
|| classname.equals("long")
|| classname.equals("short")
|| classname.equals("void"));
}
/**
* Determine if the classname corresponds to an array type as defined by
* the Java Language Specification.
*
* @param classname the name of the class
* @return true iff the classname corresponds to an array type, false
* otherwise.
*/
private static boolean isArrayType(String classname) {
return classname.startsWith("[");
}
/**
* Determine the element type of the array type. This can be the name
* of a primitive type or the fully qualified class name of a non primitive
* type.
*
* @param classname the array type
* @return the name of the base element type.
*/
private static String getElementType(String classname) {
// remove leading '['
String elementType = classname.split("^\\[+")[1];
char encoding = elementType.charAt(0);
if (encoding == 'L') {
// don't include the first char 'L' or last char ';'
return elementType.substring(1, elementType.length() - 1);
} else if (encoding == 'Z') {
return "boolean";
} else if (encoding == 'B') {
return "byte";
} else if (encoding == 'C') {
return "char";
} else if (encoding == 'D') {
return "double";
} else if (encoding == 'F') {
return "float";
} else if (encoding == 'I') {
return "int";
} else if (encoding == 'J') {
return "long";
} else if (encoding == 'S') {
return "short";
} else {
throw new InternalError(
"unknown array type: '"
+ encoding
+ "'.\nplease file a bug report at http://which4j.dev.java.net");
}
}
}
|