MongoDB 的不可变自动生成存储库抛出 "Can't find a codec for interface" CodecConfigurationException

Immutables Autogenerated repository for MongoDB throws "Can't find a codec for interface" CodecConfigurationException

问题描述。

这是当前 immutables site 中示例的简化版本。

所以我有一个项目想与 MongoDB 一起使用。

@Value.Immutable
@Mongo.Repository("items")
public abstract class Item {
  @Mongo.Id
  public abstract long id();
  public abstract String name();
}

为简单起见,我创建了一个 Junit 测试。就像例子一样。 问题是这个 junit 测试,虽然它在 immutables site 的示例中出现,但抛出了一个异常:

public class ItemTest{
@Test
public void testRepository() {
try {
 //Simple ItemRepository creation
   ItemRepository items = new ItemRepository(
     RepositorySetup.forUri("mongodb://localhost/test")
     );

// Create item Item item = ImmutableItem.builder()
    .id(1)
    .name("one")
    .build();

    //Insert is async. Returns a Future. 
    FluentFuture<Integer> future=items.insert(item);
    future.get(); // get the result (ensure it was saved)
    
   }catch(Exception e){
       e.printStackTrace();
       Assert.fail(e.getMessage());
   }
}//end test

}//end class

运行 此测试将导致以下异常:

org.bson.codecs.configuration.CodecConfigurationException: Can't find a codec for interface spyros.Whosebug.example.Item

下面提供了完整的堆栈跟踪。

java.lang.AssertionError: java.util.concurrent.ExecutionException: **org.bson.codecs.configuration.CodecConfigurationException: Can't find a codec for interface spyros.Whosebug.example.Item.**
    at com.google.common.util.concurrent.AbstractFuture.getDoneValue(AbstractFuture.java:552)
    at com.google.common.util.concurrent.AbstractFuture.get(AbstractFuture.java:533)
    at com.google.common.util.concurrent.FluentFuture$TrustedFuture.get(FluentFuture.java:82)
    at com.google.common.util.concurrent.ForwardingFuture.get(ForwardingFuture.java:62)
    at spyros.Whosebug.example.ItemTest.testRepository(ItemTest.java:78)
    at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
    at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
    at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
    at java.lang.reflect.Method.invoke(Method.java:498)
    at org.junit.runners.model.FrameworkMethod.runReflectiveCall(FrameworkMethod.java:50)
    at org.junit.internal.runners.model.ReflectiveCallable.run(ReflectiveCallable.java:12)
    at org.junit.runners.model.FrameworkMethod.invokeExplosively(FrameworkMethod.java:47)
    at org.junit.internal.runners.statements.InvokeMethod.evaluate(InvokeMethod.java:17)
    at org.junit.runners.ParentRunner.runLeaf(ParentRunner.java:325)
    at org.junit.runners.BlockJUnit4ClassRunner.runChild(BlockJUnit4ClassRunner.java:78)
    at org.junit.runners.BlockJUnit4ClassRunner.runChild(BlockJUnit4ClassRunner.java:57)
    at org.junit.runners.ParentRunner.run(ParentRunner.java:290)
    at org.junit.runners.ParentRunner.schedule(ParentRunner.java:71)
    at org.junit.runners.ParentRunner.runChildren(ParentRunner.java:288)
    at org.junit.runners.ParentRunner.access[=14=]0(ParentRunner.java:58)
    at org.junit.runners.ParentRunner.evaluate(ParentRunner.java:268)
    at org.junit.runners.ParentRunner.run(ParentRunner.java:363)
    at org.junit.runner.JUnitCore.run(JUnitCore.java:137)
    at com.intellij.junit4.JUnit4IdeaTestRunner.startRunnerWithArgs(JUnit4IdeaTestRunner.java:68)
    at com.intellij.rt.execution.junit.IdeaTestRunner$Repeater.startRunnerWithArgs(IdeaTestRunner.java:47)
    at com.intellij.rt.execution.junit.JUnitStarter.prepareStreamsAndStart(JUnitStarter.java:242)
    at com.intellij.rt.execution.junit.JUnitStarter.main(JUnitStarter.java:70)
Caused by: org.bson.codecs.configuration.CodecConfigurationException: Can't find a codec for interface spyros.Whosebug.example.Item.
    at org.bson.codecs.configuration.CodecCache.getOrThrow(CodecCache.java:46)
    at org.bson.codecs.configuration.ProvidersCodecRegistry.get(ProvidersCodecRegistry.java:63)
    at org.bson.codecs.configuration.ProvidersCodecRegistry.get(ProvidersCodecRegistry.java:37)
    at com.mongodb.MongoCollectionImpl.getCodec(MongoCollectionImpl.java:591)
    at com.mongodb.MongoCollectionImpl.insertMany(MongoCollectionImpl.java:333)
    at com.mongodb.MongoCollectionImpl.insertMany(MongoCollectionImpl.java:322)
    at org.immutables.mongo.repository.Repositories$Repository.call(Repositories.java:130)
    at org.immutables.mongo.repository.Repositories$Repository.call(Repositories.java:127)
    at com.google.common.util.concurrent.TrustedListenableFutureTask$TrustedFutureInterruptibleTask.runInterruptibly(TrustedListenableFutureTask.java:125)
    at com.google.common.util.concurrent.InterruptibleTask.run(InterruptibleTask.java:69)
    at com.google.common.util.concurrent.TrustedListenableFutureTask.run(TrustedListenableFutureTask.java:78)
    at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1149)
    at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:624)
    at java.lang.Thread.run(Thread.java:748)


    at org.junit.Assert.fail(Assert.java:88)
    at spyros.Whosebug.example.ItemTest.testRepository(ItemTest.java:84)

我用的是gradle,下面是build.gradle

plugins {
    id 'java'
    id 'java-library'
}


sourceCompatibility = 1.8
targetCompatibility = 1.8

repositories {
    mavenLocal()
    mavenCentral()
    jcenter()
}

dependencies {
    implementation 'org.apache.logging.log4j:log4j-slf4j-impl:2.7'
    implementation 'org.apache.logging.log4j:log4j-core:2.7'
    implementation  'javax.persistence:javax.persistence-api:2.2'
    implementation  'javax.xml.bind:jaxb-api:2.1'
    implementation 'com.fasterxml.jackson.core:jackson-databind:2.9.8'
    implementation 'com.google.guava:guava:27.1-jre'

    
    annotationProcessor 'org.immutables:value:2.7.4'
    implementation 'org.immutables:value:2.7.4' 
    implementation 'org.immutables:mongo:2.7.4'
    

    implementation 'org.apache.commons:commons-lang3:3.4'
    implementation 'org.apache.commons:commons-collections4:4.1'
    implementation 'org.apache.commons:commons-configuration2:2.3'

   testCompile group: 'junit', name: 'junit', version: '4.12'
}

已查明原因

不可变 JSON 库需要能够找到 implements com.google.gson.TypeAdapterFactory 的自动生成的 GsonAdaptersItem.class。事实上,对于每个 interfaceabstract class 命名为 XXX 并带有与 'class Item'(上面提供)中类似的注释的不可变对象将生成类似的 GsonAdapterXXX,即 implements com.google.gson.TypeAdapterFactory

为了能够自动找到这些 classes RepositorySetup 使用 java.util.ServiceLoader 来自动定位它们。 这是相关代码部分:

    GsonBuilder gsonBuilder = new GsonBuilder();
    // there are no longer auto-registed from class-path, but from here or if added manually.
    gsonBuilder.registerTypeAdapterFactory(new TypeAdapters());

    for (TypeAdapterFactory factory : ServiceLoader.load(TypeAdapterFactory.class)) {
      gsonBuilder.registerTypeAdapterFactory(factory);
    }
    return gsonBuilder.create();

抛出异常的原因是由于某种原因这似乎不起作用并抛出以下异常。

更新 进一步的研究表明该示例有效,但前提是已编译 jar。这是因为 Immutables 会生成以下文件,该文件实际上将用于查找所有必需的 GsonAdapterXXX classes.

 build\classes\java\main\META-INF\services\com.google.gson.TypeAdapterFactory

org.bson.codecs.configuration.CodecConfigurationException: Can't find a codec for interface spyros.Whosebug.example.Item This is a permalink to the source code.

解决方法 直接的工作是专门将 GsonAdaptersItem 注册到 GsonBuilder。 以下 Junit 测试有效。

   @Test
    public void testItemVerbose() {
        try {
            //repeat what the RepositorySetup#createGson does
            GsonBuilder gsonBuilder = new GsonBuilder();
            //iterating in this loop
            for (TypeAdapterFactory factory : ServiceLoader.load(TypeAdapterFactory.class)) {
                //You can see that the ServiceLoader does not find the GsonAdaptersItem
                //System.out.println("Factory:"+factory.getClass().getCanonicalName()+" "+factory.toString());
                gsonBuilder.registerTypeAdapterFactory(factory);
            }
            
            //add the GsonAdaptersItem manually
            gsonBuilder.registerTypeAdapterFactory(new GsonAdaptersItem());
            Gson gson = gsonBuilder.create();



            Item item = ImmutableItem.builder()
                    .id(1)
                    .name("one")
                    .build();
            
            final MongoClient mongo = new MongoClient( "localhost" , 27017 );
            final MongoDatabase mongoDatabase=mongo.getDatabase("test");
            ItemRepository items =new ItemRepository(
                RepositorySetup.builder()
                        .executor(MoreExecutors.newDirectExecutorService())
                        .database(mongoDatabase)
                        .gson(gson).build()
                        );
            // Insert async and get
            items.insert(item).get(); // returns future, works


        }catch (final Exception e){
             e.printStackTrace();
           Assert.fail(e.getMessage());
        }

    }

此解决方法可用于手动创建通用的 api,程序员需要提供 GsonAdapterXXX。例如。 ItemRepository itemRepository=reporitoryProvider.getRepositoryWithRegisteredGsonAdapter(new GsonAdaptersItem()); 还可以创建更具体的 XXXRepository 提供商。

public ItemRepository getItemRepository(){
return reporitoryProvider.getRepositoryWithRegisteredGsonAdapter(new GsonAdaptersItem());
}

然而,以上所有都需要维护,更容易出错,并且无论如何都需要编写样板代码,这是使用不可变对象的人希望避免的。

问题

我希望该示例能够如 immutables site 中所示运行。我最好的猜测是,因为我使用 gradle 而不是 maven,所以我可能需要更改一些设置或依赖项。 问题是: 需要更改什么才能使简单的 ItemRepository 创建(如下所示)起作用?

 //Simple ItemRepository creation
ItemRepository items = new ItemRepository(
     RepositorySetup.forUri("mongodb://localhost/test")
     );

是否可以使用 Immutables 来做到这一点,而无需手动编写通过 class 或逐个软件包注册编解码器 class 的代码? 我真的很感激解释为什么它首先不起作用。

一段时间后我重新审视这个老问题。 目前建议的解决方案是使用不可变的 criteria 功能。

@Value.Immutable
@Criteria.Repository
public abstract class Item {
  
  @Criteria.Id
  public abstract long id();
  public abstract String name();
}