http://xml.apache.org/commons/components/external/: xml-commons provides an Apache-hosted set of DOM, SAX, and JAXP interfaces for use in other xml-based projects. Our hope is that we can standardize on both a common version and packaging scheme for these critical XML standards interfaces to make the lives of both our developers and users easier. The External Components portion of xml-commons contains interfaces that are defined by external standards organizations. For DOM, that's the W3C; for SAX it's David Megginson and sax.sourceforge.net; for JAXP it's Sun. 
/*
 * Copyright (c) 1999 World Wide Web Consortium,
 * (Massachusetts Institute of Technology, Institut National de
 * Recherche en Informatique et en Automatique, Keio University). All
 * Rights Reserved. This program is distributed under the W3C's Software
 * Intellectual Property License. This program is distributed in the
 * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
 * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
 * PURPOSE.
 * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
 *
 * $Id: ConditionFactory.java 477010 2006-11-20 02:54:38Z mrglavas $
 */
package org.w3c.css.sac;


Author: Philippe Le Hegaret
Version:$Revision: 477010 $
/**
 * @version $Revision: 477010 $
 * @author  Philippe Le Hegaret
 */
public interface ConditionFactory {

    
Creates an and condition

Params:
  • first – the first condition
  • second – the second condition
Throws:
Returns:A combinator condition
/**
     * Creates an and condition
     *
     * @param first the first condition
     * @param second the second condition
     * @return A combinator condition
     * @exception CSSException if this exception is not supported.
     */    
    CombinatorCondition createAndCondition(Condition first, Condition second)
	throws CSSException;

    
Creates an or condition

Params:
  • first – the first condition
  • second – the second condition
Throws:
Returns:A combinator condition
/**
     * Creates an or condition
     *
     * @param first the first condition
     * @param second the second condition
     * @return A combinator condition
     * @exception CSSException if this exception is not supported.
     */    
    CombinatorCondition createOrCondition(Condition first, Condition second)
	throws CSSException;

    
Creates a negative condition

Params:
  • condition – the condition
Throws:
Returns:A negative condition
/**
     * Creates a negative condition
     *
     * @param condition the condition
     * @return A negative condition
     * @exception CSSException if this exception is not supported.
     */    
    NegativeCondition createNegativeCondition(Condition condition)
	throws CSSException;

    
Creates a positional condition

Params:
  • position – the position of the node in the list.
  • typeNode – true if the list should contain
                only nodes of the same type (element, text node, ...).
  • type – true true if the list should contain
            only nodes of the same node (for element, same localName
            and same namespaceURI).
Throws:
Returns:A positional condition
/**
     * Creates a positional condition
     *
     * @param position the position of the node in the list.
     * @param typeNode <code>true</code> if the list should contain
     *                 only nodes of the same type (element, text node, ...).
     * @param type <code>true</code> true if the list should contain
     *             only nodes of the same node (for element, same localName
     *             and same namespaceURI).
     * @return A positional condition
     * @exception CSSException if this exception is not supported.
     */    
    PositionalCondition createPositionalCondition(int position, 
						  boolean typeNode, 
						  boolean type)
	throws CSSException;
    
    
Creates an attribute condition

Params:
  • localName – the localName of the attribute
  • namespaceURI – the namespace URI of the attribute
  • specified – true if the attribute must be specified
                 in the document.
  • value – the value of this attribute.
Throws:
Returns:An attribute condition
/**
     * Creates an attribute condition
     *
     * @param localName the localName of the attribute
     * @param namespaceURI the namespace URI of the attribute
     * @param specified <code>true</code> if the attribute must be specified
     *                  in the document.
     * @param value the value of this attribute.
     * @return An attribute condition
     * @exception CSSException if this exception is not supported.
     */    
    AttributeCondition createAttributeCondition(String localName,
						String namespaceURI,
						boolean specified,
						String value)
	throws CSSException;

    
Creates an id condition

Params:
  • value – the value of the id.
Throws:
Returns:An Id condition
/**
     * Creates an id condition
     *
     * @param value the value of the id.
     * @return An Id condition
     * @exception CSSException if this exception is not supported.
     */    
    AttributeCondition createIdCondition(String value)
	throws CSSException;

    
Creates a lang condition

Params:
  • value – the value of the language.
Throws:
Returns:A lang condition
/**
     * Creates a lang condition
     *
     * @param value the value of the language.
     * @return A lang condition
     * @exception CSSException if this exception is not supported.
     */    
    LangCondition createLangCondition(String lang)
	throws CSSException;

    
Creates a "one of" attribute condition

Params:
  • localName – the localName of the attribute
  • namespaceURI – the namespace URI of the attribute
  • specified – true if the attribute must be specified
                 in the document.
  • value – the value of this attribute.
Throws:
Returns:A "one of" attribute condition
/**
     * Creates a "one of" attribute condition
     *
     * @param localName the localName of the attribute
     * @param namespaceURI the namespace URI of the attribute
     * @param specified <code>true</code> if the attribute must be specified
     *                  in the document.
     * @param value the value of this attribute.
     * @return A "one of" attribute condition
     * @exception CSSException if this exception is not supported.
     */    
    AttributeCondition createOneOfAttributeCondition(String localName,
						     String namespaceURI,
						     boolean specified,
						     String value)
	throws CSSException;

    
Creates a "begin hyphen" attribute condition

Params:
  • localName – the localName of the attribute
  • namespaceURI – the namespace URI of the attribute
  • specified – true if the attribute must be specified
                 in the document.
  • value – the value of this attribute.
Throws:
Returns:A "begin hyphen" attribute condition
/**
     * Creates a "begin hyphen" attribute condition
     *
     * @param localName the localName of the attribute
     * @param namespaceURI the namespace URI of the attribute
     * @param specified <code>true</code> if the attribute must be specified
     *                  in the document.
     * @param value the value of this attribute.
     * @return A "begin hyphen" attribute condition
     * @exception CSSException if this exception is not supported.
     */    
    AttributeCondition createBeginHyphenAttributeCondition(String localName,
							   String namespaceURI,
							   boolean specified,
							   String value)
	throws CSSException;

    
Creates a class condition

Params:
  • localName – the localName of the attribute
  • namespaceURI – the namespace URI of the attribute
  • specified – true if the attribute must be specified
                 in the document.
  • value – the name of the class.
Throws:
Returns:A class condition
/**
     * Creates a class condition
     *
     * @param localName the localName of the attribute
     * @param namespaceURI the namespace URI of the attribute
     * @param specified <code>true</code> if the attribute must be specified
     *                  in the document.
     * @param value the name of the class.
     * @return A class condition
     * @exception CSSException if this exception is not supported.
     */    
    AttributeCondition createClassCondition(String namespaceURI,
					    String value)
	throws CSSException;

    
Creates a pseudo class condition

Params:
  • namespaceURI – the namespace URI of the attribute
  • value – the name of the pseudo class
Throws:
Returns:A pseudo class condition
/**
     * Creates a pseudo class condition
     *
     * @param namespaceURI the namespace URI of the attribute
     * @param value the name of the pseudo class
     * @return A pseudo class condition
     * @exception CSSException if this exception is not supported.
     */    
    AttributeCondition createPseudoClassCondition(String namespaceURI,
						  String value)
	throws CSSException;

    
Creates a "only one" child condition

Throws:
Returns:A "only one" child condition
/**
     * Creates a "only one" child condition
     *
     * @return A "only one" child condition
     * @exception CSSException if this exception is not supported.
     */    
    Condition createOnlyChildCondition() throws CSSException;


    
Creates a "only one" type condition

Throws:
Returns:A "only one" type condition
/**
     * Creates a "only one" type condition
     *
     * @return A "only one" type condition
     * @exception CSSException if this exception is not supported.
     */    
    Condition createOnlyTypeCondition() throws CSSException;

    
Creates a content condition

Params:
  • data – the data in the content
Throws:
Returns:A content condition
/**
     * Creates a content condition
     *
     * @param data the data in the content
     * @return A content condition
     * @exception CSSException if this exception is not supported.
     */    
    ContentCondition createContentCondition(String data)
	throws CSSException;

    
}