/**
 * Adds a service to this BeanContext.
 * <code>BeanContextServiceProvider</code>s call this method
 * to register a particular service with this context.
 * If the service has not previously been added, the
 * <code>BeanContextServices</code> associates
 * the service with the <code>BeanContextServiceProvider</code> and
 * fires a <code>BeanContextServiceAvailableEvent</code> to all
 * currently registered <code>BeanContextServicesListeners</code>.
 * The method then returns <code>true</code>, indicating that
 * the addition of the service was successful.
 * If the given service has already been added, this method
 * simply returns <code>false</code>.
 * @param serviceClass     the service to add
 * @param serviceProvider  the <code>BeanContextServiceProvider</code>
 * associated with the service
 * @return true if the service was successful added, false otherwise
 */
boolean addService(Class serviceClass, BeanContextServiceProvider serviceProvider);
 

/**
 * BeanContextServiceProviders wishing to remove
 * a currently registered service from this context
 * may do so via invocation of this method. Upon revocation of
 * the service, the <code>BeanContextServices</code> fires a
 * <code>BeanContextServiceRevokedEvent</code> to its
 * list of currently registered
 * <code>BeanContextServiceRevokedListeners</code> and
 * <code>BeanContextServicesListeners</code>.
 * @param serviceClass the service to revoke from this BeanContextServices
 * @param serviceProvider the BeanContextServiceProvider associated with
 * this particular service that is being revoked
 * @param revokeCurrentServicesNow a value of <code>true</code>
 * indicates an exceptional circumstance where the
 * <code>BeanContextServiceProvider</code> or
 * <code>BeanContextServices</code> wishes to immediately
 * terminate service to all currently outstanding references
 * to the specified service.
 */
void revokeService(Class serviceClass, BeanContextServiceProvider serviceProvider, boolean revokeCurrentServicesNow);
 

/**
 * Adds a service to this BeanContext.
 * <code>BeanContextServiceProvider</code>s call this method
 * to register a particular service with this context.
 * If the service has not previously been added, the
 * <code>BeanContextServices</code> associates
 * the service with the <code>BeanContextServiceProvider</code> and
 * fires a <code>BeanContextServiceAvailableEvent</code> to all
 * currently registered <code>BeanContextServicesListeners</code>.
 * The method then returns <code>true</code>, indicating that
 * the addition of the service was successful.
 * If the given service has already been added, this method
 * simply returns <code>false</code>.
 * @param serviceClass     the service to add
 * @param serviceProvider  the <code>BeanContextServiceProvider</code>
 * associated with the service
 * @return true if the service was successful added, false otherwise
 */
boolean addService(Class serviceClass, BeanContextServiceProvider serviceProvider);
 

/**
 * BeanContextServiceProviders wishing to remove
 * a currently registered service from this context
 * may do so via invocation of this method. Upon revocation of
 * the service, the <code>BeanContextServices</code> fires a
 * <code>BeanContextServiceRevokedEvent</code> to its
 * list of currently registered
 * <code>BeanContextServiceRevokedListeners</code> and
 * <code>BeanContextServicesListeners</code>.
 * @param serviceClass the service to revoke from this BeanContextServices
 * @param serviceProvider the BeanContextServiceProvider associated with
 * this particular service that is being revoked
 * @param revokeCurrentServicesNow a value of <code>true</code>
 * indicates an exceptional circumstance where the
 * <code>BeanContextServiceProvider</code> or
 * <code>BeanContextServices</code> wishes to immediately
 * terminate service to all currently outstanding references
 * to the specified service.
 */
void revokeService(Class serviceClass, BeanContextServiceProvider serviceProvider, boolean revokeCurrentServicesNow);
 

