Differences between revisions 10 and 11
| Deletions are marked like this. | Additions are marked like this. |
| Line 3: | Line 3: |
|
== 参考 == === 必須 === * [[http://thrift.apache.org/tutorial/|Apache Thrift]]<<BR>>本家。Windows版のバイナリがある。 * [[http://wiki.apache.org/thrift/|Thrift wiki]]<<BR>>資料いろいろ。しかしドキュメントは貧弱 * [[http://diwakergupta.github.com/thrift-missing-guide/|Thrift: The Missing Guide]]<<BR>>唯一まともなマニュアル === その他 === * [[http://developers.facebook.com/thrift/thrift-20070401.pdf|Thrift: Scalable Cross-Language Services Implementation]] * [[http://d.hatena.ne.jp/conceal-rs/20081116/1226838725|Ubuntu 8.04 で Thrift を試してみた]] * [[http://d.hatena.ne.jp/covanew/20081110/1226344882|Thriftを触ってみる(1)]] * [[http://blog.ibd.com/scalable-deployment/installing-apache-thrift-on-ubuntu-and-leopard/|Installing Apache Thrift on Ubuntu and Leopard]] == バイナリの取得とビルド == 現時点(2009/1/1)で、バイナリを配布しているところは無い模様。上記Apache Thriftからもソースコードしか取得できない。 ただし、上記「Thriftを触ってみる」ではバイナリダウンロードをしているようだが、これはFreeBSDバージョンであるらしい。 現時点では、上記「Ubuntu 8.04 で Thrift を試してみた」の通り、Ubuntu(Debian系列？)でビルドするのが最も手早い。 -Redhat系列(CentOS-5.2, Fedora-10)ではどうしてもうまくビルドできなかった。 -Windows上では非常に難しいと思われる。 困難の理由はひとえに、[[http://www.boost.org/|boost]]というC++ライブラリに依存していることがあげられる。これはとても巨大なライブラリであり、redhat系列のrpmパッケージはきちんとビルドされていないのか（あるいは相性が悪いのか）、Thriftをどうしてもビルドできない。また、Windows用のバイナリも提供されていない模様。 == ビルドの方法 == ビルドの方法としては、上記の「Installing Apache Thrift on Ubuntu and Leopard」の通りに行えばよいのだが、ただしJava, Ruby, PHP用のライブラリは自動的にはビルド・インストールされない（トップのREADMEをよく読むこと）。 これを行うにはlibディレクトリ以下の各言語用ディレクトリにてビルドを行う。 === Javaの場合 === READMEに記述があるように、lib/javaディレクトリにてantを動作させればlibthrift.jarが生成される。 == フラグ == {{{ Usage: thrift [options] file Options: -version Print the compiler version -php Generate PHP output files -phpi Generate PHP inlined files -phps Generate PHP server stubs (with -php) -phpl Generate PHP-lite (with -php) -phpa Generate PHP with autoload (with -php) -phpo Generate PHP with object oriented subclasses (with -php) -xsd Generate XSD output files -erl Generate Erlang output files -o dir Set the output directory for gen-* packages (default: current directory) -I dir Add a directory to the list of directories searched for include directives -rest Generate PHP REST processors (with -php) -nowarn Suppress all compiler warnings (BAD!) -strict Strict compiler warnings on -v[erbose] Verbose mode -r[ecurse] Also generate included files -debug Parse debug trace to stdout --gen STR Generate code with a dynamically-registered generator. STR has the form language[:key1=val1[,key2,[key3=val3]]]. Keys and values are options passed to the generator. Many options will not require values. Available generators (and options): cpp (C++): dense: Generate type specifications for the dense protocol. include_prefix: Use full include paths in generated files. hs (Haskell): html (HTML): java (Java): beans: Generate bean-style output files. nocamel: Do not use CamelCase field accessors with beans. hashcode: Generate quality hashCode methods. perl (Perl): py (Python): new_style: Generate new-style classes. rb (Ruby): }}} ※ * -phpと-phpiはインラインとされるかどうか、処理内容は変わりない模様。 * -phpiにすると、gen-phpiというディレクトリに出力される。 * -phpと-phpsは全く同じ * -phplは、-phpからProcessorを除去したもの。 * -phpaは、-phpとはかなり異なる。-phpaのみにて作成されるファイルもある。 * -phpoは、-phpのクラスにextends TBase等が付加される。 ※ * java:beansは全く効果なし。 * java:hashcodeを指定すると、常に０を返していたhashCodeメソッドがきちんと値を返すようになる。 * java:nocamelも特に効果なし。 {{{ } else if (strcmp(arg, "-php") == 0) { gen_php = true; } else if (strcmp(arg, "-phpi") == 0) { gen_phpi = true; } else if (strcmp(arg, "-phps") == 0) { gen_php = true; gen_phps = true; } else if (strcmp(arg, "-phpl") == 0) { gen_php = true; gen_phps = false; } else if (strcmp(arg, "-phpa") == 0) { gen_php = true; gen_phps = false; gen_phpa = true; } else if (strcmp(arg, "-phpo") == 0) { gen_php = true; gen_phpo = true; } else if (strcmp(arg, "-rest") == 0) { gen_rest = true; }}} == サービスのマルチプレックス化 == 例えばJavaのサーバを作成する場合、 {{{ public class Server { public static class DebugHandler implements Debug.Iface { public void info(String value) { System.out.println(value); } } public static void main(String[]args) throws Exception { DebugHandler debugHandler = new DebugHandler(); Debug.Processor processor = new Debug.Processor(debugHandler); TServerTransport transport = new TServerSocket(9090); TServer server = new TSimpleServer(processor, transport); server.serve(); } } }}} などとすればよいが、一つのサーバには一つのサービスしか登録できず、一つのサーバには一つのポートが必要である。したがって、上記Debug.IFaceのほかにSample.IFaceやTest.IFaceのサーバを作成する場合は、それぞれのプロセッサ・トランスポート・ポートが必要になる。 これを避けるために、[[https://issues.apache.org/jira/browse/THRIFT-66|https://issues.apache.org/jira/browse/THRIFT-66]]というパッチがリリースされている。これを用いると、一つのポートで複数のサービスを提供できるらしいが、ただしクライアント側も変更しなければならない。 現在はJava用しか提供されておらず、また正式なリリースではなくテスト的なものであるため、とりあえず避けておくのが無難と思われる。 == Thriftのスレッドセーフティについて == * [[http://stackoverflow.com/questions/4244350/how-thread-safe-is-thrift-re-i-seem-to-have-requests-disrupting-one-another]] == 各言語用 == * [[thrift/PHP_Client|PHPクライアント]] |
* [[thrift/old|旧コンテンツ]: |
Thrift
- [[thrift/old|旧コンテンツ]: