我的这个通用 Guice 绑定方法的 TypeLiteral 等价物有什么问题？

Question

以下通用 Guice 绑定方法行为正确：

<T> Key<?> bindMultibinder(
    ArrayList<Class<? extends T>> contents, Class<T> superClass) {
   Named annotation = randomAnnotation();
   Multibinder<T> options = 
    Multibinder.newSetBinder(binder(), superClass, annotation);
   for (Class<? extends T> t : contents) {
      options.addBinding().to(t);
   }
   final Key<?> multibinderKey = Key.get(Types.setOf( superClass ), annotation);
   return multibinderKey;
}

并使用如下所示的客户端代码：

ArrayList<Class<? extends Option>> options = 
 new ArrayList<Class<? extends Option>>();
options.add(CruiseControl.class);
bindMultibinder(options, Option.class);

但是，如果我想允许 Option 采用像 Option 这样的通用参数，那么我假设我需要在 bindMultibinder superClass 参数中传递一个 TypeLiteral 。这是迄今为止我最好的尝试：

<T> Key<?> bindMultibinder(
 ArrayList<TypeLiteral<? extends T>> contents, TypeLiteral<T> superClass) {
   Named annotation = randomAnnotation();
   Multibinder<T> options = 
    Multibinder.newSetBinder(binder(), superClass, annotation);
   for (TypeLiteral<? extends T> t : contents) {
      options.addBinding().to(t);
   }
   final Key<?> multibinderKey = Key.get(Types.setOf(superClass.getRawType()), annotation);
   return multibinderKey;
}

与先前情况等效的绑定代码如下所示：

ArrayList<TypeLiteral<? extends Option>> options = 
 new ArrayList<TypeLiteral<? extends Option>>();
options.add(new TypeLiteral<CruiseControl>(){});
bindMultibinder(options, new TypeLiteral<Option>(){});

我几乎可以肯定以下绑定是不正确的，因为 Types.setOf(superClass.getRawType())返回一个 ParameterizedType

final Key<?> multibinderKey = 
 Key.get(Types.setOf(superClass.getRawType()), annotation);

您有如何正确创建集合的想法吗？

Answer 1

ParameterizedType 是一个 java 类，用于表示在 java 源代码中需要用尖括号编写的类型：例如 Foo 或 Set<; 等类型。 Option> 或 Set> 甚至 Set>。这就是你想要的返回值。

事实上，您所做的工作只需在倒数第二行中调用 superClass.getType() 而不是 superClass.getRawType() 的微小更改即可正常工作。话虽这么说，当我在这里时，我确实有一些其他建议。

首先，在您的第一种方法中，我将其更改为：

<T> Key<Set<T>> bindMultibinder(
    Iterable<? extends Class<? extends T>> contents, Class<T> superClass) {
   Named annotation = randomAnnotation();
   Multibinder<T> options = 
     Multibinder.newSetBinder(binder(), superClass, annotation);
   for (Class<? extends T> t : contents) {
      options.addBinding().to(t);
   }
   @SuppressWarnings("unchecked")
   final Key<Set<T>> multibinderKey = (Key<Set<T>>) Key.get(Types.setOf( superClass ), annotation);
   return multibinderKey;
}

这将让您执行如下调用：

bindMultibinder(ImmutableList.of(CruiseControlSubOptOne.class,
                                 CruiseControlSubOptTwo.class),
                Option.class);

或者，如果您不使用 guava - 虽然你应该这样做 - 你可以使用 Arrays.asList 而不是 ImmutableList.of。您可以获得与以前相同的类型安全性，而无需在绑定代码中使用所有这些尖括号声明。

如果您还没有很多 bindMultibinder 调用者，我也会交换参数的顺序，但这可能只是个人风格的问题。

通过这些相同的更改，您的第二种方法将变为：

<T> Key<Set<T>> bindMultibinder(
 Iterable<? extends TypeLiteral<? extends T>> contents, TypeLiteral<T> superClass) {
   Named annotation = randomAnnotation();
   Multibinder<T> options = 
    Multibinder.newSetBinder(binder(), superClass, annotation);
   for (TypeLiteral<? extends T> t : contents) {
      options.addBinding().to(t);
   }
   @SuppressWarnings("unchecked")
   final Key<Set<T>> multibinderKey = (Key<Set<T>>) Key.get(Types.setOf(superClass.getType()), annotation);
   return multibinderKey;
}

您可以类似地使用它：

bindMultibinder(ImmutableList.of(
                    new TypeLiteral<CruiseControlSubOptOne>() {},
                    new TypeLiteral<CruiseControlSubOptTwo>() {}),
                new TypeLiteral<Option>() {});

虽然现在考虑一下，我想知道您是否真的想要一个采用 TypeLiteral 的 bindMultibinder 重载>。您不想拥有一个需要 Key 的设备吗？

<T> Key<Set<T>> bindMultibinder(Iterable<? extends Key<? extends T>> contents, Key<T> superClass) {
  Named annotation = randomAnnotation();
  Multibinder<T> options =
      Multibinder.newSetBinder(binder(), superClass.getTypeLiteral(), annotation);
  for (Key<? extends T> t : contents) {
    options.addBinding().to(t);
  }
  @SuppressWarnings("unchecked")
  final Key<Set<T>> multibinderKey =
      (Key<Set<T>>) Key.get(Types.setOf(superClass.getTypeLiteral().getType()), annotation);
  return multibinderKey;
}

毕竟，您可以以几乎相同的方式调用此方法：

bindMultibinder(ImmutableList.of(
                    new Key<CruiseControlSubOptOne>() {},
                    new Key<CruiseControlSubOptTwo>() {}),
                new Key<Option>() {});

除了 Key 比 TypeLiteral 更容易键入，并且如果您需要放入仅由它的注释，这很简单：

bindMultibinder(ImmutableList.of(
                    new Key<CruiseControlSubOptOne>() {},
                    new Key<CruiseControlSubOptTwo>() {},
                    Key.get(CruiseControl.class, Names.named("ThirdOpt")),
                    Key.get(CruiseControl.class, Names.named("FourthOpt"))),
                new Key<Option>() {});

现在，@Suppress 是否让您感到紧张？良好的直觉。

不幸的是，可悲的事实是，当处理泛型类型（其中带有尖括号的类型）的反射时，您几乎肯定会有小的未经检查的位。我的建议是，将需要抑制非类型化警告的部分做得尽可能小，并向外界公开尽可能多的类型信息。如果您从此处返回 Key，您可能会让此方法的调用者在尝试使用您的返回值时抑制非类型化警告。最好在这里执行此操作，您可以将警告抑制限制为一行，并且可以证明强制转换是安全的。