1 /* |
1 /* |
2 * reserved comment block |
2 * reserved comment block |
3 * DO NOT REMOVE OR ALTER! |
3 * DO NOT REMOVE OR ALTER! |
4 */ |
4 */ |
5 /* |
5 /* |
6 * Copyright 2003-2004 The Apache Software Foundation. |
6 * Licensed to the Apache Software Foundation (ASF) under one |
7 * |
7 * or more contributor license agreements. See the NOTICE file |
8 * Licensed under the Apache License, Version 2.0 (the "License"); |
8 * distributed with this work for additional information |
|
9 * regarding copyright ownership. The ASF licenses this file |
|
10 * to you under the Apache License, Version 2.0 (the "License"); |
9 * you may not use this file except in compliance with the License. |
11 * you may not use this file except in compliance with the License. |
10 * You may obtain a copy of the License at |
12 * You may obtain a copy of the License at |
11 * |
13 * |
12 * http://www.apache.org/licenses/LICENSE-2.0 |
14 * http://www.apache.org/licenses/LICENSE-2.0 |
13 * |
15 * |
108 * @param mappings NamespaceMappings |
110 * @param mappings NamespaceMappings |
109 */ |
111 */ |
110 public void setNamespaceMappings(NamespaceMappings mappings); |
112 public void setNamespaceMappings(NamespaceMappings mappings); |
111 |
113 |
112 /** |
114 /** |
113 * Flush any pending events currently queued up in the serializer. This will |
115 * A SerializationHandler accepts SAX-like events, so |
114 * flush any input that the serializer has which it has not yet sent as |
116 * it can accumulate attributes or namespace nodes after |
115 * output. |
117 * a startElement(). |
|
118 * <p> |
|
119 * If the SerializationHandler has a Writer or OutputStream, |
|
120 * a call to this method will flush such accumulated |
|
121 * events as a closed start tag for an element. |
|
122 * <p> |
|
123 * If the SerializationHandler wraps a ContentHandler, |
|
124 * a call to this method will flush such accumulated |
|
125 * events as a SAX (not SAX-like) calls to |
|
126 * startPrefixMapping() and startElement(). |
|
127 * <p> |
|
128 * If one calls endDocument() then one need not call |
|
129 * this method since a call to endDocument() will |
|
130 * do what this method does. However, in some |
|
131 * circumstances, such as with document fragments, |
|
132 * endDocument() is not called and it may be |
|
133 * necessary to call this method to flush |
|
134 * any pending events. |
|
135 * <p> |
|
136 * For performance reasons this method should not be called |
|
137 * very often. |
116 */ |
138 */ |
117 public void flushPending() throws SAXException; |
139 public void flushPending() throws SAXException; |
118 |
140 |
119 /** |
141 /** |
120 * Default behavior is to expand DTD entities, |
142 * Default behavior is to expand DTD entities, |