01: /* ====================================================================
02: The Jicarilla Software License
03:
04: Copyright (c) 2003 Leo Simons.
05: All rights reserved.
06:
07: Permission is hereby granted, free of charge, to any person obtaining
08: a copy of this software and associated documentation files (the
09: "Software"), to deal in the Software without restriction, including
10: without limitation the rights to use, copy, modify, merge, publish,
11: distribute, sublicense, and/or sell copies of the Software, and to
12: permit persons to whom the Software is furnished to do so, subject to
13: the following conditions:
14:
15: The above copyright notice and this permission notice shall be
16: included in all copies or substantial portions of the Software.
17:
18: THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
19: EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
20: MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
21: IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
22: CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
23: TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
24: SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
25: ==================================================================== */
26: package org.jicarilla.collections;
27:
28: import java.util.Collection;
29: import java.util.Iterator;
30: import java.util.List;
31: import java.util.Map;
32:
33: /**
34: * Representation of hierarchical data similar to DOM, JDOM,
35: * etc, but much more similar to the normal java collections.
36: * Use the Map interface for accessing the Node attributes,
37: * and use the modified List interface for accessing the Node
38: * children. The name and contents javabean properties allow
39: * full interoperability with DOM.
40: *
41: * @author <a href="lsimons at jicarilla dot org">Leo Simons</a>
42: * @version $Id: Node.java,v 1.3 2004/02/26 16:51:54 lsimons Exp $
43: */
44: public interface Node extends Map {
45: String getName();
46:
47: String setName(String s);
48:
49: Object getContents();
50:
51: Object setContents(Object o);
52:
53: // override Map
54: //boolean isEmpty();
55: //void clear();
56: //int size();
57:
58: // List
59: boolean addChild(Node n);
60:
61: boolean addChildren(Collection c);
62:
63: boolean containsChild(Node n);
64:
65: boolean containsChildren(Collection c);
66:
67: Iterator iterator();
68:
69: boolean removeChild(Node n);
70:
71: boolean removeChildren(Collection c);
72:
73: Node[] childrenToArray();
74:
75: Node[] childrenToArray(Object[] o);
76:
77: List childrenToList();
78: }
|