JavaTM Platform
Standard Ed. 6

javax.xml.stream
�ӿ� XMLStreamReader

���г����ӿڣ�
XMLStreamConstants
������֪ʵ���ࣺ
StreamReaderDelegate

public interface XMLStreamReader
extends XMLStreamConstants

XMLStreamReader �ӿ�����ת�� XML �Ͷ� XML ��ֻ�����ʡ��������Ϊ��ȡ XML ���ݵ���Ͳ�������Ч�ķ�����

XMLStreamReader �����Ϊʹ�� next() �� hasNext() �� XML �Ͻ��е���������ʹ������ getEventType()��getNamespaceURI()��getLocalName() �� getText() ֮��ķ����������ݣ�

next() ������ʹ reader ��ȡ��һ�������¼���next() ��������һ��������ָʾ�ղŶ�ȡ���¼����͡�

�¼����Ϳ���ʹ�� getEventType() ��ȷ����

�����¼�������Ϊ XML ������DTD����ʼ��ǡ��ַ����ݡ��ո񡢽�����ǡ�ע�ͻ���ָ����Ի����ƿռ��¼�������Ϊ��ѯ�����Ľ�����ĵ��ĸ�������֡�

Ϊ������ XML 1.0��XML ���������뽫��������δ����ʵ��ı�ʶ����ע���������������ʶ�����ݸ�Ӧ�ó��򡣴���Ϣͨ���˽ӿ��ϵ����� API �ṩ���������������������ʴ���Ϣ��javax.xml.stream.notations �� javax.xml.stream.entities����ǰ�¼�Ϊ DTD ʱ�����µ��ý�����һ�� Notation �б� List l = (List) getProperty("javax.xml.stream.notations"); ���µ��ý�����һ��ʵ�������б���List l = (List) getProperty("javax.xml.stream.entities"); ��Щ����ֻ���� DTD �¼��з��ʣ����ұ�����Ϊ�����Ϣ�����ã��򷵻� null��

�±������˸���״̬����Ӧ����Ч���������ij�ַ���������Ч״̬�е��õģ���÷������׳� java.lang.IllegalStateException��

ÿ��״̬��Ӧ����Ч����
�¼����� ��Ч����
����״̬ getProperty()��hasNext()��require()��close()��getNamespaceURI()��isStartElement()��isEndElement()��isCharacters()��isWhiteSpace()��getNamespaceContext()��getEventType()��getLocation()��hasText()��hasName()
START_ELEMENT next()��getName()��getLocalName()��hasName()��getPrefix()��getAttributeXXX()��isAttributeSpecified()��getNamespaceXXX()��getElementText()��nextTag()
ATTRIBUTE next()��nextTag()��getAttributeXXX()��isAttributeSpecified()
NAMESPACE next()��nextTag()��getNamespaceXXX()
END_ELEMENT next()��getName()��getLocalName()��hasName()��getPrefix()��getNamespaceXXX()��nextTag()
CHARACTERS next()��getTextXXX()��nextTag()
CDATA next()��getTextXXX()��nextTag()
COMMENT next()��getTextXXX()��nextTag()
SPACE next()��getTextXXX()��nextTag()
START_DOCUMENT next()��getEncoding()��getVersion()��isStandalone()��standaloneSet()��getCharacterEncodingScheme()��nextTag()
END_DOCUMENT close()
PROCESSING_INSTRUCTION next()��getPITarget()��getPIData()��nextTag()
ENTITY_REFERENCE next()��getLocalName()��getText()��nextTag()
DTD next()��getText()��nextTag()

�����°汾��ʼ��
1.6
������
XMLEvent, XMLInputFactory, XMLStreamWriter

�ֶ�ժҪ
 
�ӽӿ� javax.xml.stream.XMLStreamConstants �̳е��ֶ�
ATTRIBUTE, CDATA, CHARACTERS, COMMENT, DTD, END_DOCUMENT, END_ELEMENT, ENTITY_DECLARATION, ENTITY_REFERENCE, NAMESPACE, NOTATION_DECLARATION, PROCESSING_INSTRUCTION, SPACE, START_DOCUMENT, START_ELEMENT
 
