/**
  * Dereference a href and return the object if it is of the expected type.
  *
  * @return the resolved object
  * @param file the URI of the file in which the referenced element is located, used to absolutize
  *     references
  * @param href the reference to resolve
  * @param clazz the class of object expected
  */
 @SuppressWarnings("unchecked")
 protected <T> T dereferenceLocalHref(URI file, String href, Class<T> clazz) {
   Object o = null;
   String id = file.toString() + href.substring(href.indexOf('#'));
   o = idMap.get(id);
   if (o == null) {
     System.err.println(Wadl2JavaMessages.SKIPPING_REFERENCE(href, file.toString()));
     return null;
   } else if (!clazz.isInstance(o)) {
     System.err.println(Wadl2JavaMessages.SKIPPING_REFERENCE_TYPE(href, file.toString()));
     return null;
   }
   return (T) o;
 }
  /**
   * Unmarshall a WADL file, process any schemas referenced in the WADL file, add any items with an
   * ID to a global ID map, and follow any references to additional WADL files.
   *
   * @param desc the URI of the description file
   * @return the unmarshalled WADL application element
   * @throws javax.xml.bind.JAXBException if the WADL file is invalid or if the code generator
   *     encounters a problem.
   * @throws java.io.IOException if the specified WADL file cannot be read.
   */
  public Application processDescription(URI desc) throws JAXBException, IOException {
    // check for files that have already been processed to prevent loops
    if (processedDocs.contains(desc.toString())) return null;
    processedDocs.add(desc.toString());

    // read in WADL file
    System.out.println(Wadl2JavaMessages.PROCESSING(desc.toString()));
    Application a = (Application) u.unmarshal(desc.toURL());

    // process embedded schemas
    Grammars g = a.getGrammars();
    if (g != null) {
      for (Include i : g.getInclude()) {
        URI incl = desc.resolve(i.getHref());
        if (processedDocs.contains(incl.toString())) continue;
        processedDocs.add(incl.toString());
        System.out.println(Wadl2JavaMessages.PROCESSING(incl.toString()));
        InputSource input = new InputSource(incl.toURL().openStream());
        input.setSystemId(incl.toString());
        s2j.parseSchema(input);
      }
      int embeddedSchemaNo = 0; // used to generate unique system ID
      for (Object any : g.getAny()) {
        if (any instanceof Element) {
          Element element = (Element) any;
          s2j.parseSchema(
              desc.toString() + "#schema" + Integer.toString(embeddedSchemaNo), element);
          embeddedSchemaNo++;
        }
      }
    }
    for (File customization : customizations) {
      URI incl = desc.resolve(customization.toURI());
      System.out.println(Wadl2JavaMessages.PROCESSING(incl.toString()));
      InputSource input = new InputSource(incl.toURL().openStream());
      input.setSystemId(incl.toString());
      s2j.parseSchema(input);
    }
    buildIDMap(a, desc);
    return a;
  }
  /**
   * Add a type to a resource. Follow references to types across WADL file boundaries
   *
   * @param href the identifier of the resource_type element to process
   * @param resource the resource
   * @param file the URI of the current WADL file being processed
   */
  protected void addTypeToResource(ResourceNode resource, String href, URI file) {
    // dereference resource
    if (!href.startsWith("#")) {
      // referecnce to element in another document
      file = getReferencedFile(file, href);
    }
    ResourceTypeNode n = ifaceMap.get(file.toString() + href.substring(href.indexOf('#')));

    if (n != null) {
      resource.addResourceType(n);
    } else {
      System.err.println(Wadl2JavaMessages.SKIPPING_REFERENCE(href, file.toString()));
    }
  }
 /**
  * Report an error.
  *
  * @param sAXParseException the exception that caused the error.
  */
 public void error(SAXParseException sAXParseException) {
   System.err.println(Wadl2JavaMessages.ERROR(sAXParseException.getMessage()));
 }
 /**
  * Report informative message
  *
  * @param sAXParseException the exception that caused the informative message.
  */
 public void info(SAXParseException sAXParseException) {
   System.err.println(Wadl2JavaMessages.INFO(sAXParseException.getMessage()));
 }
 /**
  * Report a warning
  *
  * @param sAXParseException the exception that caused the warning.
  */
 public void warning(SAXParseException sAXParseException) {
   System.err.println(Wadl2JavaMessages.WARNING(sAXParseException.getMessage()));
 }