1 files changed, 76 insertions, 0 deletions
diff --git a/files/ja/mozilla/tech/xpcom/xptcall_faq/index.html b/files/ja/mozilla/tech/xpcom/xptcall_faq/index.html
new file mode 100644
index 0000000000..340d8c6940
--- /dev/null
+++ b/files/ja/mozilla/tech/xpcom/xptcall_faq/index.html
@@ -0,0 +1,76 @@
+---
+title: xptcall FAQ
+slug: Mozilla/Tech/XPCOM/xptcall_FAQ
+tags:
+  - XPCOM
+  - 'XPCOM:Language Bindings'
+  - XPConnect
+translation_of: Mozilla/Tech/XPCOM/xptcall_FAQ
+---
+<h2 id="_What_is_xptcall.3F_" name="_What_is_xptcall.3F_"><code>xptcall</code> とは何ですか？</h2>
+<p><code>xptcall</code> は、低レベルの XPCOM メソッド呼び出しのための小さなライブラリです。プラットフォーム固有の C/C++ とアセンブラ言語のコードを使って実装されています。異なる言語間の呼び出しと異なるスレッドへのメソッド呼び出しを容易にするためのものです。 Mozillaをあらゆるプラットフォーム上で動作させるためには、このコードを移植する必要があります。</p>
+
+
+
+<h2 id="_Why_does_xptcall_exist.3F_" name="_Why_does_xptcall_exist.3F_">なぜ <code>xptcall</code> があるのですか？</h2>
+<p><code>xptcall</code> があるのは、以下の二つの理由によります:</p>
+<ol>
+  <li>XPCOM インタフェースの任意のメソッドを実行できるようにするため。</li>
+  <li>任意の XPCOM インタフェースを実装しているかのように、動的に振舞いを変えられるようにするため。</li>
+</ol>
+<p>どちらの仕組みも <a href="/ja/docs/XPConnect">XPConnect</a> にとって必要なものです。また、<code><a href="/ja/docs/NsISupports_proxies">xpcom/proxy</a></code> もこれらの仕組みを利用しています。将来的には、他のサブシステムでも使われるかもしれません。</p>
+<p><code>xptcall</code> のアプローチの方が、スタブコードの生成により、すべてのインタフェースの呼び出しと実装をサポートするアプローチよりも良いということで、選択されました。この <code>xptcall</code> のアプローチは、コアなプラットフォーム固有のコードを必要とします。しかし、メモリ使用量が最小で済み、そして任意の正当な XPCOM インタフェースとともに動作できるように拡張できます。しかも各プラットフォームごとに追加のコンパイル済みコードを付加する必要がないのです。</p>
+
+
+
+<h2 id="_What_does_xptcall_really_do.3F_" name="_What_does_xptcall_really_do.3F_"><code>xptcall</code> は、実際には何をするのでしょうか？</h2>
+<p>これが、コアとなる <i>invoke</i> 関数の宣言です:</p>
+
+<pre class="brush:text">XPTC_PUBLIC_API(nsresult)
+XPTC_InvokeByIndex(nsISupports* that,
+                   PRUint32 methodIndex,
+                   PRUint32 paramCount,
+                   nsXPTCVariant* params);
+</pre>
+
+<p><code>nsXPTCVariant</code> は、共用体のデータです。これは、目的の関数にパラメータとして渡される型で区別されます (型として <code>void*</code> も使えるので、任意のポインター型を表現することができます)。</p>
+<p>正しいパラメータセットを与えることで、この関数を使って任意の XPCOM インタフェースの任意のメソッドを呼び出すことができます。 XPConnect は、<a href="http://www.mozilla.org/scriptable/typelib_file.html">タイプライブラリ</a> ファイルの情報を使用して、任意の XPCOM インタフェースを JavaScript にマッピングし、<code>XPTC_InvokeByIndex</code> を使って JavaScript から XPCOM を呼び出すことができるようになります。タイプライブラリの情報を使うことで、 XPConnect は、関数のパラメータを変換でき、そしてこの呼び出しをするのに必要な <code>nsXPTCVariant</code> 型の配列を組み立てることができます。</p>
+<p><code>xptcall</code> の <i>スタブ</i> (あるいは偽装) の仕組みにより、実行時に、任意の XPCOM インタフェースのふりをすることができるクラスを実装できるようになります。これは、<code>xptcall</code> が、関数の汎用的なスタブへのポインタが並べられた vtbl を提供することで実現されます。これらのスタブは、呼び出しを共通の関数に転送します。この共通の関数は、タイプライブラリの情報を使って、パラメータを取り出します。そして、プラットフォーム固有の呼び出し規約に従って、パラメータを保持するバリアント型の配列を組み立てます。その後、継承したメソッドを呼び出すことで、任意の処理を実行することができます。このコードは、呼び出しから戻る時に、プラットフォーム固有の後始末も行います。</p>
+<p>これらはすべて動作しており、現在、<a href="https://dxr.mozilla.org/mozilla-central/source/xpcom/reflect/xptcall/status.html" rel="custom">様々なプラットフォーム</a> 上の Mozilla で使われています。</p>
+
+
+
+<h2 id="_Why_cant_xptcall_just_be_implemented_in_C_or_C.2B.2B.3F_" name="_Why_can't_xptcall_just_be_implemented_in_C_or_C.2B.2B.3F_">なぜ <code>xptcall</code> を、単に C や C++ で実装することができないのですか？</h2>
+<p>これらの二つの仕組みでは、完全にクロスプラットフォームにできないからです。あるいは、汎用的にすべて C や C++ で行うこともできないからです。それがどうしてなのかを、ひとつずつ見てみましょう。</p>
+<p><i>invoke</i> では、任意の呼び出しのフレームを組み立てて、それを実行できるコードが必要になります。C++ のコンパイラは、そのような呼び出しのフレームをいつも組み立てています。しかし、コンパイラは、呼び出し先の固有のシグネチャーのためにカスタマイズしたフレームを <i>コンパイル時に</i> 組み立てます。 <code>xptcall</code> は、任意の正当な XPCOM メソッドシグネチャーを呼び出せなければなりません。そしてシグネチャーは実行時に特定する必要があるのです。</p>
+<p><i>stubs</i> は、任意の XPCOM インタフェースのすべてのメソッド (祖先のメソッドも含む) の全ての vtbl を実装しているかのように振舞わなければなりません。これを行ういくつかの方法があります。実行時にコンパイラを動かして、スタブの動的に組み立てとロードを行うことができます。あるいは、プラットフォーム固有のコードを書いて、インタフェース固有の vtbl とメソッドのスタブを組み立てる方法もあります。私は、ひとつの巨大な vtbl と多くの小さな汎用のスタブを使う方法を選びました。これにより、プラットフォーム固有のコードは可能な限り小さくなるのです。もう一度言うと、これをすべて行うコードを C で書くことはできません。 varargs を使って一部実現することはできますが、それでは十分ではありません。</p>
+<p>もし、何か確実な方法があって、クロスプラットフォームな方法で、かつ/またはアセンブラ言語のコードを使わずに必要な機能を実現することができるのであれば、教えてください。</p>
+
+
+
+<h2 id="_Is_xptcall_a_platform_requirement_for_Mozilla.3F_" name="_Is_xptcall_a_platform_requirement_for_Mozilla.3F_"><code>xptcall</code> は、Mozilla のプラットフォームとして必要なものですか？</h2>
+<p>はい。Mozilla は、<code>xptcall</code> がきちんと移植されていないと、正しく動作しないでしょう。無機能のスタブコードがあるので、サポートされていないプラットフォーム上でも <code>xptcall</code> をビルドできるようになっています。しかし XPConnect に依存しているブラウザ機能は、すべて実行に失敗するでしょう。プラットフォーム上で <code>xptcall</code> が機能しないと、問題が起きるでしょう。 <code>xptcall</code> が、どこででも動作するように取り組んでいく必要があります！</p>
+
+
+
+<h2 id="_What_platforms_are_supported.3F_" name="_What_platforms_are_supported.3F_">どのプラットフォームがサポートされていますか？</h2>
+<p>増加中のリストです:</p>
+<ul>
+  <li><a href="https://dxr.mozilla.org/mozilla-central/source/xpcom/reflect/xptcall/status.html" rel="custom">移植状況</a></li>
+</ul>
+
+
+
+<h2 id="Where_can_I_find_other_resources.3F" name="Where_can_I_find_other_resources.3F">他のリソースは、どこにあるでしょう？</h2>
+<p>コードは <code><a href="https://dxr.mozilla.org/mozilla-central/source/xpcom/reflect/xptcall" rel="custom">xpcom/reflect/xptcall</a></code> にあります。</p>
+<p>新しい移植のためのガイドは <code><a href="https://dxr.mozilla.org/mozilla-central/source/xpcom/reflect/xptcall/porting.html" rel="custom">xpcom/reflect/xptcall/porting.html</a></code> にあります。</p>
+<p>実装前の提案が <a href="http://www.mozilla.org/scriptable/zero-generated-code-proposal.html">ここ</a> と <a href="http://www.mozilla.org/scriptable/zero-ASM-proposal.html">ここ</a> にあります。</p>
+
+
+<div class="originaldocinfo">
+<h2 id="Original_Document_Information" name="Original_Document_Information">原文書の情報</h2>
+  <ul>
+    <li>著者: <a class="link-mailto" href="mailto:jband@netscape.com">John Bandhauer &lt;jband@netscape.com&gt;</a></li>
+    <li>初出: 1999 年 09 月 02 日</li>
+  </ul>
+</div>