| /* |
| * Copyright (c) 2017, Oracle and/or its affiliates. All rights reserved. |
| */ |
| /* |
| * Licensed to the Apache Software Foundation (ASF) under one or more |
| * contributor license agreements. See the NOTICE file distributed with |
| * this work for additional information regarding copyright ownership. |
| * The ASF licenses this file to You under the Apache License, Version 2.0 |
| * (the "License"); you may not use this file except in compliance with |
| * the License. You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, software |
| * distributed under the License is distributed on an "AS IS" BASIS, |
| * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| * See the License for the specific language governing permissions and |
| * limitations under the License. |
| */ |
| package com.sun.org.apache.bcel.internal; |
| |
| |
| import com.sun.org.apache.bcel.internal.classfile.JavaClass; |
| import com.sun.org.apache.bcel.internal.util.SyntheticRepository; |
| |
| /** |
| * The repository maintains informations about class interdependencies, e.g., |
| * whether a class is a sub-class of another. Delegates actual class loading to |
| * SyntheticRepository with current class path by default. |
| * |
| * @see com.sun.org.apache.bcel.internal.util.Repository |
| * @see SyntheticRepository |
| * |
| * @version $Id: Repository.java 1749603 2016-06-21 20:50:19Z ggregory $ |
| */ |
| public abstract class Repository { |
| |
| private static com.sun.org.apache.bcel.internal.util.Repository repository |
| = SyntheticRepository.getInstance(); |
| |
| /** |
| * @return currently used repository instance |
| */ |
| public static com.sun.org.apache.bcel.internal.util.Repository getRepository() { |
| return repository; |
| } |
| |
| /** |
| * Set repository instance to be used for class loading |
| */ |
| public static void setRepository(final com.sun.org.apache.bcel.internal.util.Repository rep) { |
| repository = rep; |
| } |
| |
| /** |
| * Lookup class somewhere found on your CLASSPATH, or whereever the |
| * repository instance looks for it. |
| * |
| * @return class object for given fully qualified class name |
| * @throws ClassNotFoundException if the class could not be found or parsed |
| * correctly |
| */ |
| public static JavaClass lookupClass(final String class_name) |
| throws ClassNotFoundException { |
| return repository.loadClass(class_name); |
| } |
| |
| /** |
| * Try to find class source using the internal repository instance. |
| * |
| * @see Class |
| * @return JavaClass object for given runtime class |
| * @throws ClassNotFoundException if the class could not be found or parsed |
| * correctly |
| */ |
| public static JavaClass lookupClass(final Class<?> clazz) |
| throws ClassNotFoundException { |
| return repository.loadClass(clazz); |
| } |
| |
| /** |
| * Clear the repository. |
| */ |
| public static void clearCache() { |
| repository.clear(); |
| } |
| |
| /** |
| * Add clazz to repository if there isn't an equally named class already in |
| * there. |
| * |
| * @return old entry in repository |
| */ |
| public static JavaClass addClass(final JavaClass clazz) { |
| final JavaClass old = repository.findClass(clazz.getClassName()); |
| repository.storeClass(clazz); |
| return old; |
| } |
| |
| /** |
| * Remove class with given (fully qualified) name from repository. |
| */ |
| public static void removeClass(final String clazz) { |
| repository.removeClass(repository.findClass(clazz)); |
| } |
| |
| /** |
| * Remove given class from repository. |
| */ |
| public static void removeClass(final JavaClass clazz) { |
| repository.removeClass(clazz); |
| } |
| |
| /** |
| * @return list of super classes of clazz in ascending order, i.e., Object |
| * is always the last element |
| * @throws ClassNotFoundException if any of the superclasses can't be found |
| */ |
| public static JavaClass[] getSuperClasses(final JavaClass clazz) throws ClassNotFoundException { |
| return clazz.getSuperClasses(); |
| } |
| |
| /** |
| * @return list of super classes of clazz in ascending order, i.e., Object |
| * is always the last element. |
| * @throws ClassNotFoundException if the named class or any of its |
| * superclasses can't be found |
| */ |
| public static JavaClass[] getSuperClasses(final String class_name) throws ClassNotFoundException { |
| final JavaClass jc = lookupClass(class_name); |
| return getSuperClasses(jc); |
| } |
| |
| /** |
| * @return all interfaces implemented by class and its super classes and the |
| * interfaces that those interfaces extend, and so on. (Some people call |
| * this a transitive hull). |
| * @throws ClassNotFoundException if any of the class's superclasses or |
| * superinterfaces can't be found |
| */ |
| public static JavaClass[] getInterfaces(final JavaClass clazz) throws ClassNotFoundException { |
| return clazz.getAllInterfaces(); |
| } |
| |
| /** |
| * @return all interfaces implemented by class and its super classes and the |
| * interfaces that extend those interfaces, and so on |
| * @throws ClassNotFoundException if the named class can't be found, or if |
| * any of its superclasses or superinterfaces can't be found |
| */ |
| public static JavaClass[] getInterfaces(final String class_name) throws ClassNotFoundException { |
| return getInterfaces(lookupClass(class_name)); |
| } |
| |
| /** |
| * Equivalent to runtime "instanceof" operator. |
| * |
| * @return true, if clazz is an instance of super_class |
| * @throws ClassNotFoundException if any superclasses or superinterfaces of |
| * clazz can't be found |
| */ |
| public static boolean instanceOf(final JavaClass clazz, final JavaClass super_class) |
| throws ClassNotFoundException { |
| return clazz.instanceOf(super_class); |
| } |
| |
| /** |
| * @return true, if clazz is an instance of super_class |
| * @throws ClassNotFoundException if either clazz or super_class can't be |
| * found |
| */ |
| public static boolean instanceOf(final String clazz, final String super_class) |
| throws ClassNotFoundException { |
| return instanceOf(lookupClass(clazz), lookupClass(super_class)); |
| } |
| |
| /** |
| * @return true, if clazz is an instance of super_class |
| * @throws ClassNotFoundException if super_class can't be found |
| */ |
| public static boolean instanceOf(final JavaClass clazz, final String super_class) |
| throws ClassNotFoundException { |
| return instanceOf(clazz, lookupClass(super_class)); |
| } |
| |
| /** |
| * @return true, if clazz is an instance of super_class |
| * @throws ClassNotFoundException if clazz can't be found |
| */ |
| public static boolean instanceOf(final String clazz, final JavaClass super_class) |
| throws ClassNotFoundException { |
| return instanceOf(lookupClass(clazz), super_class); |
| } |
| |
| /** |
| * @return true, if clazz is an implementation of interface inter |
| * @throws ClassNotFoundException if any superclasses or superinterfaces of |
| * clazz can't be found |
| */ |
| public static boolean implementationOf(final JavaClass clazz, final JavaClass inter) |
| throws ClassNotFoundException { |
| return clazz.implementationOf(inter); |
| } |
| |
| /** |
| * @return true, if clazz is an implementation of interface inter |
| * @throws ClassNotFoundException if clazz, inter, or any superclasses or |
| * superinterfaces of clazz can't be found |
| */ |
| public static boolean implementationOf(final String clazz, final String inter) |
| throws ClassNotFoundException { |
| return implementationOf(lookupClass(clazz), lookupClass(inter)); |
| } |
| |
| /** |
| * @return true, if clazz is an implementation of interface inter |
| * @throws ClassNotFoundException if inter or any superclasses or |
| * superinterfaces of clazz can't be found |
| */ |
| public static boolean implementationOf(final JavaClass clazz, final String inter) |
| throws ClassNotFoundException { |
| return implementationOf(clazz, lookupClass(inter)); |
| } |
| |
| /** |
| * @return true, if clazz is an implementation of interface inter |
| * @throws ClassNotFoundException if clazz or any superclasses or |
| * superinterfaces of clazz can't be found |
| */ |
| public static boolean implementationOf(final String clazz, final JavaClass inter) |
| throws ClassNotFoundException { |
| return implementationOf(lookupClass(clazz), inter); |
| } |
| } |