krkrsdl2 / ncbind Goto Github PK
View Code? Open in Web Editor NEWThis project forked from wtnbgo/ncbind
This project forked from wtnbgo/ncbind
Title: 吉里吉里プラグイン向けネイティブクラスバインダ Author: miahmie ●これは何か? 既存の C++ ライブラリを TJS で扱うためのプラグインを 簡単に作ることができるようにするための C++ テンプレートです。 従来のプラグインソースでは引数の受け渡し部分のラッパを tp_stub.h のマクロを使いつつ手で書かなければならなかったのですが, テンプレートによりこれをほとんどコンパイラに任せることができます。 gcc 3.4 系列と VC++2005 Express で動作確認しています。 テンプレート実装の関係で VC++6 ではコンパイルすら無理だと思います。 VC++2003 や他のコンパイラは未確認なのでどうなるかわかりません。 ●簡単な説明 マクロで登録したいクラスの定義を記述するだけです。 #include "ncbind.hpp" #include "既存ライブラリのヘッダ等" NCB_REGISTER_CLASS(登録するクラス名) { Constructor<コンストラクタの引数の型, ...>(0); Method("登録するメソッド名1", &Class::登録するメソッド1); Method("登録するメソッド名2", &Class::登録するメソッド2); : Method("登録するメソッド名n", &Class::登録するメソッドn); } 詳しくは testbind.cpp のソースを見るなどしてください。 ●ファイル構成 ncbind.hpp メインテンプレート ncbind.cpp V2Link/V2Unlink 定義 ncbind.def gcc用エクスポートファイル VC++では /EXPORT:V2Link /EXPORT:V2Unlink してください ncb_invoke.hpp 任意のメソッドを呼ぶためのテンプレート ncb_foreach.h マクロを任意個数展開するためのincludeマクロ testbind.* テスト用のプロジェクト ●詳細 ▼NCB_REGISTER_CLASS(Class) { ... } ▼NCB_REGISTER_CLASS_DIFFER(Name, Class) { ... } Class を TJSグローバル空間(Name or Class)に登録します。 NCB_REGISTER_CLASS では Class が,NCB_REGISTER_CLASS_DIFFERでは Name が グローバル空間上での名前となります。同じクラスの多重登録はエラーになります。 ※ 以前のバージョンの NCB_{ CONSTRUCTOR, METHOD*, PROPERTY* } マクロも 使用できますが,Bridge用のマクロは用意されていません。 ---------------------------------------------------------------- ▽Constructor(); ▽Constructor<arg1, arg2, ...>(0); 引数の型のリスト (arg1, arg2, ...) を渡してコンストラクタを登録します。 直後の (0) は Constructor のオーバーロード用のシグネチャとして必要です。 デフォルトコンストラクタ(引数なし)を登録する場合はその限りではありません。 型の一致したコンストラクタが TJS から new するときに呼ばれます。 登録しない場合はそのクラスを new するとエラーになります。(※まだ未実装) また,オーバーロードされた複数コンストラクタの登録はできません。 最初に登録されたものが有効となります。(実行時に警告メッセージが出ます) ---------------------------------------------------------------- ▽Factory(Class* (*)(iTJSDispatch2*[, arg1, arg2, ...])); ▽Factory(tjs_error (TJS_INTF_METHOD *)(Class**, tjs_int, tTJSVariant**, iTJSDispatch2*)); インスタンスを生成する関数を指定してコンストラクタを登録します。 1番目の引数にobjthisが渡るProxyのような関数を使用する方法と,引数の個数と tTJSVariantの配列を渡すRawCallbackのような関数を使用する方法があります。 前者は返り値として生成したインスタンスのポインタを返します。 (NULLを返すとエラーとして扱われます) 後者は一番目の引数にインスタンスのポインタを書き込んでTJS_S_OKを返します。 (NULLを書き込んだり,TJS_S_OK以外を返すとエラーとして扱われます) ---------------------------------------------------------------- ▽Method(Name, &Class::Method); クラスメソッド Method を登録します。Class は NCB_REGISTER_CLASS にて 渡されたクラスが typedef されています。 Name は TJS_W() 経由のワイド文字でも,直記述のナロー文字列でもかまいません。 (ナローの場合は登録時に自動的に変換がかかります) オーバーロード等で同じ名前のメソッドが複数ある場合は メソッド型の自動判定に失敗するので static_cast または method_cast を 使用してください。 static_cast<ReturnType (Class::*)(arg1, ... argN) [const]>(&Class::Method) method_cast<ReturnType, Type, arg1, ... argN>(&Class::Method) ReturnType は メソッドの返り値の型です。 Type はクラスメソッドのタイプで, Class 普通のクラスメソッド Const const なクラスメソッド(ReturnType Method(arg...) const;) Static static なクラスメソッド の 3つのうちどれかを記述します。 arg1, ... argN は引数の型を指定します。 ---------------------------------------------------------------- ▽Method(Name, &Method, Proxy); クラス外のstatic関数をクラスメソッドとして振舞わせるよう登録します。 その関数の一番目の引数は必ずそのクラスのインスタンスポインタ型にします。 これに this 相当の値が渡り,TJSから渡される残りの引数はその後に並べます。 既存のライブラリを登録するときに,ライブラリに手を加えず 何らかの特殊な処理を入れたいなどの場合で有効です。 ---------------------------------------------------------------- ▽Method(Name, &Method, Bridge<BridgeFunctor>()); ブリッジファンクタを指定して,そのクラス内から別のクラスインスタンスに 処理を委譲するメソッドを登録します。 ファンクタは以下のような形式です。 struct BridgeFunctor { BridgeClass* operator()(Class* p) const { return p->BridgeInstance; } }; Class : 登録中のクラス BridgeClass : 処理を委譲するクラス BridgeInstance : Class内に保持されている BridgeClass のインスタンス Methodは委譲先のクラスのメソッドを記述します。 &Class::Method ではなく,&BridgeClass::Method という表記になります。 ---------------------------------------------------------------- ▽Method(Name, &Method, ProxyBridge<BridgeFunctor>()); ▽Method(Name, &Method, BridgeProxy<BridgeFunctor>()); Proxyつきのブリッジ登録です。 ---------------------------------------------------------------- ▽Property(Property, GetterMethod, SetterMethod); Property という名前でプロパティを登録します。 GetterMethod, SetterMethod はそれぞれ プロパティ取得,プロパティ設定メソッドです。 SetterMethod または GetterMethod に 0 を渡すと, それぞれ は読み込み専用,書き込み専用プロパティになります。 Setter/Getterのメソッド型のチェックが甘いので 指定するメソッドには注意してください。 ---------------------------------------------------------------- ▽Property(Property, GetterMethod, SetterMethod, Proxy); ▽Property(Property, GetterMethod, SetterMethod, Bridge<Functor>()); ▽Property(Property, GetterMethod, SetterMethod, ProxyBridge<Functor>()); ▽Property(Property, GetterMethod, SetterMethod, BridgeProxy<Functor>()); Proxy/Bridgeつきのプロパティを登録します。 詳細は Method 項目を参照してください。 ---------------------------------------------------------------- ▽RawCallback(Name, &Callback, Flag); コールバックを指定して Name という名前でメソッドを登録します。 Callback は tTJSNativeClassMethodCallback 型の static 関数ポインタか, または,tTJSNativeClassMethodCallback の引数の iTJSDispatch2 *objthis を このクラスのインスタンスのポインタにしたものが使えます。 (この場合,実際のネイティブインスタンスへのポインタが引数として渡ります) Flag は, 0 (通常クラスメソッド時) TJS_STATICMEMBER (staticメソッド時) のどちらかが指定できます。 ---------------------------------------------------------------- ▽RawCallback(Name, &GetterCallback, &SetterCallback, Flag); コールバック指定のプロパティ登録です。 ---------------------------------------------------------------- マクロ説明の続き: ▼NCB_ATTACH_CLASS( Class, TJS2Class) { ... } ▼NCB_ATTACH_CLASS_WITH_HOOK(Class, TJS2Class) { ... } 吉里吉里2の既存のクラス TJS2Class に Class を付加します。 { ... } スコープ内は NCB_REGISTER_CLASS と同じように定義します。 ただし,コンストラクタ定義 NCB_CONSTRUCTOR は使えません。 NCB_ATTACH_CLASS で登録した場合,Class のインスタンスは 登録された Class のメソッドが初めて呼ばれたときに 引数なしのコンストラクタで new され,メソッドが呼ばれます。 NCB_ATTACH_CLASS_WITH_HOOK で登録する場合は,あらかじめ後述の NCB_GET_INSTANCE_HOOK が定義済みでなければなりません。 Class インスタンスの生成はフック用クラスに一任されます。 ▼NCB_GET_INSTANCE_HOOK(Class) { ... }; ▼NCB_GET_INSTANCE_HOOK_CLASS ▼NCB_INSTANCE_GETTER(ObjThis) TJS からネイティブクラス Class のメソッドを呼び出す時の インスタンスを取得する関数をフック(というか再定義)します。 詳しくは testbind.cpp ソースを参照してください。 NCB_ATTACH_CLASS だけでなく,NCB_REGISTER_CLASS で 登録したクラスにも適用されます。 また,すべてのクラスメソッドに適用されるため, 指定の個別メソッドにフックする等はできません。 ⇒要望があれば実装します ▼NCB_REGISTER_SUBCLASS(Class) ▽SubClass(Name, TypeWrap<Class>()); サブクラスの定義と登録です。クラス中にstaticとしてサブクラスが置かれます。 これを使うことで名前空間を汚さずに階層構造をとることができます。 ※実験中コードにつき不具合があるかもしれません ▼NCB_REGISTER_FUNCTION(Name, Function); TJS グローバル空間に Name という名前で Function という関数を登録します。 Function が tTJSNativeClassMethodCallback 型の場合は そのまま RawCallback 形式のグローバル関数として動作します。 ▼NCB_ATTACH_FUNCTION(Name, TJS2Class, Function); 吉里吉里2の既存のクラス TJS2Class に Name という名前で Function を付加します。Function が tTJSNativeClassMethodCallback 型の場合は そのままメソッドの RawCallback と同じように動作します。 このマクロでは,非 static な関数しか付加できません。static なメソッドとして 登録したい場合は,ダミーの static メソッドしか存在しないクラスを作り, NCB_ATTACH_CLASS で登録してください。(static メソッドの呼び出しであれば ネイティブインスタンスは生成されません) ▼NCB_REGISTER_INSTANCE(...); // 未実装 ⇒ 参照を返す function / property で代用できます ▼NCB_TYPECONV_CAST(Type, CastType); 引数の型が Type の場合,キャスト CastType を指定して tTJSVariant と相互変換するように登録します。 ▼NCB_SET_CONVERTOR(Type, Convertor); 引数の型 Type を変換するクラスを登録します。 詳しくは ncbind.hpp のコメント等を参照してください。 ▼NCB_PRE_REGIST_CALLBACK(Callback); ▼NCB_POST_REGIST_CALLBACK(Callback); ▼NCB_PRE_UNREGIST_CALLBACK(Callback); ▼NCB_POST_UNREGIST_CALLBACK(Callback); クラスを登録・開放する前後に呼ばれるコールバック void Callback() を 登録します。呼ばれる順番は以下のとおりです。 V2Link時: PRE_REGIST_CALLBACK クラス登録 POST_REGIST_CALLBACK V2Unlink時: PRE_UNREGIST_CALLBACK クラス開放 POST_UNREGIST_CALLBACK 同じ種類のコールバックが複数登録された場合の順番の保証はありません。 ●制限 ・継承関係はサポートしていない ⇒継承関係にあるクラス同士を登録した場合,別のクラス扱いになる ・instanceof で派生クラスインスタンスのチェックができない ・引数に派生クラスインスタンスを渡した場合は インスタンスポインタが取得できずにエラーとなる ・引数の省略によるデフォルト値をサポートしていない ⇒TJSから渡す引数の個数はメソッドの引数の個数以上であること 余分に渡された引数は無視され,足りない場合は TJS_E_BADPARAMCOUNT が返る ⇒可変長引数をサポートする場合は RawCallback で自力実装すること ・namespace 内でのクラス登録は考えられていないので namespace 外で行うこと ⇒namespace 内のクラスを登録する場合は typedef するなどで 必ず namespace の外で行う (:: を含むとエラーになる) ex. typedef ::Foo::Bar::TargetClass TargetClass; NCB_REGISTER_CLASS(TargetClass) { ... } ・コンストラクタは1つしか記述できない ⇒インスタンスを生成する static なメソッドを書くなどして解決する ・登録したクラスのインスタンスをメソッドの返り値で返す時には注意が必要 ⇒インスタンスの多重 delete や,既に delete されている無効な インスタンスが使用される可能性がある コピーで返す :コピーコンストラクタで新たなインスタンスが生成されTJS側へ返る 参照で返す :そのままTJS側へ返され,invalidate 時に delete されない ポインタで返す:そのままTJS側へ渡され,invalidate 時に delete される const の参照/ポインタは強制的に const 解除される ・参照で値を書き換えて返すようなメソッドには対応できない ⇒適当なRawCallback関数を書くなどして対処すること ・TJSCreateNativeClassMethod を使わずにメソッド呼び出しを独自実装 しているため,将来にわたりソース互換が保てるという保証がない ⇒吉里吉里2自体もうメンテフェーズだから別にいい…よね? ●独り言 ・テンプレートは Modern C++ Design 書籍を読んだくらいで,Boostとかシラネ ncb_invokeの前身バージョンでTypeListで実装したやつもあったけど そこまでするような物ではないと悟ったので今回は力業で実現 ・tTJSVariantType tTJSVariant::Type() は何故 const メソッドでないのか const_cast使うハメになって敗北気分 ⇒修正されましたが,従来互換重視のため結局使えない(涙) ●TODOメモ ・ncibind.hpp 古いコメントの整理 ・NCB_SET_CONVERTOR テスト ・Attach時に既存のメソッドがあった場合の処理 ・オーバーロードと引数の省略をサポートするか?
A declarative, efficient, and flexible JavaScript library for building user interfaces.
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google ❤️ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.