/**
 * Adds a service to this BeanContext.
 * <code>BeanContextServiceProvider</code>s call this method
 * to register a particular service with this context.
 * If the service has not previously been added, the
 * <code>BeanContextServices</code> associates
 * the service with the <code>BeanContextServiceProvider</code> and
 * fires a <code>BeanContextServiceAvailableEvent</code> to all
 * currently registered <code>BeanContextServicesListeners</code>.
 * The method then returns <code>true</code>, indicating that
 * the addition of the service was successful.
 * If the given service has already been added, this method
 * simply returns <code>false</code>.
 * @param serviceClass     the service to add
 * @param serviceProvider  the <code>BeanContextServiceProvider</code>
 * associated with the service
 * @return true if the service was successful added, false otherwise
 */
boolean addService(Class serviceClass, BeanContextServiceProvider serviceProvider);
 

/**
 * BeanContextServiceProviders wishing to remove
 * a currently registered service from this context
 * may do so via invocation of this method. Upon revocation of
 * the service, the <code>BeanContextServices</code> fires a
 * <code>BeanContextServiceRevokedEvent</code> to its
 * list of currently registered
 * <code>BeanContextServiceRevokedListeners</code> and
 * <code>BeanContextServicesListeners</code>.
 * @param serviceClass the service to revoke from this BeanContextServices
 * @param serviceProvider the BeanContextServiceProvider associated with
 * this particular service that is being revoked
 * @param revokeCurrentServicesNow a value of <code>true</code>
 * indicates an exceptional circumstance where the
 * <code>BeanContextServiceProvider</code> or
 * <code>BeanContextServices</code> wishes to immediately
 * terminate service to all currently outstanding references
 * to the specified service.
 */
void revokeService(Class serviceClass, BeanContextServiceProvider serviceProvider, boolean revokeCurrentServicesNow);
 

/**
 * Adds a service to this BeanContext.
 * <code>BeanContextServiceProvider</code>s call this method
 * to register a particular service with this context.
 * If the service has not previously been added, the
 * <code>BeanContextServices</code> associates
 * the service with the <code>BeanContextServiceProvider</code> and
 * fires a <code>BeanContextServiceAvailableEvent</code> to all
 * currently registered <code>BeanContextServicesListeners</code>.
 * The method then returns <code>true</code>, indicating that
 * the addition of the service was successful.
 * If the given service has already been added, this method
 * simply returns <code>false</code>.
 * @param serviceClass     the service to add
 * @param serviceProvider  the <code>BeanContextServiceProvider</code>
 * associated with the service
 * @return true if the service was successful added, false otherwise
 */
boolean addService(Class serviceClass, BeanContextServiceProvider serviceProvider);
 

/**
 * BeanContextServiceProviders wishing to remove
 * a currently registered service from this context
 * may do so via invocation of this method. Upon revocation of
 * the service, the <code>BeanContextServices</code> fires a
 * <code>BeanContextServiceRevokedEvent</code> to its
 * list of currently registered
 * <code>BeanContextServiceRevokedListeners</code> and
 * <code>BeanContextServicesListeners</code>.
 * @param serviceClass the service to revoke from this BeanContextServices
 * @param serviceProvider the BeanContextServiceProvider associated with
 * this particular service that is being revoked
 * @param revokeCurrentServicesNow a value of <code>true</code>
 * indicates an exceptional circumstance where the
 * <code>BeanContextServiceProvider</code> or
 * <code>BeanContextServices</code> wishes to immediately
 * terminate service to all currently outstanding references
 * to the specified service.
 */
void revokeService(Class serviceClass, BeanContextServiceProvider serviceProvider, boolean revokeCurrentServicesNow);
 

/**
 * Adds a service to this BeanContext.
 * <code>BeanContextServiceProvider</code>s call this method
 * to register a particular service with this context.
 * If the service has not previously been added, the
 * <code>BeanContextServices</code> associates
 * the service with the <code>BeanContextServiceProvider</code> and
 * fires a <code>BeanContextServiceAvailableEvent</code> to all
 * currently registered <code>BeanContextServicesListeners</code>.
 * The method then returns <code>true</code>, indicating that
 * the addition of the service was successful.
 * If the given service has already been added, this method
 * simply returns <code>false</code>.
 * @param serviceClass     the service to add
 * @param serviceProvider  the <code>BeanContextServiceProvider</code>
 * associated with the service
 * @return true if the service was successful added, false otherwise
 */
