Adobe® Flash® Platform 用 ActionScript® 3.0 リファレンスガイド
ホーム  |  パッケージおよびクラスリストの非表示 |  パッケージ  |  クラス  |  新機能  |  索引  |  付録  |  英語で表示される理由
フィルター: サーバーからデータを取得しています...
サーバーからデータを取得しています...
com.adobe.gravity.framework 

IBundleContext  - AS3 ADEP Client Component

パッケージcom.adobe.gravity.framework
インターフェイスpublic interface IBundleContext extends IEventDispatcher

言語バージョン: ActionScript 3.0
製品バージョン: Adobe Digital Enterprise Platform Experience Services - Client Component Framework 10
ランタイムバージョン: AIR 1.1, Flash Player 9

The IBundleContext interface is the main point of access to all bundle framework functionality. The IBundleContext for a particular bundle is passed into the IBundleActivator for that bundle, if the bundle implementes that interface, or it can be accessed using BundleContext.currentContext.



パブリックプロパティ
 プロパティ定義元
  bundle : IBundle
[読み取り専用] Retrieve the current bundle.
IBundleContext
  properties : Object
[読み取り専用] The properties (read-only) for the given bundle.
IBundleContext
パブリックメソッド
 メソッド定義元
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。
IEventDispatcher
  
Create a filter object from the given filter objects.
IBundleContext
  
Create a filter object from the given filter objects.
IBundleContext
  
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).
IBundleContext
 Inherited
イベントをイベントフローに送出します。
IEventDispatcher
  
Retrieve all defined bundles.
IBundleContext
  
Get the bundle with the specified id.
IBundleContext
  
Get the service object for the specified service reference.
IBundleContext
  
Get a service reference for a service.
IBundleContext
  
getServiceReferences(clazz:Class, filter:IFilter = null):Array
Get all service references of the given class matching the specified filter.
IBundleContext
 Inherited
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。
IEventDispatcher
  
installBundlesFromURL(bundleManifestLocation:String, allowCodeImport:Boolean = false, autoStart:Boolean = true):com.adobe.gravity.utility.async:IToken
Install all bundles in the specified bundle manifest.
IBundleContext
  
installBundlesFromXML(bundleManifest:XML, allowCodeImport:Boolean = false, autoStart:Boolean = true, baseUrl:String = null):com.adobe.gravity.utility.async:IToken
Install all bundles in the specified bundle manifest.
IBundleContext
  
Register a service object implementing the given classes.
IBundleContext
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
EventDispatcher オブジェクトからリスナーを削除します。
IEventDispatcher
  
Release a service retrieved by getService.
IBundleContext
 Inherited
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。
IEventDispatcher
イベント
 イベント 概要 定義元
  Dispatched when a bundle has been installed.IBundleContext
  Dispatched when a bundle is has been resolved.IBundleContext
  Dispatched when a bundle is about to be resolved.IBundleContext
  Dispatched when a bundle has been started.IBundleContext
  Dispatched when a bundle is about to be started.IBundleContext
  Dispatched when a bundle has been stopped.IBundleContext
  Dispatched when a bundle is about to be stopped.IBundleContext
  Dispatched when a bundle has been uninstalled.IBundleContext
  Dispatched when a bundle is about to be uninstalled.IBundleContext
  Dispatched when a bundle has been updated.IBundleContext
  Dispatched when a bundle is about to be updated.IBundleContext
  Dispatched when the properties of a service have been modified.IBundleContext
  Dispatched when a service has been registered.IBundleContext
  Dispatched when a service is going to be unregistered.IBundleContext
プロパティの詳細

bundle

プロパティ
bundle:IBundle  [読み取り専用]

言語バージョン: ActionScript 3.0
製品バージョン: Adobe Digital Enterprise Platform Experience Services - Client Component Framework 10
ランタイムバージョン: AIR 1.1, Flash Player 9

Retrieve the current bundle.



実装
    public function get bundle():IBundle

properties

プロパティ 
properties:Object  [読み取り専用]

言語バージョン: ActionScript 3.0
製品バージョン: Adobe Digital Enterprise Platform Experience Services - Client Component Framework 10
ランタイムバージョン: AIR 1.1, Flash Player 9

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



実装
    public function get properties():Object
メソッドの詳細

createFilter

()メソッド
public function createFilter(... filters):IFilter

言語バージョン: ActionScript 3.0
製品バージョン: Adobe Digital Enterprise Platform Experience Services - Client Component Framework 10
ランタイムバージョン: AIR 1.1, Flash Player 9

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.

パラメーター

... filters — One or more filter objects. A filter is either an implementation of IFilter, a String, XML, or an Object.

戻り値
IFilter — An IFilter instance that will perform the specified filtering.

createFilterMatchAny

()メソッド 
public function createFilterMatchAny(... filters):IFilter

