= 旧コンテンツ =


== 参考 ==

=== 必須 ===

 * [[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クライアント]]