Interface BeanContextServices
- All Superinterfaces:
BeanContext,BeanContextChild,BeanContextServiceRevokedListener,BeanContextServicesListener,Collection,DesignMode,EventListener,Iterable,Visibility
- All Known Implementing Classes:
BeanContextServicesSupport
@Deprecated(since="23",
forRemoval=true)
public interface BeanContextServices
extends BeanContext, BeanContextServicesListener
Deprecated, for removal: This API element is subject to removal in a future version.
The BeanContextServices interface provides a mechanism for a BeanContext to expose generic "services" to the BeanContextChild objects within.
-
Field Summary
Fields declared in interface java.beans.beancontext.BeanContext
globalHierarchyLockFields declared in interface java.beans.DesignMode
PROPERTYNAME -
Method Summary
Modifier and TypeMethodDescriptionvoidDeprecated, for removal: This API element is subject to removal in a future version.Adds aBeanContextServicesListenerto this BeanContextbooleanaddService(Class<?> serviceClass, BeanContextServiceProvider serviceProvider) Deprecated, for removal: This API element is subject to removal in a future version.Adds a service to this BeanContext.Iterator<?> Deprecated, for removal: This API element is subject to removal in a future version.Gets the currently available services for this context.Iterator<?> getCurrentServiceSelectors(Class<?> serviceClass) Deprecated, for removal: This API element is subject to removal in a future version.Gets the list of service dependent service parameters (Service Selectors) for the specified service, by calling getCurrentServiceSelectors() on the underlying BeanContextServiceProvider.getService(BeanContextChild child, Object requestor, Class<?> serviceClass, Object serviceSelector, BeanContextServiceRevokedListener bcsrl) Deprecated, for removal: This API element is subject to removal in a future version.ABeanContextChild, or any arbitrary object associated with aBeanContextChild, may obtain a reference to a currently registered service from its nestingBeanContextServicesvia invocation of this method.booleanhasService(Class<?> serviceClass) Deprecated, for removal: This API element is subject to removal in a future version.Reports whether or not a given service is currently available from this context.voidreleaseService(BeanContextChild child, Object requestor, Object service) Deprecated, for removal: This API element is subject to removal in a future version.Releases aBeanContextChild's (or any arbitrary object associated with a BeanContextChild) reference to the specified service by calling releaseService() on the underlyingBeanContextServiceProvider.voidDeprecated, for removal: This API element is subject to removal in a future version.Removes aBeanContextServicesListenerfrom thisBeanContextvoidrevokeService(Class<?> serviceClass, BeanContextServiceProvider serviceProvider, boolean revokeCurrentServicesNow) Deprecated, for removal: This API element is subject to removal in a future version.BeanContextServiceProviders wishing to remove a currently registered service from this context may do so via invocation of this method.Methods declared in interface java.beans.beancontext.BeanContext
addBeanContextMembershipListener, getResource, getResourceAsStream, instantiateChild, removeBeanContextMembershipListenerMethods declared in interface java.beans.beancontext.BeanContextChild
addPropertyChangeListener, addVetoableChangeListener, getBeanContext, removePropertyChangeListener, removeVetoableChangeListener, setBeanContextMethods declared in interface java.beans.beancontext.BeanContextServiceRevokedListener
serviceRevokedMethods declared in interface java.beans.beancontext.BeanContextServicesListener
serviceAvailableMethods declared in interface java.util.Collection
add, addAll, clear, contains, containsAll, equals, hashCode, isEmpty, iterator, parallelStream, remove, removeAll, removeIf, retainAll, size, spliterator, stream, toArray, toArray, toArrayMethods declared in interface java.beans.DesignMode
isDesignTime, setDesignTimeMethods declared in interface java.beans.Visibility
avoidingGui, dontUseGui, needsGui, okToUseGui
-
Method Details
-
addService
Deprecated, for removal: This API element is subject to removal in a future version.Adds a service to this BeanContext.BeanContextServiceProviders call this method to register a particular service with this context. If the service has not previously been added, theBeanContextServicesassociates the service with theBeanContextServiceProviderand fires aBeanContextServiceAvailableEventto all currently registeredBeanContextServicesListeners. The method then returnstrue, indicating that the addition of the service was successful. If the given service has already been added, this method simply returnsfalse.- Parameters:
serviceClass- the service to addserviceProvider- theBeanContextServiceProviderassociated with the service- Returns:
- true if the service was successful added, false otherwise
-
revokeService
void revokeService(Class<?> serviceClass, BeanContextServiceProvider serviceProvider, boolean revokeCurrentServicesNow) Deprecated, for removal: This API element is subject to removal in a future version.BeanContextServiceProviders wishing to remove a currently registered service from this context may do so via invocation of this method. Upon revocation of the service, theBeanContextServicesfires aBeanContextServiceRevokedEventto its list of currently registeredBeanContextServiceRevokedListenersandBeanContextServicesListeners.- Parameters:
serviceClass- the service to revoke from this BeanContextServicesserviceProvider- the BeanContextServiceProvider associated with this particular service that is being revokedrevokeCurrentServicesNow- a value oftrueindicates an exceptional circumstance where theBeanContextServiceProviderorBeanContextServiceswishes to immediately terminate service to all currently outstanding references to the specified service.
-
hasService
Deprecated, for removal: This API element is subject to removal in a future version.Reports whether or not a given service is currently available from this context.- Parameters:
serviceClass- the service in question- Returns:
- true if the service is available
-
getService
Object getService(BeanContextChild child, Object requestor, Class<?> serviceClass, Object serviceSelector, BeanContextServiceRevokedListener bcsrl) throws TooManyListenersException Deprecated, for removal: This API element is subject to removal in a future version.ABeanContextChild, or any arbitrary object associated with aBeanContextChild, may obtain a reference to a currently registered service from its nestingBeanContextServicesvia invocation of this method. When invoked, this method gets the service by calling the getService() method on the underlyingBeanContextServiceProvider.- Parameters:
child- theBeanContextChildassociated with this requestrequestor- the object requesting the serviceserviceClass- class of the requested serviceserviceSelector- the service dependent parameterbcsrl- theBeanContextServiceRevokedListenerto notify if the service should later become revoked- Returns:
- a reference to this context's named
Service as requested or
null - Throws:
TooManyListenersException- if there are too many listeners
-
releaseService
Deprecated, for removal: This API element is subject to removal in a future version.Releases aBeanContextChild's (or any arbitrary object associated with a BeanContextChild) reference to the specified service by calling releaseService() on the underlyingBeanContextServiceProvider.- Parameters:
child- theBeanContextChildrequestor- the requestorservice- the service
-
getCurrentServiceClasses
Iterator<?> getCurrentServiceClasses()Deprecated, for removal: This API element is subject to removal in a future version.Gets the currently available services for this context.- Returns:
- an
Iteratorconsisting of the currently available services
-
getCurrentServiceSelectors
Deprecated, for removal: This API element is subject to removal in a future version.Gets the list of service dependent service parameters (Service Selectors) for the specified service, by calling getCurrentServiceSelectors() on the underlying BeanContextServiceProvider.- Parameters:
serviceClass- the specified service- Returns:
- the currently available service selectors for the named serviceClass
-
addBeanContextServicesListener
Deprecated, for removal: This API element is subject to removal in a future version.Adds aBeanContextServicesListenerto this BeanContext- Parameters:
bcsl- theBeanContextServicesListenerto add
-
removeBeanContextServicesListener
Deprecated, for removal: This API element is subject to removal in a future version.Removes aBeanContextServicesListenerfrom thisBeanContext- Parameters:
bcsl- theBeanContextServicesListenerto remove from this context
-