< prev index next >
src/java.xml/share/classes/javax/xml/stream/XMLEventWriter.java
Print this page
*** 66,84 ****
* will be closed when the corresponding END_ELEMENT is written.
* <table class="striped">
* <caption>Required and optional fields for events added to the writer</caption>
* <thead>
* <tr>
! * <th>Event Type</th>
! * <th>Required Fields</th>
! * <th>Optional Fields</th>
! * <th>Required Behavior</th>
* </tr>
* </thead>
* <tbody>
* <tr>
! * <td> START_ELEMENT </td>
* <td> QName name </td>
* <td> namespaces , attributes </td>
* <td> A START_ELEMENT will be written by writing the name,
* namespaces, and attributes of the event in XML 1.0 valid
* syntax for START_ELEMENTs.
--- 66,84 ----
* will be closed when the corresponding END_ELEMENT is written.
* <table class="striped">
* <caption>Required and optional fields for events added to the writer</caption>
* <thead>
* <tr>
! * <th scope="col">Event Type</th>
! * <th scope="col">Required Fields</th>
! * <th scope="col">Optional Fields</th>
! * <th scope="col">Required Behavior</th>
* </tr>
* </thead>
* <tbody>
* <tr>
! * <th scope="row"> START_ELEMENT </th>
* <td> QName name </td>
* <td> namespaces , attributes </td>
* <td> A START_ELEMENT will be written by writing the name,
* namespaces, and attributes of the event in XML 1.0 valid
* syntax for START_ELEMENTs.
*** 94,104 ****
* using the behavior specified in the namespace section of this
* table.
* </td>
* </tr>
* <tr>
! * <td> END_ELEMENT </td>
* <td> Qname name </td>
* <td> None </td>
* <td> A well formed END_ELEMENT tag is written.
* The name is written by looking up the prefix for
* the namespace uri. The writer can be configured to
--- 94,104 ----
* using the behavior specified in the namespace section of this
* table.
* </td>
* </tr>
* <tr>
! * <th scope="row"> END_ELEMENT </th>
* <td> Qname name </td>
* <td> None </td>
* <td> A well formed END_ELEMENT tag is written.
* The name is written by looking up the prefix for
* the namespace uri. The writer can be configured to
*** 109,130 ****
* If the END_ELEMENT name does not match the START_ELEMENT
* name an XMLStreamException is thrown.
* </td>
* </tr>
* <tr>
! * <td> ATTRIBUTE </td>
* <td> QName name , String value </td>
* <td> QName type </td>
* <td> An attribute is written using the same algorithm
* to find the lexical form as used in START_ELEMENT.
* The default is to use double quotes to wrap attribute
* values and to escape any double quotes found in the
* value. The type value is ignored.
* </td>
* </tr>
* <tr>
! * <td> NAMESPACE </td>
* <td> String prefix, String namespaceURI,
* boolean isDefaultNamespaceDeclaration
* </td>
* <td> None </td>
* <td> A namespace declaration is written. If the
--- 109,130 ----
* If the END_ELEMENT name does not match the START_ELEMENT
* name an XMLStreamException is thrown.
* </td>
* </tr>
* <tr>
! * <th scope="row"> ATTRIBUTE </th>
* <td> QName name , String value </td>
* <td> QName type </td>
* <td> An attribute is written using the same algorithm
* to find the lexical form as used in START_ELEMENT.
* The default is to use double quotes to wrap attribute
* values and to escape any double quotes found in the
* value. The type value is ignored.
* </td>
* </tr>
* <tr>
! * <th scope="row"> NAMESPACE </th>
* <td> String prefix, String namespaceURI,
* boolean isDefaultNamespaceDeclaration
* </td>
* <td> None </td>
* <td> A namespace declaration is written. If the
*** 135,145 ****
* and the writer must prepend xmlns to the prefix
* and write out a standard prefix declaration.
* </td>
* </tr>
* <tr>
! * <td> PROCESSING_INSTRUCTION </td>
* <td> None</td>
* <td> String target, String data</td>
* <td> The data does not need to be present and may be
* null. Target is required and many not be null.
* The writer
--- 135,145 ----
* and the writer must prepend xmlns to the prefix
* and write out a standard prefix declaration.
* </td>
* </tr>
* <tr>
! * <th scope="row"> PROCESSING_INSTRUCTION </th>
* <td> None</td>
* <td> String target, String data</td>
* <td> The data does not need to be present and may be
* null. Target is required and many not be null.
* The writer
*** 147,180 ****
* directly after the target,
* enclosed in appropriate XML 1.0 syntax
* </td>
* </tr>
* <tr>
! * <td> COMMENT </td>
* <td> None </td>
* <td> String comment </td>
* <td> If the comment is present (not null) it is written, otherwise an
* an empty comment is written
* </td>
* </tr>
* <tr>
! * <td> START_DOCUMENT </td>
* <td> None </td>
* <td> String encoding , boolean standalone, String version </td>
* <td> A START_DOCUMENT event is not required to be written to the
* stream. If present the attributes are written inside
* the appropriate XML declaration syntax
* </td>
* </tr>
* <tr>
! * <td> END_DOCUMENT </td>
* <td> None </td>
* <td> None </td>
* <td> Nothing is written to the output </td>
* </tr>
* <tr>
! * <td> DTD </td>
* <td> String DocumentTypeDefinition </td>
* <td> None </td>
* <td> The DocumentTypeDefinition is written to the output </td>
* </tr>
* </tbody>
--- 147,180 ----
* directly after the target,
* enclosed in appropriate XML 1.0 syntax
* </td>
* </tr>
* <tr>
! * <th scope="row"> COMMENT </th>
* <td> None </td>
* <td> String comment </td>
* <td> If the comment is present (not null) it is written, otherwise an
* an empty comment is written
* </td>
* </tr>
* <tr>
! * <th scope="row"> START_DOCUMENT </th>
* <td> None </td>
* <td> String encoding , boolean standalone, String version </td>
* <td> A START_DOCUMENT event is not required to be written to the
* stream. If present the attributes are written inside
* the appropriate XML declaration syntax
* </td>
* </tr>
* <tr>
! * <th scope="row"> END_DOCUMENT </th>
* <td> None </td>
* <td> None </td>
* <td> Nothing is written to the output </td>
* </tr>
* <tr>
! * <th scope="row"> DTD </th>
* <td> String DocumentTypeDefinition </td>
* <td> None </td>
* <td> The DocumentTypeDefinition is written to the output </td>
* </tr>
* </tbody>
< prev index next >