1. /*

  2.  * Copyright 1999-2004 The Apache Software Foundation.

  3.  *

  4.  * Licensed under the Apache License, Version 2.0 (the "License");

  5.  * you may not use this file except in compliance with the License.

  6.  * You may obtain a copy of the License at

  7.  *

  8.  *     http://www.apache.org/licenses/LICENSE-2.0

  9.  *

  10.  * Unless required by applicable law or agreed to in writing, software

  11.  * distributed under the License is distributed on an "AS IS" BASIS,

  12.  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

  13.  * See the License for the specific language governing permissions and

  14.  * limitations under the License.

  15.  */

  16. /*

  17.  * $Id: XPathFactory.java,v 1.9 2004/02/17 04:30:02 minchau Exp $

  18.  */

  19. package com.sun.org.apache.xpath.internal;

  20. 

  21. import javax.xml.transform.SourceLocator;

  22. 

  23. import com.sun.org.apache.xml.internal.utils.PrefixResolver;

  24. 

  25. /**

  26.  * Factory class for creating an XPath.  Implementors of XPath derivatives

  27.  * will need to make a derived class of this.

  28.  * @xsl.usage advanced

  29.  */

  30. public interface XPathFactory

  31. {

  32. 

  33.   /**

  34.    * Create an XPath.

  35.    *

  36.    * @param exprString The XPath expression string.

  37.    * @param locator The location of the expression string, mainly for diagnostic

  38.    *                purposes.

  39.    * @param prefixResolver This will be called in order to resolve prefixes 

  40.    *        to namespace URIs.

  41.    * @param type One of {@link com.sun.org.apache.xpath.internal.XPath#SELECT} or 

  42.    *             {@link com.sun.org.apache.xpath.internal.XPath#MATCH}.

  43.    *

  44.    * @return an XPath ready for execution.

  45.    */

  46.   XPath create(String exprString, SourceLocator locator,

  47.                PrefixResolver prefixResolver, int type);

  48. }