|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
ObjectControlBean
public abstract class ControlBean
The ControlBean class is an abstract base class for the JavaBean classes generated to support Workshop controls. The ControlBean class indirectly implements BeanContextProxy; the ControlBeanContext that it contains/scopes acts as that proxy. All support APIs (which may be called from derived derived subclasses or contextual services are generally marked as protected and have names that start with an underscore. This avoids the possibility that the name might conflict with a user-defined method on a control's public or extended (JCX) interface.
Field Summary | |
---|---|
protected Class |
_implClass
The control implementation class bound to this ControlBean |
Fields inherited from interface ControlBean |
---|
IDSeparator |
Constructor Summary | |
---|---|
protected |
ControlBean(ControlBeanContext context,
String id,
PropertyMap initProperties,
Class controlIntf)
|
Method Summary | ||
---|---|---|
void |
decodeImpl(Object impl)
Called during XMLDecoder reconstruction of a ControlBean. |
|
protected static void |
enforceVersionRequired(String intfName,
Version version,
VersionRequired versionRequired)
Enforces the VersionRequired annotation at runtime (called from each ControlBean). |
|
Object |
ensureControl()
Returns the target control instance associated with this ControlBean, performing lazy instantiation and initialization of the instance. |
|
protected Interceptor |
ensureInterceptor(String n)
Retrieves interceptor instances, creates them lazily. |
|
protected void |
firePropertyChange(PropertyKey propertyKey,
Object oldValue,
Object newValue)
Delivers a PropertyChangeEvent to any registered PropertyChangeListeners associated with the property referenced by the specified key. |
|
protected void |
fireVetoableChange(PropertyKey propertyKey,
Object oldValue,
Object newValue)
Delivers a PropertyChangeEvent to any registered VetoableChangeListeners associated with the property referenced by the specified key. |
|
protected PropertyMap |
getAnnotationMap(AnnotatedElement annotElem)
Returns the PropertyMap containing values associated with an AnnotatedElement. |
|
BeanContext |
getBeanContext()
Returns the nesting BeanContext for this ControlBean. |
|
ControlBeanContext |
getBeanContextProxy()
Return the BeanContextService proxy associated with this bean instance |
|
ControlBeanContext |
getControlBeanContext()
Returns the bean context instance associated with the this bean, as opposed to the parent context returned by the public getBeanContext() API. |
|
String |
getControlID()
Returns the control ID for this control |
|
Class |
getControlInterface()
Returns the public interface for this control. |
|
protected Object |
getControlProperty(PropertyKey key)
Returns a property on the ControlBean instance. |
|
protected Object |
getControlService(Class serviceClass,
Object selector)
Locates and obtains a context service from the BeanContextServices instance supporting this bean. |
|
protected
|
getEventNotifier(Class<T> eventSet)
Returns an EventNotifier/UnicastEventNotifier for this ControlBean for the target event set |
|
protected ImplInitializer |
getImplInitializer()
Obtains an instance of the appropriate ImplInitializer class |
|
protected String |
getLocalID()
Returns the local (parent-relative) ID for this ControlBean |
|
static Class |
getMostDerivedInterface(Class controlIntf)
Computes the most derived ControlInterface for the specified ControlExtension. |
|
protected String[] |
getParameterNames(Method m)
Returns the parameter names for a method on the ControlBean. |
|
protected PropertyChangeSupport |
getPropertyChangeSupport()
This protected version is only available to concrete subclasses that expose bound property support. |
|
protected abstract Map |
getPropertyMapCache()
Returns the local cache for ControlBean property maps. |
|
protected Object |
getRawControlProperty(PropertyKey key)
Returns a property on the ControlBean instance. |
|
protected VetoableChangeSupport |
getVetoableChangeSupport()
This protected version is only available to concrete subclasses that expose bound property support. |
|
protected void |
postInvoke(Method m,
Object[] args,
Object retval,
Throwable t)
The postInvoke method is called after all operations on the control. |
|
protected void |
postInvoke(Method m,
Object[] args,
Object retval,
Throwable t,
String[] interceptorNames,
String pivotedInterceptor)
The postInvoke method is called after all operations on the control. |
|
protected void |
preInvoke(Method m,
Object[] args)
The preinvoke method is called before all operations on the control. |
|
protected void |
preInvoke(Method m,
Object[] args,
String[] interceptorNames)
The preinvoke method is called before all operations on the control. |
|
void |
setBeanContext(BeanContext bc)
Called by the BeanContextProxy (_cbc) whenever the _parent_ context containing this control bean is changed. |
|
void |
setControlID(String id)
Sets the absolute controlID for this ControlBean. |
|
protected void |
setControlProperty(PropertyKey key,
Object o)
Sets a property on the ControlBean instance. |
|
protected
|
setEventNotifier(Class<T> eventSet,
T notifier)
Sets the EventNotifier for this ControlBean |
Methods inherited from class Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
protected Class _implClass
Constructor Detail |
---|
protected ControlBean(ControlBeanContext context, String id, PropertyMap initProperties, Class controlIntf)
context
- the containing ControlBeanContext. May be null, in which case the bean will attempt to
associate with an active context at runtime (via thread-locals).id
- initProperties
- controlIntf
- Method Detail |
---|
public final ControlBeanContext getBeanContextProxy()
getBeanContextProxy
in interface BeanContextProxy
public final BeanContext getBeanContext()
getBeanContext
in interface ControlBean
BeanContext
for the Java ControlBean.BeanContext
public final void setBeanContext(BeanContext bc)
bc
- the new parent context containing this control bean (not _cbc)public final String getControlID()
getControlID
in interface ControlBean
public final Class getControlInterface()
getControlInterface
in interface ControlBean
protected ImplInitializer getImplInitializer()
public Object ensureControl()
protected void preInvoke(Method m, Object[] args, String[] interceptorNames) throws InterceptorPivotException
InterceptorPivotException
protected void preInvoke(Method m, Object[] args)
protected void postInvoke(Method m, Object[] args, Object retval, Throwable t, String[] interceptorNames, String pivotedInterceptor)
protected void postInvoke(Method m, Object[] args, Object retval, Throwable t)
protected <T> void setEventNotifier(Class<T> eventSet, T notifier)
protected <T> T getEventNotifier(Class<T> eventSet)
protected String getLocalID()
public ControlBeanContext getControlBeanContext()
getControlBeanContext
in interface ControlBean
protected Object getControlService(Class serviceClass, Object selector) throws TooManyListenersException
TooManyListenersException
public void setControlID(String id)
protected void setControlProperty(PropertyKey key, Object o)
protected Object getRawControlProperty(PropertyKey key)
protected Object getControlProperty(PropertyKey key)
protected abstract Map getPropertyMapCache()
protected PropertyMap getAnnotationMap(AnnotatedElement annotElem)
protected PropertyChangeSupport getPropertyChangeSupport()
protected void firePropertyChange(PropertyKey propertyKey, Object oldValue, Object newValue)
protected VetoableChangeSupport getVetoableChangeSupport()
protected void fireVetoableChange(PropertyKey propertyKey, Object oldValue, Object newValue) throws PropertyVetoException
PropertyVetoException
protected String[] getParameterNames(Method m)
public static Class getMostDerivedInterface(Class controlIntf)
controlIntf
-
protected static void enforceVersionRequired(String intfName, Version version, VersionRequired versionRequired)
intfName
- version
- versionRequired
- public void decodeImpl(Object impl)
protected Interceptor ensureInterceptor(String n)
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |