elephant-bird的安装和使用

2023-12-10 18:38
文章标签 安装 使用 bird elephant

本文主要是介绍elephant-bird的安装和使用,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

转自:http://guoyunsky.iteye.com/blog/1780165 

elephant-bird使用还是比较简单,毕竟只是一个生成代码的工具.我一开始以为elephant-bird也跟Protcol Buffer或Thrift一样,有自己的脚本,传入参数和参数值,通过脚本去生成代码.后来才发现,根本无需如此.
       毕竟elephant-bird基于Protocol Buffer和Thrift,而Protocol Buffer跟Thrift(Thrift我还没去测试过)又支持调用外部命令,也就是shell脚本.而这个shell脚本可以是elephant-bird生成代码的地方.具体看使用吧.
       1.依赖环境: 

                 1)Ant 

                 2)Protocol Buffer
       2.下载   

               下载相对简单,我这里通过git:   

                git clone https://github.com/kevinweil/elephant-bird.git 

                这里下载的elephant-bird路径我在下面简称为$ELEPHANT_BIRD_HOME
       3.安装 

              安装也相对简单,通过ant即可.如: ant install-local ant compile 

              运行这两个ant之后,会发现在$ELEPHANT_BIRD_HOME/build目录下发现elephant-bird-xxx.jar以及lib/compile目录,等下需要用到.
       4.使用 

             1)所需要的proto文件

               我这里直接拷贝Protocol Buffer的样例:address_book.proto,代码如下:    

 

Proto代码   收藏代码
  1.  package com.twitter.data.proto.tutorial;  
  2. // The sample protocol buffer file that Google uses in their examples at   
  3. // http://code.google.com/p/protobuf.   
  4. // Used in this project for tests and examples.  
  5. option java_outer_classname = "AddressBookProtos";  
  6. message Person {  
  7.     required string name = 1;   
  8.     required int32 id = 2;   
  9.     optional string email = 3;  
  10.   
  11.    enum PhoneType {   
  12.              MOBILE = 0;   
  13.              HOME = 1;   
  14.              WORK = 2;  
  15.     }  
  16.   
  17.      message PhoneNumber {   
  18.              required string number = 1;   
  19.              optional PhoneType type = 2 [default = HOME];   
  20.      }  
  21.      repeated PhoneNumber phone = 4;   
  22. }  
  23.   
  24. message AddressBook {  
  25.      repeated Person person = 1;   
  26. }   

      也可以从$ELEPHANT_BIRD_HOME/examples/src/proto/下获取address_book.proto


    2)新建build.xml,代码如下:  

     

Xml代码   收藏代码
  1. <project name="elephant-bird-study" basedir"." default="generate-protobuf" >  
  2.       <property name="src.dir" location="src" />   
  3.       <property name="src.java.dir" location="${src.dir}/java" />   
  4.       <property name="src.proto.dir" location="${src.dir}/proto" />   
  5.       <property name="src.gen.java.dir" location="${src.dir}/gen-java" />  
  6.   
  7.      <target name="generate-protobuf" >   
  8.            <delete dir="${src.gen.java.dir}"/>   
  9.            <mkdir dir="${src.gen.java.dir}"/>   
  10.            <apply executable="protoc" failonerror="true" skipemptyfilesets="true" verbose="true">                                      
  11.            <arg value="--proto_path=${src.proto.dir}" />      
  12.             <arg value="--java_out=${src.gen.java.dir}" />     
  13.             <arg value="--test_out=${src.gen.java.dir}" />      
  14.             <fileset dir="${src.proto.dir}" includes="**/*.proto" />   
  15.          </apply>  
  16.     </target>  
  17. </project>  

  
        3)通过ant脚本生成address_book.proto对应的代码:

 

           ant generate-protobuf    

           如果不出意外,可以在你工程目录下的src/gen-java看到生成的代码:com.twitter.data.proto.tutorial.AddressBookProtos.java.

 

        4)以上只是通过Protocol Buffer生成了Java,但对应Hadoop的Writable,Pig的LoadFunc还没生成,这里还要使用protoc命令,由protoc去调用一个脚本去生成这些代码.具体如下: 

           i.需要的东西:    

             a)各种jar:

                     elephant-bird-2.1.8.jar,guava-10.0.1.jar,hadoop-core-0.20.2-cdh3u0.jar,hadoop-lzo-0.4.15.jar,protobuf-java-2.3.0.jar,yamlbeans-0.9.3.jar,这些自己下载获取从$ELEPHANT_BIRD_HOME/build/lib/compile或$ELEPHANT_BIRD_HOME/lib下获取 

            b)需要运行elephant-bird脚本,我这里放在$YOUR_PROJECT_HOME/script目录下 

        ii.步骤: 

             a)将以上需要的jar放到你的工程目录下的lib目录中    

             b)更改build.xml,如下:      

