JavaTM Platform
Standard Ed. 6

org.xml.sax
�ӿ� Parser

������֪ʵ���ࣺ
XMLReaderAdapter

�ѹ�ʱ�� �˽ӿ��Ѿ��� SAX2 XMLReader �ӿ�ȡ�������߰������ƿռ�֧�֡�

public interface Parser

���� SAX ��XML �ļ� API�� �������Ļ����ӿڡ�

��ģ�飨����Դ������ĵ����ڹ������У�ͬʱ û�е������йظ�����Ϣ�������http://www.saxproject.org��

����һ�� SAX1 ����Ҫ�¼��ṩ�߽ӿڣ��� SAX2 �����Ѿ��� XMLReader ��ȡ�������߰������ƿռ�֧�֡����ӵĿ������Լ�����չ�ԡ�

���е� SAX1 ������������ʵ����һ�����ӿڣ�������Ӧ�ó���Ϊ��ͬ���͵��¼�ע�ᴦ�������Ҵ� URI ���ַ�����ʼ������

���е� SAX1 ������������ʵ��������Ĺ��췽��������Ҳ����ʵ�������Ĺ��췽������

SAX1 ��������������ʹ�ã����������룺һ���ɹ�����˵�һ�ν�����Ӧ�ó���Ϳ�������ʹ��һ�����������󣨿��ܾ��в�ͬ������Դ���������������ڽ������Եݹ�ķ�ʽ���� parse() ������

�����°汾��ʼ��
SAX 1.0
������
EntityResolver, DTDHandler, DocumentHandler, ErrorHandler, HandlerBase, InputSource

����ժҪ
 void parse(InputSource source)
          �ѹ�ʱ�� ���� XML �ĵ���
 void parse(String systemId)
          �ѹ�ʱ�� ��ϵͳ��ʶ�� (URI) ���� XML �ĵ���
 void setDocumentHandler(DocumentHandler handler)
          �ѹ�ʱ�� ����Ӧ�ó���ע���ĵ��¼���������
 void setDTDHandler(DTDHandler handler)
          �ѹ�ʱ�� ����Ӧ�ó���ע�� DTD �¼���������
 void setEntityResolver(EntityResolver resolver)
          �ѹ�ʱ�� ����Ӧ�ó���ע���Զ����ʵ���������
 void setErrorHandler(ErrorHandler handler)
          �ѹ�ʱ�� ����Ӧ�ó���ע������¼���������
 void setLocale(Locale locale)
          �ѹ�ʱ�� ����Ӧ�ó����������;���Ļ�����
 

������ϸ��Ϣ

setLocale

void setLocale(Locale locale)
               throws SAXException
�ѹ�ʱ�� 
����Ӧ�ó����������;���Ļ�����

����Ҫ SAX �������ṩ�Դ���;���ı��ػ������ǣ���������޷�֧��������Ļ�����������׳� SAX �쳣���ڽ���������Ӧ�ó��������󻷾��ı䡣

������
locale - Java Locale ����
�׳���
SAXException - �����֧������Ļ��������׳��쳣��ʹ��ԭ���Ļ�Ĭ�ϵĻ�������
������
SAXException, SAXParseException

setEntityResolver

void setEntityResolver(EntityResolver resolver)
�ѹ�ʱ�� 
����Ӧ�ó���ע���Զ����ʵ���������

���Ӧ�ó���ע��ʵ����������� SAX ����������������ϵͳ��ʶ�����򿪵�ʵ������ӣ������� HandlerBase ��ʵ�ֵ�Ĭ����Ϊ����

Ӧ�ó��򻹿����ڽ����ڼ�ע���µĻ�ͬ��ʵ������������� SAX ����������������ʼʹ���µĽ�������

������
resolver - ��������ʵ��Ķ���
������
EntityResolver, HandlerBase

setDTDHandler

void setDTDHandler(DTDHandler handler)
�ѹ�ʱ�� 
����Ӧ�ó���ע�� DTD �¼���������

���Ӧ�ó���ע�� DTD ���������򽫺����� SAX ��������������� DTD �¼��������� HandlerBase ʵ�ֵ�Ĭ����Ϊ����

Ӧ�ó��򻹿����ڽ����ڼ�ע���µĻ�ͬ�Ĵ������򣬲��� SAX ����������������ʼʹ���µĴ�������

������
handler - DTD ��������
������
DTDHandler, HandlerBase

setDocumentHandler

void setDocumentHandler(DocumentHandler handler)
�ѹ�ʱ�� 
����Ӧ�ó���ע���ĵ��¼���������

���Ӧ�ó���ע���ĵ����������򽫺����� SAX ����������������ĵ��¼��������� HandlerBase ʵ�ֵ�Ĭ����Ϊ����

Ӧ�ó��򻹿����ڽ���������ע���µĻ�ͬ�Ĵ������򣬲��� SAX ����������������ʼʹ���µĴ�������

������
handler - �ĵ���������
������
DocumentHandler, HandlerBase

setErrorHandler

void setErrorHandler(ErrorHandler handler)
�ѹ�ʱ�� 
����Ӧ�ó���ע������¼���������

���Ӧ�ó���ע������¼����������򽫺����� SAX ��������������д����¼����������� fatalError�������׳� SAXException�������� HandlerBase ʵ�ֵ�Ĭ����Ϊ����

Ӧ�ó��򻹿����ڽ���������ע���µĻ�ͬ�Ĵ������򣬲��� SAX ����������������ʼʹ���µĴ�������

������
handler - ����������
������
ErrorHandler, SAXException, HandlerBase

parse

void parse(InputSource source)
           throws SAXException,
                  IOException
�ѹ�ʱ�� 
���� XML �ĵ���

Ӧ�ó������ʹ�ô˷���ָ�� SAX ��������ʼ���������κ���Ч����Դ���ַ������ֽ����� URI���� XML �ĵ���

�ڽ������ڽ���ʱ��Ӧ�ó�����ܲ��ܵ��ô˷��������DZ���Ϊÿ������� XML �ĵ������µ� Parser����һ������˽�����Ӧ�ó���Ϳ�������ʹ�ÿ��ܾ�������һ������Դ��ͬһ�� Parser ����

������
source - XML �ĵ��Ķ��������Դ��
�׳���
SAXException - �κ� SAX �쳣�����ܰ�װ������쳣��
IOException - ������������ IO �쳣����������Ӧ�ó����ṩ���ֽ������ַ�����
������
InputSource, parse(java.lang.String), setEntityResolver(org.xml.sax.EntityResolver), setDTDHandler(org.xml.sax.DTDHandler), setDocumentHandler(org.xml.sax.DocumentHandler), setErrorHandler(org.xml.sax.ErrorHandler)

parse

void parse(String systemId)
           throws SAXException,
                  IOException
�ѹ�ʱ�� 
��ϵͳ��ʶ�� (URI) ���� XML �ĵ���

�˷����Ǵ�ϵͳ��ʶ����ȡ�ĵ���һ�������εĽݾ�������ȫ��Ч�����·�����

 parse(new InputSource(systemId));
 

���ϵͳ��ʶ����һ�� URL�����ڽ������ݵ�������֮ǰ������Ӧ�ó���������������Ľ�����

������
systemId - ϵͳ��ʶ�� (URI)��
�׳���
SAXException - �κ� SAX �쳣�����ܰ�װ������쳣��
IOException - ������������ IO �쳣����������Ӧ�ó����ṩ���ֽ������ַ�����
������
parse(org.xml.sax.InputSource)

JavaTM Platform
Standard Ed. 6

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

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