woody_java/woody-thrift/woody-thrift.md

com.rbkmoney.woody.thrift

Реализация woody-api для Thrift, которая по возможности абстрагирует разработчика от деталей работы с Thrift библиотекой.

Подключение к библиотеки к проекту

В pom.xml добавить зависимость:

<dependency>
    <groupId>com.rbkmoney.woody</groupId>
    <artifactId>woody-thrift</artifactId>
    <version>[1.0.0,)</version>
</dependency>

Для генерации кода по Thrift IDL добавляем плагин:

<plugin>
    <groupId>org.apache.thrift</groupId>
    <artifactId>thrift-maven-plugin</artifactId>
    <version>[0.9.3-1,)</version>
    <configuration>
        <thriftExecutable>/usr/local/bin/thrift</thriftExecutable>
    </configuration>
    <executions>
        <execution>
            <id>thrift-sources</id>
            <phase>generate-sources</phase>
            <goals>
                <goal>compile</goal>
            </goals>
        </execution>
        <execution>
            <id>thrift-test-sources</id>
            <phase>generate-test-sources</phase>
            <goals>
                <goal>testCompile</goal>
            </goals>
        </execution>
    </executions>
</plugin>

Создание клиента

THClientBuilder clientBuilder = new THClientBuilder()
.withAddress(new URI(serviceURLString))
//Optional, you can set your own configured client if you want, if not HttpClient with default configuration will be used.
.withHttpClient(HttpClientBuilder.create().build())
// Optional, you can set your own id generation logic, TimeStampIdGenerator is used by default.
.withIdGenerator(idGenerator)
//Optional, you can omit setting eventListener and all generated events 'll be just skipped.
.withEventListener(eventListener); 
ThriftServiceSrv.Iface client = clientBuilder.build(ThriftServiceSrv.Iface.class);

Полученный объект client реализует интерфейс Thrift сервиса и готов к использованию.

Создание thread-safe клиента

Есть два билдера thread-safe клиента:

1. THSpawnClientBuilder - создает новый экземпляр Thrift клиента на каждый вызов сервиса.
2. THPooledClientBuilder - использует пул для переиспользования созданных экземпляров Thrift клиента.

Создание thread-safe клиента аналогично приведенному выше.

Создание сервиса

THServiceBuilder serviceBuilder = new THServiceBuilder();
serviceBuilder.withEventListener(eventListener);
Servlet service = serviceBuilder.build(ThriftServiceSrv.Iface.class, handler);

service - это ничто иное, как javax.servlet.Servlet, который нужно добавить в servlet контейнер. handler - реализация ThriftServiceSrv.Iface, которая вызывается для обработки запросов к сервису.