{"id":1532,"date":"2022-10-04T12:54:48","date_gmt":"2022-10-04T10:54:48","guid":{"rendered":"https:\/\/www.loicmathieu.fr\/wordpress\/?p=1532"},"modified":"2022-10-04T12:58:40","modified_gmt":"2022-10-04T10:58:40","slug":"tester-une-java-google-cloud-function","status":"publish","type":"post","link":"https:\/\/www.loicmathieu.fr\/wordpress\/fr\/informatique\/tester-une-java-google-cloud-function\/","title":{"rendered":"Tester une Java Google Cloud Function"},"content":{"rendered":"

Jusqu’il y a peu de temps, tester une Google Cloud Function \u00e9crite en Java pouvait se faire via l’invoker fournit par le SDK des Google Cloud Functions mais pas via un test unitaire. Mais cela \u00e0 chang\u00e9 r\u00e9cemment !<\/p>\n

Prenons comme exemple la fonction HTTP suivante :<\/p>\n

\npublic class HelloHttpFunction implements HttpFunction { \n    @Override\n    public void service(HttpRequest httpRequest, HttpResponse httpResponse) \n            throws Exception { \n        Writer writer = httpResponse.getWriter();\n        writer.write(\"Hello World\");\n    }\n}\n<\/pre>\n
Apr\u00e8s packaging de celle-ci dans un \u00fcber JAR, nous pouvons t\u00e9l\u00e9charger l’invoker Google Cloud function via la commande Maven suivante :<\/p>\n
\nmvn dependency:copy \\\n  -Dartifact='com.google.cloud.functions.invoker:java-function-invoker:1.1.1' \\\n  -DoutputDirectory=.\n<\/pre>\n
Puis l’utiliser pour d\u00e9marrer la fonction en local :<\/p>\n
\njava -jar java-function-invoker-1.1.1.jar \\\n  --classpath target\/hello-world.jar \\\n  --target org.example.HelloHttpFunction\n<\/pre>\n
Notre fonction est alors testable sur le port 8080.<\/p>\n
H\u00e9las, ceci n’est pas pratique dans une optique d’int\u00e9gration continue o\u00f9 nous voudrions ex\u00e9cuter des tests automatis\u00e9s avec JUnit par exemple.<\/p>\n
Heureusement, l’invoker de fonction est un projet Open Source de Google et votre serviteur a propos\u00e9 une PR pour permettre l’utilisation de celui-ci via des tests automatis\u00e9s en proposant une m\u00e9thode stop<\/a> qui \u00e9tait manquante.<\/p>\n
En utilisant sa derni\u00e8re version, nous pouvons ajouter l’invoker en d\u00e9pendance Maven de notre projet pour l’utiliser dans un test unitaire.<\/p>\n
\n\n    com.google.cloud.functions.invoker\n    java-function-invoker\n    1.1.1\n    test\n\n<\/pre>\n
Nous pouvons alors cr\u00e9er des tests JUnit.\nPar exemple pour notre fonction HTTP HelloHttpFunction<\/code> nous aurons le test suivant :<\/p>\n
\nclass HttpFunctionTestCase {\n    @Test\n    public void test() throws Exception {\n        \/\/ start the invoker without joining to avoid blocking the thread\n        Invoker invoker = new Invoker(\n                8081,\n                \"org.example.HelloHttpFunction\",\n                \"http\",\n                Thread.currentThread().getContextClassLoader());\n        invoker.startTestServer();\n\n        \/\/ test the function using REST-assured\n        when()\n                .get(\"http:\/\/localhost:8081\")\n                .then()\n                .statusCode(200)\n                .body(is(\"Hello World!\"));\n\n        \/\/ stop the invoker\n        invoker.stopServer();\n    }\n}\n<\/pre>\n
Le framework REST-assured<\/a> est utilis\u00e9 ici pour faciliter l’\u00e9criture de test HTTP.<\/em><\/p>\n
Le troisi\u00e8me param\u00e8tre \u00e0 passer lors de l\u2019instanciation de l’invoker est le type de fonction \u00e0 tester, tous les types de fonction sont support\u00e9s :<\/p>\n