言語バージョン: ActionScript 3.0
製品バージョン: Adobe Digital Enterprise Platform Experience Services - Client Component Framework 10
ランタイムバージョン: AIR 1.1, Flash Player 9

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.

パラメーター

... filters — One or more filter objects. A filter is either an implementation of IFilter, a String, XML, or an Object.

戻り値
IFilter — An IFilter instance that will perform the specified filtering.

createFilterMatchInverse

()メソッド 
public function createFilterMatchInverse(filter:IFilter):IFilter

言語バージョン: ActionScript 3.0
製品バージョン: Adobe Digital Enterprise Platform Experience Services - Client Component Framework 10
ランタイムバージョン: AIR 1.1, Flash Player 9

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.

パラメーター

filter:IFilter — The filter to invert.

戻り値
IFilter — An IFilter instance that will match if and only if the provided filter does not match.

getAllBundles

()メソッド 
public function getAllBundles():Array

言語バージョン: ActionScript 3.0
製品バージョン: Adobe Digital Enterprise Platform Experience Services - Client Component Framework 10
ランタイムバージョン: AIR 1.1, Flash Player 9

Retrieve all defined bundles.

戻り値
Array — An Array of IBundle instances.

getBundle

()メソッド 
public function getBundle(id:int):IBundle

言語バージョン: ActionScript 3.0
製品バージョン: Adobe Digital Enterprise Platform Experience Services - Client Component Framework 10
ランタイムバージョン: AIR 1.1, Flash Player 9

Get the bundle with the specified id.

パラメーター

id:int — The identifier for the desired bundle.

戻り値
IBundle — The requested bundle.

getService

()メソッド 
public function getService(reference:IServiceReference):com.adobe.gravity.utility.async:IToken

言語バージョン: ActionScript 3.0
製品バージョン: Adobe Digital Enterprise Platform Experience Services - Client Component Framework 10
ランタイムバージョン: AIR 1.1, Flash Player 9

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
         }
         

パラメーター

reference:IServiceReference — An IServiceReference for the desired service. The getServiceReference functions can be used to retrieve a service reference.

戻り値
com.adobe.gravity.utility.async:IToken — A token used to set success and failure handlers to be called when the operation has completed. If the service retrieval is successful, the service object will be passed into the result handler. In other words, the result handler should take a single object of the service interface type.

getServiceReference

()メソッド 
public function getServiceReference(clazz:Class):IServiceReference

言語バージョン: ActionScript 3.0
製品バージョン: Adobe Digital Enterprise Platform Experience Services - Client Component Framework 10
ランタイムバージョン: AIR 1.1, Flash Player 9

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.

パラメーター

clazz:Class — The service class.

戻り値
IServiceReference — The service reference for the (first) service implementing the given service class, or null if there is no such service.

getServiceReferences

()メソッド 
public function getServiceReferences(clazz:Class, filter:IFilter = null):Array

言語バージョン: ActionScript 3.0
製品バージョン: Adobe Digital Enterprise Platform Experience Services - Client Component Framework 10
ランタイムバージョン: AIR 1.1, Flash Player 9

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

パラメーター

clazz:Class — The service class.
 
filter:IFilter (default = null) — A filter to restrict the services returned. The filter may be null, in which case all services implementing the given contract are returned.

戻り値
Array — An array of IServiceReference objects for all the services implementing the given service contract and matching the filter.

installBundlesFromURL

()メソッド 
public function installBundlesFromURL(bundleManifestLocation:String, allowCodeImport:Boolean = false, autoStart:Boolean = true):com.adobe.gravity.utility.async:IToken

言語バージョン: ActionScript 3.0
製品バージョン: Adobe Digital Enterprise Platform Experience Services - Client Component Framework 10
ランタイムバージョン: AIR 1.1, Flash Player 9

Install all bundles in the specified bundle manifest.

パラメーター

bundleManifestLocation:String — The location of the bundle manifest.
 
allowCodeImport:Boolean (default = false) — Allow cross-domain loading of any SWF files in the specified manifest.
 
autoStart:Boolean (default = true) — Start the bundles in the manifest.

戻り値
com.adobe.gravity.utility.async:IToken — A token used to set success and failure handlers to be called when the operation has completed. If the manifest load was successful, an Array containing a set of IBundle objects for the bundles from the manifest file will be passed into the result handler.

installBundlesFromXML

()メソッド 
public function installBundlesFromXML(bundleManifest:XML, allowCodeImport:Boolean = false, autoStart:Boolean = true, baseUrl:String = null):com.adobe.gravity.utility.async:IToken

言語バージョン: ActionScript 3.0
製品バージョン: Adobe Digital Enterprise Platform Experience Services - Client Component Framework 10
ランタイムバージョン: AIR 1.1, Flash Player 9

Install all bundles in the specified bundle manifest.