boolean addService(Class serviceClass, BeanContextServiceProvider serviceProvider);
 

/**
 * BeanContextServiceProviders wishing to remove
 * a currently registered service from this context
 * may do so via invocation of this method. Upon revocation of
 * the service, the <code>BeanContextServices</code> fires a
 * <code>BeanContextServiceRevokedEvent</code> to its
 * list of currently registered
 * <code>BeanContextServiceRevokedListeners</code> and
 * <code>BeanContextServicesListeners</code>.
 * @param serviceClass the service to revoke from this BeanContextServices
 * @param serviceProvider the BeanContextServiceProvider associated with
 * this particular service that is being revoked
 * @param revokeCurrentServicesNow a value of <code>true</code>
 * indicates an exceptional circumstance where the
 * <code>BeanContextServiceProvider</code> or
 * <code>BeanContextServices</code> wishes to immediately
 * terminate service to all currently outstanding references
 * to the specified service.
 */
void revokeService(Class serviceClass, BeanContextServiceProvider serviceProvider, boolean revokeCurrentServicesNow);
 

/**
 * Adds a service to this BeanContext.
 * <code>BeanContextServiceProvider</code>s call this method
 * to register a particular service with this context.
 * If the service has not previously been added, the
 * <code>BeanContextServices</code> associates
 * the service with the <code>BeanContextServiceProvider</code> and
 * fires a <code>BeanContextServiceAvailableEvent</code> to all
 * currently registered <code>BeanContextServicesListeners</code>.
 * The method then returns <code>true</code>, indicating that
 * the addition of the service was successful.
 * If the given service has already been added, this method
 * simply returns <code>false</code>.
 * @param serviceClass     the service to add
 * @param serviceProvider  the <code>BeanContextServiceProvider</code>
 * associated with the service
 * @return true if the service was successful added, false otherwise
 */
boolean addService(Class serviceClass, BeanContextServiceProvider serviceProvider);
 

/**
 * BeanContextServiceProviders wishing to remove
 * a currently registered service from this context
 * may do so via invocation of this method. Upon revocation of
 * the service, the <code>BeanContextServices</code> fires a
 * <code>BeanContextServiceRevokedEvent</code> to its
 * list of currently registered
 * <code>BeanContextServiceRevokedListeners</code> and
 * <code>BeanContextServicesListeners</code>.
 * @param serviceClass the service to revoke from this BeanContextServices
 * @param serviceProvider the BeanContextServiceProvider associated with
 * this particular service that is being revoked
 * @param revokeCurrentServicesNow a value of <code>true</code>
 * indicates an exceptional circumstance where the
 * <code>BeanContextServiceProvider</code> or
 * <code>BeanContextServices</code> wishes to immediately
 * terminate service to all currently outstanding references
 * to the specified service.
 */
void revokeService(Class serviceClass, BeanContextServiceProvider serviceProvider, boolean revokeCurrentServicesNow);
 

/**
 * Adds a service to this BeanContext.
 * <code>BeanContextServiceProvider</code>s call this method
 * to register a particular service with this context.
 * If the service has not previously been added, the
 * <code>BeanContextServices</code> associates
 * the service with the <code>BeanContextServiceProvider</code> and
 * fires a <code>BeanContextServiceAvailableEvent</code> to all
 * currently registered <code>BeanContextServicesListeners</code>.
 * The method then returns <code>true</code>, indicating that
 * the addition of the service was successful.
 * If the given service has already been added, this method
 * simply returns <code>false</code>.
 * @param serviceClass     the service to add
 * @param serviceProvider  the <code>BeanContextServiceProvider</code>
 * associated with the service
 * @return true if the service was successful added, false otherwise
 */