����ժҪ
 void close()
          �ͷ���� Reader ������������Դ��
 int getAttributeCount()
          ���ش� START_ELEMENT �е����Լ������˷������� START_ELEMENT �� ATTRIBUTE ��Ч��
 String getAttributeLocalName(int index)
          �������ṩ�����������Ե� localName
 QName getAttributeName(int index)
          �������ṩ�����������Ե� qname
 String getAttributeNamespace(int index)
          �������ṩ�����������Ե����ƿռ�
 String getAttributePrefix(int index)
          �������ṩ�����������Ե�ǰ׺
 String getAttributeType(int index)
          �������ṩ�����������Ե� XML ����
 String getAttributeValue(int index)
          ���� index ��������ֵ
 String getAttributeValue(String namespaceURI, String localName)
          ���ش������ƿռ�� localName �����ԵĹ淶������ֵ��
 String getCharacterEncodingScheme()
          ���� xml �������������ַ����롣
 String getElementText()
          ��ȡ���ı�Ԫ�ص����ݣ�������Ǵ��ı�Ԫ�أ����׳��쳣��
 String getEncoding()
          ������������֪���򷵻�������룻���δ֪���򷵻� null��
 int getEventType()
          ����һ�������룬ָʾ�����ָ����¼������͡�
 String getLocalName()
          ���ص�ǰ�¼��ģ����أ����ơ�
 Location getLocation()
          ���ش������ĵ�ǰλ�á�
 QName getName()
          ���ص�ǰ START_ELEMENT �� END_ELEMENT �¼��� QName
 NamespaceContext getNamespaceContext()
          ���ص�ǰλ�õ�ֻ�����ƿռ������ġ�
 int getNamespaceCount()
          ������ START_ELEMENT �� END_ELEMENT �����������ƿռ�ļ������˷������� START_ELEMENT��END_ELEMENT �� NAMESPACE ��Ч��
 String getNamespacePrefix(int index)
          ������ index �����������ƿռ�ǰ׺��
 String getNamespaceURI()
          �����ǰ�¼��� START_ELEMENT �� END_ELEMENT����˷�������ǰ׺�� URI ��Ĭ�����ƿռ䡣
 String getNamespaceURI(int index)
          ������ index �����������ƿռ� URI��
 String getNamespaceURI(String prefix)
          ���ظ���ǰ׺�� URI��
 String getPIData()
          ��ȡ����ָ������ݽ�
 String getPITarget()
          ��ȡ����ָ���Ŀ��
 String getPrefix()
          ���ص�ǰ�¼���ǰ׺������¼�û��ǰ׺���򷵻� null
 Object getProperty(String name)
          �ӵײ�ʵ�ֻ�ȡ����/���Ե�ֵ
 String getText()
          ���ַ�������ʽ���ؽ����¼��ĵ�ǰֵ���˷������� CHARACTERS �¼����ַ���ֵ������ COMMENT ��ֵ��ENTITY_REFERENCE �����ֵ��CDATA �ڵ��ַ���ֵ��SPACE �¼����ַ���ֵ��DTD �ڲ��Ӽ����ַ���ֵ��
 char[] getTextCharacters()
          ����һ���������¼����ַ������顣
 int getTextCharacters(int sourceStart, char[] target, int targetStart, int length)
          ��ȡ�� CHARACTERS��SPACE �� CDATA �¼��������ı���
 int getTextLength()
          �����ı��ַ������д��ı��¼����ַ����г��ȡ�
 int getTextStart()
          ���ش洢�����ı��¼��ģ���һ���ַ�λ�ô����ı��ַ������ƫ������
 String getVersion()
          ��ȡ�� xml ������������ xml �汾�����û�������汾���򷵻� null
 boolean hasName()
          �����ǰ�¼������ƣ��� START_ELEMENT �� END_ELEMENT�����򷵻� ture�����򷵻� false
 boolean hasNext()
          ����ж�������¼����򷵻� true������������¼����򷵻� false��
 boolean hasText()
          �����ǰ�¼������ı����򷵻� true�����򷵻� false��
 boolean isAttributeSpecified(int index)
          ����һ�� boolean ֵ����ָʾ�������Ƿ�ΪĬ�ϴ�����
 boolean isCharacters()
          ������ָ���ַ������¼����򷵻� true
 boolean isEndElement()
          ������ָ�������ǣ��򷵻� true�����򷵻� false��
 boolean isStandalone()
          ��ȡ xml �����еĶ�������
 boolean isStartElement()
          ������ָ��ʼ��ǣ��򷵻� true�����򷵻� false��
 boolean isWhiteSpace()
          ������ָ�������пո���ɵ��ַ������¼����򷵻� true
 int next()
          ��ȡ��һ�������¼�??�����������õ����洢�鷵�������������ַ����ݣ���Ҳ���Խ���ָ�ɼ����洢�顣
 int nextTag()
          �ڵ��� START_ELEMENT �� END_ELEMENT ֮ǰ���������пո�isWhiteSpace() ���� true����COMMENT �� PROCESSING_INSTRUCTION��
 void require(int type, String namespaceURI, String localName)
          ���Ե�ǰ�¼��Ƿ����ڸ��������ͣ��Լ����ƿռ�������Ƿ��뵱ǰ�¼��ĵ�ǰ���ƿռ��������ƥ�䡣
 boolean standaloneSet()
          ����ĵ����Ƿ������˶���
 

