JavaTM Platform
Standard Ed. 6

org.w3c.dom.ls
�ӿ� LSParserFilter


public interface LSParserFilter

LSParserFilter ΪӦ�ó����ṩ���ڽ����ڼ乹���ڵ�ʱ�����Щ�ڵ������������Ҫ���ÿ���ڵ㣬���Կ��ܻ��޸Ļ�ɾ����Щ�ڵ㣬���߻���ǰ��ֹ����������

��ʱ������������κι������������������� Document �� DOMImplementation ������ڲ��ɷ��ʡ��Ӳ��Ὣ�ĵ�Ԫ�ش��ݸ� LSParserFilter �������������ܹ��˳��ĵ�Ԫ�ء�Document��DocumentType��Notation��Entity �� Attr �ڵ�Ӳ��ᱻ���ݸ��������ϵ� acceptNode ������������� "entities" ����Ϊ false����� EntityReference �ڵ���ӽڵ㴫�ݸ���������ע�⣬����� "entities" ���������������Ӳ��ᶪ��δչ����ʵ�����ýڵ㣬����ʼ�ս������ݸ���������

�����ĵ��ڼ䣬���е���Ч�Լ�鶼����������������������������Դ�ĵ��ϣ����������ڴ��й��������������� DOM �ĵ��ϡ�ʹ�ù��������ڴ��е��ĵ������������ĵ����Ӽ�����������Ч�Կ������ܵ��˹��˵�Ӱ�졣

����Ԫ�ش��ݸ�����������ʱ�����е�Ĭ�����Ա����������ЩԪ���ϡ���������Ĭ������Ҳ���봫�ݸ�������������

DOM Ӧ�ó����������������е��쳣���ӹ��������׳��쳣������Ч������ DOM ʵ�������ԡ�

������Document Object Model (DOM) Level 3 Load and Save Specification����


�ֶ�ժҪ
static short FILTER_ACCEPT
          ���ܽڵ㡣
static short FILTER_INTERRUPT
          �ж϶��ĵ��ij��洦����
static short FILTER_REJECT
          �ܾ��ڵ㼰���ӽڵ㡣
static short FILTER_SKIP
          �����˵����ڵ㡣
 
����ժҪ
 short acceptNode(Node nodeArg)
          �˷������ɽ���������ɶ�ÿ���ڵ�Ľ�������á�
 int getWhatToShow()
          ��֪ LSParser ���򷽷� LSParserFilter.acceptNode ��ʾʲô���͵Ľڵ㡣
 short startElement(Element elementArg)
          ����������ɨ����ÿ�� Element ������Ǻ󣬴�������� Element ֮ǰ���ô˷�����
 

�ֶ���ϸ��Ϣ

FILTER_ACCEPT

static final short FILTER_ACCEPT
���ܽڵ㡣

������
�����ֶ�ֵ

FILTER_REJECT

static final short FILTER_REJECT
�ܾ��ڵ㼰���ӽڵ㡣

������
�����ֶ�ֵ

FILTER_SKIP

static final short FILTER_SKIP
�����˵����ڵ㡣���迼�Ǵ˽ڵ���ӽڵ㡣

������
�����ֶ�ֵ

FILTER_INTERRUPT

static final short FILTER_INTERRUPT
�ж϶��ĵ��ij��洦����

������
�����ֶ�ֵ
������ϸ��Ϣ

startElement

short startElement(Element elementArg)
����������ɨ����ÿ�� Element ������Ǻ󣬴�������� Element ֮ǰ���ô˷�������Ŀ����������Ч���������κ���Ԫ�����ڵ�Ԫ�ء�ע�⣬����Ԫ�ؽڵ㴫�ݸ� startElement ������
���ݸ� startElement �Ա���˵�Ԫ�ؽڵ�������е� Element ���ԣ����������κ��ӽڵ㡣Element �����ܷŹ������ĵ����ʵ���λ�ã��������и��ڵ㣩��
startElement �������������Է��ʻ���� Element �����ԡ����� Namespace ��������Խ����������ƿռ���������κ�Ӱ�졣
Ϊ�����Ч�ʣ�����ڵ㱻���ܣ����ݸ��������� Element �ڵ㲻����ʵ�ʷ��������еĽڵ���ͬһ���ڵ㡣�������ĵ��ж�ȡ�͹����ĵ������У���������ʹ��ʵ�ʵĽڵ㣨�ڵ�����ʶ����

������
elementArg - ��������Ԫ�ء���ʱ�����ô˷�����Ԫ�ز����� - ���������Լ������ԣ���û�����
���أ�
  • FILTER_ACCEPT ��� Element ���������Ҫ������ DOM �ĵ��С�
  • FILTER_REJECT ��� Element �������е��������ܾ���
  • FILTER_SKIP ��� Element �������������������е�������뵽������ Element �ڵ�λ�á�
  • FILTER_INTERRUPT �����������ֹͣ���ĵ��Ĵ������ж϶��ĵ��Ĵ��������ٱ�֤�õ��� DOM ���Ǹ�ʽ���õ� XML���ܾ� Element��
�����κ�����ֵ���ᵼ��δָ������Ϊ��

acceptNode

short acceptNode(Node nodeArg)
�˷������ɽ���������ɶ�ÿ���ڵ�Ľ�������á��ڵ㼰�����к�������ڲ����������ġ����ڵ�Ҳ�����ڣ����������ܲ��������ģ�������������δ�����ĸ����ӽڵ㡣�Ӳ������Խڵ㴫�ݸ��˺�����
�ڴ˷����У��½ڵ���������޸� - �������ӻ��Ƴ��ӽڵ㣬�޸��ı��ڵ�ȡ��˽ڵ������ĵ������ಿ�ֵ�״̬��û�ж���ģ����ҳ��Ե��������޸��ĵ��������κβ��ֲ�����Ӱ����δ����ġ�
Ϊ����֤�����������ڹ����������κ��޸�֮ǰ���ԭʼ�ĵ����ڹ�����ִ�е��κ��ĵ��޸��϶���������Ч�Լ�顣
������½ڵ㱻�ܾ�������������ܻ����ø��½ڵ㼰�����еĺ����

������
nodeArg - �¹�����Ԫ�ء���ʱ���ô˷�������Ԫ���������� - �����������е��ӽڵ㣨�����ǵ��ֽڵ㣬�Դ����ƣ������ԣ�������Ϊ�ӽڵ����ӵ����ĸ��ڵ㡣
���أ�
  • FILTER_ACCEPT ����� Node ���������Ҫ������ DOM �ĵ��С�
  • FILTER_REJECT ��� Node �������е��ӽڵ���뱻�ܾ���
  • FILTER_SKIP ��� Node ������������ Node ������ Node �������ӽڵ���档
  • FILTER_INTERRUPT �����������ֹͣ���ĵ��Ĵ�������ֹ���ĵ��Ĵ��������ٱ�֤�õ��� DOM ���Ǹ�ʽ���õ� XML��Node �����ܣ����ҽ���Ϊ���һ���õ����������Ľڵ㡣

getWhatToShow

int getWhatToShow()
��֪ LSParser ���򷽷� LSParserFilter.acceptNode ��ʾʲô���͵Ľڵ㡣���û�н�ij���ڵ���ʾ��ʹ�ô����ԵĹ���������ýڵ㽫�Զ�������Ҫ������ DOM �ĵ��С��йضԳ����Ķ�����μ� NodeFilter������ SHOW_ATTRIBUTE��SHOW_DOCUMENT��SHOW_DOCUMENT_TYPE��SHOW_NOTATION��SHOW_ENTITY �� SHOW_DOCUMENT_FRAGMENT �ڴ������塣�Ӳ��Ὣ��Щ�ڵ㴫�ݸ� LSParserFilter.acceptNode��
�˴�ʹ�õij����� [DOM Level 2 Traversal and Range] �ж��塣


JavaTM Platform
Standard Ed. 6

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

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