123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323 |
- /*--
-
- $Id: IllegalAddException.java,v 1.26 2007/11/10 05:28:59 jhunter Exp $
-
- Copyright (C) 2000-2007 Jason Hunter & Brett McLaughlin.
- All rights reserved.
-
- Redistribution and use in source and binary forms, with or without
- modification, are permitted provided that the following conditions
- are met:
-
- 1. Redistributions of source code must retain the above copyright
- notice, this list of conditions, and the following disclaimer.
-
- 2. Redistributions in binary form must reproduce the above copyright
- notice, this list of conditions, and the disclaimer that follows
- these conditions in the documentation and/or other materials
- provided with the distribution.
-
- 3. The name "JDOM" must not be used to endorse or promote products
- derived from this software without prior written permission. For
- written permission, please contact <request_AT_jdom_DOT_org>.
-
- 4. Products derived from this software may not be called "JDOM", nor
- may "JDOM" appear in their name, without prior written permission
- from the JDOM Project Management <request_AT_jdom_DOT_org>.
-
- In addition, we request (but do not require) that you include in the
- end-user documentation provided with the redistribution and/or in the
- software itself an acknowledgement equivalent to the following:
- "This product includes software developed by the
- JDOM Project (http://www.jdom.org/)."
- Alternatively, the acknowledgment may be graphical using the logos
- available at http://www.jdom.org/images/logos.
-
- THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
- WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
- DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT
- CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
- SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
- USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
- ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
- OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
- SUCH DAMAGE.
-
- This software consists of voluntary contributions made by many
- individuals on behalf of the JDOM Project and was originally
- created by Jason Hunter <jhunter_AT_jdom_DOT_org> and
- Brett McLaughlin <brett_AT_jdom_DOT_org>. For more information
- on the JDOM Project, please see <http://www.jdom.org/>.
-
- */
-
- package org.jdom;
-
- /**
- * Thrown when trying to add a illegal object to a JDOM construct.
- *
- * @version $Revision: 1.26 $, $Date: 2007/11/10 05:28:59 $
- * @author Brett McLaughlin
- * @author Jason Hunter
- */
- public class IllegalAddException extends IllegalArgumentException {
-
- private static final String CVS_ID =
- "@(#) $RCSfile: IllegalAddException.java,v $ $Revision: 1.26 $ $Date: 2007/11/10 05:28:59 $ $Name: jdom_1_1 $";
-
- /**
- * This will create an <code>Exception</code> indicating
- * that the addition of the <code>{@link Attribute}</code>
- * to the <code>{@link Element}</code> is illegal.
- *
- * @param base <code>Element</code> that <code>Attribute</code>
- * couldn't be added to
- * @param added <code>Attribute</code> that could not be added
- * @param reason cause of the problem
- */
- IllegalAddException(Element base, Attribute added, String reason) {
- super(new StringBuffer()
- .append("The attribute \"")
- .append(added.getQualifiedName())
- .append("\" could not be added to the element \"")
- .append(base.getQualifiedName())
- .append("\": ")
- .append(reason)
- .toString());
- }
-
- /**
- * This will create an <code>Exception</code> indicating
- * that the addition of the <code>{@link Element}</code>
- * to parent is illegal.
- *
- * @param base <code>Element</code> that the child
- * couldn't be added to
- * @param added <code>Element</code> that could not be added
- * @param reason cause of the problem
- */
- IllegalAddException(Element base, Element added, String reason) {
- super(new StringBuffer()
- .append("The element \"")
- .append(added.getQualifiedName())
- .append("\" could not be added as a child of \"")
- .append(base.getQualifiedName())
- .append("\": ")
- .append(reason)
- .toString());
- }
-
- /**
- * This will create an <code>Exception</code> indicating
- * that the addition of the <code>{@link Element}</code>
- * to the <code>{@link Document}</code> is illegal.
- *
- * @param added <code>Element</code> that could not be added
- * @param reason cause of the problem
- */
- IllegalAddException(Element added, String reason) {
- super(new StringBuffer()
- .append("The element \"")
- .append(added.getQualifiedName())
- .append("\" could not be added as the root of the document: ")
- .append(reason)
- .toString());
- }
-
- /**
- * This will create an <code>Exception</code> indicating
- * that the addition of the <code>{@link ProcessingInstruction}</code>
- * to the <code>{@link Element}</code> is illegal.
- *
- * @param base <code>Element</code> that the
- * <code>ProcessingInstruction</code> couldn't be added to
- * @param added <code>ProcessingInstruction</code> that could not be added
- * @param reason cause of the problem
- */
- IllegalAddException(Element base, ProcessingInstruction added,
- String reason) {
- super(new StringBuffer()
- .append("The PI \"")
- .append(added.getTarget())
- .append("\" could not be added as content to \"")
- .append(base.getQualifiedName())
- .append("\": ")
- .append(reason)
- .toString());
- }
-
- /**
- * This will create an <code>Exception</code> indicating
- * that the addition of the <code>{@link ProcessingInstruction}</code>
- * to the <code>{@link Document}</code> is illegal.
- *
- * @param added <code>ProcessingInstruction</code> that could not be added
- * @param reason cause of the problem
- */
- IllegalAddException(ProcessingInstruction added,
- String reason) {
- super(new StringBuffer()
- .append("The PI \"")
- .append(added.getTarget())
- .append("\" could not be added to the top level of the document: ")
- .append(reason)
- .toString());
- }
-
- /**
- * This will create an <code>Exception</code> indicating
- * that the addition of the <code>{@link Comment}</code>
- * to the <code>{@link Element}</code> is illegal.
- *
- * @param base <code>Element</code> that the <code>Comment</code>
- * couldn't be added to
- * @param added <code>Comment</code> that could not be added
- * @param reason cause of the problem
- */
- IllegalAddException(Element base, Comment added, String reason) {
- super(new StringBuffer()
- .append("The comment \"")
- .append(added.getText())
- .append("\" could not be added as content to \"")
- .append(base.getQualifiedName())
- .append("\": ")
- .append(reason)
- .toString());
- }
-
-
- /**
- * This will create an <code>Exception</code> indicating
- * that the addition of the <code>{@link CDATA}</code>
- *
- * @param base <code>Element</code> that the <code>CDATA</code>
- * couldn't be added to
- * @param added <code>CDATA</code> that could not be added
- * @param reason cause of the problem
- */
- IllegalAddException(Element base, CDATA added, String reason) {
- super(new StringBuffer()
- .append("The CDATA \"")
- .append(added.getText())
- .append("\" could not be added as content to \"")
- .append(base.getQualifiedName())
- .append("\": ")
- .append(reason)
- .toString());
- }
-
-
- /**
- * This will create an <code>Exception</code> indicating
- * that the addition of the <code>{@link Text}</code>
- * to the <code>{@link Element}</code> is illegal.
- *
- * @param base <code>Element</code> that the <code>Comment</code>
- * couldn't be added to
- * @param added <code>Text</code> that could not be added
- * @param reason cause of the problem
- */
- IllegalAddException(Element base, Text added, String reason) {
- super(new StringBuffer()
- .append("The Text \"")
- .append(added.getText())
- .append("\" could not be added as content to \"")
- .append(base.getQualifiedName())
- .append("\": ")
- .append(reason)
- .toString());
- }
-
- /**
- * This will create an <code>Exception</code> indicating
- * that the addition of the <code>{@link Comment}</code>
- * to the <code>{@link Document}</code> is illegal.
- *
- * @param added <code>Comment</code> that could not be added
- * @param reason cause of the problem
- */
- IllegalAddException(Comment added, String reason) {
- super(new StringBuffer()
- .append("The comment \"")
- .append(added.getText())
- .append("\" could not be added to the top level of the document: ")
- .append(reason)
- .toString());
- }
-
- /**
- * This will create an <code>Exception</code> indicating
- * that the addition of the <code>{@link EntityRef}</code>
- * to the <code>{@link Element}</code> is illegal.
- *
- * @param base <code>Element</code> that the <code>EntityRef</code>
- * couldn't be added to
- * @param added <code>EntityRef</code> reference that could not be added
- * @param reason cause of the problem
- */
- IllegalAddException(Element base, EntityRef added, String reason) {
- super(new StringBuffer()
- .append("The entity reference\"")
- .append(added.getName())
- .append("\" could not be added as content to \"")
- .append(base.getQualifiedName())
- .append("\": ")
- .append(reason)
- .toString());
- }
-
- /**
- * This will create an <code>Exception</code> indicating
- * that the addition of the <code>{@link Namespace}</code>
- * to the <code>{@link Element}</code> is illegal.
- *
- * @param base <code>Element</code> that the <code>Namespace</code>
- * couldn't be added to
- * @param added <code>Namespace</code> that could not be added
- * @param reason cause of the problem
- */
- IllegalAddException(Element base, Namespace added, String reason) {
- super(new StringBuffer()
- .append("The namespace xmlns")
- .append((added.getPrefix() == null ||
- added.getPrefix().equals("")) ? "="
- : ":" + added.getPrefix() + "=")
- .append("\"")
- .append(added.getURI())
- .append("\" could not be added as a namespace to \"")
- .append(base.getQualifiedName())
- .append("\": ")
- .append(reason)
- .toString());
- }
-
- /**
- * This will create an <code>Exception</code> indicating
- * that the addition of the <code>{@link DocType}</code>
- * to the <code>{@link Document}</code> is illegal.
- *
- * @param added <code>DocType</code> that could not be added
- * @param reason cause of the problem
- */
- IllegalAddException(DocType added, String reason) {
- super(new StringBuffer()
- .append("The DOCTYPE ")
- .append(added.toString())
- .append(" could not be added to the document: ")
- .append(reason)
- .toString());
- }
-
- /**
- * This will create an <code>Exception</code> with the specified
- * error message.
- *
- * @param reason cause of the problem
- */
- public IllegalAddException(String reason) {
- super(reason);
- }
- }
|