Helidon Tips - MicroProfile RestClientを使ったRESTリソースのJUnitテスト

HTTPプロトコルを用いた結合レベルのRESTリソースのテストはどのようにやられていますか？ クライアントからE2Eテストでドカンと一緒に確認でしょうか？それともRESTリソースを呼び出す疑似クライアントプアプリを作成して実施でしょうか？あるいは真面目にやっていないとかでしょうか？いずれにせよHTTPレベルでRESTリソース（REST API）に対するテストを細かくやろうと思った場合、それなりに手間は掛かると思います。

今回はそんな手間のかかるHTTPレベルのRESTリソースのテストをMicroProfile RestClientとHelidon MP Testing With JUnit5(Helidon MP Testing)を使って効率的に行う便利なテスト方法を紹介します。

記事はコードの抜粋を記載しています。全体を見たい場合や動作を確認したい場合は以下のGitHubリポジトリを参照ください。

• https://github.com/extact-io/contrarian-microprofile-sample/tree/main/ex-helidon-rest-testing

MicroProfileは連載を行ってます。よければ他の記事も下のリンクからどうぞ！

• 逆張りのMicroProfile ～ Helidonで始めるマイクロサービスへの一歩 ～

最初に結論から言うと、MicroProfile RestClientとHelidon MP Testingを組み合わせて使うことで

• RESTリソースに対するテストを
• 実際のネットワークを介したHTTPレベルで
• テスト用のクライアントアプリやテスト向けの特別な設定なしで
• 簡単に！

実施ができるようなります。

RESTリソースのテストを簡単にするポイントはMicroProfile RestClientの利用にあります。「第7回 らくらくMicroProfile RestClient」で取り上げましたが、RESTリソースのインタフェースがあれば、それをそのままMicroProfile RestClient のRestClientインタフェースとして利用することができます。

この発想を少し転換させ、RESTリソースが持つPersonResourceインタフェースをRestClientインタフェースとして使うことで、RESTリソースを呼び出すクライアント（テストドライバ）を簡単に手に入れることができます。つまり、RESTリソースが実装しているインタフェースを使ってHTTPレベルで自分自身のテストができるようになります。

では、実際にどのようにやるかを見てきましょう。

今回は「第7回 らくらくMicroProfile RestClient」で使用した以下のPersonアプリをテスト対象のアプリとして利用します。

• テストに利用するRESTアプリケーションの構造

classDiagram
    class PersonResource {
        +get(id) Person
        +add(person) Person
        +findByName(name) List~Person~
    }
    class PersonResourceImpl {
        
    }
    class Person {
        -Long id
        -String name
        -int age
    }
    class PersonExceptionMapper {
        +toResponse(exception) Response
    }
    class PersonApplication {
        +getClasses() Set~Class~
    }
    PersonResource <|.. PersonResourceImpl : implements
    PersonResource <.. Person : parameter/return
    PersonResource <.. PersonApplication : register
    PersonExceptionMapper <.. PersonApplication : register

• PersonResourceインタフェース

public interface PersonResource {
    @GET
    @Path("/{id}")
    @Produces(MediaType.APPLICATION_JSON)
    Person get(@PathParam("id")long id);

    @POST
    @Consumes(MediaType.APPLICATION_JSON)
    @Produces(MediaType.APPLICATION_JSON)
    Person add(Person person);

    @GET
    @Produces(MediaType.APPLICATION_JSON)
    List<Person> findByName(@QueryParam("name") String name);
}

クラス図のとおり、RESTリソースの実装（PersonResourceImplクラス）とREST APIのインタフェース(PersonResourceインタフェース)は分けて定義しています。ですので、今回例として説明するのはPersonResourceインタフェースを実装したPersonResourceImplに対するHTTPレベルのテストの実装方法となります。

HTTPレベルのRESTリソースのテストはMicroProfile RestClientとHelidon MP Testingを使うことで次のように簡単に実現できます。

@HelidonTest
@AddConfig(key = "server.port", value = "7001")
public class PersonResourceTest {
    private PersonResource personResource;
    @BeforeEach
    public void setup() throws Exception {
        personResource = RestClientBuilder.newBuilder()
                .baseUri(new URI("http://localhost:7001/api/persons"))
                .build(PersonResource.class);
    }
    @Test
    void tesGetPerson() {
        var expected = new Person(1L, "taro", 12);
        var actual = personResource.get(1L);
        assertEquals(expected, actual);
    }
    @Test
    void testGetPersonOnNotFound() {
        var exception = assertThrows(WebApplicationException.class, () -> {
            personResource.get(99L);
        });
        assertEquals(Status.NOT_FOUND.getStatusCode(), exception.getResponse().getStatus());
    }
    @Test
    void tesAddPerson() {
        var newPerson = new Person(null, "add-person", 32);
        var addedPerson = personResource.add(newPerson);
        assertNotNull(addedPerson.getId());
    }
    @Test
    void testAddPersonOnDuplicated() {
        var exception = assertThrows(WebApplicationException.class, () -> {
            personResource.add(new Person(null, "hanko", 50));
        });
        assertEquals(Status.CONFLICT.getStatusCode(), exception.getResponse().getStatus());
    }
    @Test
    void tesFindPerson() {
        var actual = personResource.findByName("bo");
        assertEquals(1, actual.size());
    }
    @Test
    void testFindPersonOnNotFound() {
        var actual = personResource.findByName("xx");
        assertEquals(0, actual.size());
    }
}

テスト実装のポイントはテスト対象のPersonResourceインタフェースをMicroProfile RestClientのRestClientインタフェースに指定^[1]し、Proxyを取得（詳細は後述のInformation欄を参照）しているところになります。

private PersonResource personResource;
@BeforeEach
public void setup() throws Exception {
    personResource = RestClientBuilder.newBuilder()
            .baseUri(new URI("http://localhost:7001/api/persons"))
            .build(PersonResource.class);
}

テスト実行時にはRESTクライアントとRESTリソース（サーバ）の2つが1つのJavaプロセス内に登場するため若干混乱しますが、実行時の状況をイメージ図にすると次のようになります。

図から分かるように、実行時にはHelidon MP Testing(@HelidonTest)により、テスト対象のRESTアプリケーション(PersonResourceImpl)が起動し、テストメソッドの各実行前(@BeforeEach)にProxyインスタンス(personResourceフィールド)が取得されます。

テスト対象のPersonResouceインタフェースに対する呼び出しは、コード上、単なるメソッドの呼び出しに見えますが、その実体はProxyインスタンスで裏ではlocalhostの7001ポートを経由したREST APIの呼び出しが行われるため、実際にはネットワークを介したテストを行っているのと同じとなります。

第3回で紹介したMicroProfileを使ったリファレンスアプリ(RMS)でも今回説明した方法でRESTリソースのテストを行っています。

• https://github.com/extact-io/rms/blob/main/rms-server/src/test/java/io/extact/rms/external/webapi/RentalReservationResourceTest.java

また、この他にもMiciroProfile OpenAPIにより公開されているOAS情報をMiciroProfile RestClientを使って取得し、openapi.yamlとしてファイルに保存する使い方をしています。

• https://github.com/extact-io/rms/blob/main/rms-server/src/test/java/io/extact/rms/external/webapi/GenerateOasFileTest.java

実践レベルで使う場合の参考としていただければと思います。

RESTリソース側のテストにMicroProfile RestClientを一工夫して使うことでHTTPレベルのテストが簡単に行えることを説明しました。実際に使ってもスゴク便利な組み合わせですので是非、実践で活用いただければと思います。