getColumnNumber
public int getColumnNumber()
Return the column number where the current document event ends.
This is one-based number of Java
char values since
the last line end.
Warning: The return value from the method
is intended only as an approximation for the sake of diagnostics;
it is not intended to provide sufficient information
to edit the character content of the original XML document.
For example, when lines contain combining character sequences, wide
characters, surrogate pairs, or bi-directional text, the value may
not correspond to the column in a text editor's display.
The return value is an approximation of the column number
in the document entity or external parsed entity where the
markup triggering the event appears.
If possible, the SAX driver should provide the line position
of the first character after the text associated with the document
event. The first column in each line is column 1.
- getColumnNumber in interface Locator
- The column number, or -1 if none is available.
getLineNumber
public int getLineNumber()
Return the line number where the current document event ends.
Lines are delimited by line ends, which are defined in
the XML specification.
Warning: The return value from the method
is intended only as an approximation for the sake of diagnostics;
it is not intended to provide sufficient information
to edit the character content of the original XML document.
In some cases, these "line" numbers match what would be displayed
as columns, and in others they may not match the source text
due to internal entity expansion.
The return value is an approximation of the line number
in the document entity or external parsed entity where the
markup triggering the event appears.
If possible, the SAX driver should provide the line position
of the first character after the text associated with the document
event. The first line is line 1.
- getLineNumber in interface Locator
- The line number, or -1 if none is available.
getPublicId
public String getPublicId()
Return the public identifier for the current document event.
The return value is the public identifier of the document
entity or of the external parsed entity in which the markup
triggering the event appears.
- getPublicId in interface Locator
- A string containing the public identifier, or
null if none is available.
getSystemId
public String getSystemId()
Return the system identifier for the current document event.
The return value is the system identifier of the document
entity or of the external parsed entity in which the markup
triggering the event appears.
If the system identifier is a URL, the parser must resolve it
fully before passing it to the application. For example, a file
name must always be provided as a
file:... URL, and other
kinds of relative URI are also resolved against their bases.
- getSystemId in interface Locator
- A string containing the system identifier, or null
if none is available.
isDeclared
public boolean isDeclared(int index)
Returns false unless the attribute was declared in the DTD.
This helps distinguish two kinds of attributes that SAX reports
as CDATA: ones that were declared (and hence are usually valid),
and those that were not (and which are never valid).
- isDeclared in interface Attributes2
index - The attribute index (zero-based).
- true if the attribute was declared in the DTD,
false otherwise.
isDeclared
public boolean isDeclared(String qName)
Returns false unless the attribute was declared in the DTD.
This helps distinguish two kinds of attributes that SAX reports
as CDATA: ones that were declared (and hence are usually valid),
and those that were not (and which are never valid).
- isDeclared in interface Attributes2
qName - The XML qualified (prefixed) name.
- true if the attribute was declared in the DTD,
false otherwise.
isDeclared
public boolean isDeclared(String uri,
String localName) Returns false unless the attribute was declared in the DTD.
This helps distinguish two kinds of attributes that SAX reports
as CDATA: ones that were declared (and hence are usually valid),
and those that were not (and which are never valid).
Remember that since DTDs do not "understand" namespaces, the
namespace URI associated with an attribute may not have come from
the DTD. The declaration will have applied to the attribute's
qName.
- isDeclared in interface Attributes2
uri - The Namespace URI, or the empty string if
the name has no Namespace URI.localName - The attribute's local name.
- true if the attribute was declared in the DTD,
false otherwise.
isSpecified
public boolean isSpecified(int index)
Returns true unless the attribute value was provided
by DTD defaulting.
- isSpecified in interface Attributes2
index - The attribute index (zero-based).
- true if the value was found in the XML text,
false if the value was provided by DTD defaulting.
isSpecified
public boolean isSpecified(String qName)
Returns true unless the attribute value was provided
by DTD defaulting.
- isSpecified in interface Attributes2
qName - The XML qualified (prefixed) name.
- true if the value was found in the XML text,
false if the value was provided by DTD defaulting.
isSpecified
public boolean isSpecified(String uri,
String localName) Returns true unless the attribute value was provided
by DTD defaulting.
Remember that since DTDs do not "understand" namespaces, the
namespace URI associated with an attribute may not have come from
the DTD. The declaration will have applied to the attribute's
qName.
- isSpecified in interface Attributes2
uri - The Namespace URI, or the empty string if
the name has no Namespace URI.localName - The attribute's local name.
- true if the value was found in the XML text,
false if the value was provided by DTD defaulting.
reset
public void reset()
Resets this parser to its original configuration.
- reset in interface SAXParser
resolveEntity
public Object resolveEntity(String publicId,
String systemId,
String baseURI,
String namespace)
throws XMLStreamException Returns an input source from which the specified external entity can be
read. The following return types are possible:
java.io.InputStreamjavax.xml.stream.XMLStreamReaderjava.xml.stream.XMLEventReader
If
null is returned, the processor will attempt to resolve
the entity itself.
- resolveEntity in interface XMLResolver
baseURI - the absolute base URI of the referring entitynamespace - the namespace of the external entity
SAXParser.java --
Copyright (C) 2005, 2006, 2007 Free Software Foundation, Inc.
This file is part of GNU Classpath.
GNU Classpath is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the 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, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with GNU Classpath; see the file COPYING. If not, write to the
Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
02110-1301 USA.
Linking this library statically or dynamically with other modules is
making a combined work based on this library. Thus, the terms and
conditions of the GNU General Public License cover the whole
combination.
As a special exception, the copyright holders of this library give you
permission to link this library with independent modules to produce an
executable, regardless of the license terms of these independent
modules, and to copy and distribute the resulting executable under
terms of your choice, provided that you also meet, for each linked
independent module, the terms and conditions of the license of that
module. An independent module is a module which is not derived from
or based on this library. If you modify this library, you may extend
this exception to your version of the library, but you are not
obligated to do so. If you do not wish to do so, delete this
exception statement from your version.