files/ja/mozilla/tech/xpcom/generic_factory/index.html


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136

---
title: Generic factory
slug: Mozilla/Tech/XPCOM/Generic_factory
tags:
  - XPCOM
translation_of: Mozilla/Tech/XPCOM/Generic_factory
---
<p><a href="ja/XPCOM">XPCOM</a> では、<b>汎用ファクトリ</b> は <code><a href="https://dxr.mozilla.org/mozilla-central/source/xpcom/glue/nsIGenericFactory.h" rel="custom">xpcom/glue/nsIGenericFactory.h</a></code> にある機能を利用して生成されたファクトリのことを指します。
</p><p><span>元の訳では「総称ファクトリー」となっていたが、「汎用」の方が適当ではないか</span>
</p>
<h4 id="概要"> 概要 </h4>
<p>ほとんどの XPCOM ファクトリは、とても単純なもので済みます。Rick Potts は、テンプレートベースの汎用ファクトリ (nsFactory&lt;T&gt;) を書いていますが、これによりファクトリの生成過程が単純化され、CreateInstance() メソッドを書くだけで済むようになります。新しい nsIGenericFactory インタフェースによる、もっと進んだ手段を使うことができます。これは、一つのインタフェースを、nsIFactory の簡易な実装が必要な時にいつでも再使用できるようにしたものです。そのインタフェースとその使用の記述をここに挙げます。
</p>
<pre class="eval">/**
 * 汎用的な nsIFactory の実装を提供します。この実装は、とても
 * 簡易なファクトリを必要とする DLL で使うことができます。
 */
class nsIGenericFactory : public nsIFactory {
public:
    static const nsIID&amp; IID() { static nsIID iid = NS_IGENERICFACTORY_IID; return iid; }

    typedef NS_CALLBACK(ConstructorProcPtr) (nsISupports *aOuter, REFNSIID aIID, void **aResult);

    /**
     * 汎用ファクトリのコンストラクタ関数を設定します。
     * これは CreateInstance によって呼び出されます。
     */
    NS_IMETHOD SetConstructor(ConstructorProcPtr constructor) = 0;
};
</pre>
<p>nsIGenericFactory は、簡単に使えます。NS_GENERICFATORY_CIDのCID と NS_IGENERICFACTORY_IID の IID を使って、リポジトリから新しいインスタンスを作成します。ConstructionProcPtr プロトタイプに適合するコンストラクタ関数を定義してください。そして、その関数に対するポインタとともに nsIGenericFactory::SetConstructor を呼び出してください。それでおしまいです。これで、あなたは完全な機能を持つファクトリオブジェクトを使うことができます。
</p>
<h4 id="実例"> 実例 </h4>
<pre class="eval">class nsIComponent : public nsISupports {
public:
  NS_IMETHOD DoSomething() = 0;
};

class MyComponent : public nsIComponent {
public:
  MyComponent();
  virtual ~MyComponent();

  static NS_METHOD Create(nsISupports *aOuter, REFNSIID aIID, void **aResult);

  NS_IMPL_ISUPPORTS

  NS_IMETHOD DoSomething();
};
</pre>
<p>このクラスのためのファクトリを作るには、単に以下のように書いてください。
</p>
<pre class="eval">nsIFactory* NewComponentFactory(nsIRepository* repository)
{
    nsIGenericFactory* factory = NULL;
    nsCID kGenericFactoryCID = NS_GENERICFACTORY_CID;
    nsresult res = repository-&gt;CreateInstance(kGenericFactoryCID, NULL, nsIGenericFactory::IID(), &amp;factory);
    if (res == NS_OK) {
        factory-&gt;SetConstructor(&amp;MyComponent::Create);
    }
    return factory;
}
</pre>
<p>この例では、XPCOM リポジトリは、インタフェースとして使うことができると仮定しています。(もうすぐそうなる予定です)
</p>
<h4 id="背景"> 背景 </h4>
<p>(これは、私のオリジナルのニュース投稿 &lt;<a class=" link-mailto" href="mailto:beard-2402991733140001@h-198-93-95-151.mcom.com">beard-2402991733140001@h-198-93-95-151.mcom.com</a>&gt; が元になっています。)
</p><p>我々は、異なるファクトリ実装を膨大に作ってきたと思われます。すべての単純なファクトリの代わりとして以下のクラスを使えば、コードサイズ (すべての QueryInterface、AddRef、Release の実装) を縮小できるはずです。
</p>
<pre class="eval"><span>// アイデア: 汎用ファクトリを作ることで、多くの
 // nsIFactory コードの複製を避けられます。我々に必要なのは、
 // アロケータ関数だけです。その他の実装は、まったく同じです。

 #include "nsIFactory.h"

 class nsGenericFactory : public nsIFactory {
 public:
    typedef nsresult (*CreatorProcPtr) (nsISupports *aOuter,
                                        REFNSIID aIID, void **aResult);

    nsGenericFactory(CreatorProcPtr creator);
    virtual ~nsGenericFactory();

    NS_DECL_ISUPPORTS

    NS_IMETHOD CreateInstance(nsISupports *aOuter, REFNSIID aIID, void **aResult);

    NS_IMETHOD LockFactory(PRBool aLock);

 private:
    CreatorProcPtr mCreator;
 };

 nsGenericFactory::nsGenericFactory(CreatorProcPtr creator)
    :  mCreator(creator)
 {
    NS_INIT_REFCNT();
 }

 nsGenericFactory::~nsGenericFactory() {}

 static NS_DEFINE_IID(kIFactoryIID, NS_IFACTORY_IID);

 NS_IMPL_ISUPPORTS(nsGenericFactory, kIFactoryIID)

 NS_IMETHODIMP nsGenericFactory::CreateInstance(nsISupports *aOuter,
                                                REFNSIID aIID, void **aResult)
 {
    return mCreator(aOuter, aIID, aResult);
 }

 NS_IMETHODIMP nsGenericFactory::LockFactory(PRBool aLock)
 {
    return NS_OK;
 }</span>
</pre>
<p>多くのクラスは、クリエータ関数として使うための静的なエントリーポイントをすでに持っています。そのため、多くの場合、クラスのための新しいファクトリを作るのは、単にこんな感じでいいのです。
</p>
<pre class="eval">nsIFactory* NewMallocFactory()
{
   nsIFactory* factory = new nsGenericFactory(&amp;nsMalloc::Create);
   factory-&gt;AddRef();
   return factory;
}
</pre>
<p>Warren に話すと、彼はこの手順を短縮するために、関数ポインタと一緒にファクトリを登録できるようにしようと提案しました。
</p>
<div class="originaldocinfo">
<h2 id="原文書の情報"> 原文書の情報 </h2>
<ul><li> 著者: <a class="link-mailto" href="mailto:beard@netscape.com">Patrick Beard</a>
</li><li> 最終更新日: February 26, 1999
</li><li> 著作権: Portions of this content are © 1998–2007 by individual mozilla.org contributors; content available under a Creative Commons license | <a class="external" href="http://www.mozilla.org/foundation/licensing/website-content.html">詳細</a>
</li></ul>
</div>
<div class="noinclude">
</div>