This repository was archived by the owner on Dec 9, 2022. It is now read-only.
githubhelp/thrift4go
Folders and files
| Name | Name | Last commit date | ||
|---|---|---|---|---|
Repository files navigation
The contents of this repository are now part of Apache Thrift as of version 0.7 or commit revision 1072478 (https://issues.apache.org/jira/browse/THRIFT-625). This project will continued to be maintained for any further developments for Thrift for Go as needed. Add this git repository to your thrift checkout. It will overwrite a few files to add options for Go. Currently generates code for the following protocols: 1) Binary Protocol (with test cases) 2) Fast Binary Protocol (with test cases) 3) Standard Thrift JSON Protocol (with test cases) 4) A (custom) simple JSON Protocol (with test cases) 5) Services (compiles and runs against Java, assumed to work elsewhere) Tested on Mac OS X 10.6 (Snow Leopard) To install in your Go Repository do: goinstall github.com/pomack/thrift4go/lib/go/thrift goinstall -a -log 4 files for thrift compiler (last tested on February 17, 2010): 1) configure.ac 2) lib/Makefile.am 3) compiler/cpp/Makefile.am 4) compiler/cpp/src/generate/t_go_generator.cc A tutorial has been created in the thrift4go/tutorial/go/src directory To use this tutorial, run thrift -r --gen go --gen java <thrift_src_dir>/tutorial/tutorial.thrift Build the files in the gen-go/ directory using gomake install Build the files in the <thrift_src_dir>/tutorial/go directory using gomake install Run the server from <thrift_src_dir>/tutorial/go/TutorialServerClient and run the client from either <thrift_src_dir>/tutorial/go/TutorialServerClient or gen-go/tutorial/Calculator/Calculator-remote Make sure you specify the same protocol for both the server and client Here's a basic walkthrough: thrift --gen go --gen java <thrift_src_dir>/test/ThriftTest.thrift this will create gen-go/thrift/test/*.go and associated files/directories * gen-go/thrift/test/ThriftTest.go shows a service and client base implementation with the associated interfaces and the ability to send/receive or serialize/deserialize as necessary. * ThriftTestClient is a client library designed to access the ThriftTest service. No changes would need to be made here. * A ThriftTest/ThriftTest-remote.go and associated Makefile is also made available so you can access a remote service implementing the ThriftTest interface and see how the client side works under the covers. The command-line arguments use the custom JSON parser, so you can just pass in JSON strings as arguments when you need to populate a struct, which I find better than any other alternative. * ThriftTestProcessor implements the server side and you would want to implement the server handlers using the function: NewThriftTestProcessor() * You just pass in your handler that implements the IThriftTest interface and make sure you import the appropriate package. Package directories/names are shown in the relevant Makefile. * One unique thing about Go is that to have a publicly available function/variable, the first letter has to be capitalized, so all exportable functions/variables have the first letter capitalized, but since the thrift files normally don't, they assume any serialization uses the capitalization found in the thrift file itself.