dagger.hilt.processor.internal.aggregateddeps.PkgPrivateModuleGenerator Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of hilt-android-compiler Show documentation

A fast dependency injector for Android and Java.

There is a newer version: 2.45-kim-rc1

Show newest version

/*
 * Copyright (C) 2019 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.hilt.processor.internal.aggregateddeps;

import com.squareup.javapoet.AnnotationSpec;
import com.squareup.javapoet.JavaFile;
import com.squareup.javapoet.TypeSpec;
import dagger.hilt.processor.internal.Processors;
import java.io.IOException;
import javax.annotation.processing.ProcessingEnvironment;
import javax.lang.model.element.Modifier;

/**
 * Generates a public Dagger module that includes a user's pkg-private module. This allows a user's
 * module to use pkg-private visibility to hide from external packages, but still allows Hilt to
 * install the module when the component is created in another package.
 */
final class PkgPrivateModuleGenerator {
  private final ProcessingEnvironment env;
  private final PkgPrivateMetadata metadata;

  PkgPrivateModuleGenerator(ProcessingEnvironment env, PkgPrivateMetadata metadata) {
    this.env = env;
    this.metadata = metadata;
  }

  // This method creates the following generated code for a pkg-private module, pkg.MyModule:
  //
  // package pkg; //same as module
  //
  // import dagger.Module;
  // import dagger.hilt.InstallIn;
  // import javax.annotation.Generated;
  //
  // @Generated("dagger.hilt.processor.internal.aggregateddeps.PkgPrivateModuleGenerator")
  // @InstallIn(ActivityComponent.class)
  // @Module(includes = MyModule.class)
  // public final class HiltModuleWrapper_MyModule {}
  void generate() throws IOException {
    TypeSpec.Builder builder =
        TypeSpec.classBuilder(metadata.generatedClassName().simpleName())
            .addOriginatingElement(metadata.getTypeElement())
            .addAnnotation(Processors.getOriginatingElementAnnotation(metadata.getTypeElement()))
            .addModifiers(Modifier.PUBLIC, Modifier.FINAL)
            // generated @InstallIn is exactly the same as the module being processed
            .addAnnotation(
                AnnotationSpec.get(metadata.getOptionalInstallInAnnotationMirror().get()))
            .addAnnotation(
                AnnotationSpec.builder(metadata.getAnnotation())
                    .addMember("includes", "$T.class", metadata.getTypeElement())
                    .build());

    Processors.addGeneratedAnnotation(builder, env, getClass());

    JavaFile.builder(metadata.generatedClassName().packageName(), builder.build())
        .build()
        .writeTo(env.getFiler());
  }
}