（Ｃ＃）オブジェクトをファイルに保存して、読み込んで復元する

-
オブジェクトの内容をファイルに保存して、後日、そのファイルから読み込んでオブジェクトを復元する。たとえばソフトを終了するときにソフトの設定情報オブジェクトを保存して、次回の起動時に設定を復元する、ということをしたい。これを.NETのクラスで実装しようと何度か試みているのだが、どうもうまくいかない。

オブジェクトを保存したり復元したりするのを、C#ではシリアライズ、デシリアライズと呼ぶらしい。

.NETにはシリアライズするクラスがあって、これをつかって設定の保存とかを実装したいのだけど、毎回挫折している。なかなか、うまくいかない。

といっても保存と復元のメソッドを自分で書くのはしんどいので、できれば.NETのライブラリで簡単に終わらせたい。ということで、今回もこりずにシリアライズにチャレンジしてみる。以前はXMLだったが、今回はJSONでいってみたい。

（JSONではどうもうまくいかなかったので、後日、XMLで試した記事をその２にまとめた。）

JSONでシリアライズするときには、DataContractJsonSerializerというクラスを使うらしい。

手順

（１）参照設定に「System.Runtime.Serialization.dll」を追加する。

（２）usingを書く。

  1. using System.Runtime.Serialization;
  2. using System.Runtime.Serialization.Json;

（３）クラスを書く。
今回はSQLのWhere句で使う式をツリー形式で持つためのクラスをサンプルにしてみる。

たとえば「where [英語] >= 70 and [テスト名称] = '2017年7月テスト'」という式をツリー形式で持ちたいとする。

図で表すとこんな感じ。


クラスは以下の通り。

  1.        [DataContract]
  2.         internal class mm50列情報
  3.         {
  4.             [DataMember]
  5.             internal string colName;
  6.             internal Type colType;
  7.         }
  8.  
  9.         internal enum mmOp_e
  10.         {
  11.             mm等しい,
  12.             mm等しくない,
  13.             mm以上,
  14.             mm以下,
  15.             mmかつ,
  16.             mmまたは,
  17.         }
  18.  
  19.         [DataContract]
  20.         internal class mm検索条件Base
  21.         {
  22.  
  23.         }
  24.  
  25.         [DataContract]
  26.         internal class mm比較式 : mm検索条件Base
  27.         {
  28.             [DataMember]
  29.             internal mm50列情報 Column;
  30.             [DataMember]
  31.             internal mmOp_e Op;
  32.             [DataMember]
  33.             internal object v1;
  34.             [DataMember]
  35.             internal object v2;
  36.         }
  37.  
  38.         [DataContract]
  39.         internal class mm数値比較式 : mm比較式
  40.         {
  41.             internal mm数値比較式(mm50列情報 col, mmOp_e op, object v1, object v2)
  42.             {
  43.                 this.Column = col;
  44.                 this.Op = op;
  45.                 this.v1 = v1;
  46.                 this.v2 = v2;
  47.             }
  48.         }
  49.  
  50.         [DataContract]
  51.         internal class mm文字列比較式 : mm比較式
  52.         {
  53.             internal mm文字列比較式(mm50列情報 col, mmOp_e op, string s)
  54.             {
  55.                 this.Column = col;
  56.                 this.Op = op;
  57.                 this.v1 = s;
  58.             }
  59.         }
  60.         [DataContract]
  61.         [KnownType(typeof(mm数値比較式))]
  62.         [KnownType(typeof(mm文字列比較式))]
  63.         internal class mm論理式 : mm検索条件Base
  64.         {
  65.             [DataMember]
  66.             internal mm比較式 条件1 { set; get; }
  67.             [DataMember]
  68.             internal mm比較式 条件2 { set; get; }
  69.             [DataMember]
  70.             internal mmOp_e Op { set; get; }
  71.         }

いくつか決まりごとがある。
  • 保存したいクラスには[DataContract]を追記する。
  • 保存したいメンバーには[DataMember]を追記する。
  • 継承しているクラスを使うときには[KnownType]を追記する。
    たとえば「mm論理式」クラスでは「条件１」メンバーが「mm比較式」型だが、ここには「mm数値比較式」のオブジェクトが代入されるかもしれない。そうしたときに継承するクラスを追記する。
なかなか面倒なのだが、保存と復元をすべてお任せにできるのだから、このくらいのコストは仕方がない。

（４）オブジェクトを保存し、復元する。
保存と復元はDataContractJsonSerializerクラスを使う。

  1.  mm50列情報 col1 = new mm50列情報() { colName = "英語", colType = typeof(int) };
  2.   mm比較式 cn1 = new mm数値比較式(col1, mmOp_e.mm以上, 70, null);
  3.  
  4.   mm50列情報 col2 = new mm50列情報() { colName = "テスト名称", colType = typeof(string) };
  5.   mm比較式 cn2 = new mm文字列比較式(col2, mmOp_e.mm等しい, "２０１７年７月テスト");
  6.  
  7.   mm論理式 ex = new mm論理式() { 条件1 = cn1, Op = mmOp_e.mmかつ, 条件2 = cn2 };
  8.  
  9.   // 論理式を保存する
  10.   var js = new DataContractJsonSerializer(ex.GetType());
  11.   System.IO.FileStream st = new System.IO.FileStream("test.json", System.IO.FileMode.OpenOrCreate);
  12.   js.WriteObject(st, ex);
  13.  
  14.   // 論理式を復元する
  15.   st.Seek(0, System.IO.SeekOrigin.Begin);
  16.   object obj =   js.ReadObject(st);
  17.   ex = obj as mm論理式;

