< prev index next >
src/jdk.xml.bind/share/classes/com/sun/xml/internal/dtdparser/DTDEventListener.java
Print this page
*** 1,7 ****
/*
! * Copyright (c) 2009, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
--- 1,7 ----
/*
! * Copyright (c) 1998, 2015, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
*** 92,102 ****
throws SAXException;
/**
* Receive notification of an external parsed general entity
* declaration event.
! * <p/>
* <p>If a system identifier is present, and it is a relative URL, the
* parser will have resolved it fully before passing it through this
* method to a listener.</p>
*
* @param name The entity name.
--- 92,102 ----
throws SAXException;
/**
* Receive notification of an external parsed general entity
* declaration event.
! * <p>
* <p>If a system identifier is present, and it is a relative URL, the
* parser will have resolved it fully before passing it through this
* method to a listener.</p>
*
* @param name The entity name.
*** 125,135 ****
throws SAXException;
/**
* Receive notification of an external parameter entity declaration
* event.
! * <p/>
* <p>If a system identifier is present, and it is a relative URL, the
* parser will have resolved it fully before passing it through this
* method to a listener.</p>
*
* @param name The parameter entity name.
--- 125,135 ----
throws SAXException;
/**
* Receive notification of an external parameter entity declaration
* event.
! * <p>
* <p>If a system identifier is present, and it is a relative URL, the
* parser will have resolved it fully before passing it through this
* method to a listener.</p>
*
* @param name The parameter entity name.
*** 162,172 ****
public void endDTD()
throws SAXException;
/**
* Receive notification that a comment has been read.
! * <p/>
* <P> Note that processing instructions are the mechanism designed
* to hold information for consumption by applications, not comments.
* XML systems may rely on applications being able to access information
* found in processing instructions; this is not true of comments, which
* are typically discarded.
--- 162,172 ----
public void endDTD()
throws SAXException;
/**
* Receive notification that a comment has been read.
! * <p>
* <P> Note that processing instructions are the mechanism designed
* to hold information for consumption by applications, not comments.
* XML systems may rely on applications being able to access information
* found in processing instructions; this is not true of comments, which
* are typically discarded.
*** 177,197 ****
public void comment(String text)
throws SAXException;
/**
* Receive notification of character data.
! * <p/>
* <p>The Parser will call this method to report each chunk of
* character data. SAX parsers may return all contiguous character
* data in a single chunk, or they may split it into several
* chunks; however, all of the characters in any single event
* must come from the same external entity, so that the Locator
* provides useful information.</p>
! * <p/>
* <p>The application must not attempt to read from the array
* outside of the specified range.</p>
! * <p/>
* <p>Note that some parsers will report whitespace using the
* ignorableWhitespace() method rather than this one (validating
* parsers must do so).</p>
*
* @param ch The characters from the DTD.
--- 177,197 ----
public void comment(String text)
throws SAXException;
/**
* Receive notification of character data.
! * <p>
* <p>The Parser will call this method to report each chunk of
* character data. SAX parsers may return all contiguous character
* data in a single chunk, or they may split it into several
* chunks; however, all of the characters in any single event
* must come from the same external entity, so that the Locator
* provides useful information.</p>
! * <p>
* <p>The application must not attempt to read from the array
* outside of the specified range.</p>
! * <p>
* <p>Note that some parsers will report whitespace using the
* ignorableWhitespace() method rather than this one (validating
* parsers must do so).</p>
*
* @param ch The characters from the DTD.
*** 204,225 ****
throws SAXException;
/**
* Receive notification of ignorable whitespace in element content.
! * <p/>
* <p>Validating Parsers must use this method to report each chunk
* of ignorable whitespace (see the W3C XML 1.0 recommendation,
* section 2.10): non-validating parsers may also use this method
* if they are capable of parsing and using content models.</p>
! * <p/>
* <p>SAX parsers may return all contiguous whitespace in a single
* chunk, or they may split it into several chunks; however, all of
* the characters in any single event must come from the same
* external entity, so that the Locator provides useful
* information.</p>
! * <p/>
* <p>The application must not attempt to read from the array
* outside of the specified range.</p>
*
* @param ch The characters from the DTD.
* @param start The start position in the array.
--- 204,225 ----
throws SAXException;
/**
* Receive notification of ignorable whitespace in element content.
! * <p>
* <p>Validating Parsers must use this method to report each chunk
* of ignorable whitespace (see the W3C XML 1.0 recommendation,
* section 2.10): non-validating parsers may also use this method
* if they are capable of parsing and using content models.</p>
! * <p>
* <p>SAX parsers may return all contiguous whitespace in a single
* chunk, or they may split it into several chunks; however, all of
* the characters in any single event must come from the same
* external entity, so that the Locator provides useful
* information.</p>
! * <p>
* <p>The application must not attempt to read from the array
* outside of the specified range.</p>
*
* @param ch The characters from the DTD.
* @param start The start position in the array.
*** 277,287 ****
* each child element will be reported by mixedElement method.
* {@link #CONTENT_MODEL_CHILDREN}
* this elemen has child content model. The actual content model will
* be reported by childElement, startModelGroup, endModelGroup, and
* connector methods. Possible call sequences are:
! * <p/>
* START := MODEL_GROUP
* MODEL_GROUP := startModelGroup TOKEN (connector TOKEN)* endModelGroup
* TOKEN := childElement
* | MODEL_GROUP
*/
--- 277,287 ----
* each child element will be reported by mixedElement method.
* {@link #CONTENT_MODEL_CHILDREN}
* this elemen has child content model. The actual content model will
* be reported by childElement, startModelGroup, endModelGroup, and
* connector methods. Possible call sequences are:
! * <p>
* START := MODEL_GROUP
* MODEL_GROUP := startModelGroup TOKEN (connector TOKEN)* endModelGroup
* TOKEN := childElement
* | MODEL_GROUP
*/
*** 298,309 ****
public final short USE_REQUIRED = 3;
/**
* For each entry in an ATTLIST declaration,
* this event will be fired.
! * <p/>
! * <p/>
* DTD allows the same attributes to be declared more than
* once, and in that case the first one wins. I think
* this method will be only fired for the first one,
* but I need to check.
*/
--- 298,309 ----
public final short USE_REQUIRED = 3;
/**
* For each entry in an ATTLIST declaration,
* this event will be fired.
! * <p>
! * <p>
* DTD allows the same attributes to be declared more than
* once, and in that case the first one wins. I think
* this method will be only fired for the first one,
* but I need to check.
*/
*** 327,341 ****
public final short CHOICE = 0;
public final short SEQUENCE = 1;
/**
* Connectors in one model group is guaranteed to be the same.
! * <p/>
! * <p/>
* IOW, you'll never see an event sequence like (a|b,c)
- *
- * @return {@link #CHOICE} or {@link #SEQUENCE}.
*/
public void connector(short connectorType) throws SAXException;
public final short OCCURENCE_ZERO_OR_MORE = 0;
public final short OCCURENCE_ONE_OR_MORE = 1;
--- 327,339 ----
public final short CHOICE = 0;
public final short SEQUENCE = 1;
/**
* Connectors in one model group is guaranteed to be the same.
! * <p>
! * <p>
* IOW, you'll never see an event sequence like (a|b,c)
*/
public void connector(short connectorType) throws SAXException;
public final short OCCURENCE_ZERO_OR_MORE = 0;
public final short OCCURENCE_ONE_OR_MORE = 1;
< prev index next >