Top Description Methods
java.beans.beancontext

public Interface BeanContextServiceProvider

Known Direct Implementers
java.beans.beancontext.BeanContextServicesSupport.BCSSProxyServiceProvider
Annotations
@SuppressWarnings:removal
@Deprecated
since:23
forRemoval:true
Imports
java.util.Iterator

Deprecated

for removal since 23.

One of the primary functions of a BeanContext is to act a as rendezvous between JavaBeans, and BeanContextServiceProviders.

A JavaBean nested within a BeanContext, may ask that BeanContext to provide an instance of a "service", based upon a reference to a Java Class object that represents that service.

If such a service has been registered with the context, or one of its nesting context's, in the case where a context delegate to its context to satisfy a service request, then the BeanContextServiceProvider associated with the service is asked to provide an instance of that service.

The ServiceProvider may always return the same instance, or it may construct a new instance for each request.

Method Summary

Modifier and TypeMethod and Description
public Iterator<?>

Returns:

the current service selectors for the specified serviceClass
getCurrentServiceSelectors(BeanContextServices
the BeanContextServices for this request
bcs, Class<?>
the specified service
serviceClass)
References Deprecated BeanContextServices is deprecated or references (maybe indirectly) at least one deprecated element.

Invoked by BeanContextServices, this method gets the current service selectors for the specified service.

public Object

Returns:

a reference to the requested service
getService(BeanContextServices
The BeanContextServices associated with this particular request. This parameter enables the BeanContextServiceProvider to distinguish service requests from multiple sources.
bcs, Object
The object requesting the service
requestor, Class<?>
The service requested
serviceClass, Object
the service dependent parameter for a particular service, or null if not applicable.
serviceSelector)
References Deprecated BeanContextServices is deprecated or references (maybe indirectly) at least one deprecated element.

Invoked by BeanContextServices, this method requests an instance of a service from this BeanContextServiceProvider.

public void
releaseService(BeanContextServices
the BeanContextServices associated with this particular release request
bcs, Object
the object requesting the service to be released
requestor, Object
the service that is to be released
service)
References Deprecated BeanContextServices is deprecated or references (maybe indirectly) at least one deprecated element.

Invoked by BeanContextServices, this method releases a nested BeanContextChild's (or any arbitrary object associated with a BeanContextChild) reference to the specified service.

Method Detail

getCurrentServiceSelectorsback to summary
public Iterator<?> getCurrentServiceSelectors(BeanContextServices bcs, Class<?> serviceClass)

References Deprecated

BeanContextServices is deprecated or references (maybe indirectly) at least one deprecated element.

See corresponding docs for further information.

Invoked by BeanContextServices, this method gets the current service selectors for the specified service. A service selector is a service specific parameter, typical examples of which could include: a parameter to a constructor for the service implementation class, a value for a particular service's property, or a key into a map of existing implementations.

Parameters
bcs:BeanContextServices

the BeanContextServices for this request

serviceClass:Class<?>

the specified service

Returns:Iterator<?>

the current service selectors for the specified serviceClass

getServiceback to summary
public Object getService(BeanContextServices bcs, Object requestor, Class<?> serviceClass, Object serviceSelector)

References Deprecated

BeanContextServices is deprecated or references (maybe indirectly) at least one deprecated element.

See corresponding docs for further information.

Invoked by BeanContextServices, this method requests an instance of a service from this BeanContextServiceProvider.

Parameters
bcs:BeanContextServices

The BeanContextServices associated with this particular request. This parameter enables the BeanContextServiceProvider to distinguish service requests from multiple sources.

requestor:Object

The object requesting the service

serviceClass:Class<?>

The service requested

serviceSelector:Object

the service dependent parameter for a particular service, or null if not applicable.

Returns:Object

a reference to the requested service

releaseServiceback to summary
public void releaseService(BeanContextServices bcs, Object requestor, Object service)

References Deprecated

BeanContextServices is deprecated or references (maybe indirectly) at least one deprecated element.

See corresponding docs for further information.

Invoked by BeanContextServices, this method releases a nested BeanContextChild's (or any arbitrary object associated with a BeanContextChild) reference to the specified service.

Parameters
bcs:BeanContextServices

the BeanContextServices associated with this particular release request

requestor:Object

the object requesting the service to be released

service:Object

the service that is to be released