API Overview API Index Package Overview Direct link to this page
JDK 1.6
  java.beans.beancontext. BeanContext View Javadoc
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116

/*
 * @(#)BeanContext.java	1.23 03/12/19
 *
 * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
 * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
 */

package java.beans.beancontext;

import java.beans.DesignMode;
import java.beans.Visibility;

import java.io.InputStream;
import java.io.IOException;

import java.net.URL;

import java.util.Collection;
import java.util.Locale;

/**
 * <p>
 * The BeanContext acts a logical hierarchical container for JavaBeans.
 * </p>
 *
 * @author Laurence P. G. Cable
 * @version 1.23, 12/19/03
 * @since 1.2
 *
 * @see java.beans.Beans
 * @see java.beans.beancontext.BeanContextChild
 * @see java.beans.beancontext.BeanContextMembershipListener
 * @see java.beans.PropertyChangeEvent
 * @see java.beans.VetoableChangeEvent
 * @see java.beans.DesignMode
 * @see java.beans.Visibility
 * @see java.util.Collection
 */

public interface BeanContext extends BeanContextChild, Collection, DesignMode, Visibility {

    /**
     * Instantiate the javaBean named as a 
     * child of this <code>BeanContext</code>.
     * The implementation of the JavaBean is 
     * derived from the value of the beanName parameter, 
     * and is defined by the 
     * <code>java.beans.Beans.instantiate()</code> method.
     *
     * @param beanName The name of the JavaBean to instantiate 
     * as a child of this <code>BeanContext</code>
     * @throws <code>IOException</code>
     * @throws <code>ClassNotFoundException</code> if the class identified
     * by the beanName parameter is not found
     */
    Object instantiateChild(String beanName) throws IOException, ClassNotFoundException;

    /**
     * Analagous to <code>java.lang.ClassLoader.getResourceAsStream()</code>, 
     * this method allows a <code>BeanContext</code> implementation 
     * to interpose behavior between the child <code>Component</code> 
     * and underlying <code>ClassLoader</code>.
     * 
     * @param name the resource name
     * @param bcc the specified child
     * @return an <code>InputStream</code> for reading the resource, 
     * or <code>null</code> if the resource could not
     * be found.
     * @throws <code>IllegalArgumentException</code> if 
     * the resource is not valid
     */
    InputStream getResourceAsStream(String name, BeanContextChild bcc) throws IllegalArgumentException;

    /**
     * Analagous to <code>java.lang.ClassLoader.getResource()</code>, this
     * method allows a <code>BeanContext</code> implementation to interpose
     * behavior between the child <code>Component</code> 
     * and underlying <code>ClassLoader</code>.
     * 
     * @param name the resource name
     * @param bcc the specified child
     * @return a <code>URL</code> for the named 
     * resource for the specified child
     * @throws <code>IllegalArgumentException</code> 
     * if the resource is not valid
     */
    URL getResource(String name, BeanContextChild bcc) throws IllegalArgumentException;

     /**
      * Adds the specified <code>BeanContextMembershipListener</code> 
      * to receive <code>BeanContextMembershipEvents</code> from 
      * this <code>BeanContext</code> whenever it adds
      * or removes a child <code>Component</code>(s).
      * 
      * @param bcml the <code>BeanContextMembershipListener</code> to be added
      */
    void addBeanContextMembershipListener(BeanContextMembershipListener bcml);

     /**
      * Removes the specified <code>BeanContextMembershipListener</code> 
      * so that it no longer receives <code>BeanContextMembershipEvent</code>s 
      * when the child <code>Component</code>(s) are added or removed.
      * 
      * @param bcml the <code>BeanContextMembershipListener</code> 
      * to be removed
      */
    void removeBeanContextMembershipListener(BeanContextMembershipListener bcml);

    /**
     * This global lock is used by both <code>BeanContext</code> 
     * and <code>BeanContextServices</code> implementors 
     * to serialize changes in a <code>BeanContext</code> 
     * hierarchy and any service requests etc.
     */
    public static final Object globalHierarchyLock = new Object();
}

Generated By: JavaOnTracks Doclet 0.1.4     ©Thibaut Colar