Xml代码   收藏代码
  1. <project name="elephant-bird-study" basedir"." default="generate-protobuf" >  
  2.          <property name="src.dir" location="src" />  
  3.          <property name="src.java.dir" location="${src.dir}/java" />   
  4.          <property name="src.proto.dir" location="${src.dir}/proto" />   
  5.          <property name="src.gen.java.dir" location="${src.dir}/gen-java" />  
  6.   
  7.          <target name="generate-protobuf" >   
  8.                <delete dir="${src.gen.java.dir}"/>   
  9.                <mkdir dir="${src.gen.java.dir}"/>   
  10.                <apply executable="protoc" failonerror="true" skipemptyfilesets="true" verbose="true">                                          <env key="PATH" path="${env.PATH}:${basedir}/script" />    
  11.                    <arg value="--proto_path=${src.proto.dir}" />    
  12.                    <arg value="--java_out=${src.gen.java.dir}" />   
  13.                    <arg value="--twadoop_out=${src.gen.java.dir}" />   
  14.                    <fileset dir="${src.proto.dir}" includes="**/*.proto" />   
  15.               </apply>   
  16.        </target>  
  17. </project>  

 

           增加了<env key="PATH" path="${env.PATH}:${basedir}/script" />,表示将刚才新建的$YOUR_PROJECT_HOME/script下的文件放入path中     

         增加了参数<arg value="--twadoop_out=${src.gen.java.dir}" />,这里elephant-bird有个奇怪的规则,参数名为--twadoop_out,其中twadoop存在规则,他将跟protoc-gen-组成protoc-gen-twadoop做为Protocol Buffer调用elephant-bird的脚本文件名.   

           c)在$YOUR_PROJECT_HOME/script目录下新建脚本protoc-gen-twadoop,内容如下:    