boolean addService(Class serviceClass, BeanContextServiceProvider serviceProvider);
 

/**
 * BeanContextServiceProviders wishing to remove
 * a currently registered service from this context
 * may do so via invocation of this method. Upon revocation of
 * the service, the <code>BeanContextServices</code> fires a
 * <code>BeanContextServiceRevokedEvent</code> to its
 * list of currently registered
 * <code>BeanContextServiceRevokedListeners</code> and
 * <code>BeanContextServicesListeners</code>.
 * @param serviceClass the service to revoke from this BeanContextServices
 * @param serviceProvider the BeanContextServiceProvider associated with
 * this particular service that is being revoked
 * @param revokeCurrentServicesNow a value of <code>true</code>
 * indicates an exceptional circumstance where the
 * <code>BeanContextServiceProvider</code> or
 * <code>BeanContextServices</code> wishes to immediately
 * terminate service to all currently outstanding references
 * to the specified service.
 */
void revokeService(Class serviceClass, BeanContextServiceProvider serviceProvider, boolean revokeCurrentServicesNow);
 

/**
 * Adds a service to this BeanContext.
 * {@code BeanContextServiceProvider}s call this method
 * to register a particular service with this context.
 * If the service has not previously been added, the
 * {@code BeanContextServices} associates
 * the service with the {@code BeanContextServiceProvider} and
 * fires a {@code BeanContextServiceAvailableEvent} to all
 * currently registered {@code BeanContextServicesListeners}.
 * The method then returns {@code true}, indicating that
 * the addition of the service was successful.
 * If the given service has already been added, this method
 * simply returns {@code false}.
 * @param serviceClass     the service to add
 * @param serviceProvider  the {@code BeanContextServiceProvider}
 * associated with the service
 * @return true if the service was successful added, false otherwise
 */
boolean addService(Class<?> serviceClass, BeanContextServiceProvider serviceProvider);
 

/**
 * BeanContextServiceProviders wishing to remove
 * a currently registered service from this context
 * may do so via invocation of this method. Upon revocation of
 * the service, the {@code BeanContextServices} fires a
 * {@code BeanContextServiceRevokedEvent} to its
 * list of currently registered
 * {@code BeanContextServiceRevokedListeners} and
 * {@code BeanContextServicesListeners}.
 * @param serviceClass the service to revoke from this BeanContextServices
 * @param serviceProvider the BeanContextServiceProvider associated with
 * this particular service that is being revoked
 * @param revokeCurrentServicesNow a value of {@code true}
 * indicates an exceptional circumstance where the
 * {@code BeanContextServiceProvider} or
 * {@code BeanContextServices} wishes to immediately
 * terminate service to all currently outstanding references
 * to the specified service.
 */
void revokeService(Class<?> serviceClass, BeanContextServiceProvider serviceProvider, boolean revokeCurrentServicesNow);
 

/**
 * Adds a service to this BeanContext.
 * {@code BeanContextServiceProvider}s call this method
 * to register a particular service with this context.
 * If the service has not previously been added, the
 * {@code BeanContextServices} associates
 * the service with the {@code BeanContextServiceProvider} and
 * fires a {@code BeanContextServiceAvailableEvent} to all
 * currently registered {@code BeanContextServicesListeners}.
 * The method then returns {@code true}, indicating that
 * the addition of the service was successful.
 * If the given service has already been added, this method
 * simply returns {@code false}.
 * @param serviceClass     the service to add
 * @param serviceProvider  the {@code BeanContextServiceProvider}
 * associated with the service
 * @return true if the service was successful added, false otherwise
 */
boolean addService(Class<?> serviceClass, BeanContextServiceProvider serviceProvider);
 

