Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Restrict multibindings from providing framework types that conflict with multibinding types Dagger provides. #4486

Merged
merged 1 commit into from
Oct 21, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 17 additions & 0 deletions java/dagger/internal/codegen/base/FrameworkTypes.java
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,7 @@

package dagger.internal.codegen.base;

import static dagger.internal.codegen.extension.DaggerStreams.toImmutableSet;
import static dagger.internal.codegen.xprocessing.XTypes.isTypeOf;

import androidx.room.compiler.processing.XType;
Expand All @@ -41,6 +42,14 @@ public final class FrameworkTypes {
private static final ImmutableSet<ClassName> ALL_FRAMEWORK_TYPES =
ImmutableSet.<ClassName>builder().addAll(PROVISION_TYPES).addAll(PRODUCTION_TYPES).build();

private static final ImmutableSet<ClassName> SET_VALUE_FRAMEWORK_TYPES =
ImmutableSet.of(TypeNames.PRODUCED);

public static final ImmutableSet<ClassName> MAP_VALUE_FRAMEWORK_TYPES =
MapType.VALID_FRAMEWORK_REQUEST_KINDS.stream()
.map(RequestKinds::frameworkClassName)
.collect(toImmutableSet());

/** Returns true if the type represents a producer-related framework type. */
public static boolean isProducerType(XType type) {
return typeIsOneOf(PRODUCTION_TYPES, type);
Expand All @@ -51,6 +60,14 @@ public static boolean isFrameworkType(XType type) {
return typeIsOneOf(ALL_FRAMEWORK_TYPES, type);
}

public static boolean isSetValueFrameworkType(XType type) {
return typeIsOneOf(SET_VALUE_FRAMEWORK_TYPES, type);
}

public static boolean isMapValueFrameworkType(XType type) {
return typeIsOneOf(MAP_VALUE_FRAMEWORK_TYPES, type);
}

private static boolean typeIsOneOf(Set<ClassName> classNames, XType type) {
return classNames.stream().anyMatch(className -> isTypeOf(type, className));
}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -144,7 +144,7 @@ private ValidationReport validate() {
checkType();
checkQualifiers();
checkMapKeys();
checkMultibindings();
checkMultibindingAnnotations();
checkScopes();
checkAdditionalProperties();
return report.build();
Expand Down Expand Up @@ -188,8 +188,10 @@ protected void checkType() {
// fall through

case SET:
bindingElementType().ifPresent(this::checkSetValueFrameworkType);
break;
case MAP:
bindingElementType().ifPresent(this::checkKeyType);
bindingElementType().ifPresent(this::checkMapValueFrameworkType);
break;

case SET_VALUES:
Expand Down Expand Up @@ -245,7 +247,7 @@ protected final void checkSetValuesType(XType type) {
if (setType.isRawType()) {
report.addError(elementsIntoSetRawSetMessage());
} else {
checkKeyType(setType.elementType());
checkSetValueFrameworkType(setType.elementType());
}
}
}
Expand Down Expand Up @@ -301,7 +303,7 @@ private void checkMapKeys() {
* dagger.producers.Produces} annotation has a {@code type} parameter.
* </ul>
*/
private void checkMultibindings() {
private void checkMultibindingAnnotations() {
ImmutableSet<XAnnotation> multibindingAnnotations =
XElements.getAllAnnotations(element, MULTIBINDING_ANNOTATIONS);

Expand Down Expand Up @@ -361,6 +363,23 @@ private void checkFrameworkType() {
report.addError(bindingElements("must not %s framework types", bindingElementTypeVerb()));
}
}

private void checkSetValueFrameworkType(XType bindingType) {
checkKeyType(bindingType);
if (FrameworkTypes.isSetValueFrameworkType(bindingType)) {
report.addError(bindingElements(
"with @IntoSet/@ElementsIntoSet must not %s framework types",
bindingElementTypeVerb()));
}
}

private void checkMapValueFrameworkType(XType bindingType) {
checkKeyType(bindingType);
if (FrameworkTypes.isMapValueFrameworkType(bindingType)) {
report.addError(
bindingElements("with @IntoMap must not %s framework types", bindingElementTypeVerb()));
}
}
}

/** Whether to check multibinding annotations. */
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -374,6 +374,84 @@ public void inconsistentMapKeyAnnotations() {
});
}

@Test
public void mapBindingOfProvider_provides() {
Source providesModule =
CompilerTests.javaSource(
"test.MapModule",
"package test;",
"",
"import dagger.Module;",
"import dagger.Provides;",
"import dagger.multibindings.IntoMap;",
"import dagger.multibindings.StringKey;",
"import javax.inject.Provider;",
"",
"@Module",
"abstract class MapModule {",
"",
" @Provides",
" @IntoMap",
" @StringKey(\"foo\")",
" static Provider<String> provideProvider() {",
" return null;",
" }",
"}");

// Entry points aren't needed because the check we care about here is a module validation
Source providesComponent = component("");

CompilerTests.daggerCompiler(providesModule, providesComponent)
.withProcessingOptions(compilerMode.processorOptions())
.compile(
subject -> {
subject.hasErrorCount(2);
subject.hasErrorContaining(
"@Provides methods with @IntoMap must not return framework types");
subject.hasErrorContaining("test.MapModule has errors")
.onSource(providesComponent)
.onLineContaining("@Component(modules = {MapModule.class})");
});
}

@Test
public void mapBindingOfProvider_binds() {
Source bindsModule =
CompilerTests.javaSource(
"test.MapModule",
"package test;",
"",
"import dagger.Module;",
"import dagger.Binds;",
"import dagger.multibindings.IntoMap;",
"import dagger.multibindings.StringKey;",
"import javax.inject.Provider;",
"",
"@Module",
"abstract class MapModule {",
"",
" @Binds",
" @IntoMap",
" @StringKey(\"foo\")",
" abstract Provider<String> provideProvider(Provider<String> provider);",
"}");

// Entry points aren't needed because the check we care about here is a module validation
Source bindsComponent = component("");

CompilerTests.daggerCompiler(bindsModule, bindsComponent)
.withProcessingOptions(compilerMode.processorOptions())
.compile(
subject -> {
subject.hasErrorCount(2);
subject.hasErrorContaining(
"@Binds methods with @IntoMap must not return framework types");
subject.hasErrorContaining("test.MapModule has errors")
.onSource(bindsComponent)
.onLineContaining("@Component(modules = {MapModule.class})");
});
}

private static Source component(String... entryPoints) {
return CompilerTests.javaSource(
"test.TestComponent",
Expand Down
212 changes: 212 additions & 0 deletions javatests/dagger/internal/codegen/SetMultibindingValidationTest.java
Original file line number Diff line number Diff line change
@@ -0,0 +1,212 @@
/*
* Copyright (C) 2024 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.internal.codegen;

import androidx.room.compiler.processing.util.Source;
import com.google.common.collect.ImmutableList;
import dagger.testing.compile.CompilerTests;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.junit.runners.Parameterized;
import org.junit.runners.Parameterized.Parameters;

@RunWith(Parameterized.class)
public class SetMultibindingValidationTest {
@Parameters(name = "{0}")
public static ImmutableList<Object[]> parameters() {
return CompilerMode.TEST_PARAMETERS;
}

private final CompilerMode compilerMode;

public SetMultibindingValidationTest(CompilerMode compilerMode) {
this.compilerMode = compilerMode;
}

@Test
public void setBindingOfProduced_provides() {
Source providesModule =
CompilerTests.javaSource(
"test.SetModule",
"package test;",
"",
"import dagger.Module;",
"import dagger.Provides;",
"import dagger.multibindings.IntoSet;",
"import dagger.producers.Produced;",
"",
"@Module",
"abstract class SetModule {",
"",
" @Provides",
" @IntoSet",
" static Produced<String> provideProducer() {",
" return null;",
" }",
"}");

// Entry points aren't needed because the check we care about here is a module validation
Source providesComponent = component("");

CompilerTests.daggerCompiler(providesModule, providesComponent)
.withProcessingOptions(compilerMode.processorOptions())
.compile(
subject -> {
subject.hasErrorCount(2);
subject.hasErrorContaining(
"@Provides methods with @IntoSet/@ElementsIntoSet must not return framework "
+ "types");
subject.hasErrorContaining("test.SetModule has errors")
.onSource(providesComponent)
.onLineContaining("@Component(modules = {SetModule.class})");
});
}

@Test
public void setBindingOfProduced_binds() {

Source bindsModule =
CompilerTests.javaSource(
"test.SetModule",
"package test;",
"",
"import dagger.Module;",
"import dagger.Binds;",
"import dagger.multibindings.IntoSet;",
"import dagger.producers.Produced;",
"",
"@Module",
"abstract class SetModule {",
"",
" @Binds",
" @IntoSet",
" abstract Produced<String> provideProvider(Produced<String> impl);",
"}");

// Entry points aren't needed because the check we care about here is a module validation
Source bindsComponent = component("");

CompilerTests.daggerCompiler(bindsModule, bindsComponent)
.withProcessingOptions(compilerMode.processorOptions())
.compile(
subject -> {
subject.hasErrorCount(2);
subject.hasErrorContaining(
"@Binds methods with @IntoSet/@ElementsIntoSet must not return framework types");
subject.hasErrorContaining("test.SetModule has errors")
.onSource(bindsComponent)
.onLineContaining("@Component(modules = {SetModule.class})");
});
}

@Test
public void elementsIntoSetBindingOfProduced_provides() {
Source providesModule =
CompilerTests.javaSource(
"test.SetModule",
"package test;",
"",
"import dagger.Module;",
"import dagger.Provides;",
"import dagger.multibindings.ElementsIntoSet;",
"import dagger.producers.Produced;",
"import java.util.Set;",
"",
"@Module",
"abstract class SetModule {",
"",
" @Provides",
" @ElementsIntoSet",
" static Set<Produced<String>> provideProducer() {",
" return null;",
" }",
"}");

// Entry points aren't needed because the check we care about here is a module validation
Source providesComponent = component("");

CompilerTests.daggerCompiler(providesModule, providesComponent)
.withProcessingOptions(compilerMode.processorOptions())
.compile(
subject -> {
subject.hasErrorCount(2);
subject.hasErrorContaining(
"@Provides methods with @IntoSet/@ElementsIntoSet must not return framework "
+ "types");
subject.hasErrorContaining("test.SetModule has errors")
.onSource(providesComponent)
.onLineContaining("@Component(modules = {SetModule.class})");
});
}

@Test
public void elementsIntoSetBindingOfProduced_binds() {

Source bindsModule =
CompilerTests.javaSource(
"test.SetModule",
"package test;",
"",
"import dagger.Module;",
"import dagger.Binds;",
"import dagger.multibindings.ElementsIntoSet;",
"import dagger.producers.Produced;",
"import java.util.Set;",
"",
"@Module",
"abstract class SetModule {",
"",
" @Binds",
" @ElementsIntoSet",
" abstract Set<Produced<String>> provideProvider(Set<Produced<String>> impl);",
"}");

// Entry points aren't needed because the check we care about here is a module validation
Source bindsComponent = component("");

CompilerTests.daggerCompiler(bindsModule, bindsComponent)
.withProcessingOptions(compilerMode.processorOptions())
.compile(
subject -> {
subject.hasErrorCount(2);
subject.hasErrorContaining(
"@Binds methods with @IntoSet/@ElementsIntoSet must not return framework types");
subject.hasErrorContaining("test.SetModule has errors")
.onSource(bindsComponent)
.onLineContaining("@Component(modules = {SetModule.class})");
});
}

private static Source component(String... entryPoints) {
return CompilerTests.javaSource(
"test.TestComponent",
ImmutableList.<String>builder()
.add(
"package test;",
"",
"import dagger.Component;",
"import dagger.producers.Producer;",
"import java.util.Set;",
"import javax.inject.Provider;",
"",
"@Component(modules = {SetModule.class})",
"interface TestComponent {")
.add(entryPoints)
.add("}")
.build());
}
}
Loading