パラメーター

bundleManifest:XML — The bundle manifest XML.
 
allowCodeImport:Boolean (default = false) — Allow cross-domain loading of any SWF files in the specified manifest.
 
autoStart:Boolean (default = true) — Start the bundles in the manifest.
 
baseUrl:String (default = null) — The base URL for relative URL.

戻り値
com.adobe.gravity.utility.async:IToken — A token used to set success and failure handlers to be called when the operation has completed. If the manifest load was successful, an Array containing a set of IBundle objects for the bundles from the manifest file will be passed into the result handler.

registerService

()メソッド 
public function registerService(classes:Array, service:Object, properties:Object):IServiceRegistration

言語バージョン: ActionScript 3.0
製品バージョン: Adobe Digital Enterprise Platform Experience Services - Client Component Framework 10
ランタイムバージョン: AIR 1.1, Flash Player 9

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.

パラメーター

classes:Array — An array of Class objects indicating the classes implemented by the service.
 
service:Object — Either the service object itself, or an implementation of IServiceFactory. If the object is not an IServiceFactory and is not an instance of all the classes in the classes array, an exception (TODO: specify which exception) will be thrown.
 
properties:Object — Name-value metadata for the service, can be used as criteria in filters when selecting a service.

戻り値
IServiceRegistration — An IServiceRegistration that can be used to manage the service.

関連する API エレメント

ungetService

()メソッド 
public function ungetService(reference:IServiceReference):Boolean

言語バージョン: ActionScript 3.0
製品バージョン: Adobe Digital Enterprise Platform Experience Services - Client Component Framework 10
ランタイムバージョン: AIR 1.1, Flash Player 9

Release a service retrieved by getService.

パラメーター

reference:IServiceReference — The service reference for the service to be released.

戻り値
Boolean — If the bundle's usage count for the service was already zero, false is returned. Otherwise, true is returned.
イベントの詳細

bundleInstalled

イベント
イベントオブジェクトの型: com.adobe.gravity.framework.BundleEvent
プロパティ BundleEvent.type = com.adobe.gravity.framework.BundleEvent.BUNDLE_INSTALLED

言語バージョン: ActionScript 3.0
製品バージョン: Adobe Digital Enterprise Platform Experience Services - Client Component Framework 10
ランタイムバージョン: AIR 1.1, Flash Player 9

Dispatched when a bundle has been installed.

A bundle has been installed.

bundleResolved

イベント  
イベントオブジェクトの型: com.adobe.gravity.framework.BundleEvent
プロパティ BundleEvent.type = com.adobe.gravity.framework.BundleEvent.BUNDLE_RESOLVED

言語バージョン: ActionScript 3.0
製品バージョン: Adobe Digital Enterprise Platform Experience Services - Client Component Framework 10
ランタイムバージョン: AIR 1.1, Flash Player 9

Dispatched when a bundle is has been resolved.

A bundle has been resolved.

bundleResolving

イベント  
イベントオブジェクトの型: com.adobe.gravity.framework.BundleEvent
プロパティ BundleEvent.type = com.adobe.gravity.framework.BundleEvent.BUNDLE_RESOLVING

言語バージョン: ActionScript 3.0
製品バージョン: Adobe Digital Enterprise Platform Experience Services - Client Component Framework 10
ランタイムバージョン: AIR 1.1, Flash Player 9

Dispatched when a bundle is about to be resolved.

A bundle is about to be resolved.

bundleStarted

イベント  
イベントオブジェクトの型: com.adobe.gravity.framework.BundleEvent
プロパティ BundleEvent.type = com.adobe.gravity.framework.BundleEvent.BUNDLE_STARTED

言語バージョン: ActionScript 3.0
製品バージョン: Adobe Digital Enterprise Platform Experience Services - Client Component Framework 10
ランタイムバージョン: AIR 1.1, Flash Player 9

Dispatched when a bundle has been started.

A bundle has been started.

bundleStarting

イベント  
イベントオブジェクトの型: com.adobe.gravity.framework.BundleEvent
プロパティ BundleEvent.type = com.adobe.gravity.framework.BundleEvent.BUNDLE_STARTING

言語バージョン: ActionScript 3.0
製品バージョン: Adobe Digital Enterprise Platform Experience Services - Client Component Framework 10
ランタイムバージョン: AIR 1.1, Flash Player 9

Dispatched when a bundle is about to be started.

A bundle is about to be started.

bundleStopped

イベント  
イベントオブジェクトの型: com.adobe.gravity.framework.BundleEvent
プロパティ BundleEvent.type = com.adobe.gravity.framework.BundleEvent.BUNDLE_STOPPED

言語バージョン: ActionScript 3.0
製品バージョン: Adobe Digital Enterprise Platform Experience Services - Client Component Framework 10
ランタイムバージョン: AIR 1.1, Flash Player 9