Shell代码   收藏代码
  1. #!/bin/bash  
  2. bindir=`/usr/bin/dirname "$0"`   
  3. /usr/bin/java -cp $bindir/../lib/*: com.twitter.elephantbird.proto.HadoopProtoCodeGenerator $bindir/config-twadoop.yml -  

         以上会将刚拷贝到$YOUR_PROJECT_HOME/lib下的所有jar由java执行,然后会调用com.twitter.elephantbird.proto.HadoopProtoCodeGenerator类去生成所需要的各种代码.想要什么代码,则由config-twadoop.yml配置 

 

       d)注意protoc-gen-twadoop中有config-twadoop.yml,该文件配置elephant-bird想生成代码.文件内容如下:    

Txt代码   收藏代码
  1. address_book:    
  2. - com.twitter.elephantbird.proto.codegen.DeprecatedLzoProtobufBlockInputFormatGenerator    
  3. - com.twitter.elephantbird.proto.codegen.LzoProtobufB64LineInputFormatGenerator    
  4. - com.twitter.elephantbird.proto.codegen.LzoProtobufB64LineOutputFormatGenerator  
  5. #  - com.twitter.elephantbird.proto.codegen.LzoProtobufB64LinePigLoaderGenerator    
  6. - com.twitter.elephantbird.proto.codegen.LzoProtobufBlockInputFormatGenerator    
  7. - com.twitter.elephantbird.proto.codegen.LzoProtobufBlockOutputFormatGenerator  
  8. #  - com.twitter.elephantbird.proto.codegen.LzoProtobufBlockPigLoaderGenerator  
  9. # - com.twitter.elephantbird.proto.codegen.LzoProtobufHiveSerdeGenerator      
  10. - com.twitter.elephantbird.proto.codegen.ProtobufWritableGenerator  
  11. # - com.twitter.elephantbird.proto.codegen.ProtobufBytesToPigTupleGenerator   

     我这里不想生成pig和hive的代码,所以在前面加了个#注释了.


    e)生成代码,再次运行ant generate-protobuf,不出意外的话,YOUR_PROJECT_HOME/src/gen-java就会生成所需要的代码.

 

     注:本博客基于Elephantbird2.1.8

    在github上建了一个开源工程,可以运行ant命令基于elephantbird直接生成代码.地址:

       https://github.com/guoyunsky/elephant-bird-simple


这篇关于elephant-bird的安装和使用的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/477972

相关文章

python使用库爬取m3u8文件的示例

《python使用库爬取m3u8文件的示例》本文主要介绍了python使用库爬取m3u8文件的示例,可以使用requests、m3u8、ffmpeg等库,实现获取、解析、下载视频片段并合并等步骤,具有... 目录一、准备工作二、获取m3u8文件内容三、解析m3u8文件四、下载视频片段五、合并视频片段六、错误

gitlab安装及邮箱配置和常用使用方式

《gitlab安装及邮箱配置和常用使用方式》:本文主要介绍gitlab安装及邮箱配置和常用使用方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录1.安装GitLab2.配置GitLab邮件服务3.GitLab的账号注册邮箱验证及其分组4.gitlab分支和标签的

SpringBoot3应用中集成和使用Spring Retry的实践记录

《SpringBoot3应用中集成和使用SpringRetry的实践记录》SpringRetry为SpringBoot3提供重试机制,支持注解和编程式两种方式,可配置重试策略与监听器,适用于临时性故... 目录1. 简介2. 环境准备3. 使用方式3.1 注解方式 基础使用自定义重试策略失败恢复机制注意事项

MySQL MCP 服务器安装配置最佳实践

《MySQLMCP服务器安装配置最佳实践》本文介绍MySQLMCP服务器的安装配置方法,本文结合实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下... 目录mysql MCP 服务器安装配置指南简介功能特点安装方法数据库配置使用MCP Inspector进行调试开发指

nginx启动命令和默认配置文件的使用

《nginx启动命令和默认配置文件的使用》:本文主要介绍nginx启动命令和默认配置文件的使用,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录常见命令nginx.conf配置文件location匹配规则图片服务器总结常见命令# 默认配置文件启动./nginx

在Windows上使用qemu安装ubuntu24.04服务器的详细指南

《在Windows上使用qemu安装ubuntu24.04服务器的详细指南》本文介绍了在Windows上使用QEMU安装Ubuntu24.04的全流程:安装QEMU、准备ISO镜像、创建虚拟磁盘、配置... 目录1. 安装QEMU环境2. 准备Ubuntu 24.04镜像3. 启动QEMU安装Ubuntu4

使用Python和OpenCV库实现实时颜色识别系统

《使用Python和OpenCV库实现实时颜色识别系统》:本文主要介绍使用Python和OpenCV库实现的实时颜色识别系统,这个系统能够通过摄像头捕捉视频流,并在视频中指定区域内识别主要颜色(红... 目录一、引言二、系统概述三、代码解析1. 导入库2. 颜色识别函数3. 主程序循环四、HSV色彩空间详解

Windows下C++使用SQLitede的操作过程

《Windows下C++使用SQLitede的操作过程》本文介绍了Windows下C++使用SQLite的安装配置、CppSQLite库封装优势、核心功能(如数据库连接、事务管理)、跨平台支持及性能优... 目录Windows下C++使用SQLite1、安装2、代码示例CppSQLite:C++轻松操作SQ

Python常用命令提示符使用方法详解

《Python常用命令提示符使用方法详解》在学习python的过程中,我们需要用到命令提示符(CMD)进行环境的配置,:本文主要介绍Python常用命令提示符使用方法的相关资料,文中通过代码介绍的... 目录一、python环境基础命令【Windows】1、检查Python是否安装2、 查看Python的安

Python UV安装、升级、卸载详细步骤记录

《PythonUV安装、升级、卸载详细步骤记录》:本文主要介绍PythonUV安装、升级、卸载的详细步骤,uv是Astral推出的下一代Python包与项目管理器,主打单一可执行文件、极致性能... 目录安装检查升级设置自动补全卸载UV 命令总结 官方文档详见:https://docs.astral.sh/