Apache Thrift 学习第二篇（安装&试用）

binghai03

这一篇，我们来试着安装Thrift，并运行Thrift自带的例子，以对Thrift有个感性的认识。
一、下载
    从官网下载最新版：http://thrift.apache.org/，在写这篇博客的时候，最新版稳定版是0.8.0。官网给的有安装教程以及系统要求，可参照http://thrift.apache.org/docs/install/，上面有各种系统下的编译安装方法。由于我的系统是ubuntu，所以就把ubuntu下thrift的编译安装教程放到这里。
    首先，在ubuntu上，系统需要需要有如下组件：
sudo apt-get install libboost-dev libboost-test-dev libboost-program-options-dev libevent-dev automake libtool flex bison pkg-config g++ libssl-dev

     如果没有JDK的话，还需要安装JDK。JDK的安装就不再细说了。
    然后，如果Thrift支持下面的语言的的话还需要安装一些额外的包：
    Ruby
    ruby-full ruby-dev librspec-ruby rake rubygems libdaemons-ruby libgemplugin-ruby mongrel
    Python
    python-dev python-twisted
    Php
    php5-dev php5-cli
    C_glib
    libglib2.0-dev
    Erlang
    erlang-base erlang-eunit erlang-dev
    Haskell
    ghc6 cabal-install libghc6-binary-dev libghc6-network-dev libghc6-http-dev

二、源码的编译与安装
   #需要指定Boost库的位置，在我的机器上是/usr/include
./configure --with-boost=/usr/include
make -j 4 #4核编译
make install

    如果编译有错误的话，请参照http://thrift.apache.org/docs/BuildingFromSource/

三、运行示例程序

    Thrift支持多种语言之间通信，一个作为服务器，另一个作为客户端，在示例程序中我们可以选择Python和Php，用Python作为服务器，Php作为客户端。下载的源码中自带示例程序，源码目录下面有个tutorial目录，里面有README，可以查看说明。使用方法如下：
    cd tutorial
#我们用自带的例子生成Python和Php代码，下面两行代码执行后会创建目录gen-py和gen-php，里面有生成的代码。
thrift -r --gen py tutorial.thrift
thrift -r --gen php:namespace tutorial.thrift

    tutorial里面已经有了现成的服务器代码，tutorial/py/PythonServer.py。但是在Thrift 0.8.0里面，这个代码是有问题的，需要修改
    第84行，
    transport = TSocket.TServerSocket(9090)
    修改为transport = TSocket.TServerSocket(port = 9090)
    否则，运行的时候会报错，TypeError: getaddrinfo() argument 1 must be string or None。而且我们在运行的时候，最好要先进入目录tutorial/py，然后以./PythonServer.py方式运行，否则由于PYTHONPATH的问题，还会有错误ImportError: No module named tutorial。当然也有其他解决办法，解决方法看这里。
    在运行PHP客户端之前，我们还有一些其他工作要做，建议这样配置：
    cd tutorial/php
cp -r ../../lib/php/src/ ./
cp -r ../gen-php ./src/packages/

    修改下面两行代码
$GLOBALS['THRIFT_ROOT'] = './src';
$GEN_DIR = $GLOBALS['THRIFT_ROOT'].'/packages';
    修改成功后运行Php客户端./php PhpClient.php
    如果出现找不到类的话，需要注意PHP命名空间的使用。

四、使用C++服务器
     使用C++做服务器需要安装C++ lib，修改Makefile文件，参照wiki
http://wiki.apache.org/thrift/ThriftUsageC%2B%2B
       安装C++ lib的方法是:
cd thrift-0.8.0/lib/cpp/
make
sudo make install
sudo /sbin/ldconfig -v

    上面的第4步是更新系统lib库的，让系统库包含/usr/local/lib，否则运行C++ Server的时候，找不到libthrift-0.8.0.so。参考链接：http://blog.csdn.net/shendl/article/details/5746062
    下一步是更新Makefile文件， 可以参考我的Makefile（Wiki上也有更详细的说明），
    我的Makefile文件如下：
#
# Licensed to the Apache Software Foundation (ASF) under one
# or more contributor license agreements. See the NOTICE file
# distributed with this work for additional information
# regarding copyright ownership. The ASF licenses this file
# to you under the Apache License, Version 2.0 (the
# "License"); you may not use this file except in compliance
# with the License. You may obtain a copy of the License at
#
#   http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing,
# software distributed under the License is distributed on an
# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
# KIND, either express or implied. See the License for the
# specific language governing permissions and limitations
# under the License.
#
BOOST_DIR := /usr/include
THRIFT_DIR := /usr/local/include/thrift
LIB_DIR := /usr/local/lib
GEN_SRC := ./gen-cpp/SharedService.cpp ./gen-cpp/shared_types.cpp ./gen-cpp/tutorial_types.cpp ./gen-cpp/Calculator.cpp
GEN_OBJ := $(patsubst %.cpp, %.o, $(GEN_SRC))
INC = -I$(THRIFT_DIR) -I$(BOOST_DIR)
.PHONY: all clean
all: server client
%.o: %.cpp
$(CXX) -Wall -DHAVE_INTTYPES_H -DHAVE_NETINET_IN_H $(INC) -c $< -o $@
server: CppServer.o $(GEN_OBJ)
$(CXX) $^ -o $@ -L$(LIB_DIR) -lthrift
client: CppClient.o $(GEN_OBJ)
$(CXX) $^ -o $@ -L$(LIB_DIR) -lthrift
clean:
$(RM) *o server client