������ϸ��Ϣ

getProperty

Object getProperty(String name)
                   throws IllegalArgumentException
�ӵײ�ʵ�ֻ�ȡ����/���Ե�ֵ

������
name - ���Ե����ƣ�������Ϊ null
���أ�
���Ե�ֵ
�׳���
IllegalArgumentException - �������Ϊ null

next

int next()
         throws XMLStreamException
��ȡ��һ�������¼�??�����������õ����洢�鷵�������������ַ����ݣ���Ҳ���Խ���ָ�ɼ����洢�顣������� javax.xml.stream.isCoalescing ����Ϊ true����Ԫ�����ݱ�����ϣ���������Ԫ�����ݻ� CDATA �ڣ�ֻ��Ҫ����һ�� CHARACTERS �¼��� Ĭ������£�������չʵ�����ã���͸���ر����Ӧ�ó������ʵ�����ò�����չ�����׳��쳣�����Ԫ������Ϊ�գ�������Ϊ ""�����򲻱��� CHARACTERS �¼���

����������� XML��
<foo><!--description-->�����ı�<![CDATA[<greeting>Hello</greeting>]]>��������</foo>
�� foo ���� next() ����Ϊ���ǣ�
1- ע�� (COMMENT)
2- Ȼ�����ַ��� (CHARACTERS)
3- �������� CDATA �ڣ���һ�� CHARACTERS��
4- �ٽ���������һ���ַ��� ����һ�� CHARACTERS��
5- ����� END_ELEMENT

ע�� ��Ԫ�أ��� <tag/>���������������������¼����棺START_ELEMENT �� END_ELEMENT??�Ᵽ֤�˿�Ԫ�ض� <tag></tag> �����ĵ�Ч�ԡ� ������� hasNext() ���� false ֮����ô˷�������˷������׳� IllegalStateException��

���أ�
�뵱ǰ�����¼����Ӧ��������
�׳���
NoSuchElementException - ����� hasNext() ���� false ʱ����
XMLStreamException - ��������ײ� XML Դʱ��������
������
XMLEvent

require

void require(int type,
             String namespaceURI,
             String localName)
             throws XMLStreamException
���Ե�ǰ�¼��Ƿ����ڸ��������ͣ��Լ����ƿռ�������Ƿ��뵱ǰ�¼��ĵ�ǰ���ƿռ��������ƥ�䡣��� namespaceURI Ϊ null����ò�������������Լ�飻��� localName Ϊ null����ò�������������Լ�顣

������
type - �¼�����
namespaceURI - �¼��� URI������Ϊ null
localName - �¼��� localName������Ϊ null
�׳���
XMLStreamException - �������ֵ��ƥ�䡣

getElementText

String getElementText()
                      throws XMLStreamException
��ȡ���ı�Ԫ�ص����ݣ�������Ǵ��ı�Ԫ�أ����׳��쳣������ javax.xml.stream.isCoalescing ��ֵ��Σ��˷���ʼ�շ�����ϵ����ݡ�
ǰ����������ǰ�¼��� START_ELEMENT��
������������ǰ�¼�����Ӧ�� END_ELEMENT��
�˷���ִ�����в�����ʵ�ֿ��������Ż���������ִ�е�Ч��������
if(getEventType() != XMLStreamConstants.START_ELEMENT) {
throw new XMLStreamException(
"parser must be on START_ELEMENT to read next text", getLocation());
 }