/**
 * BeanContextServiceProviders wishing to remove
 * a currently registered service from this context
 * may do so via invocation of this method. Upon revocation of
 * the service, the {@code BeanContextServices} fires a
 * {@code BeanContextServiceRevokedEvent} to its
 * list of currently registered
 * {@code BeanContextServiceRevokedListeners} and
 * {@code BeanContextServicesListeners}.
 * @param serviceClass the service to revoke from this BeanContextServices
 * @param serviceProvider the BeanContextServiceProvider associated with
 * this particular service that is being revoked
 * @param revokeCurrentServicesNow a value of {@code true}
 * indicates an exceptional circumstance where the
 * {@code BeanContextServiceProvider} or
 * {@code BeanContextServices} wishes to immediately
 * terminate service to all currently outstanding references
 * to the specified service.
 */
void revokeService(Class<?> serviceClass, BeanContextServiceProvider serviceProvider, boolean revokeCurrentServicesNow);
 

/**
 * Adds a service to this BeanContext.
 * <code>BeanContextServiceProvider</code>s call this method
 * to register a particular service with this context.
 * If the service has not previously been added, the
 * <code>BeanContextServices</code> associates
 * the service with the <code>BeanContextServiceProvider</code> and
 * fires a <code>BeanContextServiceAvailableEvent</code> to all
 * currently registered <code>BeanContextServicesListeners</code>.
 * The method then returns <code>true</code>, indicating that
 * the addition of the service was successful.
 * If the given service has already been added, this method
 * simply returns <code>false</code>.
 * @param serviceClass     the service to add
 * @param serviceProvider  the <code>BeanContextServiceProvider</code>
 * associated with the service
 * @return true if the service was successful added, false otherwise
 */
boolean addService(Class serviceClass, BeanContextServiceProvider serviceProvider);
 

/**
 * BeanContextServiceProviders wishing to remove
 * a currently registered service from this context
 * may do so via invocation of this method. Upon revocation of
 * the service, the <code>BeanContextServices</code> fires a
 * <code>BeanContextServiceRevokedEvent</code> to its
 * list of currently registered
 * <code>BeanContextServiceRevokedListeners</code> and
 * <code>BeanContextServicesListeners</code>.
 * @param serviceClass the service to revoke from this BeanContextServices
 * @param serviceProvider the BeanContextServiceProvider associated with
 * this particular service that is being revoked
 * @param revokeCurrentServicesNow a value of <code>true</code>
 * indicates an exceptional circumstance where the
 * <code>BeanContextServiceProvider</code> or
 * <code>BeanContextServices</code> wishes to immediately
 * terminate service to all currently outstanding references
 * to the specified service.
 */
void revokeService(Class serviceClass, BeanContextServiceProvider serviceProvider, boolean revokeCurrentServicesNow);
 

/**
 * Adds a service to this BeanContext.
 * <code>BeanContextServiceProvider</code>s call this method
 * to register a particular service with this context.
 * If the service has not previously been added, the
 * <code>BeanContextServices</code> associates
 * the service with the <code>BeanContextServiceProvider</code> and
 * fires a <code>BeanContextServiceAvailableEvent</code> to all
 * currently registered <code>BeanContextServicesListeners</code>.
 * The method then returns <code>true</code>, indicating that
 * the addition of the service was successful.
 * If the given service has already been added, this method
 * simply returns <code>false</code>.
 * @param serviceClass     the service to add
 * @param serviceProvider  the <code>BeanContextServiceProvider</code>
 * associated with the service
 * @return true if the service was successful added, false otherwise
 */
boolean addService(Class serviceClass, BeanContextServiceProvider serviceProvider);
 

/**
 * BeanContextServiceProviders wishing to remove
 * a currently registered service from this context
 * may do so via invocation of this method. Upon revocation of
 * the service, the <code>BeanContextServices</code> fires a
 * <code>BeanContextServiceRevokedEvent</code> to its
 * list of currently registered
 * <code>BeanContextServiceRevokedListeners</code> and
 * <code>BeanContextServicesListeners</code>.
 * @param serviceClass the service to revoke from this BeanContextServices
 * @param serviceProvider the BeanContextServiceProvider associated with
 * this particular service that is being revoked
 * @param revokeCurrentServicesNow a value of <code>true</code>
 * indicates an exceptional circumstance where the
 * <code>BeanContextServiceProvider</code> or
 * <code>BeanContextServices</code> wishes to immediately
 * terminate service to all currently outstanding references
 * to the specified service.
 */
