01: /*--
02:
03: $Id: IllegalTargetException.java,v 1.14 2004/02/06 09:28:30 jhunter Exp $
04:
05: Copyright (C) 2000-2004 Jason Hunter & Brett McLaughlin.
06: All rights reserved.
07:
08: Redistribution and use in source and binary forms, with or without
09: 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 a target is supplied in construction of a JDOM {@link
61: * ProcessingInstruction}, and that name breaks XML naming conventions.
62: *
63: * @version $Revision: 1.14 $, $Date: 2004/02/06 09:28:30 $
64: * @author Brett McLaughlin
65: */
66: public class IllegalTargetException extends IllegalArgumentException {
67:
68: private static final String CVS_ID = "@(#) $RCSfile: IllegalTargetException.java,v $ $Revision: 1.14 $ $Date: 2004/02/06 09:28:30 $ $Name: jdom_1_0 $";
69:
70: /**
71: * This will create an <code>Exception</code> indicating
72: * that the specified target is illegal for the
73: * <code>{@link ProcessingInstruction}</code> it was supplied to.
74: *
75: * @param target <code>String</code> target that breaks rules.
76: * @param reason <code>String</code> message or reason target is illegal.
77: */
78: IllegalTargetException(String target, String reason) {
79: super (
80: new StringBuffer()
81: .append("The target \"")
82: .append(target)
83: .append(
84: "\" is not legal for JDOM/XML Processing Instructions: ")
85: .append(reason).append(".").toString());
86: }
87:
88: /**
89: * Creates an exception with the specified error message.
90: *
91: * @param reason cause of the problem
92: */
93: public IllegalTargetException(String reason) {
94: super(reason);
95: }
96: }
|