/* Transformer.java --    Copyright (C) 2004, 2005  Free Software Foundation, Inc.This file is part of GNU Classpath.GNU Classpath is free software; you can redistribute it and/or modifyit under the terms of the GNU General Public License as published bythe Free Software Foundation; either version 2, or (at your option)any later version.GNU Classpath is distributed in the hope that it will be useful, butWITHOUT ANY WARRANTY; without even the implied warranty ofMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNUGeneral Public License for more details.You should have received a copy of the GNU General Public Licensealong with GNU Classpath; see the file COPYING.  If not, write to theFree Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA02110-1301 USA.Linking this library statically or dynamically with other modules ismaking a combined work based on this library.  Thus, the terms andconditions of the GNU General Public License cover the wholecombination.As a special exception, the copyright holders of this library give youpermission to link this library with independent modules to produce anexecutable, regardless of the license terms of these independentmodules, and to copy and distribute the resulting executable underterms of your choice, provided that you also meet, for each linkedindependent module, the terms and conditions of the license of thatmodule.  An independent module is a module which is not derived fromor based on this library.  If you modify this library, you may extendthis exception to your version of the library, but you are notobligated to do so.  If you do not wish to do so, delete thisexception statement from your version. */package javax.xml.transform;import java.util.Properties;/** * An XSL transformation. * Instances of this class may be reused, but the same instance may not be * used concurrently by different threads. * * @author (a href='mailto:dog@gnu.org'>Chris Burdess</a) */public abstract class Transformer{  protected Transformer()  {  }  /**   * Transforms the source XML to a result tree.   * @param xmlSource the XML source   * @param outputTarget the result of the transformation   */  public abstract void transform(Source xmlSource, Result outputTarget)     throws TransformerException;    /**   * Sets a parameter value for the transformation.   * Parameters may be referenced in the XSLT stylesheet.   * @param name the parameter name (an XML Name, or a namespace-prefixed   * XML Name of the form <code>{<i>namespaceURI</i>}<i>localName</i></code>   * @param value the value to assign   */  public abstract void setParameter(String name, Object value);  /**   * Returns the specified parameter value.   * @param name the parameter name (an XML Name, or a namespace-prefixed   * XML Name of the form <code>{<i>namespaceURI</i>}<i>localName</i></code>   */  public abstract Object getParameter(String name);  /**   * Clears all parameter values.   */  public abstract void clearParameters();  /**   * Sets the callback used to resolve entities referenced by   * <code>xsl:include</code>, <code>xsl:import</code>, or the XPath   * <code>document()</code> function.   */  public abstract void setURIResolver(URIResolver resolver);  /**   * Returns the callback used to resolve entities referenced by   * <code>xsl:include</code>, <code>xsl:import</code>, or the XPath   * <code>document()</code> function.   */  public abstract URIResolver getURIResolver();  /**   * Sets the output properties for the transformation, overriding any   * properties defined in the stylesheet.   * The format of property keys is as in the   * {@link #setOutputProperty(java.lang.String,java.lang.String)} method.   * @param oformat a set of output properties, or null to reset all the   * properties to their default values   */  public abstract void setOutputProperties(Properties oformat)     throws IllegalArgumentException;  /**   * Returns a copy of the output properties for the transformation.   * Missing properties are defaulted according the   * <a href='http://www.w3.org/TR/xslt#output'>XSLT Recommendation, section   * 16</a>: <code>getProperty(String)</code> returns all properties   * including defaulted ones, and <code>get(Object)</code> returns only the   * properties explicitly set in the stylesheet.   */  public abstract Properties getOutputProperties();  /**   * Sets an output property for the transformation, overriding any property   * of the same name defined in the stylesheet.   * @param name the property name (an XML Name, or a namespace-prefixed   * XML Name of the form <code>{<i>namespaceURI</i>}<i>localName</i></code>   * @param value the string value of the property   * @exception IllegalArgumentException if the property is not supported   */  public abstract void setOutputProperty(String name, String value)     throws IllegalArgumentException;  /**   * Returns the value of an output property for the transformation.   * Only explicit properties set programmatically or defined in the   * stylesheet, not defaulted properties, are returned by this method.   * @param name the property name (an XML Name, or a namespace-prefixed   * XML Name of the form <code>{<i>namespaceURI</i>}<i>localName</i></code>   * @exception IllegalArgumentException if the property is not supported   */  public abstract String getOutputProperty(String name)     throws IllegalArgumentException;  /**   * Sets the callback used to report errors during the transformation.   *  @exception IllegalArgumentException if the listener is null   */  public abstract void setErrorListener(ErrorListener listener)    throws IllegalArgumentException;    /**   * Returns the callback used to report errors during the transformation.   */  public abstract ErrorListener getErrorListener();  // -- JAXP 1.3 methods --  /**   * Reset this Transformer to its original configuration.   * @since 1.3   */  public void reset()  {  }}