/* * Copyright (C) 2016 The Dagger Authors. * * Licensed 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 dagger.grpc.server.processor; import static com.google.auto.common.MoreElements.hasModifiers; import static com.google.common.collect.ImmutableList.toImmutableList; import static com.squareup.javapoet.MethodSpec.methodBuilder; import static com.squareup.javapoet.TypeSpec.anonymousClassBuilder; import static com.squareup.javapoet.TypeSpec.classBuilder; import static javax.lang.model.element.Modifier.FINAL; import static javax.lang.model.element.Modifier.PUBLIC; import static javax.lang.model.element.Modifier.STATIC; import static javax.lang.model.util.ElementFilter.fieldsIn; import static javax.lang.model.util.ElementFilter.methodsIn; import com.google.common.collect.ImmutableList; import com.squareup.javapoet.CodeBlock; import com.squareup.javapoet.MethodSpec; import com.squareup.javapoet.ParameterSpec; import com.squareup.javapoet.ParameterizedTypeName; import com.squareup.javapoet.TypeName; import com.squareup.javapoet.TypeSpec; import dagger.grpc.server.GrpcService; import java.util.List; import java.util.function.Function; import javax.lang.model.element.Element; import javax.lang.model.element.ExecutableElement; import javax.lang.model.element.VariableElement; import javax.lang.model.type.TypeMirror; /** * An object that generates the proxying service definition module for a {@link * GrpcService}-annotated service implementation. */ final class ProxyModuleGenerator extends SourceGenerator { private final GrpcServiceModel grpcServiceModel; ProxyModuleGenerator(GrpcServiceModel grpcServiceModel) { super(grpcServiceModel.packageName()); this.grpcServiceModel = grpcServiceModel; } @Override protected TypeSpec createType() { TypeSpec.Builder proxyModule = classBuilder(grpcServiceModel.proxyModuleName) .addModifiers(PUBLIC, FINAL) .addJavadoc( "Install this module in the {@link $T @Singleton} server component.\n", JavaxInject.singleton().type); grpcServiceModel.generatedAnnotation().ifPresent(proxyModule::addAnnotation); return proxyModule .addAnnotation(Dagger.module()) .addMethod(provideServiceDefinitionContribution()) .addMethod(provideServiceDefinitionFactory()) .build(); } /** * Returns the {@link dagger.Provides @Provides} method for the proxying {@link * io.grpc.ServerServiceDefinition}. */ private MethodSpec provideServiceDefinitionContribution() { MethodSpec.Builder method = methodBuilder("serviceDefinition") .addAnnotation(Dagger.provides()) .addAnnotation(Dagger.intoSet()) .addAnnotation(JavaxInject.singleton()) .addModifiers(STATIC) .returns(IoGrpc.SERVER_SERVICE_DEFINITION) .addParameter( ParameterSpec.builder( Dagger.GrpcServer.SERVICE_DEFINITION_FACTORY, "serviceDefinitionFactory") .addAnnotation(grpcServiceModel.forGrpcService()) .build()) .addCode( "return $T.builder($T.SERVICE_NAME)", IoGrpc.SERVER_SERVICE_DEFINITION, grpcServiceModel.grpcClass()); for (CodeBlock methodDescriptor : methodDescriptors()) { method.addCode( ".addMethod($T.proxyMethod($L, serviceDefinitionFactory))", Dagger.GrpcServer.PROXY_SERVER_CALL_HANDLER, methodDescriptor); } method.addCode(".build();"); return method.build(); } /** * Returns the {@link io.grpc.MethodDescriptor} references from the class enclosing the service * interface. * *

Looks first for public static methods (new in 1.8), and then for public static fields if it * finds none. */ private ImmutableList methodDescriptors() { ImmutableList staticMethodCalls = findMethodDescriptors( methodsIn(grpcServiceModel.grpcClass().getEnclosedElements()), ExecutableElement::getReturnType, method -> CodeBlock.of("$T.$N()", grpcServiceModel.grpcClass(), method.getSimpleName())); if (!staticMethodCalls.isEmpty()) { return staticMethodCalls; } return findMethodDescriptors( fieldsIn(grpcServiceModel.grpcClass().getEnclosedElements()), VariableElement::asType, field -> CodeBlock.of("$T.$N", grpcServiceModel.grpcClass(), field.getSimpleName())); } private ImmutableList findMethodDescriptors( List elements, Function elementType, Function elementReference) { return elements .stream() .filter(hasModifiers(PUBLIC, STATIC)::apply) .filter( method -> { TypeName typeName = TypeName.get(elementType.apply(method)); return typeName instanceof ParameterizedTypeName && ((ParameterizedTypeName) typeName).rawType.equals(IoGrpc.METHOD_DESCRIPTOR); }) .map(elementReference) .collect(toImmutableList()); } /** * Returns the {@link dagger.Provides @Provides} method for the {@link * dagger.grpc.server.ProxyServerCallHandler.ServiceDefinitionFactory} used by the proxy. */ private MethodSpec provideServiceDefinitionFactory() { return methodBuilder("serviceDefinitionFactory") .addAnnotation(Dagger.provides()) .addAnnotation(grpcServiceModel.forGrpcService()) .addModifiers(STATIC) .returns(Dagger.GrpcServer.SERVICE_DEFINITION_FACTORY) .addParameter(grpcServiceModel.serviceDefinitionTypeFactoryName, "factory", FINAL) .addStatement("return $L", anonymousServiceDefinitionFactory()) .build(); } /** * Returns the anonymous inner class that implements the {@link * dagger.grpc.server.ProxyServerCallHandler.ServiceDefinitionFactory} used by the proxy. */ private TypeSpec anonymousServiceDefinitionFactory() { return anonymousClassBuilder("") .addSuperinterface(Dagger.GrpcServer.SERVICE_DEFINITION_FACTORY) .addMethod( methodBuilder("getServiceDefinition") .addAnnotation(Override.class) .addModifiers(PUBLIC) .returns(IoGrpc.SERVER_SERVICE_DEFINITION) .addParameter(IoGrpc.METADATA, "headers") .addStatement( "return factory.grpcService(new $T(headers)).$N()", Dagger.GrpcServer.GRPC_CALL_METADATA_MODULE, grpcServiceModel.subcomponentServiceDefinitionMethodName()) .build()) .build(); } }