注意しないといけないのは、保存するときにクラスの型を指定する必要がある。そして、復元するときは、保存したときに指定したクラスのオブジェクトしか復元できない。つまり、復元するときは、このオブジェクトは何のクラスだったのかを知っておく必要がある。

保存内容される内容は以下の通り。改行が無いのですこぶる読みにくい。


読みやすく改行を入れてみる。

  1. {
  2.   "Op":4,
  3.   "条件1":{
  4.     "__type":"testA.mm数値比較式:#serializ",
  5.     "Column":{ "colName":"英語"},"Op":2, "v1":70, "v2":null
  6.   },
  7.   "条件2":{
  8.     "__type":"testA.mm文字列比較式:#serializ",
  9.     "Column":{"colName":"テスト名称"},
  10.     "Op":0,"v1":"２０１７年７月テスト","v2":null
  11.   }
  12. }

いくつか気がつくのだけど、
  • enumは整数値で保存される。
    もしうっかりしてenmuのメンバーの順番を変えると復元できなくなる。たとえば「mm以上」の前に「mm未満」を追加するとアウト。enumメンバーには初期値を設定しておくのがよさそう。
  • 継承したクラスの情報が追記されている。
  • 自分が何者か（クラス情報）は無い。
JSON情報だけもらっても、どのクラスのオブジェクトなのかを知っていないと復元はできない。ということは、継承したクラスが数種類あって、それらのオブジェクトをいくつか保存する場合は、クラス名も保存しておく必要があるということですな。

未解決問題

あと、解決できていないのが、「Type colType;」メンバーを保存できないこと。下記のように型情報を追加してみたのだが、保存時に例外が起きる。

  1.         [DataContract]
  2.         [KnownType(typeof(int))]
  3.         [KnownType(typeof(string))]
  4.         internal class mm50列情報
  5.         {
  6.             [DataMember]
  7.             internal string colName;
  8.             [DataMember]
  9.             internal Type colType;
  10.         }

例外は以下の通り。

System.Runtime.Serialization.SerializationException: 'データ コントラクト名 'RuntimeType:http://schemas.datacontract.org/2004/07/System' を持つ型 'System.RuntimeType' は予期されていません。DataContractSerializer を使用している場合は DataContractResolver を使用することを検討するか、静的に認知されていないすべての型を既知の型の一覧に追加してください。このためには、たとえば KnownTypeAttribute 属性を使用するか、シリアライザーへ渡される既知の型の一覧にこれらの型を追加します。'

さすがにTypeデータはシリアライズできないのかな。

まとめ

DataContractJsonSerializerを使って保存と復元をするときの注意点をまとめてみる。
  • 将来、クラスの構造が変わると保存したデータから復元するのが大変そう。
  • クラスの構造を簡素にしておくのがよさそう。
  • 継承は控えめに。継承するごとに[KnownType]の追記が増えていくことになって面倒。
  • 保存と復元のための簡素なクラスを作っておいて、複雑な処理は別のクラスに作るのがよさそう。
  • 逆に、保存と復元用に簡素なオブジェクトを用意するのもありかも。
  • 保存するときクラス名も別に保存しておくこと。
  • なかなか面倒。
JSONをあきらめてXMLで試した記事もまとめた。(2017/10/16追記)

＊



コメント

コメントを投稿

このブログの人気の投稿

varchar をデータ型 numeric に変換中に、算術オーバーフロー エラーが発生しました。

-
SQL Serverで頭記のエラーが起きたときは、文字列の数字を数値型の値に変換しようとして桁があふれた場合が多い。 たとえば '123456789012' という数字を０という数値と比較すると、数字を数値に変換して比較しようとして桁あふれが（算術オーバーフロー）が起きる select 1 where '123456789012' = 0 SQLServer2014だとエラーメッセージが少し変わって下記のようになる。 varchar の値 '123456789012' の変換が int 型の列でオーバーフローしました。 数字を数値に変換するSQLを修正すれば、このエラーは消える。テーブル設計がひどくて、varchar型の列に数字を登録して数値として扱う運用をしていたりすると、なかなか簡単ではないかもしれない。 ＊ ここからは事例の紹介。 SQL Serverで何気ないＳＱＬが急にエラーになってびっくりすることがある。たとえば、このＳＱＬは調子よく動いていたのだが、データによってエラーが起きて、あたふたしてしまった。 select case when isnull([機関番号],0) = 0 then 5521111111 else [機関番号] end このSQLには１つ問題があって「機関番号」がvarchar(10)の列というのがミソ。ここに '5555555555' という大きな数字を登録したら、エラーが起きた。 エラーの原因を調べるためにSQLを少し書き換えてみる SQL（１） select case when isnull('5555555555', 0) = 0 then 5521111111 else 0 end SQL（２） select isnull('5555555555', 0) SQL（３） select case when isnull('5555555555', '') = '' then 5521111111 else 0 end SQL(4) select case when 1=0 then 5521111111 else '55555555...
続きを読む