1 /*
   2  * reserved comment block
   3  * DO NOT REMOVE OR ALTER!
   4  */
   5 // DOMCatalogParser.java - An interface for reading catalog files
   6 
   7 /*
   8  * Copyright 2001-2004 The Apache Software Foundation or its licensors,
   9  * as applicable.
  10  *
  11  * Licensed under the Apache License, Version 2.0 (the "License");
  12  * you may not use this file except in compliance with the License.
  13  * You may obtain a copy of the License at
  14  *
  15  *      http://www.apache.org/licenses/LICENSE-2.0
  16  *
  17  * Unless required by applicable law or agreed to in writing, software
  18  * distributed under the License is distributed on an "AS IS" BASIS,
  19  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  20  * See the License for the specific language governing permissions and
  21  * limitations under the License.
  22  */
  23 
  24 package com.sun.org.apache.xml.internal.resolver.readers;
  25 
  26 import com.sun.org.apache.xml.internal.resolver.Catalog;
  27 import org.w3c.dom.Node;
  28 
  29 /**
  30  * The DOMCatalogParser interface.
  31  *
  32  * <p>This interface must be implemented in order for a class to
  33  * participate as a parser for the DOMCatalogReader.
  34  *
  35  * @see Catalog
  36  * @see DOMCatalogReader
  37  *
  38  * @author Norman Walsh
  39  * <a href="mailto:Norman.Walsh@Sun.COM">Norman.Walsh@Sun.COM</a>
  40  *
  41  */
  42 public interface DOMCatalogParser {
  43     /**
  44      * Parse a DOM node as a catalog entry.
  45      *
  46      * <p>This method is expected to analyze the specified node and
  47      * construct appropriate catalog entry(ies) from it.</p>
  48      *
  49      * @param catalog The catalog for which this node is being considered.
  50      * @param node The DOM Node from the catalog.
  51      */
  52     public void parseCatalogEntry(Catalog catalog, Node node);
  53 }