int eventType = next();
StringBuffer content = new StringBuffer();
while(eventType != XMLStreamConstants.END_ELEMENT ) {
if(eventType == XMLStreamConstants.CHARACTERS
|| eventType == XMLStreamConstants.CDATA
|| eventType == XMLStreamConstants.SPACE
|| eventType == XMLStreamConstants.ENTITY_REFERENCE) {
buf.append(getText());
} else if(eventType == XMLStreamConstants.PROCESSING_INSTRUCTION
|| eventType == XMLStreamConstants.COMMENT) {
// skipping
} else if(eventType == XMLStreamConstants.END_DOCUMENT) {
throw new XMLStreamException(
"unexpected end of document when reading element text content", this);
} else if(eventType == XMLStreamConstants.START_ELEMENT) {
throw new XMLStreamException(
"element text content may not contain START_ELEMENT", getLocation());
} else {
throw new XMLStreamException(
"Unexpected event type "+eventType, getLocation());
 }
eventType = next();
 }
return buf.toString();
 

�׳���
XMLStreamException - �����ǰ�¼����� START_ELEMENT ���������˷��ı�Ԫ��

nextTag

int nextTag()
            throws XMLStreamException
�ڵ��� START_ELEMENT �� END_ELEMENT ֮ǰ���������пո�isWhiteSpace() ���� true����COMMENT �� PROCESSING_INSTRUCTION����������ո��ַ���COMMENT��PROCESSING_INSTRUCTION��START_ELEMENT��END_ELEMENT ������������ݣ����׳��쳣���ڴ����Կո�ָ��Ĵ�Ԫ������ʱ��Ӧʹ�ô˷�����
ǰ����������
������������ǰ�¼�Ϊ START_ELEMENT �� END_ELEMENT�����ҹ���Ѿ��Ƶ��κοո��¼��ϡ�
��ʵ����ִ�����в�����ʵ�ֿ��������Ż���������ִ�е�Ч��������
int eventType = next();
while((eventType == XMLStreamConstants.CHARACTERS && isWhiteSpace()) // skip whitespace
|| (eventType == XMLStreamConstants.CDATA && isWhiteSpace()) 
// skip whitespace
|| eventType == XMLStreamConstants.SPACE
|| eventType == XMLStreamConstants.PROCESSING_INSTRUCTION
|| eventType == XMLStreamConstants.COMMENT
 ) {
eventType = next();
 }
if (eventType != XMLStreamConstants.START_ELEMENT && eventType != XMLStreamConstants.END_ELEMENT) {
throw new String XMLStreamException("expected start or end tag", getLocation());
 }
return eventType;
 

���أ�
Ԫ�ض�ȡ���¼����ͣ�START_ELEMENT �� END_ELEMENT��
�׳���
XMLStreamException - �����ǰ�¼����ǿո�PROCESSING_INSTRUCTION��START_ELEMENT �� END_ELEMENT
NoSuchElementException - ������� hasNext() ���� false ʱ������

hasNext

boolean hasNext()
                throws XMLStreamException
����ж�������¼����򷵻� true������������¼����򷵻� false����� XMLStreamReader �ĵ�ǰ״̬Ϊ END_DOCUMENT����˷������� false

���أ�
����ж���¼����򷵻� true�����򷵻� false
�׳���
XMLStreamException - ��������һ��״̬ʱ�������ش���

close

void close()
           throws XMLStreamException
�ͷ���� Reader ������������Դ���˷�������رյײ�����Դ��

�׳���
XMLStreamException - ����ͷŹ�����Դʱ��������

getNamespaceURI

String getNamespaceURI(String prefix)
���ظ���ǰ׺�� URI�����ص� URI ȡ���ڴ������ĵ�ǰ״̬��

ע������ Namespaces in XML �淶�еĶ��壬'xml' ǰ׺���󶨵� "http://www.w3.org/XML/1998/namespace"��

