01: package javax.xml.stream.events;
02:
03: import java.util.List;
04:
05: /**
06: * This is the top level interface for events dealing with DTDs
07: *
08: * @version 1.0
09: * @author Copyright (c) 2003 by BEA Systems. All Rights Reserved.
10: */
11: public interface DTD extends XMLEvent {
12:
13: /**
14: * Returns the entire Document Type Declaration as a string, including
15: * the internal DTD subset.
16: * This may be null if there is not an internal subset.
17: * If it is not null it must return the entire
18: * Document Type Declaration which matches the doctypedecl
19: * production in the XML 1.0 specification
20: */
21: String getDocumentTypeDeclaration();
22:
23: /**
24: * Returns an implementation defined representation of the DTD.
25: * This method may return null if no representation is available.
26: */
27: Object getProcessedDTD();
28:
29: /**
30: * Return a List containing the notations declared in the DTD.
31: * This list must contain NotationDeclaration events.
32: * @see NotationDeclaration
33: * @return an unordered list of NotationDeclaration events
34: */
35: List getNotations();
36:
37: /**
38: * Return a List containing the general entities,
39: * both external and internal, declared in the DTD.
40: * This list must contain EntityDeclaration events.
41: * @see EntityDeclaration
42: * @return an unordered list of EntityDeclaration events
43: */
44: List getEntities();
45: }
|