C++でのAPI設計

Question

他のいくつかのライブラリを使用する複雑なC++ソフトウェアを書き始めていますが、私の懸念事項は、これらのライブラリにアクセスするには限られた数のクラスにしたいが、C++ヘッダーヘッダーを含むオブジェクトもクラスの依存関係にアクセスする必要があります。これを取り巻く最も適切な方法は何ですか？

Answer 1

制限付きライブラリのオブジェクトへのポインタまたは参照のみがライブラリのオブジェクトに保持されている場合、ヘッダー自体を含めるのではなく、ヘッダーで前方宣言できます。唯一のCPPファイルがrestricted.hヘッダーを含める必要があり、前方宣言の場合には

#include <restricted.h> // contains definitions of restricted_lib_class1 and restricted_lib_class2 

class my_class1 { 
    restricted_lib_class1 *restricted1; 
    restricted_lib_class2 *restricted2; 
    // Other class members 
}; 

：たとえば、あなたはこの

class restricted_lib_class1; 
class restricted_lib_class2; 

class my_class1 { 
    restricted_lib_class1 *restricted1; 
    restricted_lib_class2 *restricted2; 
    // Other class members 
}; 

の代わりにこれを行うことができます。

"制限された"クラスのインスタンスを含めるか、継承する必要がある場合は、ヘッダーファイルにそのヘッダーを含めないでください。

Answer 2

1つの提案は、pimplまたは抽象的な「インターフェース」パターンを使用することです。

pimplパターンは、前方宣言された実装クラスへのポインタを格納する場所です。

例：

---

blah.hpp

class foo 
{ 
    struct impl; 
    impl* myImpl; 
public: 
    foo(); 
} 

blah.cpp

#incldue <internalClass> 
struct foo::impl 
{ 
    internalClass o; 
}; 

foo::foo() 
{ 
    myImpl = new impl(); 
} 

---

別のオプションは、AKA純粋仮想抽象クラスを（持っているだろうインタフェース）。 次に、ファクトリ関数（またはファクトリクラス）が実装へのポインタを返します。 したがって、クライアントコードは実装内のメンバーを参照する必要はありません。

例：

---

inter.hpp

class inter 
{ 
    virtual void doFoo() = 0; 
    inter* create(); 
}; 

realInter.hpp

class realInter: public inter 
{ 
    virtual void doFoo() { //blah blah blah} 
    internalClass aMember; 
}; 

inter.cpp

#include <realInter.hpp> 
inter* inter::create() 
{ 
    return new realInter(); 
}