IBundleContext  - AS3 ADEP Client Component

Retrieve the current bundle.

The properties (read-only) for the given bundle.

Create a filter object from the given filter objects. The filter will match only when all given filters match. A SyntaxError will be thrown if a filter specified as a String or XML is not a valid filter. TBD: multiple examples are desperately needed here, because this is terribly opaque.

Parameters

Create a filter object from the given filter objects. The filter will match when one or more of the given filters match. A SyntaxError will be thrown if a filter specified as a String or XML is not a valid filter. TBD: multiple examples are desperately needed here, because this is terribly opaque.

Parameters

Create a filter object that inverts the sense of provided filter (if the provided filter returns true, the returned filter would return false, and vice-versa). TBD: examples are needed here.

Parameters

Retrieve all defined bundles.

Get the bundle with the specified id.

Parameters

Get the service object for the specified service reference. This method is asynchronous; you must add a success and fault handlers to the returned IToken to retrieve the requested service or deal with any errors that occurred during service retrieval.

NOTE: A bundle may register a single service object under multiple classes. This means that in some implementations it may be possible to cast a returned service object to one of the other classes or interfaces implemented by that service object if you happen to know what those classes or interfaces are for that particular bundle. This is NOT a supported use-case, and some implementations may explicitly prevent this by injecting a proxy. If multiple interfaces should be visible on a single service object, an aggregating interface that extends all the desired interfaces should be created and the service object should be requested by that aggregating interface.

         public function getSomeService():void
         {
             var context:IBundleContext = BundleContext.currentContext;
             var reference:IServiceReference = context.getServiceReference(IFancyService);
             if (reference == null)
                 throw new NoSuchServiceError();
             var token:IToken = context.getService(reference);
             token.addSuccessHandler(doSomethingWithTheFancyService);
             token.addFailureHandler(doSomethingToIndicateAProblem);
         }
         
         public function doSomethingWithTheFancyService(service:IFancyService):void
         {
             service.doFancyOperation();
         }
         
         public function doSomethingToIndicateAProblem(error:Error):void
         {
         // deal with the error here
         }
         

Parameters

Get a service reference for a service. If there is more than one service for the specified class, the service with the highest ranking will be returned. If there are multiple services with the highest rank, the service that was registered first will be returned. If there are no services for the specified class, null is returned.

Parameters

Get all service references of the given class matching the specified filter.

Parameters

Install all bundles in the specified bundle manifest.

Parameters

Install all bundles in the specified bundle manifest.

Parameters

Register a service object implementing the given classes.

NOTE: A bundle may register a single service object under multiple classes. This means that in some implementations it may be possible to cast a returned service object to one of the other classes or interfaces implemented by that service object if you happen to know what those classes or interfaces are for that particular bundle. This is NOT a supported use-case, and some implementations may explicitly prevent this by injecting a proxy. If multiple interfaces should be visible on a single service object, an aggregating interface that extends all the desired interfaces should be created and the service object should be requested by that aggregating interface.

Parameters

Related API Elements

Release a service retrieved by getService.

Parameters

Dispatched when a bundle has been installed.

Dispatched when a bundle is has been resolved.

Dispatched when a bundle is about to be resolved.

Dispatched when a bundle has been started.

Dispatched when a bundle is about to be started.

Dispatched when a bundle has been stopped.

Dispatched when a bundle is about to be stopped.

Dispatched when a bundle has been uninstalled.

Dispatched when a bundle is about to be uninstalled.

Dispatched when a bundle has been updated.

Dispatched when a bundle is about to be updated.

Dispatched when the properties of a service have been modified.

Dispatched when a service has been registered.

Dispatched when a service is going to be unregistered.