C# PR

【C# Newtonsoft.Json】JsonProperty JSONの変数名が日本語の場合にデシリアライズする方法

記事内に商品プロモーションを含む場合があります

はじめに

C#で人気のライブラリ NewtonSoft Json.NETで、JSONの変数名に日本語や特殊な名前が使われている場合の解決策について解説します。

結論から言うと「JsonProperty」を使えば、「JSONの変数名」と「コードの変数名」が違う場合でも、2つを紐づけることができます。詳しくは以下で解説します。

Json.netのインストール方法についてはこちらの記事をご覧ください。

通常のデシアライズはどうするの?という方は以下の記事も参照ください。

環境

環境バージョンなど備考
VisualStudio   2019 Community 2017でも使用できます
.NET4.7.2
プロジェクトコンソール(.NET Framework) 
Json.NET13.0.1

JSONファイルと実行結果

日本語や特殊な変数名が含まれるJSONファイルと、デシリアライズするコードの実行結果は以下の通りです。

JSONファイル

  • 「メールアドレス」が日本語の変数名になっています。
  • __CREATED_date__が特殊な変数名になっています。
{
  "メールアドレス": "james@example.com",
  "Active": true,
  "__CREATED_date__": "2013-01-20T00:00:00Z",
  "Roles": [
    "User",
    "Admin"
  ]
}

JsonPropertyに日本語を設定する際は、文字コードに注意してください。
本記事のJSONファイルはutf-8であることを前提に解説しています。

実行結果

JsonPropertyを使ってデシリアライズするコードの実行結果

全体コード

上述したJSONファイルを、「JsonProperty」を使ってデシリアライズするコードです。

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

using System.IO;          // ファイルの読み書きに必要です
using Newtonsoft.Json; // Json.net用に必要です

namespace ConsoleAppJsonProperty
{
    class Program
    {

        //
        // デシリアライズ用のデータクラスです
        //
        public class Account
        {
            // JsonPropertyでJSON変数 "メールアドレス" を 
            //  メンバ変数 "Email" に入れるように設定します

            [JsonProperty("メールアドレス")]
            public string Email { get; set; }
            
            public bool Active { get; set; }
            

            // 特殊な変数名も、読みやすい変数に入れることができます

            [JsonProperty("__CREATED_date__")]
            public DateTime CreatedDate { get; set; }
            
            public IList<string> Roles { get; set; }
        }


        static void Main(string[] args)
        {

            //
            // 注意:
            // Cドライブの直下に、test.jsonのファイルが保存済みであることを前提にしています。
            //

            // デシリアライズするデータクラスのオブジェクトです
            Account account = null;

            try
            {
                //
                // jsonファイルを読み込みます
                //
                using (StreamReader file = File.OpenText(@"C:\test_jp.json"))
                {
                    // Json.netのオブジェクトを作成します
                    JsonSerializer serializer = new JsonSerializer();

                    // デシリアライズ関数に
                    // 読み込んだファイルと、データ用クラスの名称(型)を指定します。
                    // 
                    // デシリアライズされたデータは、自動的にaccountの
                    // メンバ変数に格納されます 
                    //
                    account = (Account)serializer.Deserialize(file, typeof(Account));
                }

                // 表示してみます
                Console.WriteLine("Email : " + account.Email);
                Console.WriteLine("Active: " + account.Active);
                Console.WriteLine("Date  : " + account.CreatedDate);

                foreach (string role in account.Roles)
                {
                    Console.WriteLine("Roles : " + role);
                }
            }

            catch
            {
                Console.WriteLine("ファイル読み込み時に例外が発生しました。");
            }

            Console.WriteLine("キーを押すと終了します");
            Console.ReadKey();

        }
    }
}

コードのポイント

JsonProperty

自作データクラス(Account)のメンバ変数の上に、[ JsonProperty(“メールアドレス”) ]として、デシリアライズしたいJSONデータ変数名を指定します。

こうすることで、Json.NETがJSON変数名とクラスのメンバ変数名の対応を解釈して自動でデシリアライズしてくれます。

この仕組みにより、JSONの変数名が日本語等でも、コード側は影響を受けずに実装することができます。

        public class Account
        {
            // JsonPropertyでJSON変数"メールアドレス" を メンバ変数Emailに入れるように設定します
            [ JsonProperty("メールアドレス") ]
            public string Email { get; set; }
            
            public bool Active { get; set; }
            

            // 特殊な変数名も、読みやすい変数に入れることができます

            [JsonProperty("__CREATED_date__")]
            public DateTime CreatedDate { get; set; }
            
            public IList<string> Roles { get; set; }
        }

まとめ

C#で人気のライブラリ NewtonSoft Json.NETで、JSONの変数名に日本語や特殊な名前が使われている場合の解決策、JsonPropertyについて解説しました。参考になればうれしいです。

お知らせ

今月号のSoftware Designは「もっとTypeScriptの力を引き出そう」

JavaScriptの拡張言語でしょ?と思っているかたへ、Union型などTypeScriptの持つ秘めたる力を解説する特集となっています。

個人的には第2特集の「Ubuntuの現代的な使い方」がの方が気になりました。より詳しい内容は以下のリンクからご覧ください。

質問・要望 大歓迎です

「こんな解説記事作って」「こんなことがしたいけど、〇〇で困ってる」など、コメント欄で教えてください。 質問・要望に、中の人ができる限り対応します。

使えたよ・設定できたよの一言コメントも大歓迎。気軽に足跡を残してみてください。記事を紹介したい方はブログ、SNSにバシバシ貼ってもらってOKです。

ABOUT ME
えす
現役のソフトウェアエンジニアです。 C++ C# Python を使ってます。10年ちょい設計/開発部門にいましたが、今はQAエンジニアっぽいことをしています。

COMMENT

メールアドレスが公開されることはありません。 が付いている欄は必須項目です