KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > nextapp > echo2 > app > IllegalChildException


1 /*
2  * This file is part of the Echo Web Application Framework (hereinafter "Echo").
3  * Copyright (C) 2002-2005 NextApp, Inc.
4  *
5  * Version: MPL 1.1/GPL 2.0/LGPL 2.1
6  *
7  * The contents of this file are subject to the Mozilla Public License Version
8  * 1.1 (the "License"); you may not use this file except in compliance with
9  * the License. You may obtain a copy of the License at
10  * http://www.mozilla.org/MPL/
11  *
12  * Software distributed under the License is distributed on an "AS IS" basis,
13  * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
14  * for the specific language governing rights and limitations under the
15  * License.
16  *
17  * Alternatively, the contents of this file may be used under the terms of
18  * either the GNU General Public License Version 2 or later (the "GPL"), or
19  * the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
20  * in which case the provisions of the GPL or the LGPL are applicable instead
21  * of those above. If you wish to allow use of your version of this file only
22  * under the terms of either the GPL or the LGPL, and not to allow others to
23  * use your version of this file under the terms of the MPL, indicate your
24  * decision by deleting the provisions above and replace them with the notice
25  * and other provisions required by the GPL or the LGPL. If you do not delete
26  * the provisions above, a recipient may use your version of this file under
27  * the terms of any one of the MPL, the GPL or the LGPL.
28  */
29
30 package nextapp.echo2.app;
31
32 /**
33  * An exception thrown when attempting to add a child to the component
34  * hierarchy where either the parent is incompatible with the child or
35  * the child is incompatible with the parent. This exception may be thrown
36  * in cases such as attempting to add children to a component that does not
37  * support children (e.g., a <code>Label</code>), or adding too many children
38  * to an object (e.g., adding more than two children to a
39  * <code>SplitPane</code>.
40  */
41 public class IllegalChildException extends RuntimeException JavaDoc {
42     
43     private Component illegalChild;
44     private Component parent;
45     
46     /**
47      * Creates a new <code>IllegalChildException</code>.
48      *
49      * @param parent the parent component
50      * @param illegalChild the child that was attempted to be illegally added
51      */
52     protected IllegalChildException(Component parent, Component illegalChild) {
53         super("Child \"" + illegalChild + "\" illegally added to component \"" + parent + "\".");
54         this.illegalChild = illegalChild;
55         this.parent = parent;
56     }
57     
58     /**
59      * Returns the illegally added child.
60      *
61      * @return the child
62      */
63     public Component getIllegalChild() {
64         return illegalChild;
65     }
66     
67     /**
68      * Returns the parent component to which the child was to be added.
69      *
70      * @return the parent
71      */
72     public Component getParent() {
73         return parent;
74     }
75 }
Popular Tags