Misc

参考資料

msgpack-java の使い方

• https://github.com/msgpack/msgpack-java/blob/develop/msgpack-jackson/src/test/java/org/msgpack/jackson/dataformat/MessagePackDataformatTestBase.java
  • MessagePackDataformatForPojoTest.java で使うPOJOの定義とセットアップコード。
• https://github.com/msgpack/msgpack-java/blob/develop/msgpack-jackson/src/test/java/org/msgpack/jackson/dataformat/MessagePackDataformatForPojoTest.java
  • MessagePackDataformatTestBase でセットアップしたPOJOを、JacksonのObjectMapperを使ってmsgpackにread/writeするテストコード。
  • testSerializationWithoutSchema() にてSchema無しの、sequence形式の変換をテストしている。
• https://github.com/msgpack/msgpack-java/blob/develop/msgpack-jackson/src/test/java/org/msgpack/jackson/dataformat/MessagePackParserTest.java
  • testParserShouldReadObject() にて、MessagePacker を使って手動で組み上げた主要msgpackデータ型を網羅したデータを、ObjectMapper を使ってJavaのMapに変換するテストコード。
  • Map型であることがわかっているので、以下のように Map<String,Object> 型を指定して変換している。
    • TypeReference<Map<String, Object>> typeReference = new TypeReference<Map<String, Object>>() {};
    • Map<String, Object> object = objectMapper.readValue(bytes, typeReference);
  • Extension型については、パースした結果の値は MessagePackExtensionType となっており、拡張型のintとその値のbyte[]を取得してassertしている。
  • テストコードからは、mapの要素の順序維持についての挙動は読み取れない・・・。
    • → 実際にJava Objectに変換してみると、LinkedHashMap となっていた。実装依存ではあるが、とりあえず順序は許容される。
  • testByteArrayKey() にて、Binaryがmapのキーだった場合に、byte[]にdeserializeするようなJacksonのカスタマイズがテストされている。
    • 以下、testXXXKey() で同様に、様々なキーの型に対応したカスタマイズがテストされている。

msgpack-lite の使い方

msgpack-lite では Unit8Array でmsgpackの生データを取り扱えるので、以下の記事を参考に、直接XHRでmsgpackを受信→decodeして表示したり、JSONをmsgpackにencodeしたりして、Netty側のエンドポイントとやり取りさせてみた。

• Reading binary data using jQuery Ajax Henry Algus
  • http://www.henryalgus.com/reading-binary-files-using-jquery-ajax/
• AjaxでバイナリのJPEG画像データを受け取って表示する - Qiita
  • https://qiita.com/Yarimizu14/items/f56123c738f12ad1844a
• XMLHttpRequestで取得した画像バイナリをJavaScriptでロードする - kinjouj.github.io
  • https://kinjouj.github.io/2013/04/xmlhttprequest-load-image-binary.html
• Uint8Array - JavaScript | MDN
  • https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array
• バイナリデータの送信と受信 - XMLHttpRequest | MDN
  • https://developer.mozilla.org/ja/docs/XMLHttpRequest/Sending_and_Receiving_Binary_Data

その他参考資料

• Cyber-Defenceの人が、burpでmsgpackをJSONに変換して表示するburp拡張作ってた。
  • http://io.cyberdefense.jp/entry/2016/05/13/Burp_Extension%E9%96%8B%E7%99%BA_-_MessagePack
• Fiddlerでのビューアプラグイン
  • https://github.com/jessemcdowell/FiddlerMessagePackViewer
• http://xuwei-k.github.io/scalajspack/
• https://github.com/xuwei-k/scalajspack
• http://kawanet.github.io/msgpack-lite/
• http://xuwei-k.hatenablog.com/entry/20150128/1422364396
• https://qiita.com/ksgwr/items/ba36fd0035789c29da7e
  • 2015年時点で実際にJavaで MessagePack のシリアライズ/デシリアライズに挑戦した人のメモ

Jackson公式ドキュメント系

• FasterXML/jackson: Main Portal page for the Jackson project
  • https://github.com/FasterXML/jackson
• FasterXML/jackson-docs: Documentation for the Jackson JSON processor.
  • https://github.com/FasterXML/jackson-docs
• Overview (Jackson-core 2.7.0 API)
  • http://fasterxml.github.io/jackson-core/javadoc/2.7/
