なぜここでObjectMapperを用いたのかわからない……

Question

現在「スッキリわかるJava入門実践編」でJavaの学習を進めています。
その中でHttpRequestとJacksonを用いてGitHub上のユーザーの情報を取得し、ブログサイトのURLを表示させるという問題が出題されました。

以下がその解答です。

package main.java;

import java.net.*;
import java.net.http.*;
import java.net.http.HttpClient.Redirect;
import java.net.http.HttpClient.Version;
import com.fasterxml.jackson.databind.*;

public class Main{
	public static void main(String[] args) throws Exception{
		String user = "https://api.github.com/miyabilink";
		
		HttpClient client = HttpClient.newBuilder()
				.version(Version.HTTP_1_1)
				.followRedirects(Redirect.NORMAL)
				.build();
		
		HttpRequest request = HttpRequest.newBuilder()
				.uri(URI.create(user))
				.header("Accept", "application/vnd.github.v3+json")
				.GET().build();
		
		HttpResponse<String> response = 
			client.send(request, HttpResponse.BodyHandlers.ofString());
		
		String body = response.body();
		int status = response.statusCode();
		
		if(status == 200) {
			ObjectMapper  mapper = new ObjectMapper();
			JsonNode root = mapper.readTree(body);
			String blog = root.get("blog").textValue();
			System.out.println(blog);
		}else {
			System.out.println("ERROR" + status);
		}
		
	}
}

今回お聞きしたいのは、29行目以降のifの中身についてです。
なぜここでObjectMapperを使用したのでしょうか。そもそもObjectMapperがどんなものかよくわかっていないのもあるかもしれませんが、ご教授いただけると幸いです。
よろしくお願いします。

Comments

[ishina_yum]

このプログラムが『一体何をするものなのか』を理解しているでしょうか？

もっと具体的に言うと「GitHub上のユーザーの情報を取得し」と質問文にありますが
・どのように取得するのか
・どのようなデータが取得できるのか
を理解しているでしょうか？

[jimbe]

> ObjectMapperがどんなものかよくわかっていない
問いの意味が無いのではありませんか。
どんなものかをお調べになるのが一番かと思います。

[hirono_suke]

@ishina_yum様
申し訳ありませんが、そこからよくわかっておりません……。
よろしければそこから教えていただきたいです。

[shiketa]

ObjectMapperのFQCNは、com.fasterxml.jackson.databind.ObjectMapper。これを調べてみては。

[hirono_suke]

@jimbee様
ご指摘ありがとうございます。
ObjectMapperは、「jsonファイルとJavaファイルを相互に変換するためのクラス」という理解に達したのですが、この理解はあってますでしょうか。

[shiketa]

ドキュメントをどうぞ。 https://fasterxml.github.io/jackson-databind/javadoc/2.7/com/fasterxml/jackson/databind/ObjectMapper.html

[hirono_suke]

@shiketa様
情報の提供ありがとうございます。他の回答者の方からのアドバイスもありましたので一度目を通したのですが、すべて理解することが出来ていません。
今の私の理解としては、「JsonファイルをJavaで操作できるようにするためのもの(逆も然り)」にとどまっていますが、この理解で正しいでしょうか。

[m.ts10806]

ドキュメントを読んで全部理解するのって無理ですし、「どういう理解をすれば自分で納得できるか」になるのでは？
ドキュメント確認したうえで、色々テストコードを組んでみて検証して「こういうもの」という理解の仕方になるとは思いますが、どこを落としどころとするおつもりでしょうか。

Answer 1

全文にコメントを追記してみました。

package main.java;

import java.net.*;
import java.net.http.*;
import java.net.http.HttpClient.Redirect;
import java.net.http.HttpClient.Version;
import com.fasterxml.jackson.databind.*;

public class Main{
    public static void main(String[] args) throws Exception{
        // どのURLから情報を取ってくるのか
        String user = "https://api.github.com/user/miyabilink";

        // サーバーに問い合わせするためのクラスをインスタンス化
        HttpClient client = HttpClient.newBuilder()
                .version(Version.HTTP_1_1)
                .followRedirects(Redirect.NORMAL)
                .build();

        // 問い合わせ内容をリクエストにします
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(user))
                .header("Accept", "application/vnd.github.v3+json")
                .GET().build();

        // レスポンス内容を文字列で受け取ります。
        HttpResponse<String> response = 
            client.send(request, HttpResponse.BodyHandlers.ofString());

        // body文字列にはjsonフォーマットの文章が入っています。
        String body = response.body();
        int status = response.statusCode();

        if(status == 200) {
            // jsonフォーマットにはルールがあります。
            // ルールに則って解読すれば目的の部分だけを読み取ることができます。
            // Jackson.ObjectMapperはJsonのルールに則り文字列を解析するクラスです。
            ObjectMapper  mapper = new ObjectMapper();

            // Jsonの式木を解析した結果がJsonNodeという整形された情報で返されます。
            // ObjectMapperは、Json文字列をJsonNodeに変換したり、その逆を行うクラスです。
            // 文字列情報を解析して、Jsonの構造にあったコンテナに変換しています。
            JsonNode root = mapper.readTree(body);

            // JsonNodeが持っているblogという値から、設定値を抜き出しています。
            String blog = root.get("blog").textValue();

            // 抜き出した文字列をコンソールに出力しています。
            System.out.println(blog);
        }else {
            System.out.println("ERROR" + status);
        }

    }
}

Jsonの結果は以下のようなものが返ってきます。
（サンプルにあるものですから、一部をそのまま利用させて頂きます）

{
"name": null,
"company": "株式会社ミヤビリンク",
"blog": "https://miyabilink.jp",
"location": "京都市中京区"
}

この中から、"blog"の値だけを取り出しやすいように整理されたものがJsonNodeです。

参考になれば。

Comments

[hirono_suke]

質面への回答ありがとうございます！
ObjectMapperがどのようなものか理解することができました！今後の学習に活かしていきたいと思います。