01: /*
02: * Copyright (c) 2002-2007 JGoodies Karsten Lentzsch. All Rights Reserved.
03: *
04: * Redistribution and use in source and binary forms, with or without
05: * modification, are permitted provided that the following conditions are met:
06: *
07: * o Redistributions of source code must retain the above copyright notice,
08: * this list of conditions and the following disclaimer.
09: *
10: * o Redistributions in binary form must reproduce the above copyright notice,
11: * this list of conditions and the following disclaimer in the documentation
12: * and/or other materials provided with the distribution.
13: *
14: * o Neither the name of JGoodies Karsten Lentzsch nor the names of
15: * its contributors may be used to endorse or promote products derived
16: * from this software without specific prior written permission.
17: *
18: * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
19: * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
20: * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
21: * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
22: * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
23: * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
24: * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
25: * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
26: * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
27: * OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
28: * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
29: */
30:
31: package com.jgoodies.binding.list;
32:
33: import java.util.List;
34:
35: import javax.swing.ListModel;
36:
37: /**
38: * Combines the {@link List} and {@link ListModel} interfaces.
39: * Implementations can be used to bind lists to list-based
40: * user interface components like <code>JList</code>, <code>JTable</code>
41: * and <code>JComboBox</code>.<p>
42: *
43: * The JGoodies Data Binding ships with two predefined implementations:
44: * <code>ArrayListModel</code> and <code>LinkedListModel</code>.<p>
45: *
46: * See also the class comment in {@link SelectionInList} that discusses
47: * the advantages you gain if you add <code>ListModel</code> capabilities
48: * to a <code>List</code>.<p>
49: *
50: * TODO: Check if this type is really necessary; remove it if obsolete.
51: * Without doubt the ObservableList implementations are really useful,
52: * among others the predefined ArrayListModel and LinkedListModel.
53: * It's just that these implementations are typically used as List
54: * and exposed as ListModel, and so there may be no need for the ObservableList
55: * interface.
56: *
57: * @author Karsten Lentzsch
58: * @version $Revision: 1.5 $
59: *
60: * @see ArrayListModel
61: * @see LinkedListModel
62: * @see SelectionInList
63: *
64: * @param <E> the type of the list elements
65: */
66: public interface ObservableList<E> extends List<E>, ListModel {
67:
68: // This interface just combines List and ListModel and
69: // doesn't add anything new.
70:
71: }
|