DOMImplementationSource


1   /*
2    * Copyright (c) 2004 World Wide Web Consortium,
3    *
4    * (Massachusetts Institute of Technology, European Research Consortium for
5    * Informatics and Mathematics, Keio University). All Rights Reserved. This
6    * work is distributed under the W3C(r) Software License [1] in the hope that
7    * it will be useful, but WITHOUT ANY WARRANTY; without even the implied
8    * warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
9    *
10   * [1] http://www.w3.org/Consortium/Legal/2002/copyright-software-20021231
11   */
12  
13  package org.w3c.dom;
14  
15  /**
16   * This interface permits a DOM implementer to supply one or more 
17   * implementations, based upon requested features and versions, as specified 
18   * in . Each implemented <code>DOMImplementationSource</code> object is 
19   * listed in the binding-specific list of available sources so that its 
20   * <code>DOMImplementation</code> objects are made available.
21   * <p>See also the <a HREF='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>.
22   * @since DOM Level 3
23   */
24  public interface DOMImplementationSource {
25      /**
26       *  A method to request the first DOM implementation that supports the 
27       * specified features. 
28       * @param features  A string that specifies which features and versions 
29       *   are required. This is a space separated list in which each feature 
30       *   is specified by its name optionally followed by a space and a 
31       *   version number.  This method returns the first item of the list 
32       *   returned by <code>getDOMImplementationList</code>.  As an example, 
33       *   the string <code>"XML 3.0 Traversal +Events 2.0"</code> will 
34       *   request a DOM implementation that supports the module "XML" for its 
35       *   3.0 version, a module that support of the "Traversal" module for 
36       *   any version, and the module "Events" for its 2.0 version. The 
37       *   module "Events" must be accessible using the method 
38       *   <code>Node.getFeature()</code> and 
39       *   <code>DOMImplementation.getFeature()</code>. 
40       * @return The first DOM implementation that support the desired 
41       *   features, or <code>null</code> if this source has none.
42       */
43      public DOMImplementation   getDOMImplementation(String   features);
44  
45      /**
46       * A method to request a list of DOM implementations that support the 
47       * specified features and versions, as specified in .
48       * @param features A string that specifies which features and versions 
49       *   are required. This is a space separated list in which each feature 
50       *   is specified by its name optionally followed by a space and a 
51       *   version number. This is something like: "XML 3.0 Traversal +Events 
52       *   2.0"
53       * @return A list of DOM implementations that support the desired 
54       *   features.
55       */
56      public DOMImplementationList   getDOMImplementationList(String   features);
57  
58  }
59
A to Z: JavaDoc & Examples Daily Java News & Articles Open Source Projects Open Source Codes Free Computer Books Remove Frame
Popular Tags