diff options
Diffstat (limited to 'files/ja/mozilla/tech/xpcom/language_bindings')
27 files changed, 0 insertions, 1283 deletions
diff --git a/files/ja/mozilla/tech/xpcom/language_bindings/components.classes/index.html b/files/ja/mozilla/tech/xpcom/language_bindings/components.classes/index.html deleted file mode 100644 index 0095fbdc58..0000000000 --- a/files/ja/mozilla/tech/xpcom/language_bindings/components.classes/index.html +++ /dev/null @@ -1,109 +0,0 @@ ---- -title: Components.classes -slug: Mozilla/Tech/XPCOM/Language_Bindings/Components.classes -tags: - - 'XPCOM:Language Bindings' - - XPConnect -translation_of: Mozilla/Tech/XPCOM/Language_Bindings/Components.classes ---- -<p> </p> - -<p><code>Components.classes</code> は、プロパティが <a href="ja/ContractID">ContractID</a> によって索引付けされたクラスである、読み出し専用オブジェクトです。</p> - -<h2 id=".E3.81.AF.E3.81.98.E3.82.81.E3.81.AB" name=".E3.81.AF.E3.81.98.E3.82.81.E3.81.AB">はじめに</h2> - -<p><code>Components.classes</code> は、<a href="ja/NsIJSCID">nsIJSCID</a> インターフェースを実装した読み出し専用オブジェクトです。それぞれのオブジェクトは、<a href="ja/XPCOM">XPCOM</a> サービスとして構築またはアクセスされうる XPCOM コンポーネントのクラスのひとつを表します。</p> - -<p>このオブジェクトのプロパティは、コンポーネントクラスの ContractID (または人間が読める形式の名前) で索引付けされています。</p> - -<p>All of the properties and methods of the nsIJSCID and its ancestor interface <a href="ja/NsIJSID">nsIJSID</a> are available for use on the objects contained in this object.</p> - -<p><strong>Note</strong> that <code>Components.classes</code> reflects only those component classes that have been previously installed and registered with the component manager using ContractIDs. If you want to use a class which was only registered with their <a href="ja/CID">CID</a>, use <code><a href="ja/Components.classesByID">Components.classesByID</a></code> instead of <code>Components.classes</code> to retrieve it.</p> - -<p>あるマシンには ContractID を指定されたアドオンコンポーネントが存在し、別のマシンにはインストールされていないこともあり得ます。Components.classes は、以前にインストールされ ProgId を用いてコンポーネントマネージャに登録されたコンポーネントクラスのみを反映します。ですから、あるマシンには ProgID を指定されたアドオンコンポーネントが存在し、別のマシンにはインストールされていないこともあり得ます。<code>Components.classes</code> オブジェクトに与えられた要素がそのマシンに登録されていない場合、その要素にアクセスを試みると、ストリクトモードでは JavaScript の警告が生成され、戻り値は JavaScript の <code><a href="ja/Core_JavaScript_1.5_Reference/Global_Properties/undefined">undefined</a></code> になります。要素にアクセスする際は、あらかじめ <code><a href="ja/Core_JavaScript_1.5_Reference/Operators/Special_Operators/in_Operator">in</a></code> オペレータを使って、その要素をテストするべきです。</p> - -<pre class="eval">if (!("@some/bogus/class;1" in Components.classes)) - // do something... -</pre> - -<p><code>Components.classes</code> オブジェクトのプロパティは <code><a href="ja/Core_JavaScript_1.5_Reference/Statements/for...in">for...in</a></code> ループを使って列挙できます。</p> - -<h2 id=".E4.BD.BF.E3.81.84.E6.96.B9" name=".E4.BD.BF.E3.81.84.E6.96.B9">使い方</h2> - -<h3 id=".E4.B8.8E.E3.81.88.E3.82.89.E3.82.8C.E3.81.9F_ContractID_.E3.81.AE.E3.81.9F.E3.82.81.E3.81.AE.E3.82.AA.E3.83.96.E3.82.B8.E3.82.A7.E3.82.AF.E3.83.88.E3.82.92.E5.8F.96.E5.BE.97.E3.81.99.E3.82.8B" name=".E4.B8.8E.E3.81.88.E3.82.89.E3.82.8C.E3.81.9F_ContractID_.E3.81.AE.E3.81.9F.E3.82.81.E3.81.AE.E3.82.AA.E3.83.96.E3.82.B8.E3.82.A7.E3.82.AF.E3.83.88.E3.82.92.E5.8F.96.E5.BE.97.E3.81.99.E3.82.8B">与えられた ContractID のためのオブジェクトを取得する</h3> - -<p>In order to retrieve the object for a given ContractID, you can query the <code>Components.classes</code> array as follows:</p> - -<pre class="eval">var clazz0 = Components.classes["@mozilla.org/preferences;1"]; -var clazz1 = Components.classes["@mozilla.org/messenger;1"]; -</pre> - -<p>The first line will return you the class object for the ContractID <code>@mozilla.org/preferences;1</code>, the second line will return you the class object for the ContractID <code>@mozilla.org/messenger;1</code>.</p> - -<div class="note"> -<p>It may be helpful to abbreviate <code>Components.classes</code> by storing a reference to the object as a constant:</p> - -<pre class="eval">// use whatever name suits your fancy -- Cc is probably the most common abbreviation -const Cc = Components.classes; -const C = Components.classes; - -var clazz0 = Cc["@mozilla.org/preferences;1"]; -var clazz1 = C["@mozilla.org/messenger;1"]; -</pre> -</div> - -<h3 id="XPCOM_.E3.82.B3.E3.83.B3.E3.83.9D.E3.83.BC.E3.83.8D.E3.83.B3.E3.83.88.E3.81.AE.E3.82.A4.E3.83.B3.E3.82.B9.E3.82.BF.E3.83.B3.E3.82.B9.E3.82.92.E4.BD.9C.E6.88.90.E3.81.99.E3.82.8B" name="XPCOM_.E3.82.B3.E3.83.B3.E3.83.9D.E3.83.BC.E3.83.8D.E3.83.B3.E3.83.88.E3.81.AE.E3.82.A4.E3.83.B3.E3.82.B9.E3.82.BF.E3.83.B3.E3.82.B9.E3.82.92.E4.BD.9C.E6.88.90.E3.81.99.E3.82.8B">XPCOM コンポーネントのインスタンスを作成する</h3> - -<p>An XPCOM component instance can be created from the returned class object as follows:</p> - -<pre class="eval">var clazz = Components.classes["@mozilla.org/messenger;1"]; -var obj = clazz.createInstance(); -</pre> - -<p><code>createInstance()</code> calls will return <a href="ja/XPConnect">XPConnect</a> wrappers for these native objects which only expose the methods of the <a href="ja/NsISupports">nsISupports</a> interface. This is because the specific interface on the component that the caller desires has not been specified. Specifying that interface is done using the properties of the <code><a href="ja/Components.interfaces">Components.interfaces</a></code> object:</p> - -<pre class="eval">var obj = Components.classes["@mozilla.org/supports-array;1"] - .createInstance(Components.interfaces.nsISupportsArray); -</pre> - -<p>which is equivalent to:</p> - -<pre class="eval">var obj = Components.classes["@mozilla.org/supports-array;1"]; - .createInstance() - .QueryInterface(Components.interfaces.nsISupportsArray); -</pre> - -<p>Alternatively, you can use the <code><a href="ja/Core_JavaScript_1.5_Reference/Operators/Special_Operators/new_Operator">new</a></code> operator on the class object to create a new instance of that class:</p> - -<pre class="eval">var clazz = Components.classes["@mozilla.org/supports-array;1"]; -var inst = new clazz(Components.interfaces.nsISupportsArray); -</pre> - -<p>This implicitly calls the <code>createInstance()</code> method for you.</p> - -<h3 id="XPCOM_.E3.82.B5.E3.83.BC.E3.83.93.E3.82.B9.E3.82.B3.E3.83.B3.E3.83.9D.E3.83.BC.E3.83.8D.E3.83.B3.E3.83.88.E3.81.B8.E3.81.AE.E3.82.A2.E3.82.AF.E3.82.BB.E3.82.B9" name="XPCOM_.E3.82.B5.E3.83.BC.E3.83.93.E3.82.B9.E3.82.B3.E3.83.B3.E3.83.9D.E3.83.BC.E3.83.8D.E3.83.B3.E3.83.88.E3.81.B8.E3.81.AE.E3.82.A2.E3.82.AF.E3.82.BB.E3.82.B9">XPCOM サービスコンポーネントへのアクセス</h3> - -<p>既存のインスタンスは、以下のように、サービスとしてアクセスできます。</p> - -<pre class="eval">var clazz = Components.classes["@mozilla.org/preferences;1"]; -var obj = clazz.getService(); -</pre> - -<p><code>getService()</code> は、<code>createInstance()</code> のように、ネイティブオブジェクトへの <a href="ja/XPConnect">XPConnect</a> ラッパーを返し、<a href="ja/NsISupports">nsISupports</a> インターフェースのメソッドのみを見せます。これは、呼び出し側の求めるコンポーネント上の特殊なインターフェースが特定されないようにするためです。このインターフェースの指定は、<code><a href="ja/Components.interfaces">Components.interfaces</a></code> オブジェクトの要素を使って行います。</p> - -<pre class="eval">var clazz = Components.classes["@mozilla.org/preferences;1"] -var srv = clazz.getService(Components.interfaces.nsIPref); -</pre> - -<p>これは以下と同等です。</p> - -<pre class="eval">var clazz = Components.classes["@mozilla.org/preferences;1"] -var obj = clazz.getService(); -var srv = obj.QueryInterface(Components.interfaces.nsIPref); -</pre> - -<h2 id=".E3.81.82.E3.82.8B.E3.82.B3.E3.83.B3.E3.83.9D.E3.83.BC.E3.83.8D.E3.83.B3.E3.83.88.E3.81.AB.E3.81.A4.E3.81.84.E3.81.A6.E3.80.81.E3.82.A4.E3.83.B3.E3.82.B9.E3.82.BF.E3.83.B3.E3.82.B9.E3.81.AE.E4.BD.9C.E6.88.90.E3.81.8C.E5.BF.85.E8.A6.81.E3.81.8B.E3.80.81.E3.82.B5.E3.83.BC.E3.83.93.E3.82.B9.E3.81.A8.E3.81.97.E3.81.A6.E5.88.A9.E7.94.A8.E5.8F.AF.E8.83.BD.E3.81.8B.E3.82.92.E8.AA.BF.E3.81.B9.E3.82.8B" name=".E3.81.82.E3.82.8B.E3.82.B3.E3.83.B3.E3.83.9D.E3.83.BC.E3.83.8D.E3.83.B3.E3.83.88.E3.81.AB.E3.81.A4.E3.81.84.E3.81.A6.E3.80.81.E3.82.A4.E3.83.B3.E3.82.B9.E3.82.BF.E3.83.B3.E3.82.B9.E3.81.AE.E4.BD.9C.E6.88.90.E3.81.8C.E5.BF.85.E8.A6.81.E3.81.8B.E3.80.81.E3.82.B5.E3.83.BC.E3.83.93.E3.82.B9.E3.81.A8.E3.81.97.E3.81.A6.E5.88.A9.E7.94.A8.E5.8F.AF.E8.83.BD.E3.81.8B.E3.82.92.E8.AA.BF.E3.81.B9.E3.82.8B">あるコンポーネントについて、インスタンスの作成が必要か、サービスとして利用可能かを調べる</h2> - -<p>It is not possible to programmatically determine if a given component has to be instantiated or used as a service.</p> - -<p>Often, this is stated in the documentation of the component you want to use. If this is not the case, you might want to try and find example usages of that component within <a class="external" href="http://lxr.mozilla.org/mozilla/search">LXR</a>.</p> diff --git a/files/ja/mozilla/tech/xpcom/language_bindings/components.classesbyid/index.html b/files/ja/mozilla/tech/xpcom/language_bindings/components.classesbyid/index.html deleted file mode 100644 index ca8065fee2..0000000000 --- a/files/ja/mozilla/tech/xpcom/language_bindings/components.classesbyid/index.html +++ /dev/null @@ -1,20 +0,0 @@ ---- -title: Components.classesByID -slug: Mozilla/Tech/XPCOM/Language_Bindings/Components.classesByID -tags: - - 'XPCOM:Language Bindings' - - XPConnect -translation_of: Mozilla/Tech/XPCOM/Language_Bindings/Components.classesByID ---- -<p> -</p><p><code>Components.classesByID</code> は、プロパティが <a href="ja/CID">CID</a> によって索引付けされたクラスである、読み出し専用オブジェクトです。 -</p> -<h2 id="はじめに"> はじめに </h2> -<p><code>Components.classesByID</code> は、<a href="ja/NsIJSCID">nsIJSCID</a> インターフェースを実装した読み出し専用オブジェクトです。それぞれのオブジェクトは、<a href="ja/XPCOM">XPCOM</a> サービスとして構築またはアクセスされうる XPCOM コンポーネントのクラスのひとつを表します。 -</p><p><code>Components.classesByID</code> は、要素が CID の「標準的な」形式で索引付けされている以外は <code><a href="ja/Components.classes">Components.classes</a></code> と同様です。また、コンポーネントマネージャによって <a href="ja/ContractID">ContractID</a> を使って登録されたコンポーネントクラスだけでなく、プレーンの CID を使って登録されたクラスも表します。 -</p> -<h2 id="使い方"> 使い方 </h2> -<p>In order to retrieve the object for a given CID, you can use that CID as an index with <code>Components.classesByID</code> as follows: -</p> -<pre class="eval">var clazz = Components.classesByID["{ed132c20-eed1-11d2-baa4-00805f8a5dd7}"]; -</pre> diff --git a/files/ja/mozilla/tech/xpcom/language_bindings/components.constructor/index.html b/files/ja/mozilla/tech/xpcom/language_bindings/components.constructor/index.html deleted file mode 100644 index dba394eb69..0000000000 --- a/files/ja/mozilla/tech/xpcom/language_bindings/components.constructor/index.html +++ /dev/null @@ -1,109 +0,0 @@ ---- -title: Components.Constructor -slug: Mozilla/Tech/XPCOM/Language_Bindings/Components.Constructor -tags: - - 'XPCOM:Language Bindings' - - XPConnect -translation_of: Mozilla/Tech/XPCOM/Language_Bindings/Components.Constructor ---- -<p> -</p><p><span id="Summary"></span> -</p> -<h3 id="概要"> 概要 </h3> -<p>XPCOM コンポーネントの新規インスタンスを作成/生成するのに使用できる JavaScript 関数を作成します。 -</p><p><span id="Syntax"></span> -</p> -<h3 id="構文"> 構文 </h3> -<pre class="eval">var func = [ new ] Components.Constructor(<i>contractID</i> [, <i>interfaceName</i> [, <i>initializer</i> ] ]); -</pre> -<p><span id="Parameters"></span> -</p> -<h3 id="パラメータ"> パラメータ </h3> -<dl><dt> <code>contractID</code></dt><dd> コンポーネントのコントラクト ID を含む文字列 -</dd><dt> <code>interfaceName</code> </dt><dd> 与えられると、新規作成されるインスタンスそれぞれに対してこの文字列の名前のインターフェイスで <a href="ja/NsISupports/QueryInterface">QueryInterface</a> が呼び出される -</dd><dt> <code>initializer</code> </dt><dd> 与えられると、この文字列の名前の関数が、新規作成されるインスタンスに対してその時に与えられる引数を使って呼び出される -</dd></dl> -<p><span id="Description"></span> -</p> -<h3 id="説明"> 説明 </h3> -<p><code>Components.Constructor()</code> は XPCOM コンポーネントのインスタンス作成に便利なショートカットです。これを使うと、インスタンスを作りたい時に毎回 <code>Components.classes</code>、<code>Components.interfaces</code>、<code>createInstance</code> などをタイピングする手間が無くなります。また、より <a href="ja/JavaScript">JavaScript</a> 的な構文で XPCOM オブジェクトを作成できるようになります。もう一つの重要な恩恵として、<code>Components.Constructor()</code> はいくつかの計算をあらかじめ行うので、<code>Components.Constructor()</code> から返される関数を使って XPCOM オブジェクトを作成した方が下記に示すように基本原則に基づいてオブジェクトを作成するよりも高速になります。 (JavaScript エンジンと XPCOM の間のレイヤーをまたぐ回数がより少なくて済むというのも高速になる理由の一つです。) -</p><p><code>Components.Constructor()</code> によって返される関数のふるまいは、 <code>Components.Constructor()</code> が呼び出されたときに与えられた引数によって異なります。与えられた引数が 1 つだけなら、その引数は作成される XPCOM コンポーネントの<a href="ja/Contract_ID">コントラクト ID</a> になります。コンポーネントはすぐ返されますが、そのコンポーネントからは基本インターフェイスの <code><a href="ja/NsISupports">nsISupports</a></code> しか利用できません。なのでそのオブジェクトのメソッドを呼び出すためにはそれに対して <a href="ja/NsISupports/QueryInterface">QueryInterface</a> を呼び出さなければなりません。例えば、 -</p> -<pre class="eval">var BinaryInputStream = Components.Constructor("@mozilla.org/binaryinputstream;1"); -var bis = new BinaryInputStream(); -print(bis.toString()); // "[xpconnect wrapped nsISupports]" - -try -{ - // someInputStream は既存の nsIInputStream - // bis は nsIBinaryInputStream に QI されていないのでエラーを投げる - bis.setInputStream(someInputStream); -} -catch (e) -{ - bis.QueryInterface(Components.interfaces.nsIBinaryInputStream); - bis.setInputStream(someInputStream); // これで成功 -} -</pre> -<p>引数が 2 つ与えられると、作成されるインスタンスは第 2 引数の名前を持つ XPCOM インターフェイスに <code><a href="ja/NsISupports/QueryInterface">QueryInterface</a></code> されます。 -</p> -<pre class="eval">var BinaryInputStream = Components.Constructor("@mozilla.org/binaryinputstream;1", - "nsIBinaryInputStream"); -var bis = new BinaryInputStream(); -print(bis.toString()); // "[xpconnect wrapped nsIBinaryInputStream]" - -// someInputStream は既存の nsIInputStream -bis.setInputStream(someInputStream); // 成功 -</pre> -<p>引数が 3 つ与えられると、インスタンスに対して <code><a href="ja/NsISupports/QueryInterface">QueryInterface</a></code> されるだけでなく、初期化メソッドも呼び出されたことになります。初期化メソッドに使われる引数は、<code>Components.Constructor()</code> によって作成された関数を呼び出す時に渡された引数です。 -</p> -<pre class="eval">var BinaryInputStream = Components.Constructor("@mozilla.org/binaryinputstream;1", - "nsIBinaryInputStream", - "setInputStream"); -try -{ - // 引数の数が nsIBinaryInputStream.setInputStream が - // 取るものと異なるのでエラーを投げる - var bis = new BinaryInputStream(); -} -catch (e) -{ - // someInputStream は既存の nsIInputStream - bis = new BinaryInputStream(someInputStream); // 成功 - var bytes = bis.readByteArray(<i>someNumberOfBytes</i>); // 成功 -} -</pre> -<p>基本原則に基づいたインスタンスの作成と <code>Components.Constructor()</code> を使ったインスタンスの作成を比較して下さい。後者の方が前者よりもずっと (たくさんの違う場所でコンポーネントのインスタンスを作成している場合には特に) 読みやすくなります。 -</p> -<pre class="eval">var bis = Components.classes["@mozilla.org/binaryinputstream;1"] - .createInstance(Components.interfaces.nsIBinaryInputStream); -bis.setInputStream(someInputStream); -</pre> -<pre class="eval">// 前もって BinaryInputStream が初期化されているとして -var bis = new BinaryInputStream(someInputStream); -</pre> -<p><code>Components.Constructor()</code> は、他の一般的なメソッドを使って実現できる挙動のシンタックスシュガーに過ぎません (高速できれいなシンタックスシュガーですが)。 次の JavaScript 関数と等価です。 -</p> -<pre class="eval">function Components_Constructor(contractID, interfaceName, initializer) -{ - var ccArgs = arguments; - - function ctor() - { - var instance = Components.classes[contractID] - .createInstance(Components.interfaces.nsISupports); - - if (ccArgs.length > 1) - { - instance.QueryInterface(Components.interfaces[interfaceName]); - - if (ccArgs.length > 2) - instance[initializer].apply(instance, arguments); - } - - return instance; - } - - return ctor; -} -</pre> diff --git a/files/ja/mozilla/tech/xpcom/language_bindings/components.exception/index.html b/files/ja/mozilla/tech/xpcom/language_bindings/components.exception/index.html deleted file mode 100644 index f7a4540734..0000000000 --- a/files/ja/mozilla/tech/xpcom/language_bindings/components.exception/index.html +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: Components.Exception -slug: Mozilla/Tech/XPCOM/Language_Bindings/Components.Exception -tags: - - 'XPCOM:Language Bindings' - - XPConnect -translation_of: Mozilla/Tech/XPCOM/Language_Bindings/Components.Exception ---- -<p> -</p> -<h3 id="要約"> 要約 </h3> -<p><code>Components.Exception</code> は、nsIXPCException オブジェクトを作る JavaScript コンストラクタです。これらの例外オブジェクトは JavaScript で XPCOM インターフェースを実装する際に投げられるでしょう。例外が補足 (catch) できなかった場合、単純に <code>nsresult</code> の値を投げるよりも、この方がエラーコンソールにより分かりやすい診断結果を表示できるでしょう。 -</p><p><a href="ja/NsIXPCException">nsIXPCException</a> もご覧ください。 -</p> -<h3 id="構文"> 構文 </h3> -<pre class="eval">var exception = [ new ] Components.Exception([ <i>message</i> [, <i>result</i> [, <i>stack</i> [, <i>data</i> ] ] ] ]); -</pre> -<h3 id="パラメータ"> パラメータ </h3> -<dl><dt> <code>message</code> </dt><dd> 例外が投げられた場合に、あるいは開発者が指定した場所で、エラーコンソールに表示する文字列。デフォルトは「exception」 -</dd><dt> <code>result</code> </dt><dd> 例外の <code>nsresult</code> 値。デフォルトは <code>NS_ERROR_FAILURE</code> -</dd><dt> <code>stack</code> </dt><dd> 例外にセットされる XPCOM スタック。デフォルトは現在のスタックチェーン -</dd><dt> <code>data</code> </dt><dd> 保存したい任意の追加データ。デフォルトは <code>null</code> -</dd></dl> -<h3 id="実例"> 実例 </h3> -<pre class="eval">throw Components.Exception("I am throwing an Exception from a Javascript XPCOM component."); -</pre> diff --git a/files/ja/mozilla/tech/xpcom/language_bindings/components.id/index.html b/files/ja/mozilla/tech/xpcom/language_bindings/components.id/index.html deleted file mode 100644 index 5908f888b6..0000000000 --- a/files/ja/mozilla/tech/xpcom/language_bindings/components.id/index.html +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: Components.ID -slug: Mozilla/Tech/XPCOM/Language_Bindings/Components.ID -tags: - - 'XPCOM:Language Bindings' - - XPConnect -translation_of: Mozilla/Tech/XPCOM/Language_Bindings/Components.ID ---- -<p> -</p> -<h3 id="要約"> 要約 </h3> -<p><code>Components.ID</code> は、<code><a href="/ja/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIJSID" title="">nsIJSID</a></code> インターフェースに合わせたネイティブオブジェクトを作成するコンストラクタです。 -</p> -<h3 id="構文"> 構文 </h3> -<pre class="eval">var interfaceID = [ new ] Components.ID(iid); -</pre> -<h3 id="パラメータ"> パラメータ </h3> -<dl><dt> <code>iid</code></dt><dd> A string of the format <code>'{00000000-0000-0000-0000-000000000000}'</code> giving the interface ID of the interface -</dd></dl> -<h3 id="説明"> 説明 </h3> -<p><code>Components.ID</code> は、インターフェース ID をパラメータとして取る、QueryInterface、getInterfaces などのメソッドを実装するために使われるインターフェース ID を作成します。 -</p><p><code><a href="ja/Components.classes">Components.classes</a></code>、<code><a href="ja/Components.classesByID">Components.classesByID</a></code>、<code><a href="ja/Components.interfaces">Components.interfaces</a></code> は、ほとんどの JavaScript コードが扱うことのない <code>nsID</code> をほぼすべて提供します。Components.classes, Components.classesByID, Components.interfaces はほとんどの JavaScript コードが扱う必要がある nsID のほぼ全てです。例外は、コンポーネントが JavaScript で書かれていて、自身を独自の <code>nsID</code> でコンポーネントマネージャに登録する必要がある場合です。その際の ID は未登録のため、<code><a href="ja/Components.classes">Components.classes</a></code> には現れません。 -</p> diff --git a/files/ja/mozilla/tech/xpcom/language_bindings/components.interfaces/index.html b/files/ja/mozilla/tech/xpcom/language_bindings/components.interfaces/index.html deleted file mode 100644 index 8105f7f239..0000000000 --- a/files/ja/mozilla/tech/xpcom/language_bindings/components.interfaces/index.html +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: Components.interfaces -slug: Mozilla/Tech/XPCOM/Language_Bindings/Components.interfaces -tags: - - 'XPCOM:Language Bindings' - - XPConnect -translation_of: Mozilla/Tech/XPCOM/Language_Bindings/Components.interfaces ---- -<p> -</p><p><code>Components.interfaces</code> は、プロパティがそれらの名前によって索引付けされたクラスである、読み出し専用オブジェクトです。 -</p> -<h2 id="はじめに"> はじめに </h2> -<p><code>Components.interfaces</code> は、<a href="ja/NsIJSCID">nsIJSCID</a> インターフェースを実装した読み出し専用オブジェクトです。それぞれのオブジェクトは、いくつかのコンポーネントが実装している (あるいは未実装の可能性もあります) <a href="ja/XPCOM">XPCOM</a> インターフェースのひとつを表します。 -</p><p><br> -対応する <code>.idl</code> の宣言が <code>[scriptable]</code> として設計されたインターフェースのみを反映します。つまり、<a href="ja/XPConnect">XPConnect</a> が JavaScript へ反映することのできるインターフェースということです。 -</p><p><code>Components.interfaces</code> オブジェクトのプロパティは、<code>nsID</code> nsID 型のパラメータを除いた XPCOM メソッドで利用されます。これには <code><a href="ja/NsISupports">nsISupports</a>::<a href="ja/NsISupports/QueryInterface">QueryInterface</a></code>、<code>nsICID::getService</code> が受け取る追加パラメータ、<code>nsICID::createInstance</code> (JavaScript から呼ばれた場合)、<code><a href="ja/NsIClassInfo">nsIClassInfo</a>::<a href="ja/NsIClassInfo/getInterfaces">getInterfaces</a></code> が含まれます。 -</p><p><code>Components.interfaces</code> オブジェクトのプロパティは <code><a href="ja/Core_JavaScript_1.5_Reference/Statements/for...in">for...in</a></code> ループを使って列挙できます。 -</p> -<h2 id="使い方"> 使い方 </h2> -<h3 id="インターフェースオブジェクトへのアクセス"> インターフェースオブジェクトへのアクセス </h3> -<p><code>Components.interfaces</code> オブジェクトのプロパティはインターフェース名で索引付けされます。インターフェースオブジェクトは以下のようにして取得できます。 -</p> -<pre class="eval">var iface = Components.interfaces.nsISupportsArray; -</pre> -<p>この戻り値は <code>nsISupportsArray</code> インターフェースのインターフェースオブジェクトです。 -</p> -<h3 id="インターフェースで定義されたコンスタントへのアクセス"> インターフェースで定義されたコンスタントへのアクセス </h3> -<p>Interface descriptions (cf. <a href="ja/XPIDL">XPIDL</a>) may not only contain method declarations, but also constants. For example, assume we have the following interface declaration: -</p> -<pre class="eval">interface nsIFoo : nsISupports { - const PRUint32 MYFLAG = 5; -}; -</pre> -<p>The constant <code>MYFLAG</code> can then be accessed using -</p> -<pre class="eval">var myFlag = Components.interfaces.nsIFoo.MYFLAG; -</pre> diff --git a/files/ja/mozilla/tech/xpcom/language_bindings/components.lastresult/index.html b/files/ja/mozilla/tech/xpcom/language_bindings/components.lastresult/index.html deleted file mode 100644 index d830cc301c..0000000000 --- a/files/ja/mozilla/tech/xpcom/language_bindings/components.lastresult/index.html +++ /dev/null @@ -1,57 +0,0 @@ ---- -title: Components.lastResult -slug: Mozilla/Tech/XPCOM/Language_Bindings/Components.lastResult -tags: - - 'XPCOM:Language Bindings' - - XPConnect -translation_of: Mozilla/Tech/XPCOM/Language_Bindings/Components.lastResult ---- -<p> -</p><p><code>Components.lastResult</code> は XPConnect を介した直前の <a href="ja/XPCOM">XPCOM</a> メソッド呼び出しの結果コードである数値コード <code>nsresult</code> を返します。 -</p> -<h2 id="はじめに"> はじめに </h2> -<p><code>Components.lastResult</code> は一般的に、「成功」コードを返す XPCOM メソッドの結果のテストにのみ役立ちます。というのは、失敗した結果コードは XPConnect が例外に変換して、呼び出し元の JavaScript メソッドへ投げるからです。ほとんどのインターフェースは 1 つの成功コード (<code>NS_OK</code>) だけを返すので、<code>Components.lastResult</code> はほとんど必要ありません。 -</p><p><code>Components.lastResult</code> が利用される場合は、対象の呼び出しの後テストのためにローカル変数に保存することが、複数のテストを <code>Components.lastResult</code> に対して行うよりも適当です。多くの「Components」プロパティとメソッドは XPConnect で実装されていて、それに続く <code>Components.lastResult</code> 呼び出しは対象とした呼び出しでなく「暗黙的な」 XPConnect 呼び出しの結果を返すかもしれないからです。 -</p> -<h2 id="実例"> 実例 </h2> -<p>In the following example, the local variable <code>i</code> contains the actual result returned by <code>bar()</code> (assuming that <code>bar()</code> is called via XPConnect), and <code>Components.lastResult</code> contains the success code returned by <code>bar()</code>. -</p> -<pre class="eval">// Given that foo.bar is a method that might return -// the success codes NS_OK, '5', and '6' OR some error code... -try -{ - var i = foo.bar(); - - switch (Components.lastResult) - { - case Components.results.NS_OK: - // NS_OK is good! - break; - case 5: - // do something with 5 here - break; - case 6: - // do something with 6 here - break; - default: - // this was a success code we did not expect. Bad component! - break; - } - // and so on.... -} -catch (e) -{ - // the call threw an exception or a native component returned - // a failure code! - if (e instanceof Components.interfaces.nsIXPCException) - { - // we might do something interesting here with the exception object - var rv = e.result; - } - else - { - // if we don't know how to handle it then rethrow - throw e; - } -} -</pre> diff --git a/files/ja/mozilla/tech/xpcom/language_bindings/components.manager/index.html b/files/ja/mozilla/tech/xpcom/language_bindings/components.manager/index.html deleted file mode 100644 index 29aea92083..0000000000 --- a/files/ja/mozilla/tech/xpcom/language_bindings/components.manager/index.html +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: Components.manager -slug: Mozilla/Tech/XPCOM/Language_Bindings/Components.manager -tags: - - 'XPCOM:Language Bindings' - - XPConnect -translation_of: Mozilla/Tech/XPCOM/Language_Bindings/Components.manager ---- -<p> -</p><p><code>Components.manager</code> はグローバルなネイティブコンポーネントマネージャーサービスの便利な反映です。<a href="ja/NsIComponentManager">nsIComponentManager</a> インターフェースのスクリプト可能なメソッドはこのオブジェクトで直接呼び出しできます。 -</p> diff --git a/files/ja/mozilla/tech/xpcom/language_bindings/components.results/index.html b/files/ja/mozilla/tech/xpcom/language_bindings/components.results/index.html deleted file mode 100644 index 129d147668..0000000000 --- a/files/ja/mozilla/tech/xpcom/language_bindings/components.results/index.html +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: Components.results -slug: Mozilla/Tech/XPCOM/Language_Bindings/Components.results -tags: - - 'XPCOM:Language Bindings' - - XPConnect -translation_of: Mozilla/Tech/XPCOM/Language_Bindings/Components.results ---- -<p> -</p><p><code>Components.results</code> は、<code><a href="https://dxr.mozilla.org/mozilla-central/source/js/src/xpconnect/src/xpc.msg" rel="custom">js/src/xpconnect/src/xpc.msg</a></code> にあるマクロの最初のパラメータとしてリストされた名前のプロパティを持つ、読み出し専用オブジェクトです。各オブジェクトの値はそのコンスタントの値に対応しています。 -</p> -<h2 id="はじめに"> はじめに </h2> -<p><code>Components.results</code> は、よく知られた XPCOM の結果コードの名前をプロパティに持つオブジェクトで、それぞれの値は対応する結果コードに対応しています。このオブジェクトのプロパティは、未知の nsresult 変数をテストするのに利用したり、失敗を示すために「投げ」たりできます。 -</p> -<pre class="eval"> if(something_unexpected_happened) - throw Components.results.NS_ERROR_UNEXPECTED; -</pre> -<p><code>Components.results</code> オブジェクトのプロパティは <code><a href="ja/Core_JavaScript_1.5_Reference/Statements/for...in">for...in</a></code> ループを使って列挙できます。 -</p> -<h2 id="使い方"> 使い方 </h2> -<h3 id="nsISupports_の実装"> <code><a href="/ja/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsISupports" title="">nsISupports</a></code> の実装 </h3> -<p>The standard <code><a href="/ja/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsISupports" title="">nsISupports</a></code> is usually implemented in JavaScript by using <code>Components.results</code> to get a failure return value if <code> does not implement the given interface. Note the common use of an abbreviation for <code>Components.results</code>, <code>Cr</code>: -</p> -<pre class="eval">const Ci = Components.interfaces, Cr = Components.results; - -function Class() -{ - /* ... */ -} -Class.prototype = -{ - /* ... */ - QueryInterface: function(id) - { - if (id.equals(Ci.IMyInterface)) - return this; - throw Cr.NS_ERROR_NO_INTERFACE; - } -}; -</pre> diff --git a/files/ja/mozilla/tech/xpcom/language_bindings/components.returncode/index.html b/files/ja/mozilla/tech/xpcom/language_bindings/components.returncode/index.html deleted file mode 100644 index ad0542e783..0000000000 --- a/files/ja/mozilla/tech/xpcom/language_bindings/components.returncode/index.html +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: Components.returnCode -slug: Mozilla/Tech/XPCOM/Language_Bindings/Components.returnCode -tags: - - 'XPCOM:Language Bindings' - - XPConnect -translation_of: Mozilla/Tech/XPCOM/Language_Bindings/Components.returnCode ---- -<p> -</p><p><code>Components.returnCode</code> は、<code>return</code> 命令による戻り値に加えて <a href="ja/XPCOM">XPCOM</a> の結果コードを保持できるプロパティです。 -</p> -<div class="warning"> -<p>Note that <code>Components.returnCode</code> is currently non-functional due to <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=287107" title='FIXED: xpcwrappedjsclass.cpp rev 1.73 regressed "return" of NS_COMFALSE (Components.returnCode)'>バグ 287107</a>. This problem was introduced in Mozilla 1.4. -</p> -</div> -<h2 id=".E4.BD.BF.E3.81.84.E6.96.B9" name=".E4.BD.BF.E3.81.84.E6.96.B9"> 使い方 </h2> -<p><code>Components.returnCode</code> は、JavaScript メソッドが特定の <code>nsresult</code> コードを返すことを、そのメソッドの XPCOM 呼び出し元へ示すのに利用できるプロパティです。 -</p><p>一般的には、<a href="ja/XPConnect">XPConnect</a> は JavaScript コードが <code>nsresult</code> コードを心配する必要のないようにうまく働きます。デフォルトでは、JavaScript メソッドの結果が成功だと、XPConnect は結果コード <code>NS_OK</code> を呼び出し元へ返します。もし JavaScript コードが失敗のシグナルを送る必要がある場合は、例外を投げることで果たします。しかし、成功コードの返り値を規定した XPCOM インターフェースがごくわずかに存在します。<code>Components.returnCode</code> はそれら稀なインターフェースを JavaScript で実装できるようにするために存在します。 </p> -<h2 id=".E5.AE.9F.E4.BE.8B" name=".E5.AE.9F.E4.BE.8B"> 実例 </h2> -<pre class="eval">var foo = { - bar: function(i) { - if (yada_yada) - Components.returnCode = 5; - - return i * 2; - } -}; -</pre> diff --git a/files/ja/mozilla/tech/xpcom/language_bindings/components.stack/index.html b/files/ja/mozilla/tech/xpcom/language_bindings/components.stack/index.html deleted file mode 100644 index f5b60e5c92..0000000000 --- a/files/ja/mozilla/tech/xpcom/language_bindings/components.stack/index.html +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: Components.stack -slug: Mozilla/Tech/XPCOM/Language_Bindings/Components.stack -tags: - - 'XPCOM:Language Bindings' - - XPConnect -translation_of: Mozilla/Tech/XPCOM/Language_Bindings/Components.stack ---- -<p> -</p><p><code>Components.stack</code> は、現在の JavaScript コールスタックのスナップショットを表す <a href="ja/NsIStackFrame">nsIStackFrame</a> (<a href="https://dxr.mozilla.org/mozilla-central/source/xpcom/base/nsIException.idl#50" rel="custom">IDL 定義</a>) 型の読み出し専用プロパティです。これは様々な診断目的で利用できます。 -</p> diff --git a/files/ja/mozilla/tech/xpcom/language_bindings/components.utils.evalinsandbox/index.html b/files/ja/mozilla/tech/xpcom/language_bindings/components.utils.evalinsandbox/index.html deleted file mode 100644 index 6c0cd7bf78..0000000000 --- a/files/ja/mozilla/tech/xpcom/language_bindings/components.utils.evalinsandbox/index.html +++ /dev/null @@ -1,34 +0,0 @@ ---- -title: Components.utils.evalInSandbox -slug: Mozilla/Tech/XPCOM/Language_Bindings/Components.utils.evalInSandbox -tags: - - Add-ons - - Developing Mozilla - - Extensions - - JavaScript - - 'XPCOM:Language Bindings' - - XPConnect -translation_of: Mozilla/Tech/XPCOM/Language_Bindings/Components.utils.evalInSandbox ---- -<p> -</p> -<h3 id="はじめに"> はじめに </h3> -<p>制限付き特権を持つ環境下で <a href="ja/JavaScript">JavaScript</a> のコードを評価したい場合があるかもしれません。<a href="ja/Firefox_1.5">Firefox 1.5</a> (Gecko 1.8) 以降にはこのための API が存在します。それにはそのコンテキスト内でコードを作成し、評価できる「サンドボックス (sandbox)」という概念が含まれています。このメソッドを用いて評価されるコードは常に普通のウェブページと同様の制限付き特権を持つ環境下で評価されます。 -</p> -<h4 id="使用法"> 使用法 </h4> -<p>evalInSandbox を使用するには、まず <code>Components.utils.Sandbox</code> というコンストラクタを用いてサンドボックスオブジェクトを作成する必要があります。サンドボックスは主要な URI で初期化しなければなりません。この URI は同一生成元 (same origin) セキュリティチェックに使用されます。例えば、<code><span>http://www.example.com/</span></code> という URI を渡すと、このサンドボックスを用いて評価されるコードは <span>http://www.example.com</span> からのデータにアクセスできるようになります。ウェブページの JavaScript から <code><a href="ja/DOM/document.domain">document.domain</a></code> をセットして同一生成元セキュリティチェックを変更することができるため、DOM window オブジェクトをサンドボックスのコンストラクタに渡してしまうこともできます。 -</p> -<pre>// 主要な URI を渡してサンドボックスを作成 -var s = Components.utils.Sandbox("http://www.example.com/"); -// サンドボックスオブジェクトは実行するスクリプトに対して -// グローバルスコープを持つ -s.y = 5; -var result = Components.utils.evalInSandbox("x = y + 2; x + 3", s); -// result は 10、s.x は 7 となる - -s.foo = Components; -// この場合は "Permission Denied" というエラーが生じる -Components.utils.evalInSandbox("foo.classes", s); -</pre> -<div class="noinclude"> -</div> diff --git a/files/ja/mozilla/tech/xpcom/language_bindings/components.utils.forcegc/index.html b/files/ja/mozilla/tech/xpcom/language_bindings/components.utils.forcegc/index.html deleted file mode 100644 index cafc9f1ca9..0000000000 --- a/files/ja/mozilla/tech/xpcom/language_bindings/components.utils.forcegc/index.html +++ /dev/null @@ -1,20 +0,0 @@ ---- -title: Components.utils.forceGC -slug: Mozilla/Tech/XPCOM/Language_Bindings/Components.utils.forceGC -tags: - - NeedsContent - - 'XPCOM:Language Bindings' - - XPConnect -translation_of: Mozilla/Tech/XPCOM/Language_Bindings/Components.utils.forceGC ---- -<p>このメソッドはスクリプトにガベージコレクションサイクルを強制します。 JavaScript ヒープがある大きさを超えると Mozilla JavaScript エンジンは自動的にガベージコレクションを実行するでしょう。もっとも、この機構は JS オブジェクトにぶら下がる ネイティブ (C++) XPCOM オブジェクトを把握してはいません。多くの場合、 JavaScript アプリケーションは巨大な XPCOM (のツリー) を参照している JavaScript オブジェクトについての内部情報を持っており、いつ参照しなくなるかを知っています。この場合 JavaScript からガベージコレクションサイクルを強制できることが重要になることがあります。</p> - -<p>ガベージコレクションを強制することは、他にも<a href="ja/Components.utils.getWeakReference">弱い JavaScript 参照</a>のハッシュからの死んだ参照 (<span style="color: green;">dead reference</span>)をクリーニングする前です。</p> - -<p>このメソッドを使う人はガベージコレクションが非常に負担の大きい (<span style="color: green;">expensive</span>)操作で、絶対必要だと<strong>知っている</strong> 時のみ使用すべきだとことに注意してください。</p> - -<div class="note"><strong>注</strong>: <code><a href="https://developer.mozilla.org/ja/docs/XPCOM_Interface_Reference/nsIDOMWindowUtils#garbageCollect()">nsIDOMWindowUtils.garbageCollect()</a></code> は同様の機能を提供しますが、 JavaScript エンジンのガベージコレクターに加えてサイクルコレクターも起動します。これにより、ガベージコレクターに依存するテストケースなど、 JavaScript オブジェクトのサイクルを構築する XPCOM コンポーネントも回収されることが重要になるかもしれないと分かるでしょう。</div> - -<p><code>UniversalXPConnect</code> 特権が必要です。</p> - -<p>もし、実行されている JavaScript コードがない状態で、将来的にガベージコレクションを起こすことをスケジューリングしたい場合は、代わりに <a href="/en/Components.utils.schedulePreciseGC" title="en/Components.utils.schedulePreciseGC"><code>Components.utils.schedulePreciseGC()</code></a> を使用することができます。</p> diff --git a/files/ja/mozilla/tech/xpcom/language_bindings/components.utils.getweakreference/index.html b/files/ja/mozilla/tech/xpcom/language_bindings/components.utils.getweakreference/index.html deleted file mode 100644 index 7d07c19b32..0000000000 --- a/files/ja/mozilla/tech/xpcom/language_bindings/components.utils.getweakreference/index.html +++ /dev/null @@ -1,45 +0,0 @@ ---- -title: Components.utils.getWeakReference -slug: Mozilla/Tech/XPCOM/Language_Bindings/Components.utils.getWeakReference -tags: - - XPCOM - - 'XPCOM:Language Bindings' - - XPConnect -translation_of: Mozilla/Tech/XPCOM/Language_Bindings/Components.utils.getWeakReference ---- -<p>このメソッドは <a href="ja/Firefox_3">Firefox 3</a> で導入され、オブジェクトの弱い参照 (<span style="color: green;">weak reference</span>)を得るために使います。オブジェクトの参照を得るには、結果のオブジェクトに対して <code>get()</code> を実行する必要があります。</p> - -<p>加えて、 <code>get()</code> が成功しても、オブジェクトが有効であるとは限りません。単にまだガベージコレクトされていないからかもしれないからです。オブジェクトが本当に欲しいものであるかを確認するには、 (DOM ノードの <a href="/ja/docs/Web/API/Node/parentNode" title="指定されたノードの DOM ツリー内の親ノードを返します。"><code>Node.parentNode()</code></a> のように) 他の角度からチェックする必要があります。</p> - -<h3 id="文法">文法</h3> - -<pre>weakRef = Components.utils.getWeakReference(<em>obj</em>); -</pre> - -<h4 id="引数">引数</h4> - -<dl> - <dt><code>obj</code></dt> - <dd>弱い参照を得ようとするオブジェクト。</dd> -</dl> - -<div class="note"> -<p><strong>注:</strong> <span title="(Firefox 11.0 / Thunderbird 11.0 / SeaMonkey 2.8)">Gecko 11.0</span> では、 このメソッドは <code>obj</code> が <code>null</code> の場合に例外を投げるように変更されました。 <span title="(Firefox 12.0 / Thunderbird 12.0 / SeaMonkey 2.9)">Gecko 12.0</span> で、暗黙に失敗するという以前の動作に戻されました。</p> -</div> - -<h3 id="例">例</h3> - -<p>こちらの例では、ウィンドウへの弱い参照を把握します。そして後から、配列の中から一致するものを探して使用します。</p> - -<pre>var arr = []; - -arr.push(Cu.getWeakReference(window)); - -// この部分は他のブロックで実行されます。 -for (var i=0; i<arr.length; i++) { - if (arr[i].get() == window) { - // ウィンドウが見つかった - break; - } -} -</pre> diff --git a/files/ja/mozilla/tech/xpcom/language_bindings/components.utils.import/index.html b/files/ja/mozilla/tech/xpcom/language_bindings/components.utils.import/index.html deleted file mode 100644 index 68cf7c5539..0000000000 --- a/files/ja/mozilla/tech/xpcom/language_bindings/components.utils.import/index.html +++ /dev/null @@ -1,118 +0,0 @@ ---- -title: Components.utils.import -slug: Mozilla/Tech/XPCOM/Language_Bindings/Components.utils.import -tags: - - NeedsContent - - 'XPCOM:Language Bindings' - - XPConnect -translation_of: Mozilla/Tech/XPCOM/Language_Bindings/Components.utils.import ---- -<p>このメソッドは <a href="/ja/Firefox_3_for_developers" title="ja/Firefox_3_for_developers">Firefox 3</a> で導入され、異なるスコープ間でコードを簡単に共有するのに使われます。例えば、自分のコンポーネントの中で、コンポーネント登録の長い定型文をコピー＆ペーストすることを避けるために <a href="/ja/XPCOMUtils.jsm" title="ja/XPCOMUtils.jsm">XPCOMUtils.jsm</a> をインポートすることができます。</p> - -<p>詳細は、<a href="/ja/JavaScript_code_modules/Using" title="ja/Using_JavaScript_code_modules">JavaScript コードモジュールの利用</a> を参照してください。</p> - -<div class="note"> -<p><strong>注記:</strong> <span title="(Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1)">Gecko 2.0</span> 以前、JavaScript コードモジュールは <strong>file:</strong> URL または <strong>resource:</strong> URL のみでしか読み込めませんでした。<span title="(Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1)">Gecko 2.0</span> で <strong>chrome:</strong> URL からの読み込みに対応しました。JAR アーカイブ内にあっても使用できます。</p> -</div> - -<p><span id="Syntax"></span></p> - -<h3 id="Syntax" name="Syntax">構文</h3> - -<pre class="eval">Components.utils.import<em>(url</em> [, <em>scope</em>]); - -// 上記のコードでは jslint などの構文チェックツールコンパイラエラーが報告される場合は以下のように書けます。 - -Components.utils["import"](<em>url </em>[, <em>scope</em>]);</pre> - -<p><span id="Parameters"></span></p> - -<h3 id="Parameters" name="Parameters">引数</h3> - -<dl> - <dt><code>url</code></dt> - <dd>読み込まれるスクリプトの URL の文字列。URL は、ディスク上のファイルを指さなくてはなりません。JAR ファイル内を指すことがあります。</dd> - <dt><code>scope</code></dt> - <dd>スクリプト上にインポートされる任意のオブジェクト。省略した場合、グローバルオブジェクトが使用されます。</dd> - <dd> - <div class="warning"> - <p>Under Boot2Gecko, the scope is not optional. If your code is meant to work on all platforms, you should always provide a scope.</p> - - <p>In case of doubt, <code>this</code> is generally a good scope.</p> - </div> - </dd> - <dt>return value</dt> - <dd>the module's global object.<br> - use of the return value is discouraged since it grants access to the module's internal properties which are not part of its public API.</dd> -</dl> - -<p>読み込んだファイル内でエラー (構文エラーなど) が発生した場合、import が例外を投げます。</p> - -<p><span id="Example"></span></p> - -<h3 id="Example" name="Example">例</h3> - -<pre class="eval">Components.utils.import("resource://gre/modules/XPCOMUtils.jsm"); -</pre> - -<p><span id="Difference_from_mozIJSSubScriptLoader"></span></p> - -<h3 id="Difference_from_mozIJSSubScriptLoader" name="Difference_from_mozIJSSubScriptLoader">mozIJSSubScriptLoader との違い</h3> - -<p><code><a href="/ja/docs/Mozilla/Tech/XPCOM/Reference/Interface/mozIJSSubScriptLoader" title="">mozIJSSubScriptLoader</a></code> との違い:</p> - -<ul> - <li>異なる場所から同じコードをインポート/読み込みした時の挙動 - <ul> - <li>サブスクリプトローダ (<span style="color: green;">subscript loader</span>) は、特定のコードが実行される度毎に 呼び出し元 (<span style="color: green;">caller</span>) のグローバルオブジェクトで評価します。</li> - <li><code>Components.utils.import</code> はそれぞれのモジュールのコードを一度だけ、自分自身のスコープの中で評価します</li> - </ul> - - <p>例:</p> - - <pre class="eval">var scope1 = {}, scope2 = {}; -Components.utils.import("resource://gre/modules/JSON.jsm", scope1); -Components.utils.import("resource://gre/modules/JSON.jsm", scope2); -assert(scope2.XPCOMUtils === scope1.XPCOMUtils); -</pre> - - <p>...<code>true</code> を返します。対して:</p> - - <pre class="eval">var someURL = "resource://gre/modules/JSON.jsm"; -var obj1 = {}, obj2 = {}; -var loader = Components.classes["@mozilla.org/moz/jssubscript-loader;1"] - .getService(Components.interfaces.mozIJSSubScriptLoader); -loader.loadSubScript(someURL, obj1); -loader.loadSubScript(someURL, obj2); -assert(obj2 === obj1); -</pre> - - <p>..<code>false</code> を返します。</p> - - <p>これは、異なるスコープで実行している JS 間での効果的なコード (とデータ?) の共有に <code>Components.utils.import</code> がより適している事を意味しています。</p> - </li> -</ul> - -<p><span id="Additional_Resources"></span></p> - -<h3 id="Additional_Resources" name="Additional_Resources">追加リソース</h3> - -<article class="approved text-content"> -<div class="boxed translate-rendered"> -<ul> - <li><a href="https://developer.mozilla.org/en-US/docs/Components.utils">Components.utils</a></li> - <li><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=238324" title="FIXED: Implement JavaScript code-sharing module system">バグ 238324</a></li> - <li>The documentation in <a href="https://dxr.mozilla.org/mozilla-central/source/js/xpconnect/idl/xpccomponents.idl" rel="custom">xpccomponents.idl</a></li> - <li>The tests in <code><a href="https://dxr.mozilla.org/mozilla-central/source/js/xpconnect/tests/unit/" rel="custom">js/xpconnect/tests/unit/</a></code></li> - <li><a href="https://developer.mozilla.org/en-US/docs/Mozilla/JavaScript_code_modules/Using#Importing_CommonJS_modules">Importing SDK/CommonJS modules into other code</a></li> -</ul> -</div> -</article> - -<div class="ckeditor-container editor-container dirty"> -<div class="editor"> -<div style="height: 168px;"> -<div style="border: 1px solid rgb(182, 182, 182); width: 503px; position: fixed; top: 0px;"> </div> -</div> -</div> -</div> diff --git a/files/ja/mozilla/tech/xpcom/language_bindings/components.utils.reporterror/index.html b/files/ja/mozilla/tech/xpcom/language_bindings/components.utils.reporterror/index.html deleted file mode 100644 index 56489ade2e..0000000000 --- a/files/ja/mozilla/tech/xpcom/language_bindings/components.utils.reporterror/index.html +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: Components.utils.reportError -slug: Mozilla/Tech/XPCOM/Language_Bindings/Components.utils.reportError -tags: - - 'XPCOM:Language Bindings' - - XPConnect -translation_of: Mozilla/Tech/XPCOM/Language_Bindings/Components.utils.reportError ---- -<p><code>Components.utils.reportError</code> は、<a href="ja/Error_Console">エラーコンソール</a>に JavaScript の Error オブジェクトを送り、プログラムの実行に戻ります。例外を「食べて」おきながらも、例外をコンソールに送りたい例外処理ブロックで用います。</p> - -<p>これは必ずパラメータを 1 つ用いて呼び出します。通常、このパラメータは例外ハンドラが受け取ったオブジェクトです。それが JavaScript のエラーオブジェクトでなければ、パラメータは文字列に変換され、新しくエラーとして送られます。つまり、<code>Components.utils.reportError</code> を用いてデバッグメッセージをエラーコンソールに送ることができるということです。<a href="ja/DOM/window.dump">dump()</a> を用いるとネイティブコンソールにメッセージを出力できるのと同じようなものです。</p> - -<p>しかしながらログをとるには <code><a href="/ja/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIConsoleService" title="">nsIConsoleService</a></code> を使用すべきです。これは <code>reportError</code> とは異なり、メッセージを通常の深刻度で記録するためです。</p> - -<pre class="eval">function myDump(aMessage) { - var consoleService = Components.classes["@mozilla.org/consoleservice;1"] - .getService(Components.interfaces.nsIConsoleService); - consoleService.logStringMessage("My component: " + aMessage); -} -</pre> - -<p>Firefox 3: エラーコンソールにはデフォルトではクロームエラーが表示されません。それらを表示するには、 'javascript.options.showInConsole' の設定を true に設定するか、代わりに <a href="/ja/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIConsoleService" title="en/Console service">nsConsoleService </a>を使用してメッセージを表示します。</p> - -<p>Firefox 4: このバージョンでは、デフォルトで 'javascript.options.showInConsole' の設定が true に設定されています。</p> - -<h3 id=".E4.BE.8B" name=".E4.BE.8B">例</h3> - -<p>例外ハンドラでの使用：</p> - -<pre class="eval">try { - this.could.raise.an.exception; -} catch(e) { - Components.utils.reportError(e); // エラーを送り、実行を続ける -} -</pre> - -<p>エラーコンソールへのデバッグメッセージの出力：</p> - -<pre class="eval">Components.utils.reportError("init() called"); -</pre> diff --git a/files/ja/mozilla/tech/xpcom/language_bindings/components.utils/index.html b/files/ja/mozilla/tech/xpcom/language_bindings/components.utils/index.html deleted file mode 100644 index 6a581462b2..0000000000 --- a/files/ja/mozilla/tech/xpcom/language_bindings/components.utils/index.html +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: Components.utils -slug: Mozilla/Tech/XPCOM/Language_Bindings/Components.utils -tags: - - 'XPCOM:Language Bindings' - - XPConnect -translation_of: Mozilla/Tech/XPCOM/Language_Bindings/Components.utils ---- -<p> -</p><p><code>Components.utils</code> は便利でありながらも必須というわけではない、さまざまな XPConnect の機能のまとまりです。そのインタフェースは <code><a href="https://dxr.mozilla.org/mozilla-central/source/js/src/xpconnect/idl/xpccomponents.idl" rel="custom">js/src/xpconnect/idl/xpccomponents.idl</a></code> で定義されています。オブジェクトには今のところ次のメンバがあります。 -</p> -<table class="fullwidth-table"> -<tbody><tr> -<th>プロパティ</th> -<th>説明</th> -</tr> -<tr> -<td><a href="ja/Components.utils.evalInSandbox">evalInSandbox</a></td> -<td>サンドボックスで JavaScript コードを実行する。普通、制限付き特権を持つ環境下でコードを実行するのに使用する。</td> -</tr> -<tr> -<td><code><a href="ja/Components.utils.forceGC">forceGC</a></code></td> -<td> ガベージコレクションサイクルを強制する。</td> -</tr> -<tr> -<td><code><a href="ja/Components.utils.getWeakReference">getWeakReference</a></code></td> -<td> 渡されたオブジェクトの弱い参照を得る。</td> -</tr> -<tr> -<td><code><a href="ja/Components.utils.import">import</a></code></td> -<td> JS のモジュールを、スコープを共有することなく現在のスクリプトに読み込む -</td></tr> -<tr> -<td><a href="ja/Components.utils.lookupMethod">lookupMethod</a></td> -<td>XPCOM オブジェクトのネイティブな（つまり、インタフェースで宣言されている）メソッドやプロパティを探す。<a href="ja/XPCNativeWrapper">XPCNativeWrapper</a> と同様の目的を果たす。</td> -</tr> -<tr> -<td><a href="ja/Components.utils.reportError">reportError</a></td> -<td>JavaScript の Error オブジェクトを JavaScript コンソールに送る。</td> -</tr><tr> -<td><a href="ja/Components.utils.Sandbox">Sandbox</a></td> -<td><code>evalInSandbox</code> で使用するサンドボックス (sandbox) オブジェクトを作成する。</td> -</tr> -</tbody></table> -<div class="noinclude"> -</div> diff --git a/files/ja/mozilla/tech/xpcom/language_bindings/components_object/index.html b/files/ja/mozilla/tech/xpcom/language_bindings/components_object/index.html deleted file mode 100644 index 7bf0a7f0d0..0000000000 --- a/files/ja/mozilla/tech/xpcom/language_bindings/components_object/index.html +++ /dev/null @@ -1,108 +0,0 @@ ---- -title: Components object -slug: Mozilla/Tech/XPCOM/Language_Bindings/Components_object -tags: - - DOM - - Gecko - - Gecko DOM Reference - - 'XPCOM:Language Bindings' - - XPConnect - - 要更新 -translation_of: Mozilla/Tech/XPCOM/Language_Bindings/Components_object ---- -<p><code>Components</code> オブジェクトは、<a href="/ja/docs/XPConnect">XPConnect</a> 機能が <a href="/ja/docs/JavaScript">JavaScript</a> へ反映されるのを仲介するオブジェクトです。<code>Components</code> オブジェクトは、実際には、XPConnect を利用するトップレベルのオブジェクトとして、JavaScript へ反映される {{Source("js/src/xpconnect/idl/xpccomponents.idl", "nsIXPCComponents")}} インタフェースのネイティブインスタンスです。</p> -<p><code>Components</code> のプロパティの一部は高度な特権を必要とするため、Web ページ上では機能しません。</p> -<p><code>Components</code> オブジェクトは次のメンバを持ちます。</p> -<table class="fullwidth-table"> - <tbody> - <tr> - <th>メンバ</th> - <th>説明</th> - </tr> - <tr> - <td><a href="/ja/docs/Components.classes"><code>classes</code></a></td> - <td>ContractID によるクラスの配列</td> - </tr> - <tr> - <td><a href="/ja/docs/Components.classesByID"><code>classesByID</code></a></td> - <td>CID によるクラスの配列</td> - </tr> - <tr> - <td><a href="/ja/docs/Components.Constructor"><code>function Object() { [native code] }</code></a></td> - <td>コンポーネントのコンストラクタのためのコンストラクタ</td> - </tr> - <tr> - <td><a href="/ja/docs/Components.Exception"><code>Exception</code></a></td> - <td>XPConnect の例外のためのコンストラクタ</td> - </tr> - <tr> - <td><a href="/ja/docs/Components.ID"><code>ID</code></a></td> - <td>XPCOM nsID のためのコンストラクタ</td> - </tr> - <tr> - <td><a href="/ja/docs/Components.interfaces"><code>interfaces</code></a></td> - <td>インタフェース名によるインタフェースの配列</td> - </tr> - <tr> - <td><a href="/ja/docs/Components.interfacesByID"><code>interfacesByID</code></a></td> - <td>IID によるインタフェースの配列</td> - </tr> - <tr> - <td><a href="/ja/docs/Components.isSuccessCode"><code>isSuccessCode</code></a></td> - <td>与えられた結果コードが成功かどうかを判別するための関数</td> - </tr> - <tr> - <td><a href="/ja/docs/Components.lastResult"><code>lastResult</code></a></td> - <td>直前の XPConnect 呼び出しの結果コード</td> - </tr> - <tr> - <td><a href="/ja/docs/Components.manager"><code>manager</code></a></td> - <td>グローバル XPCOM コンポーネントマネージャ</td> - </tr> - <tr> - <td><a href="/ja/docs/Components.results"><code>results</code></a></td> - <td>名前による既知の結果コードの配列</td> - </tr> - <tr> - <td><a href="/ja/docs/Components.returnCode"><code>returnCode</code></a></td> - <td>現在の呼び出しの未決定の結果</td> - </tr> - <tr> - <td><a href="/ja/docs/Components.stack"><code>stack</code></a></td> - <td>現在の JavaScript のコールスタック</td> - </tr> - <tr> - <td><a href="/ja/docs/Components.utils"><code>utils</code></a></td> - <td>いくつかの便利な機能へのアクセスを提供します。</td> - </tr> - <tr> - <td><a href="/ja/docs/Components.utils.evalInSandbox"><code>utils.evalInSandbox</code></a></td> - <td>JavaScript コードをサンドボックス内で実行。通常は限られた特権でコードを実行するときに使われます。</td> - </tr> - <tr> - <td><a href="/ja/docs/Components.utils.forceGC"><code>utils.forceGC</code></a></td> - <td>{{Gecko_minversion_inline(1.9)}} ガベージコレクションサイクルを強制します。</td> - </tr> - <tr> - <td><a href="/ja/docs/Components.utils.getWeakReference"><code>utils.getWeakReference</code></a></td> - <td>{{Gecko_minversion_inline(1.9)}} 渡されたオブジェクトの弱い参照を取得します。</td> - </tr> - <tr> - <td><a href="/ja/docs/Components.utils.import"><code>utils.import</code></a></td> - <td>{{Gecko_minversion_inline(1.9)}} JavaScript モジュールを、スコープを共有せずに現在のスクリプトに読み込みます。</td> - </tr> - <tr> - <td><a href="/ja/docs/Components.utils.lookupMethod"><code>utils.lookupMethod</code></a></td> - <td>XPCOM オブジェクトのネイティブの (例えばインタフェースで宣言された) メソッドやプロパティを参照します。<a href="/ja/docs/XPCNativeWrapper"><code>XPCNativeWrapper</code></a> と同じ役割を果たします。</td> - </tr> - <tr> - <td><a href="/ja/docs/Components.utils.reportError"><code>utils.reportError</code></a></td> - <td>JavaScript エラーオブジェクトを <a href="/ja/docs/Error_Console">エラーコンソール</a> に出力します。</td> - </tr> - <tr> - <td><a href="/ja/docs/Components.utils.Sandbox"><code>utils.Sandbox</code></a></td> - <td><code>evalInSandbox</code> で利用するサンドボックスオブジェクトを生成します。</td> - </tr> - </tbody> -</table> -<p><span class="comment">EDITORS! please keep descriptions of the following properties in sync with <a href="/ja/docs/Components.utils">Components.utils</a> page.</span></p> diff --git a/files/ja/mozilla/tech/xpcom/language_bindings/index.html b/files/ja/mozilla/tech/xpcom/language_bindings/index.html deleted file mode 100644 index f576a1cbb6..0000000000 --- a/files/ja/mozilla/tech/xpcom/language_bindings/index.html +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: XPCOM 言語バインディング -slug: Mozilla/Tech/XPCOM/Language_Bindings -translation_of: Mozilla/Tech/XPCOM/Language_Bindings ---- -<p><strong>XPCOM 言語バインディング</strong>は、以下の目的のために特定の言語と <a href="/ja/XPCOM" rel="internal" title="ja/XPCOM">XPCOM</a> との橋渡しを行います。</p> - -<ul> - <li>他の言語から XPCOM オブジェクトへのアクセス方法を提供します（「アクセス」とは、 XPCOM オブジェクトの読み込み・書き込み・生成・オブジェクトのメソッド呼び出しを意味します）。</li> - <li>他の言語で書かれた XPCOM オブジェクトのモジュールを「露出」させます。モジュールは XPCOM バインディングが存在する言語すべてからアクセスすることができるようになります。</li> -</ul> - -<p>XPCOM レイヤー自身は C/C++ で書かれているため、 XPCOM API は C/C++ でサンドボックスの外側から呼び出すことができます。また、他の言語から XPCOM API を利用できるようにするためには別のレイヤーが必要になります。</p> - -<p>そのようなバインディング層が様々な言語に対して提供されています。</p> - -<ul> - <li><strong>JavaScript</strong>: <a href="/ja/XPConnect" rel="internal" title="ja/XPConnect">XPConnect</a> （これは Firefox に含まれています。 XUL アプリケーションで利用されています）</li> - <li><strong>Java</strong>: <a href="/ja/JavaXPCOM" rel="internal" title="ja/JavaXPCOM">JavaXPCOM</a> (これは Firefox には含まれていませんが、XULRunner の標準のビルドには梱包されており、また Eclipse のアプリケーションで利用されています）</li> - <li><strong>Python</strong>: <a href="/ja/PyXPCOM" rel="internal" title="ja/PyXPCOM">PyXPCOM</a> （これは標準のビルドには含まれていませんが、 ActiveState Komodo 製品では利用されています）</li> - <li><strong>Perl</strong>: <a href="/ja/PlXPCOM" rel="internal" title="ja/PlXPCOM">PlXPCOM</a></li> - <li><strong>Ruby</strong>: <a href="/ja/RbXPCOM" rel="internal" title="ja/RbXPCOM">RbXPCOM</a></li> -</ul> - -<p>利用法が必要な場合は、それぞれのバインディングのページを参照してください。</p> diff --git a/files/ja/mozilla/tech/xpcom/language_bindings/javaxpcom/development/index.html b/files/ja/mozilla/tech/xpcom/language_bindings/javaxpcom/development/index.html deleted file mode 100644 index 6d9b1ca50b..0000000000 --- a/files/ja/mozilla/tech/xpcom/language_bindings/javaxpcom/development/index.html +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: Development -slug: Mozilla/Tech/XPCOM/Language_Bindings/JavaXPCOM/Development -tags: - - JavaXPCOM - - 'XPCOM:Language Bindings' -translation_of: Mozilla/Tech/XPCOM/Language_bindings/JavaXPCOM/Development ---- -<p> -</p> -<h3 id=".E3.82.BD.E3.83.BC.E3.82.B9" name=".E3.82.BD.E3.83.BC.E3.82.B9"> ソース </h3> -<p>最新のソースコードは、Mozilla trunk上の {{ Source("extensions/java/xpcom") }} ディレクトリ内にあります。 -</p> -<h3 id=".E6.A7.8B.E7.AF.89.E6.89.8B.E9.A0.86" name=".E6.A7.8B.E7.AF.89.E6.89.8B.E9.A0.86"> 構築手順 </h3> -<p>ビルドの手順はここにあります: <a href="ja/Building_JavaXPCOM">Building JavaXPCOM</a>。 -</p> -<h3 id=".E3.83.90.E3.82.B0" name=".E3.83.90.E3.82.B0"> バグ </h3> -<p>すべての JavaXPCOM バグは、 <a class="external" href="http://bugzilla.mozilla.org/">Bugzilla</a>内で、"Core" プロダクトと "Java to XPCOM Bridge" コンポーネントを使って記録されています。 -</p> -<ul><li> 公開されている JavaXPCOMバグの<a class="link-https" href="https://bugzilla.mozilla.org/buglist.cgi?query_format=advanced&product=Core&component=Java+to+XPCOM+Bridge&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&chfieldto=Now">一覧</a> -</li><li> 新しい JavaXPCOMバグを<a class="link-https" href="https://bugzilla.mozilla.org/enter_bug.cgi?product=Core&component=Java+to+XPCOM+Bridge&rep_platform=All&op_sys=All">開く</a> -</li><li> 最近1ヶ月の<a class="external" href="http://bonsai.mozilla.org/cvsquery.cgi?treeid=default&module=all&branch=HEAD&branchtype=match&dir=mozilla%2Fextensions%2Fjava%2Fxpcom&file=&filetype=match&who=&whotype=match&sortby=Date&hours=2&date=month&mindate=&maxdate=&cvsroot=%2Fcvsroot">チェックイン</a> -</li></ul> -{{ languages( { "en": "en/JavaXPCOM/Development", "zh-cn": "cn/JavaXPCOM/\u5f00\u53d1" } ) }} diff --git a/files/ja/mozilla/tech/xpcom/language_bindings/javaxpcom/embedding_mozilla_in_a_java_application_using_javaxpcom/index.html b/files/ja/mozilla/tech/xpcom/language_bindings/javaxpcom/embedding_mozilla_in_a_java_application_using_javaxpcom/index.html deleted file mode 100644 index d523b94ce1..0000000000 --- a/files/ja/mozilla/tech/xpcom/language_bindings/javaxpcom/embedding_mozilla_in_a_java_application_using_javaxpcom/index.html +++ /dev/null @@ -1,156 +0,0 @@ ---- -title: Embedding Mozilla in a Java Application using JavaXPCOM -slug: >- - Mozilla/Tech/XPCOM/Language_Bindings/JavaXPCOM/Embedding_Mozilla_in_a_Java_Application_using_JavaXPCOM -tags: - - Embedding Mozilla - - JavaXPCOM - - 'XPCOM:Language Bindings' -translation_of: Archive/Mozilla/Embedding_Mozilla_in_a_Java_Application_using_JavaXPCOM ---- -<p> -</p><p><a href="ja/XULRunner">XULRunner</a>には<a href="ja/JavaXPCOM">JavaXPCOM</a>が標準搭載されており、これは、JavaのコードとXPCOMの相互利用を可能にするものです。この記事で示すとおり、JavaでのXPCOMオブジェクトの操作は、C++の場合とそれほど大きな差はありません。 -</p> -<h4 id="必要な環境"> 必要な環境 </h4> -<ul><li> Java 1.4.2 以降 -</li><li> <a href="ja/XULRunner">XULRunner</a> 1.8.0.1 以降 -</li></ul> -<h4 id="組み込み"> 組み込み </h4> -<p>Mozilla を Java アプリケーションに埋め込むためには、<tt>xulrunner/sdk/lib</tt>フォルダーにある<tt>MozillaInterfaces.jar</tt>というライブラリをclasspathに追加する必要があります。このライブラリは Mozilla をブートストラップし、XPCOM メソッドを呼び出すために必要なインターフェースを提供します。 -</p><p>組み込みを開始するために、<a href="https://dxr.mozilla.org/mozilla-central/source/extensions/java/xpcom/interfaces/Mozilla.java" rel="custom">Mozilla</a>共有クラスの提供するメソッドを使用します。はじめに、Java アプリケーションは適切な XULRunner installationを見つける必要があります。 -</p> -<pre class="eval"> Mozilla mozilla = Mozilla.getInstance(); - GREVersionRange[] range = new GREVersionRange[1]; - range[0] = new GREVersionRange("1.8.0", true, "1.9", false); - <span>// work with trunk nightly version 1.9a1 ^^</span> - - try { - File grePath = Mozilla.getGREPathWithProperties(range, null); - LocationProvider locProvider = new LocationProvider(grePath); - mozilla.initEmbedding(grePath, grePath, locProvider); - } catch (FileNotFoundException e) { - <span>// この例外は greGREPathWithProperties が GRE を見つけられなかったときに送出されます</span> - } catch (XPCOMException e) { - <span>// この例外は initEmbedding が失敗したときに送出されます</span> - } -</pre> -<p><code>LocationProvider</code>はJavaアプリケーションによって提供されるクラスです。これはインターフェース<a href="https://dxr.mozilla.org/mozilla-central/source/extensions/java/xpcom/interfaces/IAppFileLocProvider.java" rel="custom">IAppFileLocProvider</a>を実装しているもので、 -and tells XPCOM where to find certain files and directories. -</p><p><code>initEmbedding</code>メソッドは embedding process を開始するもので、Java アプリケーションと XPCOM や Mozilla の連携を可能にするものです。ひとたび Java アプリケーションが Mozilla を使う作業を終えたとき、それは embedding process を terminate する必要があります。 -</p> -<pre class="eval"> try { - mozilla.termEmbedding(); - } catch (XPCOMException e) { - <span>// この例外は termEmbedding が失敗したときに送出されます</span> - } -</pre> -<h4 id="XPCOMオブジェクトを利用する"> XPCOMオブジェクトを利用する </h4> -<p>Mozilla が組み込まれると、Java アプリケーションは XPCOM オブジェクトを利用することができるようになります。<code>Mozilla</code> クラスはこれの手助けをするメソッドを提供しており、たとえば、<code>getServiceManager</code>、<code>getComponentManager</code>、<code>newLocalFile</code>があります。JavaXPCOM により、 Java アプリケーションがXPCOM オブジェクトを取得し、メソッドを呼び出すのに加え、Java クラスオブジェクトを XPCOM メソッドに渡すことも可能になります。 -</p><p>例えば: -</p> -<pre class="eval"> Mozilla mozilla = Mozilla.getInstance(); - WindowCreator creator = new WindowCreator(); <span>// nsIWindowCreator を実装</span> - - nsIServiceManager serviceManager = mozilla.getServiceManager(); - - nsIWindowWatcher windowWatcher = (nsIWindowWatcher) serviceManager - .getServiceManagerByContractID(NS_WINDOWWATCHER_CONTRACTID, - nsIWindowWatcher.NS_IWINDOWWATCHER_IID); - windowWatcher.setWindowCreator(creator); -</pre> -<p>この例では、<code>nsIWindowCreator</code>インターフェースを実装した Java のクラスである<code>WindowCreator</code>が存在し、それを Mozilla に登録しようとしています。そのために、まず service manager を取得するのですが、それは Mozilla のwindow watcherのリファレンスにある方法によります。 -</p><p>別の例: (<a class="external" href="http://rayh.co.uk">rayh.co.uk</a>にあるもの) -</p> -<pre class="eval"> // linux 上ではこのコードが実行されるより前に gtk が初期化されている必要があることに注意 - Mozilla moz = Mozilla.getInstance(); - - // 次に XUL アプリケーションを実行するために、XPCOMのservice managerのインスタンスを取得する必要がある - nsIServiceManager serviceManager = moz.getServiceManager(); - - // 次に @mozilla.org/toolkit/app-startup;1 サービスを取得する必要がある - nsIAppStartup appStartup = (nsIAppStartup)serviceManager.getServiceByContractID("@mozilla.org/toolkit/app-startup;1", nsIAppStartup.NS_IAPPSTARTUP_IID); - - // 上のものへの nsIWindowWatcher インターフェースを取得する - nsIWindowCreator windowCreator = (nsIWindowCreator)appStartup.queryInterface(nsIWindowCreator.NS_IWINDOWCREATOR_IID); - - // window watcher サービスを取得する - nsIWindowWatcher windowWatcher = (nsIWindowWatcher)serviceManager.getServiceByContractID("@mozilla.org/embedcomp/window-watcher;1", nsIWindowWatcher.NS_IWINDOWWATCHER_IID); - - // window creator をsetする (from step 6) - windowWatcher.setWindowCreator(windowCreator); - - // Create the root XUL window を作成: - nsIDOMWindow win = windowWatcher.openWindow(null, "<a class=" external">chrome://your-app/content/window.xul</a>", "mywindow", "chrome,resizable,centerscreen", null); - - // これを active window にする - windowWatcher.setActiveWindow(win); - - // application を xpcom/xul に手渡し、ここでブロックする: - appStartup.run(); -</pre> -<p>これは動作する LocationProvider の例です : -</p> -<pre class="eval"> public class LocationProvider implements IAppFileLocProvider { -</pre> -<pre class="eval"> private final File libXULPath; - int counter = 0; - - public LocationProvider(File grePath) { - this.libXULPath = grePath; - } -</pre> -<pre class="eval"> public File getFile(String aProp, boolean[] aPersistent) { - File file = null; - if (aProp.equals("GreD") || aProp.equals("GreComsD")) { - file = libXULPath; - if (aProp.equals("GreComsD")) { - file = new File(file, "components"); - } - } - else if (aProp.equals("MozBinD") || - aProp.equals("CurProcD") || - aProp.equals("ComsD") || - aProp.equals("ProfD")) - { - file = libXULPath; - if (aProp.equals("ComsD")) { - file = new File(file, "components"); - } - } - return file; - } -</pre> -<pre class="eval"> public File[] getFiles(String aProp) { - File[] files = null; - if (aProp.equals("APluginsDL")) { - files = new File[1]; - files[0] = new File(libXULPath, "plugins"); - } - return files; - } -</pre> -<p><br> -</p> -<h4 id="XPCOM_の_UI_を別のスレッドから呼び出す"> XPCOM の UI を別のスレッドから呼び出す </h4> -<p>appStartup.run() はメインのイベントループを始動し、アプリケーションが終了するまでそこに留まります。これ以降の場所で XPCOM とcommunicateするためには、nsIProxyObjectManager を使用する必要があります。 -</p><p>上の例に引き続き新しいウインドウを作成するためには、このようにします : -</p> -<pre class="eval"> // まず、event queue service を取得します。これは、XPCOM の全てのイベントキューを処理するものです。 - nsIEventQueueService eventQueueServive = (nsIEventQueueService)serviceManager.getServiceByContractID("@mozilla.org/event-queue-service;1",nsIEventQueueService.NS_IEVENTQUEUESERVICE_IID); - - // 次に、ウインドウを開くために、UI スレッドを取得します。 - // nsIEventQueueService が所有するstatic変数がUIイベント用の特別なキューを所有しています。 - nsIEventQueue eventQueue = eventQueueServive.getSpecialEventQueue(nsIEventQueueService.UI_THREAD_EVENT_QUEUE); - - // 次に、proxy object manager 用の proxy を作成します。 - nsIProxyObjectManager proxy = (nsIProxyObjectManager)componentManager.createInstanceByContractID("@mozilla.org/xpcomproxy;1",null,nsIProxyObjectManager.NS_IPROXYOBJECTMANAGER_IID); - - // そして、proxy object manager を使って、さきほど作成した nsIWindowWatcher のインスタンスへの proxy を作成します。 - nsIWindowWatcher windowProxy = (nsIWindowWatcher)proxy.getProxyForObject(eventQueue,windowWatcher.NS_IWINDOWWATCHER_IID,windowWatcher,nsIProxyObjectManager.INVOKE_SYNC); - - // そうすれば、proxy を使ってメソッドを普通に呼び出すことができます。 - windowProxy.openWindow(null, chromeUri, name, "centerscreen", null); -</pre> -<p>さらに詳しい情報は、<a class="external" href="http://www.xulplanet.com/references/xpcomref/ifaces/nsIProxyObjectManager.html">XulPlanet's documentation of nsIProxyObjectManager</a>を参照してください。 -</p><p>これは、<a class="external" href="http://rayh.co.uk/blog/?p=14">Injecting Events onto XPCOM’s UI Thread</a>からとられたものです。 -</p> diff --git a/files/ja/mozilla/tech/xpcom/language_bindings/javaxpcom/examples/index.html b/files/ja/mozilla/tech/xpcom/language_bindings/javaxpcom/examples/index.html deleted file mode 100644 index 9c34d27c84..0000000000 --- a/files/ja/mozilla/tech/xpcom/language_bindings/javaxpcom/examples/index.html +++ /dev/null @@ -1,13 +0,0 @@ ---- -title: Examples -slug: Mozilla/Tech/XPCOM/Language_Bindings/JavaXPCOM/Examples -tags: - - JavaXPCOM - - 'XPCOM:Language Bindings' -translation_of: Mozilla/Tech/XPCOM/Language_bindings/JavaXPCOM/Examples ---- -<p> -</p><p>いくつかの Java テストアプリケーションがソースツリーにチェックインされています。ここには、Java から Gecko の埋め込みや XPCOM の初期化をする方法の例があります。<a class="external" href="http://lxr.mozilla.org/mozilla/source/extensions/java/xpcom/tests">mozilla/extensions/java/xpcom/tests</a> -</p> -<div class="noinclude"> -</div> diff --git a/files/ja/mozilla/tech/xpcom/language_bindings/javaxpcom/index.html b/files/ja/mozilla/tech/xpcom/language_bindings/javaxpcom/index.html deleted file mode 100644 index c2707f8de0..0000000000 --- a/files/ja/mozilla/tech/xpcom/language_bindings/javaxpcom/index.html +++ /dev/null @@ -1,73 +0,0 @@ ---- -title: JavaXPCOM -slug: Mozilla/Tech/XPCOM/Language_Bindings/JavaXPCOM -tags: - - JavaXPCOM - - 'XPCOM:Language Bindings' - - 要更新 -translation_of: Mozilla/Tech/XPCOM/Language_bindings/JavaXPCOM ---- -<p> </p> -<div> - <p><b>JavaXPCOM</b> は Java と <a href="ja/XPCOM">XPCOM</a> のコミュニケーションを可能にします。つまり、Java アプリケーションは、XPCOM オブジェクトにアクセスでき、XPCOM オブジェクトも XPCOM インターフェースを実装するすべての Java class にアクセスできます。 JavaXPCOM を使うことで、開発者は Java アプリケーションから XPCOM や埋め込み <a href="ja/Gecko">Gecko</a> にデータを伝送することができます。 JavaXPCOM は <a href="ja/XPConnect">XPConnect</a> (JavaScript-XPCOM ブリッジ) に非常によく似ていて <a href="ja/XPIDL">XPIDL</a> を使用します。</p> - <p>JavaXPCOM は <a href="ja/XULRunner">XULRunner</a> の一部として標準で構築されています。 最近のビルドまたは <a href="ja/XULRunner_1.8.0.4_Release_Notes">XULRunner 1.8.0.4</a> をダウンロードして試してみてください。</p> -</div> -<table class="topicpage-table"> - <tbody> - <tr> - <td> - <h4 id=".E3.83.89.E3.82.AD.E3.83.A5.E3.83.A1.E3.83.B3.E3.83.86.E3.83.BC.E3.82.B7.E3.83.A7.E3.83.B3" name=".E3.83.89.E3.82.AD.E3.83.A5.E3.83.A1.E3.83.B3.E3.83.86.E3.83.BC.E3.82.B7.E3.83.A7.E3.83.B3"><a>ドキュメンテーション</a></h4> - <dl> - <dt> - <a href="ja/JavaXPCOM/Development">JavaXPCOM Development</a></dt> - <dd> - <small>ソースの取得・構築方法、それから読み方・バグの報告の方法。</small></dd> - </dl> - <dl> - <dt> - <a href="ja/JavaXPCOM/Examples">サンプルコード</a></dt> - <dd> - <small>いくつかの Java テストアプリケーションがソースツリーにチェックインされており、Java から Gecko の埋め込みや XPCOM を初期化する方法の例があります。</small></dd> - </dl> - <dl> - <dt> - <a href="ja/JavaXPCOM/Embedding_Mozilla_in_a_Java_Application_using_JavaXPCOM">JavaXPCOM を使って Java アプリケーションへ Mozilla を組み込む</a></dt> - <dd> - <small><a href="ja/XULRunner">XULRunner</a> には JavaXPCOM が標準搭載されており、これは、Java のコードと XPCOM の相互利用を可能にするものです。この記事で示すとおり、Java での XPCOM オブジェクトの操作は C++ の場合とそれほど大きな差はありません。</small></dd> - </dl> - <p><span class="alllinks"><a>すべて見る...</a></span></p> - </td> - <td> - <h4 id=".E3.82.B3.E3.83.9F.E3.83.A5.E3.83.8B.E3.83.86.E3.82.A3" name=".E3.82.B3.E3.83.9F.E3.83.A5.E3.83.8B.E3.83.86.E3.82.A3">コミュニティ</h4> - <ul> - <li>Mozilla Java フォーラムを見る...</li> - </ul> - <ul> - <li><a href="https://lists.mozilla.org/listinfo/dev-tech-java"> メーリングリストとして</a></li> - - - <li><a href="http://groups.google.com/group/mozilla.dev.tech.java"> ニュースグループとして</a></li> - <li><a href="http://groups.google.com/group/mozilla.dev.tech.java/feeds"> フィードとして</a></li> -</ul> - <ul> - <li>Mozilla Embedding フォーラムを見る...</li> - </ul> - <ul> - <li><a href="https://lists.mozilla.org/listinfo/dev-embedding"> メーリングリストとして</a></li> - - - <li><a href="http://groups.google.com/group/mozilla.dev.embedding"> ニュースグループとして</a></li> - <li><a href="http://groups.google.com/group/mozilla.dev.embedding/feeds"> フィードとして</a></li> -</ul> - <ul> - <li><a class="link-mailto" href="mailto:jhpedemonte@gmail.com">Javier Pedemonte</a> JavaXPCOM プロジェクトを率いている開発者</li> - </ul> - <h4 id=".E9.96.A2.E9.80.A3.E9.A0.85.E7.9B.AE" name=".E9.96.A2.E9.80.A3.E9.A0.85.E7.9B.AE">関連項目</h4> - <dl> - <dd> - <a href="ja/XPCOM">XPCOM</a>, <a href="ja/Embedding_Mozilla">Embedding Mozilla</a></dd> - </dl> - </td> - </tr> - </tbody> -</table> diff --git a/files/ja/mozilla/tech/xpcom/language_bindings/javaxpcom/other_resources/index.html b/files/ja/mozilla/tech/xpcom/language_bindings/javaxpcom/other_resources/index.html deleted file mode 100644 index 14a9eb1ee0..0000000000 --- a/files/ja/mozilla/tech/xpcom/language_bindings/javaxpcom/other_resources/index.html +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: その他の情報源 -slug: Mozilla/Tech/XPCOM/Language_Bindings/JavaXPCOM/Other_Resources -tags: - - JavaXPCOM - - 'XPCOM:Language Bindings' -translation_of: Mozilla/Tech/XPCOM/Language_bindings/JavaXPCOM/Other_Resources ---- -<h2 id="Other_Resources" name="Other_Resources">その他の情報源</h2> -<ul> - <li><a href="/ja/docs/Embedding_Mozilla">Embedding Mozilla</a></li> - <li><a href="/ja/docs/XPConnect">XPConnect</a> - Javascript-XPCOM bridge</li> - <li><a href="/ja/docs/BlackConnect">BlackConnect</a> - Java-XPCOM bridge (no longer supported)</li> - <li><a href="http://www.mozilla.org/projects/blackwood/connect/RequirementsSpec.html#IDL">XPIDL to Java types</a> - from Blackconnect</li> -</ul> diff --git a/files/ja/mozilla/tech/xpcom/language_bindings/plxpcom/index.html b/files/ja/mozilla/tech/xpcom/language_bindings/plxpcom/index.html deleted file mode 100644 index 4bb9b94597..0000000000 --- a/files/ja/mozilla/tech/xpcom/language_bindings/plxpcom/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: PlXPCOM -slug: Mozilla/Tech/XPCOM/Language_Bindings/PlXPCOM -tags: - - PlXPCOM - - XPCOM - - 'XPCOM:Language Bindings' -translation_of: Mozilla/Tech/XPCOM/Language_bindings/PlXPCOM ---- -<p>Perl XPCOM (plXPCOM): Perl と XPCOM のバインディング -</p> -<ul><li> <a class="external" href="http://plxpcom.mozdev.org/">プロジェクトページ</a> (MozDev) -</li><li> <a class="external" href="http://plxpcom.mozdev.org/docs/XPCOM.html">Perl オブジェクト定義</a> (MozDev) -</li><li> <a class="external" href="http://plxpcom.mozdev.org/docs/xpcom-perl.html">開発者ガイド</a> (MozDev) -</li><li> <a class="link-news" href="news://news.mozdev.org/public.mozdev.plxpcom">ニュースグループ</a> (MozDev) -</li><li> <a class="external" href="http://plxpcom.mozdev.org/list.html">メーリングリスト</a> (MozDev) -</li></ul> diff --git a/files/ja/mozilla/tech/xpcom/language_bindings/pyxpcom/index.html b/files/ja/mozilla/tech/xpcom/language_bindings/pyxpcom/index.html deleted file mode 100644 index 5dfb513534..0000000000 --- a/files/ja/mozilla/tech/xpcom/language_bindings/pyxpcom/index.html +++ /dev/null @@ -1,62 +0,0 @@ ---- -title: PyXPCOM -slug: Mozilla/Tech/XPCOM/Language_Bindings/PyXPCOM -tags: - - PyXPCOM - - 'XPCOM:Language Bindings' -translation_of: Mozilla/Tech/XPCOM/Language_bindings/PyXPCOM ---- -<p> -</p> -<div> -<p><b>PyXPCOM</b> は <a class="external" href="http://www.python.org/">Python</a> と <a href="ja/XPCOM">XPCOM</a> の間で通信を可能にします。すなわち、Python アプリケーションが XPCOM オブジェクトにアクセスできるように、また XPCOM が XPCOM インタフェースを実装したあらゆる Python クラスにアクセスできるようにします。PyXPCOM によって開発者は Python アプリケーションから XPCOM や組み込み <a href="ja/Gecko">Gecko</a> に通話が可能になります。PyXPCOM は <a href="ja/JavaXPCOM">JavaXPCOM</a> (Java と XPCOM のブリッジ) や <a href="ja/XPConnect">XPConnect</a> (JavaScript と XPCOM のブリッジ) と類似しています。 -</p> -Python のクラスとインタフェース: Mozilla は組み込み開発者やコンポーネント開発者が利用できる多くの外部インターフェイスを定義しています。PyXPCOM はこれらのインタフェースを Python インタフェースとしてアクセスできる機能を提供します。PyXPCOM は Python から XPCOM や Gecko の初期化や終了を行う関数にアクセスを提供するいくつかのクラスや、さらに XPCOM のヘルパー関数をいくつか含みます。</div> -<table class="topicpage-table"> -<tbody><tr><td> -<h4 id="ドキュメント"> <a>ドキュメント</a> </h4> -<dl><dt> <a href="ja/Building_PyXPCOM">PyXPCOM のビルド</a> -</dt><dd> <small>PyXPCOM のビルド手順。</small> -</dd></dl> -<dl><dt> <a href="ja/Creating_a_Python_XPCOM_component">Creating a Python XPCOM component</a> -</dt><dd> <small>Python を使って簡単な <a href="ja/XPCOM">XPCOM</a> コンポーネントを作る方法のサンプル。</small> -</dd></dl> -<dl><dt> <a class="external" href="http://www.ibm.com/developerworks/jp/webservices/library/co-pyxp1/">PyXPCOM 入門</a> -</dt><dd> <small>PyXPCOM は XPCOM と Python の間を橋渡しする技術です。この記事はこれから PyXPCOM を学ぶ開発者のためのスタートガイドです。</small> -</dd></dl> -<p><span><a>すべて見る...</a></span> -</p> -<h4 id="歴史"> 歴史 </h4> -<p>PyXPCOM は当初 <a class="external" href="http://www.activestate.com/">ActiveState Tool Corporation</a> によって開発され、彼らの <a class="external" href="http://www.activestate.com/Products/Komodo">Komodo プロジェクト</a> の一部として <a class="external" href="http://aspn.activestate.com/ASPN/Downloads/Komodo/index/PyXPCOM/">知られています</a>。現在のリリースでは Mozilla ビルドシステムにすでに <a class="external" href="http://public.activestate.com/pyxpcom/">統合されています</a>。 -</p> -</td> -<td> -<h4 id="コミュニティ"> コミュニティ </h4> -<ul><li> Mozilla XPCOM フォーラムを見る... -</li></ul> -<ul> - <li><a href="https://lists.mozilla.org/listinfo/dev-tech-xpcom"> メーリングリストとして</a></li> - - - <li><a href="http://groups.google.com/group/mozilla.dev.tech.xpcom"> ニュースグループとして</a></li> - <li><a href="http://groups.google.com/group/mozilla.dev.tech.xpcom/feeds"> フィードとして</a></li> -</ul> - -<ul><li> <a class="external" href="http://listserv.activestate.com/mailman/listinfo/pyxpcom">ActiveState の Python XPCOM bindings メーリングリスト</a> -</li><li> <a class="link-irc" href="irc://irc.mozilla.org:6667/pyxpcom">#pyxpcom on irc.mozilla.org</a> -</li></ul> -<h4 id="ソースコード"> ソースコード </h4> -<ul><li> PyXPCOM のコードは trunk の <code><a href="https://dxr.mozilla.org/mozilla-central/source/extensions/python/xpcom/" rel="custom">extensions/python/xpcom/</a></code> ディレクトリから利用可能です。 -</li><li> PyXPCOM は標準ではビルドされないことに気をつけてください。PyXPCOM をビルドするには <a href="ja/Building_PyXPCOM">PyXPCOM のビルド</a> を参照してください。 -</li></ul> -<h4 id="関連事項"> 関連事項 </h4> -<dl><dd> <a href="ja/XPCOM">XPCOM</a> -</dd><dd> <a href="ja/PyDOM">PyDOM</a>: JavaScript を Python で置き換える -</dd></dl> -</td></tr></tbody></table> -<p><span>Categories</span> -</p><p><span>Interwiki Language Links</span> -</p><p><br> -</p> -<div class="noinclude"> -</div> diff --git a/files/ja/mozilla/tech/xpcom/language_bindings/rbxpcom/index.html b/files/ja/mozilla/tech/xpcom/language_bindings/rbxpcom/index.html deleted file mode 100644 index ff1cec39a2..0000000000 --- a/files/ja/mozilla/tech/xpcom/language_bindings/rbxpcom/index.html +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: RbXPCOM -slug: Mozilla/Tech/XPCOM/Language_Bindings/RbXPCOM -tags: - - RbXPCOM - - XPCOM - - 'XPCOM:Language Bindings' -translation_of: Mozilla/Tech/XPCOM/Language_bindings/RbXPCOM ---- -<p>Ruby Cross-Platform COM (rbXPCOM): Ruby と XPCOM のバインディング -</p> -<ul><li> <a class="external" href="http://rbxpcom.mozdev.org/">プロジェクトページ</a> (MozDev) -</li><li> <a class="external" href="http://rbxpcom.mozdev.org/no_wrap/doc/">マニュアル</a> (MozDev) -</li><li> <a class="external" href="http://rbxpcom.mozdev.org/list.html">メーリングリスト</a> (MozDev) -</li><li> <a class="link-news" href="news://news.mozdev.org/public.mozdev.rbxpcom">ニュースグループ</a> (MozDev) -</li></ul> |