void revokeService(Class serviceClass, BeanContextServiceProvider serviceProvider, boolean revokeCurrentServicesNow);
 

/**
 * Adds a service to this BeanContext.
 * <code>BeanContextServiceProvider</code>s call this method
 * to register a particular service with this context.
 * If the service has not previously been added, the
 * <code>BeanContextServices</code> associates
 * the service with the <code>BeanContextServiceProvider</code> and
 * fires a <code>BeanContextServiceAvailableEvent</code> to all
 * currently registered <code>BeanContextServicesListeners</code>.
 * The method then returns <code>true</code>, indicating that
 * the addition of the service was successful.
 * If the given service has already been added, this method
 * simply returns <code>false</code>.
 * @param serviceClass     the service to add
 * @param serviceProvider  the <code>BeanContextServiceProvider</code>
 * associated with the service
 * @return true if the service was successful added, false otherwise
 */
boolean addService(Class serviceClass, BeanContextServiceProvider serviceProvider);
 

/**
 * BeanContextServiceProviders wishing to remove
 * a currently registered service from this context
 * may do so via invocation of this method. Upon revocation of
 * the service, the <code>BeanContextServices</code> fires a
 * <code>BeanContextServiceRevokedEvent</code> to its
 * list of currently registered
 * <code>BeanContextServiceRevokedListeners</code> and
 * <code>BeanContextServicesListeners</code>.
 * @param serviceClass the service to revoke from this BeanContextServices
 * @param serviceProvider the BeanContextServiceProvider associated with
 * this particular service that is being revoked
 * @param revokeCurrentServicesNow a value of <code>true</code>
 * indicates an exceptional circumstance where the
 * <code>BeanContextServiceProvider</code> or
 * <code>BeanContextServices</code> wishes to immediately
 * terminate service to all currently outstanding references
 * to the specified service.
 */
void revokeService(Class serviceClass, BeanContextServiceProvider serviceProvider, boolean revokeCurrentServicesNow);
 

/**
 * Adds a service to this BeanContext.
 * <code>BeanContextServiceProvider</code>s call this method
 * to register a particular service with this context.
 * If the service has not previously been added, the
 * <code>BeanContextServices</code> associates
 * the service with the <code>BeanContextServiceProvider</code> and
 * fires a <code>BeanContextServiceAvailableEvent</code> to all
 * currently registered <code>BeanContextServicesListeners</code>.
 * The method then returns <code>true</code>, indicating that
 * the addition of the service was successful.
 * If the given service has already been added, this method
 * simply returns <code>false</code>.
 * @param serviceClass     the service to add
 * @param serviceProvider  the <code>BeanContextServiceProvider</code>
 * associated with the service
 * @return true if the service was successful added, false otherwise
 */
boolean addService(Class serviceClass, BeanContextServiceProvider serviceProvider);
 

/**
 * BeanContextServiceProviders wishing to remove
 * a currently registered service from this context
 * may do so via invocation of this method. Upon revocation of
 * the service, the <code>BeanContextServices</code> fires a
 * <code>BeanContextServiceRevokedEvent</code> to its
 * list of currently registered
 * <code>BeanContextServiceRevokedListeners</code> and
 * <code>BeanContextServicesListeners</code>.
 * @param serviceClass the service to revoke from this BeanContextServices
 * @param serviceProvider the BeanContextServiceProvider associated with
 * this particular service that is being revoked
 * @param revokeCurrentServicesNow a value of <code>true</code>
 * indicates an exceptional circumstance where the
 * <code>BeanContextServiceProvider</code> or
 * <code>BeanContextServices</code> wishes to immediately
 * terminate service to all currently outstanding references
 * to the specified service.
 */
