- 
- All Superinterfaces:
- BeanContext,- BeanContextChild,- BeanContextServiceRevokedListener,- BeanContextServicesListener,- Collection,- DesignMode,- EventListener,- Iterable,- Visibility
 - All Known Implementing Classes:
- BeanContextServicesSupport
 
 public interface BeanContextServices extends BeanContext, BeanContextServicesListener 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.BeanContextglobalHierarchyLock
 - 
Fields declared in interface java.beans.DesignModePROPERTYNAME
 
- 
 - 
Method SummaryAll Methods Instance Methods Abstract Methods Modifier and Type Method Description voidaddBeanContextServicesListener(BeanContextServicesListener bcsl)Adds aBeanContextServicesListenerto this BeanContextbooleanaddService(Class<?> serviceClass, BeanContextServiceProvider serviceProvider)Adds a service to this BeanContext.Iterator<?>getCurrentServiceClasses()Gets the currently available services for this context.Iterator<?>getCurrentServiceSelectors(Class<?> serviceClass)Gets the list of service dependent service parameters (Service Selectors) for the specified service, by calling getCurrentServiceSelectors() on the underlying BeanContextServiceProvider.ObjectgetService(BeanContextChild child, Object requestor, Class<?> serviceClass, Object serviceSelector, BeanContextServiceRevokedListener bcsrl)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)Reports whether or not a given service is currently available from this context.voidreleaseService(BeanContextChild child, Object requestor, Object service)Releases aBeanContextChild's (or any arbitrary object associated with a BeanContextChild) reference to the specified service by calling releaseService() on the underlyingBeanContextServiceProvider.voidremoveBeanContextServicesListener(BeanContextServicesListener bcsl)Removes aBeanContextServicesListenerfrom thisBeanContextvoidrevokeService(Class<?> serviceClass, BeanContextServiceProvider serviceProvider, boolean revokeCurrentServicesNow)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.BeanContextaddBeanContextMembershipListener, getResource, getResourceAsStream, instantiateChild, removeBeanContextMembershipListener
 - 
Methods declared in interface java.beans.beancontext.BeanContextChildaddPropertyChangeListener, addVetoableChangeListener, getBeanContext, removePropertyChangeListener, removeVetoableChangeListener, setBeanContext
 - 
Methods declared in interface java.beans.beancontext.BeanContextServiceRevokedListenerserviceRevoked
 - 
Methods declared in interface java.beans.beancontext.BeanContextServicesListenerserviceAvailable
 - 
Methods declared in interface java.util.Collectionadd, addAll, clear, contains, containsAll, equals, hashCode, isEmpty, iterator, parallelStream, remove, removeAll, removeIf, retainAll, size, spliterator, stream, toArray, toArray, toArray
 - 
Methods declared in interface java.beans.DesignModeisDesignTime, setDesignTime
 - 
Methods declared in interface java.beans.VisibilityavoidingGui, dontUseGui, needsGui, okToUseGui
 
- 
 
- 
- 
- 
Method Detail- 
addServiceboolean addService(Class<?> serviceClass, BeanContextServiceProvider serviceProvider) 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 add
- serviceProvider- the- BeanContextServiceProviderassociated with the service
- Returns:
- true if the service was successful added, false otherwise
 
 - 
revokeServicevoid revokeService(Class<?> serviceClass, BeanContextServiceProvider serviceProvider, boolean revokeCurrentServicesNow) 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 BeanContextServices
- serviceProvider- the BeanContextServiceProvider associated with this particular service that is being revoked
- revokeCurrentServicesNow- a value of- trueindicates an exceptional circumstance where the- BeanContextServiceProvideror- BeanContextServiceswishes to immediately terminate service to all currently outstanding references to the specified service.
 
 - 
hasServiceboolean hasService(Class<?> serviceClass) 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
 
 - 
getServiceObject getService(BeanContextChild child, Object requestor, Class<?> serviceClass, Object serviceSelector, BeanContextServiceRevokedListener bcsrl) throws TooManyListenersException 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- the- BeanContextChildassociated with this request
- requestor- the object requesting the service
- serviceClass- class of the requested service
- serviceSelector- the service dependent parameter
- bcsrl- the- BeanContextServiceRevokedListenerto 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
 
 - 
releaseServicevoid releaseService(BeanContextChild child, Object requestor, Object service) Releases aBeanContextChild's (or any arbitrary object associated with a BeanContextChild) reference to the specified service by calling releaseService() on the underlyingBeanContextServiceProvider.- Parameters:
- child- the- BeanContextChild
- requestor- the requestor
- service- the service
 
 - 
getCurrentServiceClassesIterator<?> getCurrentServiceClasses() Gets the currently available services for this context.- Returns:
- an Iteratorconsisting of the currently available services
 
 - 
getCurrentServiceSelectorsIterator<?> getCurrentServiceSelectors(Class<?> serviceClass) 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
 
 - 
addBeanContextServicesListenervoid addBeanContextServicesListener(BeanContextServicesListener bcsl) Adds aBeanContextServicesListenerto this BeanContext- Parameters:
- bcsl- the- BeanContextServicesListenerto add
 
 - 
removeBeanContextServicesListenervoid removeBeanContextServicesListener(BeanContextServicesListener bcsl) Removes aBeanContextServicesListenerfrom thisBeanContext- Parameters:
- bcsl- the- BeanContextServicesListenerto remove from this context
 
 
- 
 
-