1 ////////////////////////////////////////////////////////////////////////////////
2 // MillScript: an Open Spice interpreter and batch website creation tool
3 // Copyright (C) 2001-2004 Open World Ltd
4 //
5 // This file is part of MillScript.
6 //
7 // MillScript is free software; you can redistribute it and/or modify it under
8 // the terms of the GNU General Public License as published by the Free
9 // Software Foundation; either version 2 of the License, or (at your option)
10 // any later version.
11 //
12 // MillScript is distributed in the hope that it will be useful, but WITHOUT
13 // ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
14 // FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
15 // more details.
16 //
17 // You should have received a copy of the GNU General Public License along with
18 // MillScript; if not, write to the Free Software Foundation, Inc., 59 Temple
19 // Place, Suite 330, Boston, MA 02111-1307 USA
20 ////////////////////////////////////////////////////////////////////////////////
21 package org.millscript.millscript.datatypes;
22
23 import org.millscript.commons.util.IList;
24
25 /**
26 * The ListAware interface should be implemented by any class which is not
27 * directly a List, but may wrap one. Such an object could be viewed as a List
28 * directly by ignoring the wrapping object. e.g. an XML element, which can be
29 * viewed as a List of its children.
30 */
31 public interface ListAware extends MapAware {
32
33 /**
34 * Returns this object as a List.
35 *
36 * @return a list containing all the items in this object.
37 */
38 IList asList();
39
40 /**
41 * Returns a new object wrapping the supplied List.
42 *
43 * @param x a List to wrap in a copy of this object.
44 * @return an Object wrapping the supplied list.
45 */
46 Object asOriginal( final IList< ? > x );
47
48 /**
49 * Compares the specified object with this object, to see if they are the
50 * same type.
51 *
52 * @param x Object to be compared for type with this object
53 * @return <code>true</code> if the specified object is the same type as
54 * this object
55 */
56 boolean sameAs( final Object x );
57
58 }