void revokeService(Class serviceClass, BeanContextServiceProvider serviceProvider, boolean revokeCurrentServicesNow);
 

/**
 * Adds a service to this BeanContext.
 * <code>BeanContextServiceProvider</code>s call this method
 * to register a particular service with this context.
 * If the service has not previously been added, the
 * <code>BeanContextServices</code> associates
 * the service with the <code>BeanContextServiceProvider</code> and
 * fires a <code>BeanContextServiceAvailableEvent</code> to all
 * currently registered <code>BeanContextServicesListeners</code>.
 * The method then returns <code>true</code>, indicating that
 * the addition of the service was successful.
 * If the given service has already been added, this method
 * simply returns <code>false</code>.
 * @param serviceClass     the service to add
 * @param serviceProvider  the <code>BeanContextServiceProvider</code>
 * associated with the service
 * @return true if the service was successful added, false otherwise
 */
boolean addService(Class serviceClass, BeanContextServiceProvider serviceProvider);
 

/**
 * BeanContextServiceProviders wishing to remove
 * a currently registered service from this context
 * may do so via invocation of this method. Upon revocation of
 * the service, the <code>BeanContextServices</code> fires a
 * <code>BeanContextServiceRevokedEvent</code> to its
 * list of currently registered
 * <code>BeanContextServiceRevokedListeners</code> and
 * <code>BeanContextServicesListeners</code>.
 * @param serviceClass the service to revoke from this BeanContextServices
 * @param serviceProvider the BeanContextServiceProvider associated with
 * this particular service that is being revoked
 * @param revokeCurrentServicesNow a value of <code>true</code>
 * indicates an exceptional circumstance where the
 * <code>BeanContextServiceProvider</code> or
 * <code>BeanContextServices</code> wishes to immediately
 * terminate service to all currently outstanding references
 * to the specified service.
 */
void revokeService(Class serviceClass, BeanContextServiceProvider serviceProvider, boolean revokeCurrentServicesNow);
 

/**
 * Adds a service to this BeanContext.
 * <code>BeanContextServiceProvider</code>s call this method
 * to register a particular service with this context.
 * If the service has not previously been added, the
 * <code>BeanContextServices</code> associates
 * the service with the <code>BeanContextServiceProvider</code> and
 * fires a <code>BeanContextServiceAvailableEvent</code> to all
 * currently registered <code>BeanContextServicesListeners</code>.
 * The method then returns <code>true</code>, indicating that
 * the addition of the service was successful.
 * If the given service has already been added, this method
 * simply returns <code>false</code>.
 * @param serviceClass     the service to add
 * @param serviceProvider  the <code>BeanContextServiceProvider</code>
 * associated with the service
 * @return true if the service was successful added, false otherwise
 */
boolean addService(Class serviceClass, BeanContextServiceProvider serviceProvider);
 

/**
 * BeanContextServiceProviders wishing to remove
 * a currently registered service from this context
 * may do so via invocation of this method. Upon revocation of
 * the service, the <code>BeanContextServices</code> fires a
 * <code>BeanContextServiceRevokedEvent</code> to its
 * list of currently registered
 * <code>BeanContextServiceRevokedListeners</code> and
 * <code>BeanContextServicesListeners</code>.
 * @param serviceClass the service to revoke from this BeanContextServices
 * @param serviceProvider the BeanContextServiceProvider associated with
 * this particular service that is being revoked
 * @param revokeCurrentServicesNow a value of <code>true</code>
 * indicates an exceptional circumstance where the
 * <code>BeanContextServiceProvider</code> or
 * <code>BeanContextServices</code> wishes to immediately
 * terminate service to all currently outstanding references
 * to the specified service.
 */
void revokeService(Class serviceClass, BeanContextServiceProvider serviceProvider, boolean revokeCurrentServicesNow);