• SerializationFeature (jackson-databind 2.7.0 API)
  • http://fasterxml.github.io/jackson-databind/javadoc/2.7/

Jacksonの使い方解説記事, Jacksonでpretty-print系

• How to convert Java object to / from JSON (Jackson)
  • https://www.mkyong.com/java/how-to-convert-java-object-to-from-json-jackson/
• Jackson使い方メモ - Qiita
  • https://qiita.com/opengl-8080/items/b613b9b3bc5d796c840c
• Jackson の痒いところ Tips - Qiita
  • https://qiita.com/komiya_atsushi/items/6e5b8e6690b82bca8198#objectmapperwritevalue-%E3%81%AA%E3%81%A9%E3%81%A7%E5%87%BA%E5%8A%9B%E3%81%95%E3%82%8C%E3%82%8B-json-%E3%82%92%E6%95%B4%E5%BD%A2%E3%82%A4%E3%83%B3%E3%83%87%E3%83%B3%E3%83%88-pretty-print-%E3%81%97%E3%81%9F%E3%81%84
• How to pretty print JSON string using Jackson? | Kode Java
  • https://kodejava.org/how-to-pretty-print-json-string-using-jackson/
• Enable JSON pretty print using Jackson API - Jackson JSON examples
  • https://www.java2novice.com/java-json/jackson/json-pretty-print/
• java - Pretty printing JSON from Jackson 2.2's ObjectMapper - Stack Overflow
  • https://stackoverflow.com/questions/17617370/pretty-printing-json-from-jackson-2-2s-objectmapper
• java - Jackson not displaying in Pretty Print format - Stack Overflow
  • https://stackoverflow.com/questions/45137882/jackson-not-displaying-in-pretty-print-format
• How to enable pretty print JSON output (Jackson)
  • https://www.mkyong.com/java/how-to-enable-pretty-print-json-output-jackson/

Jacksonでのカスタムシリアライザ系

• JacksonHowToCustomSerializers ・ FasterXML/jackson-docs Wiki
  • https://github.com/FasterXML/jackson-docs/wiki/JacksonHowToCustomSerializers
• 備忘録的なblog: [Jackson]特定の型に対してカスタムなシリアライザを設定する
  • http://se-bikou.blogspot.jp/2016/03/jackson.html
• 備忘録的なblog: [Jackson]末尾のスペースを取り除いてjson変換する
  • http://se-bikou.blogspot.jp/2016/03/jacksonjson.html
• java - How do I use a custom Serializer with Jackson? - Stack Overflow
  • https://stackoverflow.com/questions/7161638/how-do-i-use-a-custom-serializer-with-jackson

Gson公式、および日本語の使い方記事

• google/gson: A Java serialization/deserialization library to convert Java Objects into JSON and back
  • https://github.com/google/gson
• com.google.code.gson:gson:2.8.2 API Doc :: Javadoc.IO
  • https://www.javadoc.io/doc/com.google.code.gson/gson/2.8.2
• gson/UserGuide.md at master ・ google/gson
  • https://github.com/google/gson/blob/master/UserGuide.md#TOC-Array-Examples
• Gson - 覚えたら書く
  • http://blog.y-yuki.net/entry/2016/11/25/000000

Gsonでのカスタムシリアライザの参考記事

• Serialize/deserialize byte array to/from base64 encoded String using Gson - Google グループ
  • https://groups.google.com/forum/#!topic/immutables/J1VPe2dfNGI
• Gson type adapter to serialize and deserialize byte arrays in base64
  • https://gist.github.com/orip/3635246

guavaを利用したUnicodeエスケープの実装参考記事

• unicode - Convert International String to \u Codes in java - Stack Overflow
  • https://stackoverflow.com/questions/6230190/convert-international-string-to-u-codes-in-java
• java - Convert UTF-8 Unicode string to ASCII Unicode escaped String - Stack Overflow
  • https://stackoverflow.com/questions/28176578/convert-utf-8-unicode-string-to-ascii-unicode-escaped-string
• guava/UnicodeEscaper.java at master ・ google/guava
  • https://github.com/google/guava/blob/master/guava/src/com/google/common/escape/UnicodeEscaper.java
• UnicodeEscaper (Guava: Google Core Libraries for Java 19.0 API)
  • https://google.github.io/guava/releases/19.0/api/docs/com/google/common/escape/UnicodeEscaper.html#escape(int)