Java tutorial
/* * Copyright 2015 LINE Corporation * * LINE Corporation 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. */ package com.linecorp.armeria.server.thrift; import static java.util.Objects.requireNonNull; import java.util.Collections; import java.util.List; import java.util.Map; import java.util.stream.Collectors; import org.apache.thrift.AsyncProcessFunction; import org.apache.thrift.ProcessFunction; import org.apache.thrift.TApplicationException; import org.apache.thrift.TBase; import org.apache.thrift.TException; import org.apache.thrift.TFieldIdEnum; import org.apache.thrift.async.AsyncMethodCallback; import com.google.common.collect.ImmutableMap; import com.linecorp.armeria.common.RequestContext; import com.linecorp.armeria.common.RequestContext.PushHandle; import com.linecorp.armeria.common.thrift.ThriftCall; import com.linecorp.armeria.common.thrift.ThriftReply; import com.linecorp.armeria.internal.thrift.ThriftFunction; import com.linecorp.armeria.server.Service; import com.linecorp.armeria.server.ServiceRequestContext; /** * A {@link Service} that handles a {@link ThriftCall}. * * @see THttpService */ public final class ThriftCallService implements Service<ThriftCall, ThriftReply> { /** * Creates a new {@link ThriftCallService} with the specified service implementation. * * @param implementation an implementation of {@code *.Iface} or {@code *.AsyncIface} service interface * generated by the Apache Thrift compiler */ public static ThriftCallService of(Object implementation) { return new ThriftCallService(ImmutableMap.of("", implementation)); } /** * Creates a new multiplexed {@link ThriftCallService} with the specified service implementations. * * @param implementations a {@link Map} whose key is service name and value is the implementation of * {@code *.Iface} or {@code *.AsyncIface} service interface generated by * the Apache Thrift compiler */ public static ThriftCallService of(Map<String, ?> implementations) { return new ThriftCallService(implementations); } private final Map<String, ThriftServiceEntry> entries; private ThriftCallService(Map<String, ?> implementations) { requireNonNull(implementations, "implementations"); if (implementations.isEmpty()) { throw new IllegalArgumentException("empty implementations"); } entries = Collections.unmodifiableMap(implementations.entrySet().stream() .collect(Collectors.toMap(Map.Entry::getKey, ThriftServiceEntry::new))); } /** * Returns the information about the Thrift services being served. * * @return a {@link Map} whose key is a service name, which could be an empty string if this service * is not multiplexed */ public Map<String, ThriftServiceEntry> entries() { return entries; } @Override public ThriftReply serve(ServiceRequestContext ctx, ThriftCall call) throws Exception { final int colonPos = call.method().indexOf(':'); final String method; final String serviceName; if (colonPos < 0) { serviceName = ""; method = call.method(); } else { serviceName = call.method().substring(0, colonPos); method = call.method().substring(colonPos + 1); } // Ensure that such a service exists. final ThriftServiceEntry e = entries.get(serviceName); if (e != null) { // Ensure that such a method exists. final ThriftFunction f = e.metadata.function(method); if (f != null) { final ThriftReply reply = new ThriftReply(call.seqId()); invoke(ctx, e.implementation, f, call.params(), reply); return reply; } } return new ThriftReply(call.seqId(), new TApplicationException(TApplicationException.UNKNOWN_METHOD, "unknown method: " + call.method())); } private static void invoke(ServiceRequestContext ctx, Object impl, ThriftFunction func, List<Object> args, ThriftReply reply) { try { final TBase<TBase<?, ?>, TFieldIdEnum> tArgs = func.newArgs(args); if (func.isAsync()) { invokeAsynchronously(impl, func, tArgs, reply); } else { invokeSynchronously(ctx, impl, func, tArgs, reply); } } catch (Throwable t) { reply.completeExceptionally(t); } } private static void invokeAsynchronously(Object impl, ThriftFunction func, TBase<TBase<?, ?>, TFieldIdEnum> args, ThriftReply reply) throws TException { final AsyncProcessFunction<Object, TBase<TBase<?, ?>, TFieldIdEnum>, Object> f = func.asyncFunc(); f.start(impl, args, new AsyncMethodCallback<Object>() { @Override public void onComplete(Object response) { if (func.isOneWay()) { reply.complete(null); } else { reply.complete(response); } } @Override public void onError(Exception e) { reply.completeExceptionally(e); } }); } private static void invokeSynchronously(ServiceRequestContext ctx, Object impl, ThriftFunction func, TBase<TBase<?, ?>, TFieldIdEnum> args, ThriftReply reply) { final ProcessFunction<Object, TBase<TBase<?, ?>, TFieldIdEnum>> f = func.syncFunc(); ctx.blockingTaskExecutor().execute(() -> { if (reply.isDone()) { // Closed already most likely due to timeout. return; } try (PushHandle ignored = RequestContext.push(ctx)) { @SuppressWarnings("unchecked") TBase<TBase<?, ?>, TFieldIdEnum> result = f.getResult(impl, args); if (func.isOneWay()) { reply.complete(null); } else { reply.complete(func.getResult(result)); } } catch (Throwable t) { reply.completeExceptionally(t); } }); } }