java - 使用 Guice 注入(inject)对 JAX-RS/Jersey servlet 进行单元测试

Question

我有一个应用程序，它使用 Jersey/JAX-RS 进行 Web 服务(注释等)，并使用 Guice 来注入(inject)服务实现。我真的不喜欢 Guice 直接与 servlet 一起工作的方式，我更喜欢 Jersey 方式，所以我必须做一些大惊小怪才能让服务注入(inject)工作，因为 Guice 不会创建我的 servlet 类，而且我没有不想处理 HK2-Guice 桥。我通过创建一个监听器类(称为 Configuration)来实现此目的，该监听器类在应用程序启动时在静态字段中设置注入(inject)器，然后通过创建一个父类来手动影响每个 servlet 类中的注入(inject)，我的所有 servlet 都使用包含以下内容的构造函数扩展该父类:

public MasterServlet() {
    // in order for the Guice @Inject annotation to work, we have to create a constructor
    // like this and call injectMembers(this) on all our injectors in it
    Configuration.getMyServiceInjector().injectMembers(this);
    Configuration.getDriverInjector().injectMembers(this);
}

我知道这有点笨拙，但这在我的 servlet 中运行得很好。我可以在我的服务上使用 Guice @Inject 注释并在命名实现之间切换等。当我去设置单元测试时，问题就出现了。我正在使用 JerseyTest 进行测试，但是对我的 servlet 运行测试会导致 500 错误，Guice 会显示以下内容:

com.google.inject.ConfigurationException: Guice configuration errors: 1) No implementation for com.mycompany.MyService was bound. while locating com.mycompany.MyService for field at com.mycompany.servlet.TestGetServlet.service(TestGetServlet.java:21) while locating com.mycompany.servlet.TestGetServlet

测试如下所示:

public class TestServletTest extends JerseyTest {

    @Test
    public void testServletFunctional() {
        final String response = target("/testget").request().get(String.class);
        assertEquals("get servlet functional", response);
    }

    @Before
    public void setup() {
        Configuration configuration = new Configuration();
        configuration.contextInitialized(null);
    }

    @Override
    protected Application configure() {
        return new ResourceConfig(TestGetServlet.class);
    }
}

您会注意到，在设置方法中，我手动创建了配置类，因为我不能依赖测试容器(Grizzly)来创建它(没有这两行，我就会得到 NullPointerExceptions)。下面详细介绍这一点。

这是正在测试的 servlet:

@Path("/testget")
public class TestGetServlet extends MasterServlet {

    @Inject
    MyService service;

    @GET
    @Produces({"text/plain", MediaType.TEXT_PLAIN})
    public String testGet() {
        //service = Configuration.getServiceInjector().getInstance(MyService.class);
        return "get servlet functional";
    }
}

注意到 testGet() 方法中的注释行了吗？如果我这样做并删除上面的 @Inject 注释，一切都会正常，这表明 Grizzly 没有按照我期望的方式创建我的 servlet。

我认为发生的事情是 Grizzly 不知道 Guice。一切似乎都表明 Grizzly 没有看到 Configuration 类，尽管事实上通过将其放入我的测试的 @Before 方法中，它似乎至少对使用它的类可用(参见: TestGetServlet 类中的注释行)。我只是不知道如何解决它。

Answer 1

我仍在尝试解决这个问题，但与此同时，我从 Guice 切换到 HK2，这需要一些时间，但我认为这可能对将来遇到此问题的任何人都有帮助。

我认为这是一个答案，因为说实话，我尝试绕过 Guice-HK2 桥但仍然使用 Guice 和 Jersey 可能不是最好的主意。

从 Guice 切换到 HK2 需要做一些工作，并且没有包含所有答案的综合指南。例如，依赖关系确实很复杂。如果您尝试使用 Jersey 2.27，您可能会遇到著名的

java.lang.IllegalStateException: InjectionManagerFactory not found

错误。由于 HK2 本身的原因，Jersey 2.27 不向后兼容以前的版本。我仍在努力让这一切正常工作，但与此同时，我必须将所有 Jersey 依赖项降级到 2.26-b06 才能使 HK2 正常工作。

谢天谢地，Jersey 已经实现了一堆 HK2 样板，因此要让注入(inject)工作，您所需要做的就是正确使用 @Contract、@Service(请参阅 HK2 文档)，然后是两个如下所示的新类:

public class MyHK2Binder extends AbstractBinder {
    @Override
    protected void configure() {
        // my service here is a singleton, yours might not be, so just omit the call to in()
        // also, the order here is switched from Guice! very subtle!
        bind(MyServiceImpl.class).to(MyService.class).in(Singleton.class);
    }
}

还有这个:

public class MyResourceConfig extends ResourceConfig {

    public MyResourceConfig() {
        register(new MyHK2Binder());
        packages(true, "com.mycompany");
    }
}

很简单，但这仅适用于应用程序本身。测试容器对此一无所知，因此您必须在测试类中自己重做 Binder 和 ResourceConfig，如下所示:

public class TestServletTest extends JerseyTest {

    @Test
    public void testServletFunctional() {

        final String response = target("/testget").request().get(String.class);
        assertEquals("get servlet functional", response);
    }

    @Before
    public void setup() {
    }

    @Override
    protected Application configure() {
        return new TestServletBinder(TestGetServlet.class);
    }

    public class TestServletBinder extends ResourceConfig {
        public TestServletBinder(Class registeree) {
            super(registeree);
            register(new MyHK2Binder());
            packages(true, "com.mycompany");
        }
    }
}

必须这样做实际上很好，因为您可以将 Binder 切换为测试 Binder，在其中您将服务绑定(bind)到模拟服务或其他东西。我在这里没有这样做，但这很容易做到:将 register() 调用中的 new MyHK2Binder() 替换为执行如下绑定(bind)的函数:

bind(MyTestServiceImpl.class).to(MyService.class).in(Singleton.class);

瞧。很不错。显然，您可以使用命名绑定(bind)获得类似的结果，但这效果很好，甚至可能更简单、更清晰。

希望这可以帮助别人节省我为完成这项工作而花费的时间。