KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > netbeans > modules > xml > xam > ComponentUpdater


1 /*
2  * The contents of this file are subject to the terms of the Common Development
3  * and Distribution License (the License). You may not use this file except in
4  * compliance with the License.
5  *
6  * You can obtain a copy of the License at http://www.netbeans.org/cddl.html
7  * or http://www.netbeans.org/cddl.txt.
8  *
9  * When distributing Covered Code, include this CDDL Header Notice in each file
10  * and include the License file at http://www.netbeans.org/cddl.txt.
11  * If applicable, add the following below the CDDL Header, with the fields
12  * enclosed by brackets [] replaced by your own identifying information:
13  * "Portions Copyrighted [year] [name of copyright owner]"
14  *
15  * The Original Software is NetBeans. The Initial Developer of the Original
16  * Software is Sun Microsystems, Inc. Portions Copyright 1997-2006 Sun
17  * Microsystems, Inc. All Rights Reserved.
18  */
19
20 package org.netbeans.modules.xml.xam;
21
22 /**
23  * Updater for children list of a component.
24  *
25  * @author nn136682
26  */
27 public interface ComponentUpdater<C extends Component> {
28     public enum Operation { ADD, REMOVE };
29     
30     /**
31      * Updates children list.
32      *
33      * @param target component to be updated
34      * @param child component to be added or removed.
35      * @param operation add or remove; if null, no update should happen, only
36      * query for possibility the update.
37      */
38     void update(C target, C child, Operation operation);
39     
40     /**
41      * Updates children list.
42      *
43      * @param target component to be updated
44      * @param child component to be added or removed.
45      * @param index of child component to be added or removed.
46      * @param operation add or remove; if null, no update should happen, only
47      * query for possibility the update.
48      */
49     void update(C target, C child, int index, Operation operation);
50     
51     /**
52      * Provide capability to query for updatability.
53      */
54     interface Query<C extends Component> {
55         /**
56          * Check if a component can be added to target component.
57          *
58          * @param target component to be updated
59          * @param child component to be added.
60          */
61         boolean canAdd(C target, Component child);
62     }
63 }
64
Popular Tags