package org.codehaus.classloader;

import java.io.IOException;
import java.net.URL;
import java.util.Enumeration;

/**
 * Implementation of this interface is responsible for managing sibling ClassLoader or ClassProvider
 * in a tree hierarchy
 * <p>
 * @author Ben Yu
 * Aug 3, 2006 5:09:48 AM
 */
public interface ClassLoaderManager {

  /**
   * Find a class.
   * @param except look into everything except this.
   * @param name the class name.
   * @return the class object.
   * @throws ClassNotFoundException if class cannot be found.
   */
  Class lookupClass(Object except, String name)
      throws ClassNotFoundException;

  /**
   * Find a library.
   * @param except look into everything except this.
   * @param libname the library name.
   * @return the library.
   */
  String lookupLibrary(Object except, String libname);

  /**
   * Find a resource
   * @param except look into everything except this.
   * @param name the resource name.
   * @return
   */
  URL lookupResource(Object except, String name);

  /**
   * Find resources for a given name.
   * @param except look into everything except this.
   * @param name the resource name.
   * @return the resource Enumeration.
   * @throws IOException if anything wrong.
   */
  Enumeration lookupResources(Object except, String name)
      throws IOException;

  /**
   * Find a package.
   * @param except look into everything except this.
   * @param name the package name.
   * @return the package object.
   */
  //Package lookupPackage(Object except, String name);

  /**
   * Find packages.
   * @param except look into everything except this.
   * @return the packages.
   */
  //Package[] lookupPackages(Object except);

}