|
0
|
1 /*--
|
|
|
2
|
|
|
3 $Id: IllegalAddException.java,v 1.26 2007/11/10 05:28:59 jhunter Exp $
|
|
|
4
|
|
|
5 Copyright (C) 2000-2007 Jason Hunter & Brett McLaughlin.
|
|
|
6 All rights reserved.
|
|
|
7
|
|
|
8 Redistribution and use in source and binary forms, with or without
|
|
|
9 modification, are permitted provided that the following conditions
|
|
|
10 are met:
|
|
|
11
|
|
|
12 1. Redistributions of source code must retain the above copyright
|
|
|
13 notice, this list of conditions, and the following disclaimer.
|
|
|
14
|
|
|
15 2. Redistributions in binary form must reproduce the above copyright
|
|
|
16 notice, this list of conditions, and the disclaimer that follows
|
|
|
17 these conditions in the documentation and/or other materials
|
|
|
18 provided with the distribution.
|
|
|
19
|
|
|
20 3. The name "JDOM" must not be used to endorse or promote products
|
|
|
21 derived from this software without prior written permission. For
|
|
|
22 written permission, please contact <request_AT_jdom_DOT_org>.
|
|
|
23
|
|
|
24 4. Products derived from this software may not be called "JDOM", nor
|
|
|
25 may "JDOM" appear in their name, without prior written permission
|
|
|
26 from the JDOM Project Management <request_AT_jdom_DOT_org>.
|
|
|
27
|
|
|
28 In addition, we request (but do not require) that you include in the
|
|
|
29 end-user documentation provided with the redistribution and/or in the
|
|
|
30 software itself an acknowledgement equivalent to the following:
|
|
|
31 "This product includes software developed by the
|
|
|
32 JDOM Project (http://www.jdom.org/)."
|
|
|
33 Alternatively, the acknowledgment may be graphical using the logos
|
|
|
34 available at http://www.jdom.org/images/logos.
|
|
|
35
|
|
|
36 THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
|
|
|
37 WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
|
|
38 OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
|
|
39 DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT
|
|
|
40 CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
|
|
41 SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
|
|
|
42 LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
|
|
|
43 USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
|
|
|
44 ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
|
|
|
45 OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
|
|
|
46 OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
|
47 SUCH DAMAGE.
|
|
|
48
|
|
|
49 This software consists of voluntary contributions made by many
|
|
|
50 individuals on behalf of the JDOM Project and was originally
|
|
|
51 created by Jason Hunter <jhunter_AT_jdom_DOT_org> and
|
|
|
52 Brett McLaughlin <brett_AT_jdom_DOT_org>. For more information
|
|
|
53 on the JDOM Project, please see <http://www.jdom.org/>.
|
|
|
54
|
|
|
55 */
|
|
|
56
|
|
|
57 package org.jdom;
|
|
|
58
|
|
|
59 /**
|
|
|
60 * Thrown when trying to add a illegal object to a JDOM construct.
|
|
|
61 *
|
|
|
62 * @version $Revision: 1.26 $, $Date: 2007/11/10 05:28:59 $
|
|
|
63 * @author Brett McLaughlin
|
|
|
64 * @author Jason Hunter
|
|
|
65 */
|
|
|
66 public class IllegalAddException extends IllegalArgumentException {
|
|
|
67
|
|
|
68 private static final String CVS_ID =
|
|
|
69 "@(#) $RCSfile: IllegalAddException.java,v $ $Revision: 1.26 $ $Date: 2007/11/10 05:28:59 $ $Name: jdom_1_1_1 $";
|
|
|
70
|
|
|
71 /**
|
|
|
72 * This will create an <code>Exception</code> indicating
|
|
|
73 * that the addition of the <code>{@link Attribute}</code>
|
|
|
74 * to the <code>{@link Element}</code> is illegal.
|
|
|
75 *
|
|
|
76 * @param base <code>Element</code> that <code>Attribute</code>
|
|
|
77 * couldn't be added to
|
|
|
78 * @param added <code>Attribute</code> that could not be added
|
|
|
79 * @param reason cause of the problem
|
|
|
80 */
|
|
|
81 IllegalAddException(Element base, Attribute added, String reason) {
|
|
|
82 super(new StringBuffer()
|
|
|
83 .append("The attribute \"")
|
|
|
84 .append(added.getQualifiedName())
|
|
|
85 .append("\" could not be added to the element \"")
|
|
|
86 .append(base.getQualifiedName())
|
|
|
87 .append("\": ")
|
|
|
88 .append(reason)
|
|
|
89 .toString());
|
|
|
90 }
|
|
|
91
|
|
|
92 /**
|
|
|
93 * This will create an <code>Exception</code> indicating
|
|
|
94 * that the addition of the <code>{@link Element}</code>
|
|
|
95 * to parent is illegal.
|
|
|
96 *
|
|
|
97 * @param base <code>Element</code> that the child
|
|
|
98 * couldn't be added to
|
|
|
99 * @param added <code>Element</code> that could not be added
|
|
|
100 * @param reason cause of the problem
|
|
|
101 */
|
|
|
102 IllegalAddException(Element base, Element added, String reason) {
|
|
|
103 super(new StringBuffer()
|
|
|
104 .append("The element \"")
|
|
|
105 .append(added.getQualifiedName())
|
|
|
106 .append("\" could not be added as a child of \"")
|
|
|
107 .append(base.getQualifiedName())
|
|
|
108 .append("\": ")
|
|
|
109 .append(reason)
|
|
|
110 .toString());
|
|
|
111 }
|
|
|
112
|
|
|
113 /**
|
|
|
114 * This will create an <code>Exception</code> indicating
|
|
|
115 * that the addition of the <code>{@link Element}</code>
|
|
|
116 * to the <code>{@link Document}</code> is illegal.
|
|
|
117 *
|
|
|
118 * @param added <code>Element</code> that could not be added
|
|
|
119 * @param reason cause of the problem
|
|
|
120 */
|
|
|
121 IllegalAddException(Element added, String reason) {
|
|
|
122 super(new StringBuffer()
|
|
|
123 .append("The element \"")
|
|
|
124 .append(added.getQualifiedName())
|
|
|
125 .append("\" could not be added as the root of the document: ")
|
|
|
126 .append(reason)
|
|
|
127 .toString());
|
|
|
128 }
|
|
|
129
|
|
|
130 /**
|
|
|
131 * This will create an <code>Exception</code> indicating
|
|
|
132 * that the addition of the <code>{@link ProcessingInstruction}</code>
|
|
|
133 * to the <code>{@link Element}</code> is illegal.
|
|
|
134 *
|
|
|
135 * @param base <code>Element</code> that the
|
|
|
136 * <code>ProcessingInstruction</code> couldn't be added to
|
|
|
137 * @param added <code>ProcessingInstruction</code> that could not be added
|
|
|
138 * @param reason cause of the problem
|
|
|
139 */
|
|
|
140 IllegalAddException(Element base, ProcessingInstruction added,
|
|
|
141 String reason) {
|
|
|
142 super(new StringBuffer()
|
|
|
143 .append("The PI \"")
|
|
|
144 .append(added.getTarget())
|
|
|
145 .append("\" could not be added as content to \"")
|
|
|
146 .append(base.getQualifiedName())
|
|
|
147 .append("\": ")
|
|
|
148 .append(reason)
|
|
|
149 .toString());
|
|
|
150 }
|
|
|
151
|
|
|
152 /**
|
|
|
153 * This will create an <code>Exception</code> indicating
|
|
|
154 * that the addition of the <code>{@link ProcessingInstruction}</code>
|
|
|
155 * to the <code>{@link Document}</code> is illegal.
|
|
|
156 *
|
|
|
157 * @param added <code>ProcessingInstruction</code> that could not be added
|
|
|
158 * @param reason cause of the problem
|
|
|
159 */
|
|
|
160 IllegalAddException(ProcessingInstruction added,
|
|
|
161 String reason) {
|
|
|
162 super(new StringBuffer()
|
|
|
163 .append("The PI \"")
|
|
|
164 .append(added.getTarget())
|
|
|
165 .append("\" could not be added to the top level of the document: ")
|
|
|
166 .append(reason)
|
|
|
167 .toString());
|
|
|
168 }
|
|
|
169
|
|
|
170 /**
|
|
|
171 * This will create an <code>Exception</code> indicating
|
|
|
172 * that the addition of the <code>{@link Comment}</code>
|
|
|
173 * to the <code>{@link Element}</code> is illegal.
|
|
|
174 *
|
|
|
175 * @param base <code>Element</code> that the <code>Comment</code>
|
|
|
176 * couldn't be added to
|
|
|
177 * @param added <code>Comment</code> that could not be added
|
|
|
178 * @param reason cause of the problem
|
|
|
179 */
|
|
|
180 IllegalAddException(Element base, Comment added, String reason) {
|
|
|
181 super(new StringBuffer()
|
|
|
182 .append("The comment \"")
|
|
|
183 .append(added.getText())
|
|
|
184 .append("\" could not be added as content to \"")
|
|
|
185 .append(base.getQualifiedName())
|
|
|
186 .append("\": ")
|
|
|
187 .append(reason)
|
|
|
188 .toString());
|
|
|
189 }
|
|
|
190
|
|
|
191
|
|
|
192 /**
|
|
|
193 * This will create an <code>Exception</code> indicating
|
|
|
194 * that the addition of the <code>{@link CDATA}</code>
|
|
|
195 *
|
|
|
196 * @param base <code>Element</code> that the <code>CDATA</code>
|
|
|
197 * couldn't be added to
|
|
|
198 * @param added <code>CDATA</code> that could not be added
|
|
|
199 * @param reason cause of the problem
|
|
|
200 */
|
|
|
201 IllegalAddException(Element base, CDATA added, String reason) {
|
|
|
202 super(new StringBuffer()
|
|
|
203 .append("The CDATA \"")
|
|
|
204 .append(added.getText())
|
|
|
205 .append("\" could not be added as content to \"")
|
|
|
206 .append(base.getQualifiedName())
|
|
|
207 .append("\": ")
|
|
|
208 .append(reason)
|
|
|
209 .toString());
|
|
|
210 }
|
|
|
211
|
|
|
212
|
|
|
213 /**
|
|
|
214 * This will create an <code>Exception</code> indicating
|
|
|
215 * that the addition of the <code>{@link Text}</code>
|
|
|
216 * to the <code>{@link Element}</code> is illegal.
|
|
|
217 *
|
|
|
218 * @param base <code>Element</code> that the <code>Comment</code>
|
|
|
219 * couldn't be added to
|
|
|
220 * @param added <code>Text</code> that could not be added
|
|
|
221 * @param reason cause of the problem
|
|
|
222 */
|
|
|
223 IllegalAddException(Element base, Text added, String reason) {
|
|
|
224 super(new StringBuffer()
|
|
|
225 .append("The Text \"")
|
|
|
226 .append(added.getText())
|
|
|
227 .append("\" could not be added as content to \"")
|
|
|
228 .append(base.getQualifiedName())
|
|
|
229 .append("\": ")
|
|
|
230 .append(reason)
|
|
|
231 .toString());
|
|
|
232 }
|
|
|
233
|
|
|
234 /**
|
|
|
235 * This will create an <code>Exception</code> indicating
|
|
|
236 * that the addition of the <code>{@link Comment}</code>
|
|
|
237 * to the <code>{@link Document}</code> is illegal.
|
|
|
238 *
|
|
|
239 * @param added <code>Comment</code> that could not be added
|
|
|
240 * @param reason cause of the problem
|
|
|
241 */
|
|
|
242 IllegalAddException(Comment added, String reason) {
|
|
|
243 super(new StringBuffer()
|
|
|
244 .append("The comment \"")
|
|
|
245 .append(added.getText())
|
|
|
246 .append("\" could not be added to the top level of the document: ")
|
|
|
247 .append(reason)
|
|
|
248 .toString());
|
|
|
249 }
|
|
|
250
|
|
|
251 /**
|
|
|
252 * This will create an <code>Exception</code> indicating
|
|
|
253 * that the addition of the <code>{@link EntityRef}</code>
|
|
|
254 * to the <code>{@link Element}</code> is illegal.
|
|
|
255 *
|
|
|
256 * @param base <code>Element</code> that the <code>EntityRef</code>
|
|
|
257 * couldn't be added to
|
|
|
258 * @param added <code>EntityRef</code> reference that could not be added
|
|
|
259 * @param reason cause of the problem
|
|
|
260 */
|
|
|
261 IllegalAddException(Element base, EntityRef added, String reason) {
|
|
|
262 super(new StringBuffer()
|
|
|
263 .append("The entity reference\"")
|
|
|
264 .append(added.getName())
|
|
|
265 .append("\" could not be added as content to \"")
|
|
|
266 .append(base.getQualifiedName())
|
|
|
267 .append("\": ")
|
|
|
268 .append(reason)
|
|
|
269 .toString());
|
|
|
270 }
|
|
|
271
|
|
|
272 /**
|
|
|
273 * This will create an <code>Exception</code> indicating
|
|
|
274 * that the addition of the <code>{@link Namespace}</code>
|
|
|
275 * to the <code>{@link Element}</code> is illegal.
|
|
|
276 *
|
|
|
277 * @param base <code>Element</code> that the <code>Namespace</code>
|
|
|
278 * couldn't be added to
|
|
|
279 * @param added <code>Namespace</code> that could not be added
|
|
|
280 * @param reason cause of the problem
|
|
|
281 */
|
|
|
282 IllegalAddException(Element base, Namespace added, String reason) {
|
|
|
283 super(new StringBuffer()
|
|
|
284 .append("The namespace xmlns")
|
|
|
285 .append((added.getPrefix() == null ||
|
|
|
286 added.getPrefix().equals("")) ? "="
|
|
|
287 : ":" + added.getPrefix() + "=")
|
|
|
288 .append("\"")
|
|
|
289 .append(added.getURI())
|
|
|
290 .append("\" could not be added as a namespace to \"")
|
|
|
291 .append(base.getQualifiedName())
|
|
|
292 .append("\": ")
|
|
|
293 .append(reason)
|
|
|
294 .toString());
|
|
|
295 }
|
|
|
296
|
|
|
297 /**
|
|
|
298 * This will create an <code>Exception</code> indicating
|
|
|
299 * that the addition of the <code>{@link DocType}</code>
|
|
|
300 * to the <code>{@link Document}</code> is illegal.
|
|
|
301 *
|
|
|
302 * @param added <code>DocType</code> that could not be added
|
|
|
303 * @param reason cause of the problem
|
|
|
304 */
|
|
|
305 IllegalAddException(DocType added, String reason) {
|
|
|
306 super(new StringBuffer()
|
|
|
307 .append("The DOCTYPE ")
|
|
|
308 .append(added.toString())
|
|
|
309 .append(" could not be added to the document: ")
|
|
|
310 .append(reason)
|
|
|
311 .toString());
|
|
|
312 }
|
|
|
313
|
|
|
314 /**
|
|
|
315 * This will create an <code>Exception</code> with the specified
|
|
|
316 * error message.
|
|
|
317 *
|
|
|
318 * @param reason cause of the problem
|
|
|
319 */
|
|
|
320 public IllegalAddException(String reason) {
|
|
|
321 super(reason);
|
|
|
322 }
|
|
|
323 }
|