ע��'xmlns' ǰ׺���뱻�������������ƿռ䣺http://www.w3.org/2000/xmlns/

������
prefix - Ҫ���ҵ�ǰ׺��������Ϊ null
���أ�
�󶨵�����ǰ׺�� URI�����δ�󶨣��򷵻� null
�׳���
IllegalArgumentException - ���ǰ׺Ϊ null

isStartElement

boolean isStartElement()
������ָ��ʼ��ǣ��򷵻� true�����򷵻� false��

���أ�
������ָ��ʼ��ǣ��򷵻� true�����򷵻� false

isEndElement

boolean isEndElement()
������ָ�������ǣ��򷵻� true�����򷵻� false��

���أ�
������ָ�������ǣ��򷵻� true�����򷵻� false

isCharacters

boolean isCharacters()
������ָ���ַ������¼����򷵻� true

���أ�
������ָ���ַ����ݣ��򷵻� true�����򷵻� false

isWhiteSpace

boolean isWhiteSpace()
������ָ�������пո���ɵ��ַ������¼����򷵻� true

���أ�
������ָ�����пո��򷵻� true�����򷵻� false

getAttributeValue

String getAttributeValue(String namespaceURI,
                         String localName)
���ش������ƿռ�� localName �����ԵĹ淶������ֵ����� namespaceURI Ϊ null�������ƿռ䲻��������Լ��

������
namespaceURI - ���Ե����ƿռ�
localName - ���Եı������ƣ�������Ϊ null
���أ�
�������Ե�ֵ�����δ�ҵ����򷵻� null
�׳���
IllegalStateException - ������� START_ELEMENT �� ATTRIBUTE

getAttributeCount

int getAttributeCount()
���ش� START_ELEMENT �е����Լ������˷������� START_ELEMENT �� ATTRIBUTE ��Ч���˼������������ƿռ䶨�塣�����������㿪ʼ��

���أ�
����������
�׳���
IllegalStateException - ����ⲻ�� START_ELEMENT �� ATTRIBUTE

getAttributeName

QName getAttributeName(int index)
�������ṩ�����������Ե� qname

������
index - ���Ե�λ��
���أ�
���Ե� QName
�׳���
IllegalStateException - ������� START_ELEMENT �� ATTRIBUTE

getAttributeNamespace

String getAttributeNamespace(int index)
�������ṩ�����������Ե����ƿռ�

������
index - ���Ե�λ��
���أ�
���ƿռ� URI������Ϊ null��
�׳���
IllegalStateException - ������� START_ELEMENT �� ATTRIBUTE

getAttributeLocalName

String getAttributeLocalName(int index)
�������ṩ�����������Ե� localName

������
index - ���Ե�λ��
���أ�
���Ե� localName
�׳���
IllegalStateException - ������� START_ELEMENT �� ATTRIBUTE

getAttributePrefix

String getAttributePrefix(int index)
�������ṩ�����������Ե�ǰ׺

������
index - ���Ե�λ��
���أ�
���Ե�ǰ׺
�׳���
IllegalStateException - ������� START_ELEMENT �� ATTRIBUTE

getAttributeType

String getAttributeType(int index)
�������ṩ�����������Ե� XML ����

������
index - ���Ե�λ��
���أ�
���Ե� XML ����
�׳���
IllegalStateException - ������� START_ELEMENT �� ATTRIBUTE

getAttributeValue

String getAttributeValue(int index)
���� index ��������ֵ

������
index - ���Ե�λ��
���أ�
����ֵ
�׳���
IllegalStateException - ������� START_ELEMENT �� ATTRIBUTE

isAttributeSpecified

boolean isAttributeSpecified(int index)
����һ�� boolean ֵ����ָʾ�������Ƿ�ΪĬ�ϴ�����

������
index - ���Ե�λ��
���أ�
�������һ��Ĭ�����ԣ��򷵻� true
�׳���
IllegalStateException - ������� START_ELEMENT �� ATTRIBUTE

getNamespaceCount

int getNamespaceCount()
������ START_ELEMENT �� END_ELEMENT �����������ƿռ�ļ������˷������� START_ELEMENT��END_ELEMENT �� NAMESPACE ��Ч������ END_ELEMENT���������������ƿռ䷶Χ������ͬ�� SAX �ص���������йؽ���Ԫ���¼�����Ϣ��

���أ�
���ش��ض�Ԫ���е����ƿռ�������
�׳���
IllegalStateException - ������� START_ELEMENT��END_ELEMENT �� NAMESPACE

getNamespacePrefix

String getNamespacePrefix(int index)
������ index �����������ƿռ�ǰ׺�������Ĭ�����ƿռ��������򷵻� null

������
index - ���ƿռ�������λ��
���أ�
�������ƿռ�ǰ׺
�׳���
IllegalStateException - ������� START_ELEMENT��END_ELEMENT �� NAMESPACE

getNamespaceURI

String getNamespaceURI(int index)
������ index �����������ƿռ� URI��

������
index - ���ƿռ�������λ��
���أ�
�������ƿռ� URI
�׳���
IllegalStateException - ������� START_ELEMENT��END_ELEMENT �� NAMESPACE

getNamespaceContext

NamespaceContext getNamespaceContext()
���ص�ǰλ�õ�ֻ�����ƿռ������ġ�������Ϊ transient��ֻ�ڵ��� next() ���� reader ��״̬֮ǰ����Ч��

���أ�
�������ƿռ�������

getEventType

int getEventType()
����һ�������룬ָʾ�����ָ����¼������͡�


getText

String getText()
���ַ�������ʽ���ؽ����¼��ĵ�ǰֵ���˷������� CHARACTERS �¼����ַ���ֵ������ COMMENT ��ֵ��ENTITY_REFERENCE �����ֵ��CDATA �ڵ��ַ���ֵ��SPACE �¼����ַ���ֵ��DTD �ڲ��Ӽ����ַ���ֵ������Ѿ������� ENTITY_REFERENCE���������ַ����ݶ���������Ϊ CHARACTERS �¼���

���أ�
��ǰ�ı��� null
�׳���
IllegalStateException - �����״̬������Ч���ı�״̬��

getTextCharacters

char[] getTextCharacters()
����һ���������¼����ַ������顣������Ӧ����Ϊֻ���ĺ� transient������ XMLStreamReader �ƶ�����һ���¼�֮ǰ�����齫�����ı��ַ�����ͼ�ڳ�����ʱ�䷶Χ�󱣴浽�ַ����飬������ͼ�޸���������ݣ���Щ����Υ���˽ӿ�Լ������Ϊ��

���أ�
��ǰ�ı��������
�׳���
IllegalStateException - �����״̬������Ч���ı�״̬��

getTextCharacters

int getTextCharacters(int sourceStart,
                      char[] target,
                      int targetStart,
                      int length)
                      throws XMLStreamException
��ȡ�� CHARACTERS��SPACE �� CDATA �¼��������ı����� "sourceStart" ��ʼ���ı������Ƶ��� "targetStart" ��ʼ�� "target" �С���ิ�� "length" ���ַ�������ʵ�ʸ��Ƶ��ַ����� "sourceStart" ����������ڵ��� 0 ��С�ڵ������¼��������ַ�����ͨ����һ�������ı��� "sourceStart" Ϊ 0 ��ʼ�����ʵ�ʸ��Ƶ��ַ���С�� "length"�����ʾû�и�����ı��������ڼ����������ı�֮ǰ����Ҫ���к����ĵ��á����磺 int length = 1024; char[] myBuffer = new char[ length ]; for ( int sourceStart = 0 ; ; sourceStart += length ) { int nCopied = stream.getTextCharacters( sourceStart, myBuffer, 0, length ); if (nCopied < length) break; } ����ڵײ�Դ�д����κ� XML �������׳� XMLStreamException��"targetStart" ����������ڵ��� 0 ��С�� "target" �ij��ȣ�Length ������� 0���� "targetStart + length" ����С�ڵ��� "target" �ij��ȡ�

������
sourceStart - Ҫ���Ƶ�Դ�����е�һ���ַ�������
target - Ŀ������
targetStart - Ŀ�������е���ʼƫ����
length - Ҫ���Ƶ��ַ���
���أ�
ʵ�ʸ��Ƶ��ַ���
�׳���
XMLStreamException - ����ײ� XML Դ���Ǹ�ʽ���õ�
IndexOutOfBoundsException - ��� targetStart < 0 �� > Ŀ�곤��
IndexOutOfBoundsException - ��� length < 0 �� targetStart + length > Ŀ�곤��
UnsupportedOperationException - ����˷�������֧��
NullPointerException - ���Ŀ��Ϊ null

