1 | /*--
|
---|
2 |
|
---|
3 | $Id: IllegalDataException.java,v 1.14 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 illegal text is supplied to a JDOM construct.
|
---|
61 | *
|
---|
62 | * @version $Revision: 1.14 $, $Date: 2007/11/10 05:28:59 $
|
---|
63 | * @author Brett McLaughlin
|
---|
64 | * @author Elliotte Rusty Harold
|
---|
65 | */
|
---|
66 | public class IllegalDataException extends IllegalArgumentException {
|
---|
67 |
|
---|
68 | /**
|
---|
69 | * This will create an <code>Exception</code> indicating
|
---|
70 | * that the specified data is illegal for the construct
|
---|
71 | * it was supplied to.
|
---|
72 | *
|
---|
73 | * @param data <code>String</code> data that breaks rules.
|
---|
74 | * @param construct <code>String</code> construct that data is illegal for.
|
---|
75 | * @param reason <code>String</code> message or reason data is illegal.
|
---|
76 | */
|
---|
77 | IllegalDataException(String data, String construct, String reason) {
|
---|
78 | super(new StringBuffer()
|
---|
79 | .append("The data \"")
|
---|
80 | .append(data)
|
---|
81 | .append("\" is not legal for a JDOM ")
|
---|
82 | .append(construct)
|
---|
83 | .append(": ")
|
---|
84 | .append(reason)
|
---|
85 | .append(".")
|
---|
86 | .toString());
|
---|
87 | }
|
---|
88 |
|
---|
89 | /**
|
---|
90 | * This will create an <code>Exception</code> indicating
|
---|
91 | * that the specified data is illegal for the construct
|
---|
92 | * it was supplied to.
|
---|
93 | *
|
---|
94 | * @param data <code>String</code> data that breaks rules.
|
---|
95 | * @param construct <code>String</code> construct that data is illegal for.
|
---|
96 | */
|
---|
97 | IllegalDataException(String data, String construct) {
|
---|
98 | super(new StringBuffer()
|
---|
99 | .append("The data \"")
|
---|
100 | .append(data)
|
---|
101 | .append("\" is not legal for a JDOM ")
|
---|
102 | .append(construct)
|
---|
103 | .append(".")
|
---|
104 | .toString());
|
---|
105 | }
|
---|
106 | }
|
---|