namespace java com.example.thrift.demo

struct UserProfile {
  1: required i64 userId,
  2: required string userName,
  3: optional string email,
  4: optional i32 age,
  5: optional list<string> tags
}

exception UserNotFound {
  1: string message
}

service UserService {
  bool createUser(1: UserProfile profile),
  UserProfile getUser(1: i64 userId) throws (1: UserNotFound unfe),
  i64 countUsers()
}

thrift --help

Usage: thrift [options] file
Options:
  -version    Print the compiler version
  -o dir      Set the output directory for gen-* packages
               (default: current directory)
  -out dir    Set the ouput location for generated files.
               (no gen-* folder will be created)
  -I dir      Add a directory to the list of directories
                searched for include directives
  -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
  --allow-neg-keys  Allow negative field keys (Used to preserve protocol
                compatibility with older .thrift files)
  --allow-64bit-consts  Do not print warnings about using 64-bit constants
  --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.

  java (Java):
    beans:           Members will be private, and setter methods will return void.
    private_members: Members will be private, but setter methods will return 'this' like usual.
    nocamel:         Do not use CamelCase field accessors with beans.
    fullcamel:       Convert underscored_accessor_or_service_names to camelCase.
    option_type=[thrift|jdk8]:
                     thrift: wrap optional fields in thrift Option type.
                     jdk8: Wrap optional fields in JDK8+ Option type.
    generated_annotations=[undated|suppress]:
                     undated: suppress the date at @Generated annotations
                     suppress: suppress @Generated annotations entirely
    jakarta_annotations: generate jakarta annotations (javax by default)

thrift --gen java user_service.thrift

gen-java/com/example/thrift/demo/UserNotFound.java
gen-java/com/example/thrift/demo/UserProfile.java
gen-java/com/example/thrift/demo/UserService.java

thrift --gen java:beans,fullcamel user_service.thrift

public void setUserName(@org.apache.thrift.annotation.Nullable java.lang.String userName) {

thrift --gen java --gen py --gen go user_service.thrift
ls -d gen-*

gen-go
gen-java
gen-py

thrift -o /tmp/t1/out1 --gen py user_service.thrift

Output directory /tmp/t1/out1 is unusable: No such file or directory

out1/gen-py/__init__.py
out1/gen-py/user_service/UserService.py
out1/gen-py/user_service/__init__.py
out1/gen-py/user_service/constants.py
out1/gen-py/user_service/ttypes.py

namespace java com.example.thrift.common

struct CommonMeta {
  1: required string requestId,
  2: optional i64 timestamp
}

include "common.thrift"

service UserAdmin {
  void audit(1: common.CommonMeta meta)
}

[WARNING:admin.thrift:1] Could not find include file common.thrift

Type "common.CommonMeta" not defined

thrift -I inc --gen java admin.thrift

thrift -I inc -r --gen java admin.thrift

gen-java/UserAdmin.java
gen-java/com/example/thrift/common/CommonMeta.java

Scanning /tmp/t1/admin.thrift for includes
Parsing /tmp/t1/admin.thrift for types
Program: /tmp/t1/admin.thrift
Generating "java"

[WARNING:big.thrift:2] 64-bit constant "1759296000000" may not work in all languages.

thrift --audit old_user_service.thrift user_service.thrift

serverArgs.protocolFactory(new TBinaryProtocol.Factory());

TBinaryProtocol protocol = new TBinaryProtocol(transport);

TTransport transport = new TFramedTransport(new TSocket("127.0.0.1", 9091, 3000));

serverArgs.transportFactory(new TFramedTransport.Factory());

transport = new TSocket("127.0.0.1", 9091, 3000);

[client] EXCEPTION: org.apache.thrift.transport.TTransportException: java.net.ConnectException: Connection refused
real    0m0.126s

sock = TSocket.TSocket('127.0.0.1', 9090)
sock.setTimeout(3000)

TServer.Args serverArgs = new TServer.Args(new TServerSocket(9090));
serverArgs.processor(processor);
serverArgs.protocolFactory(new TBinaryProtocol.Factory());
TServer server = new TSimpleServer(serverArgs);

TProcessor processor = new UserService.Processor<>(new UserServiceHandler());
TThreadPoolServer.Args serverArgs = new TThreadPoolServer.Args(new TServerSocket(9091));
serverArgs.processor(processor);
serverArgs.protocolFactory(new TCompactProtocol.Factory());
serverArgs.transportFactory(new TFramedTransport.Factory());
serverArgs.minWorkerThreads(4);
serverArgs.maxWorkerThreads(16);
TServer server = new TThreadPoolServer(serverArgs);

[server] TThreadPoolServer listening on port 9091 (compact+framed) ...
[client] countUsers -> 0

[client] EXCEPTION: org.apache.thrift.transport.TTransportException: Socket is closed by peer.

org.apache.thrift.protocol.TProtocolException: Bad version in readMessageBegin
        at org.apache.thrift.protocol.TBinaryProtocol.readMessageBegin(TBinaryProtocol.java:256)

TProcessor processor = new UserService.Processor<>(new UserServiceHandler());
TThreadPoolServer.Args serverArgs = new TThreadPoolServer.Args(new TServerSocket(9090));
serverArgs.processor(processor);
serverArgs.protocolFactory(new TCompactProtocol.Factory());
serverArgs.transportFactory(new TFramedTransport.Factory());
serverArgs.minWorkerThreads(8);
serverArgs.maxWorkerThreads(64);
TServer server = new TThreadPoolServer(serverArgs);

java -Xms256m -Xmx512m -cp target/classes:target/lib/* com.example.thrift.demo.ThriftServer
jps -lv

17991 com.example.thrift.demo.ThriftServer -Xms256m -Xmx512m

TTransport transport = new TFramedTransport(new TSocket("127.0.0.1", 9090, 3000));
transport.open();
TCompactProtocol protocol = new TCompactProtocol(transport);
UserService.Client client = new UserService.Client(protocol);