Dispatched when a bundle has been stopped.

A bundle has been stopped.

bundleStopping

イベント  
イベントオブジェクトの型: com.adobe.gravity.framework.BundleEvent
プロパティ BundleEvent.type = com.adobe.gravity.framework.BundleEvent.BUNDLE_STOPPING

言語バージョン: ActionScript 3.0
製品バージョン: Adobe Digital Enterprise Platform Experience Services - Client Component Framework 10
ランタイムバージョン: AIR 1.1, Flash Player 9

Dispatched when a bundle is about to be stopped.

A bundle is about to be stopped.

bundleUninstalled

イベント  
イベントオブジェクトの型: com.adobe.gravity.framework.BundleEvent
プロパティ BundleEvent.type = com.adobe.gravity.framework.BundleEvent.BUNDLE_UNINSTALLED

言語バージョン: ActionScript 3.0
製品バージョン: Adobe Digital Enterprise Platform Experience Services - Client Component Framework 10
ランタイムバージョン: AIR 1.1, Flash Player 9

Dispatched when a bundle has been uninstalled.

A bundle has been uninstalled.

bundleUninstalling

イベント  
イベントオブジェクトの型: com.adobe.gravity.framework.BundleEvent
プロパティ BundleEvent.type = com.adobe.gravity.framework.BundleEvent.BUNDLE_UNINSTALLING

言語バージョン: ActionScript 3.0
製品バージョン: Adobe Digital Enterprise Platform Experience Services - Client Component Framework 10
ランタイムバージョン: AIR 1.1, Flash Player 9

Dispatched when a bundle is about to be uninstalled.

A bundle is about to be uninstalled.

bundleUpdated

イベント  
イベントオブジェクトの型: com.adobe.gravity.framework.BundleEvent
プロパティ BundleEvent.type = com.adobe.gravity.framework.BundleEvent.BUNDLE_UPDATED

言語バージョン: ActionScript 3.0
製品バージョン: Adobe Digital Enterprise Platform Experience Services - Client Component Framework 10
ランタイムバージョン: AIR 1.1, Flash Player 9

Dispatched when a bundle has been updated.

A bundle has been updated.

bundleUpdating

イベント  
イベントオブジェクトの型: com.adobe.gravity.framework.BundleEvent
プロパティ BundleEvent.type = com.adobe.gravity.framework.BundleEvent.BUNDLE_UPDATING

言語バージョン: ActionScript 3.0
製品バージョン: Adobe Digital Enterprise Platform Experience Services - Client Component Framework 10
ランタイムバージョン: AIR 1.1, Flash Player 9

Dispatched when a bundle is about to be updated.

A bundle is about to be updated.

serviceModified

イベント  
イベントオブジェクトの型: com.adobe.gravity.framework.ServiceEvent
プロパティ ServiceEvent.type = com.adobe.gravity.framework.ServiceEvent.SERVICE_MODIFIED

言語バージョン: ActionScript 3.0
製品バージョン: Adobe Digital Enterprise Platform Experience Services - Client Component Framework 10
ランタイムバージョン: AIR 1.1, Flash Player 9

Dispatched when the properties of a service have been modified.

The serviceModified event type indicates that the properties of the service have been modified.

serviceRegistered

イベント  
イベントオブジェクトの型: com.adobe.gravity.framework.ServiceEvent
プロパティ ServiceEvent.type = com.adobe.gravity.framework.ServiceEvent.SERVICE_REGISTERED

言語バージョン: ActionScript 3.0
製品バージョン: Adobe Digital Enterprise Platform Experience Services - Client Component Framework 10
ランタイムバージョン: AIR 1.1, Flash Player 9

Dispatched when a service has been registered.

The serviceRegistered event type indicates that the service has been registered.

serviceUnregistering

イベント  
イベントオブジェクトの型: com.adobe.gravity.framework.ServiceEvent
プロパティ ServiceEvent.type = com.adobe.gravity.framework.ServiceEvent.SERVICE_UNREGISTERING

言語バージョン: ActionScript 3.0
製品バージョン: Adobe Digital Enterprise Platform Experience Services - Client Component Framework 10
ランタイムバージョン: AIR 1.1, Flash Player 9

Dispatched when a service is going to be unregistered.

The serviceUnregistering event type indicates that the service is in the process of being unregistered.




[ X ]英語で表示される理由
ActionScript 3.0 リファレンスガイドのコンテンツが英語で表示されます。

ActionScript 3.0 リファレンスガイドのすべての部分がすべての言語に翻訳されているわけではありません。言語エレメントが翻訳されていない場合、そのエレメントは英語で表示されます。例えば、ga.controls.HelpBox クラスはどの言語にも訳されていません。このため、リファレンスガイドの日本語バージョンでは、ga.controls.HelpBox クラスは英語で表示されます。