src/java.base/share/classes/jdk/internal/org/xml/sax/DTDHandler.java
changeset 52825 2077a5437d43
parent 47216 71c04702a3d5
equal deleted inserted replaced
52824:52a692760109 52825:2077a5437d43
     1 /*
     1 /*
     2  * Copyright (c) 2000, 2012, Oracle and/or its affiliates. All rights reserved.
     2  * Copyright (c) 2000, 2018, Oracle and/or its affiliates. All rights reserved.
     3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
     3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
     4  *
     4  *
     5  * This code is free software; you can redistribute it and/or modify it
     5  * This code is free software; you can redistribute it and/or modify it
     6  * under the terms of the GNU General Public License version 2 only, as
     6  * under the terms of the GNU General Public License version 2 only, as
     7  * published by the Free Software Foundation.  Oracle designates this
     7  * published by the Free Software Foundation.  Oracle designates this
    71  * @author David Megginson
    71  * @author David Megginson
    72  * @see org.xml.sax.XMLReader#setDTDHandler
    72  * @see org.xml.sax.XMLReader#setDTDHandler
    73  */
    73  */
    74 public interface DTDHandler {
    74 public interface DTDHandler {
    75 
    75 
    76 
       
    77     /**
    76     /**
    78      * Receive notification of a notation declaration event.
    77      * Receive notification of a notation declaration event.
    79      *
    78      *
    80      * <p>It is up to the application to record the notation for later
    79      * <p>It is up to the application to record the notation for later
    81      * reference, if necessary;
    80      * reference, if necessary;
   134                                              String publicId,
   133                                              String publicId,
   135                                              String systemId,
   134                                              String systemId,
   136                                              String notationName)
   135                                              String notationName)
   137         throws SAXException;
   136         throws SAXException;
   138 
   137 
       
   138     // from SAX2 extension DeclHandler
       
   139     /**
       
   140      * Receive notification of the start of DTD declarations.
       
   141      *
       
   142      * The start/endDTD events appear within the start/endDocument events
       
   143      * from ContentHandler.
       
   144      *
       
   145      * @param name The document type name.
       
   146      * @param publicId The declared public identifier for the
       
   147      *        external DTD subset, or null if none was declared.
       
   148      * @param systemId The declared system identifier for the
       
   149      *        external DTD subset, or null if none was declared.
       
   150      *        (Note that this is not resolved against the document
       
   151      *        base URI.)
       
   152      * @throws SAXException the event receiver may throw an exception during processing
       
   153      */
       
   154     default public void startDTD (String name, String publicId, String systemId)
       
   155         throws SAXException
       
   156     {
       
   157         // no op
       
   158     }
       
   159 
       
   160     // Custom API for the Properties
       
   161 
       
   162     /**
       
   163      * Receive notification of the start of DTD internal subset.
       
   164      *
       
   165      * @throws SAXException the event receiver may throw an exception during processing
       
   166      */
       
   167     default public void startInternalSub () throws SAXException
       
   168     {
       
   169         // no op
       
   170     }
   139 }
   171 }
   140 
   172 
   141 // end of DTDHandler.java
   173 // end of DTDHandler.java