org.w3c.dom.ls.LSOutput Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of xercesImpl Show documentation

Xerces2 is the next generation of high performance, fully compliant XML parsers in the Apache Xerces family. This new version of Xerces introduces the Xerces Native Interface (XNI), a complete framework for building parser components and configurations that is extremely modular and easy to program. The Apache Xerces2 parser is the reference implementation of XNI but other parser components, configurations, and parsers can be written using the Xerces Native Interface. For complete design and implementation documents, refer to the XNI Manual. Xerces2 is a fully conforming XML Schema 1.0 processor. A partial experimental implementation of the XML Schema 1.1 Structures and Datatypes Working Drafts (December 2009) and an experimental implementation of the XML Schema Definition Language (XSD): Component Designators (SCD) Candidate Recommendation (January 2010) are provided for evaluation. For more information, refer to the XML Schema page. Xerces2 also provides a complete implementation of the Document Object Model Level 3 Core and Load/Save W3C Recommendations and provides a complete implementation of the XML Inclusions (XInclude) W3C Recommendation. It also provides support for OASIS XML Catalogs v1.1. Xerces2 is able to parse documents written according to the XML 1.1 Recommendation, except that it does not yet provide an option to enable normalization checking as described in section 2.13 of this specification. It also handles namespaces according to the XML Namespaces 1.1 Recommendation, and will correctly serialize XML 1.1 documents if the DOM level 3 load/save APIs are in use.

The newest version!

/*
 * Copyright (c) 2004 World Wide Web Consortium,
 *
 * (Massachusetts Institute of Technology, European Research Consortium for
 * Informatics and Mathematics, Keio University). All Rights Reserved. This
 * work is distributed under the W3C(r) Software License [1] 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.
 *
 * [1] http://www.w3.org/Consortium/Legal/2002/copyright-software-20021231
 */

package org.w3c.dom.ls;

/**
 *  This interface represents an output destination for data. 
 *  This interface allows an application to encapsulate information about 
 * an output destination in a single object, which may include a URI, a byte 
 * stream (possibly with a specified encoding), a base URI, and/or a 
 * character stream. 
 * 
 The exact definitions of a byte stream and a character stream are 
 * binding dependent. 
 * 
 The application is expected to provide objects that implement this 
 * interface whenever such objects are needed. The application can either 
 * provide its own objects that implement this interface, or it can use the 
 * generic factory method DOMImplementationLS.createLSOutput() 
 * to create objects that implement this interface. 
 * 
 The LSSerializer will use the LSOutput object 
 * to determine where to serialize the output to. The 
 * LSSerializer will look at the different outputs specified in 
 * the LSOutput in the following order to know which one to 
 * output to, the first one that is not null and not an empty string will be 
 * used: 
 * 

 *  LSOutput.characterStream 
 * 
 *  
 * LSOutput.byteStream 
 * 
 *  LSOutput.systemId 
 * 
 *  
 *  LSOutput objects belong to the application. The DOM 
 * implementation will never modify them (though it may make copies and 
 * modify the copies, if necessary). 
 * See also the Document Object Model (DOM) Level 3 Load
and Save Specification.
 */
public interface LSOutput {
    /**
     *  An attribute of a language and binding dependent type that represents 
     * a writable stream to which 16-bit units can be output. 
     */
    public java.io.Writer getCharacterStream();
    /**
     *  An attribute of a language and binding dependent type that represents 
     * a writable stream to which 16-bit units can be output. 
     */
    public void setCharacterStream(java.io.Writer characterStream);

    /**
     *  An attribute of a language and binding dependent type that represents 
     * a writable stream of bytes. 
     */
    public java.io.OutputStream getByteStream();
    /**
     *  An attribute of a language and binding dependent type that represents 
     * a writable stream of bytes. 
     */
    public void setByteStream(java.io.OutputStream byteStream);

    /**
     *  The system identifier, a URI reference [IETF RFC 2396], for this 
     * output destination. 
     * 
 If the system ID is a relative URI reference (see section 5 in [IETF RFC 2396]), the 
     * behavior is implementation dependent. 
     */
    public String getSystemId();
    /**
     *  The system identifier, a URI reference [IETF RFC 2396], for this 
     * output destination. 
     * 
 If the system ID is a relative URI reference (see section 5 in [IETF RFC 2396]), the 
     * behavior is implementation dependent. 
     */
    public void setSystemId(String systemId);

    /**
     *  The character encoding to use for the output. The encoding must be a 
     * string acceptable for an XML encoding declaration ([XML 1.0] section 
     * 4.3.3 "Character Encoding in Entities"), it is recommended that 
     * character encodings registered (as charsets) with the Internet 
     * Assigned Numbers Authority [IANA-CHARSETS]
     *  should be referred to using their registered names. 
     */
    public String getEncoding();
    /**
     *  The character encoding to use for the output. The encoding must be a 
     * string acceptable for an XML encoding declaration ([XML 1.0] section 
     * 4.3.3 "Character Encoding in Entities"), it is recommended that 
     * character encodings registered (as charsets) with the Internet 
     * Assigned Numbers Authority [IANA-CHARSETS]
     *  should be referred to using their registered names. 
     */
    public void setEncoding(String encoding);

}