getTextStart

int getTextStart()
���ش洢�����ı��¼��ģ���һ���ַ�λ�ô����ı��ַ������ƫ������

�׳���
IllegalStateException - �����״̬������Ч���ı�״̬��

getTextLength

int getTextLength()
�����ı��ַ������д��ı��¼����ַ����г��ȡ�

�׳���
IllegalStateException - �����״̬������Ч���ı�״̬��

getEncoding

String getEncoding()
������������֪���򷵻�������룻���δ֪���򷵻� null��

���أ�
��ʵ���ı���� null

hasText

boolean hasText()
�����ǰ�¼������ı����򷵻� true�����򷵻� false�������¼������ı���CHARACTERS��DTD��ENTITY_REFERENCE��COMMENT��SPACE


getLocation

Location getLocation()
���ش������ĵ�ǰλ�á���� Location δ֪��������Ӧ���� Location ��ʵ�֣���ʵ�ֶ�λ�÷��� -1���� publicId �� systemId ���� null��λ����Ϣ���ڵ��� next() ֮ǰ��Ч��


getName

QName getName()
���ص�ǰ START_ELEMENT �� END_ELEMENT �¼��� QName

���أ�
��ǰ START_ELEMENT �� END_ELEMENT �¼��� QName
�׳���
IllegalStateException - ������� START_ELEMENT �� END_ELEMENT

getLocalName

String getLocalName()
���ص�ǰ�¼��ģ����أ����ơ����� START_ELEMENT �� END_ELEMENT�����ص�ǰԪ�صģ����أ����ơ����� ENTITY_REFERENCE������ʵ�����ơ���ǰ�¼������� START_ELEMENT��END_ELEMENT �� ENTITY_REFERENCE

���أ�
localName
�׳���
IllegalStateException - ������� START_ELEMENT��END_ELEMENT �� ENTITY_REFERENCE

hasName

boolean hasName()
�����ǰ�¼������ƣ��� START_ELEMENT �� END_ELEMENT�����򷵻� ture�����򷵻� false


getNamespaceURI

String getNamespaceURI()
�����ǰ�¼��� START_ELEMENT �� END_ELEMENT����˷�������ǰ׺�� URI ��Ĭ�����ƿռ䡣����¼�û��ǰ׺���򷵻� null��

���أ�
�󶨵���Ԫ��ǰ׺�� URI��Ĭ�����ƿռ�� null

getPrefix

String getPrefix()
���ص�ǰ�¼���ǰ׺������¼�û��ǰ׺���򷵻� null

���أ�
ǰ׺�� null

getVersion

String getVersion()
��ȡ�� xml ������������ xml �汾�����û�������汾���򷵻� null

���أ�
XML �汾�� null

isStandalone

boolean isStandalone()
��ȡ xml �����еĶ�������

���أ�
����Ƕ����ģ��򷵻� true�����򷵻� false

standaloneSet

boolean standaloneSet()
����ĵ����Ƿ������˶���

���أ�
����ĵ��������˶������򷵻� true�����򷵻� false

getCharacterEncodingScheme

String getCharacterEncodingScheme()
���� xml �������������ַ����롣���û�������ַ����룬�򷵻� null

���أ�
���ĵ��������ı���� null

getPITarget

String getPITarget()
��ȡ����ָ���Ŀ��

���أ�
Ŀ��� null

getPIData

String getPIData()
��ȡ����ָ������ݽ�

���أ�
���ݻ� null

JavaTM Platform
Standard Ed. 6

�ύ��������
�йظ���� API �ο����ϺͿ�����Ա�ĵ�������� Java SE ������Ա�ĵ������ĵ���������ϸ�ġ����򿪷���Ա���������Լ�������������ﶨ�塢ʹ�ü��ɺ͹�������ʾ����

��Ȩ���� 2007 Sun Microsystems, Inc. ��������Ȩ���� ����������֤��������������ĵ����·ַ�������