0. 前回までの目次
#01 最初の構想
#02 要求
#03 提供データの特定とER図
1. リソースを特定する
(1)西暦年リソース
西暦年で各国の年号情報を串刺しするというコンセプトからして、西暦年は外せないでしょう。１つの西暦年に対する各国元号年の情報を持たせます。
なお、持たせる情報の詳細は次回予定のリソース表現の検討で考えます(以下、同様)。
(2)検索結果リソース
検索は機能で情報ではないですが、検索結果は情報ですのでリソースとして扱います。元号名、元号名の読み、天皇名、及び天皇名の読みで元号情報を検索した結果の情報を持たせます。
(3)元号リソース
元号の情報を持たせます。
(4)時代・王朝別元号リソース
時代・王朝ごとの元号一覧を持たせます。
(5)地域・国別元号リソース
各国/地域ごとの時代・王朝・元号の一覧を持たせます。
(6)地域・国別西暦年リソース
最初は日本しかありませんが、他の国の対応後は国指定で元号を取得したくなりそうです。その時、(1)の西暦年リソースだと余分な情報も含まれてしまいますので、国も指定出来た方が良いかもしれないと思いました。
(7)トップレベルリソース
このWebサービスのスタート地点。西暦年の指定、地域・国別元号リソースへのリンク、検索フォームを持たせます。
2. リソースにURIで名前を付ける
仮にアプリケーションのURLを「http://gengo.appspot.com」とします。
(1)西暦年リソース
西暦年リソースは西暦年で一意に識別できるので、西暦年がそのまま使えそうです。例えば、1092年は「http://gengo.appspot.com/1192」です。「年」は付けないことにします。可読性に問題はないのでプログラムで扱い易くするためです。
(2)検索結果リソース
まず、「/search」を検索クエリを受け取るリソースのURLとします。問題は、クエリパラメータです。
(a)文字表現はどのように扱うべきか？
(a1)元号名と天皇名の漢字表現をどうあつかうか？
UTF-8で%エンコードした漢字表現を、そのままURIに使用します。
(a2)元号名の読みと天皇名の読みは、ひらがな/カタカナ/ローマ字？
和暦だけをターゲットにするのではなく、中国/朝鮮/ベトナムまで含めるとどうすべきかちょっと悩むところです。ローマ字表記も各国ごとにばらばらで、いろいろな方式があるためどうしたものかと。
各国/地域の表音文字表現は下記の通りです。
中国やベトナムのように独自の表音文字がない(？、よくわかりません)ケースを考えると、ローマ字表記での統一が良さそうですが、実際にはアクセント記号も込みのため、単純にアスキー文字列で表現できるわけではありません。日本人ユーザーによる入力のし易さから考えて、今回は日本用には「ひらがな」(UTF-8の%エンコード)を採用することにします。つまり、ローマ字による表現の統一は諦めるため、読みによる串刺し検索ができなくなります。但し需要があるとは思えないので良しとしました。
その他の国は機能拡張時の検討事項として残しておきます。
(b)名前検索と読み検索とで検索結果リソースを区別すべきか？
名前は漢字で、読みはその他の文字になるため、使う側としては名前と読みとをことさら意識しないと思われます。ルールは分けないで同じ仕組みでのリソースとします。
(c)元号検索と天皇検索とで検索を区別すべきか？
リソース表現を工夫することで対応出来そうな気がしますので、一旦は区別せずに進めます。但し、天皇名は最初の機能からは落とすつもりですので、機能追加時には再検討を行います。ということで、クエリパラメータは慣例に合わせて「q」とします。
(d)地域・国別に検索したい場合はどう扱うか？
串刺しをデフォルトとし、国・地域別は階層を落として分けましょう。国/地域はUTF-8の%エンコーディングでは可読性が落ちるため英語表記とします。
「japan」「china」「korea」「vietnam」
なお、串刺しでの読み検索は、ローマ字表記を諦めたので、地域・国を省略できるということ以外にはあまり意味はなくなります。
まとめると、URIは以下のような感じです。
- 串刺し：「http://gengo.appspot.com/search?q=建」
- 日本 ：「http://gengo.appspot.com/japan/search?q=建」
- 「http://gengo.appspot.com/japan/search?q=けん」
- 中国 ：「http://gengo.appspot.com/china/search?q=建」
- 朝鮮 ：「http://gengo.appspot.com/korea/search?q=建」
- 越南 ：「http://gengo.appspot.com/vietnam/search?q=建」
(3)元号リソース
同じように考えます。但し、時代・王朝名と元号でのリソース重複を防止するため「gengo」を挟みます。元号と地域・国では、地域国を上位概念とします。理由は、使うときに「建長の日本」ではなく「日本の建長」で探すことの方が多いと思うからです。串刺しについては、各国が中国の元号をまねて付けたものもなくはないため、もしかしたら良い結果を産むかもしれません。
- 串刺し：「http://gengo.appspot.com/gengo/建長」
- 日本 ：「http://gengo.appspot.com/japan/gengo/建長」
- 中国 ：「http://gengo.appspot.com/china/gengo/建長」
- 朝鮮 ：「http://gengo.appspot.com/korea/gengo/建長」
- 越南 ：「http://gengo.appspot.com/vietnam/gengo/建長」
(4)時代・王朝別元号リソース
串刺しの情報は存在しません。「時代・王朝」は「era」として、それ以外は元号リソースと同様です。なお「＊＊時代」の「時代」は冗長なため含めないことにします。
- 串刺し：なし
- 日本 ：「http://gengo.appspot.com/japan/era/鎌倉」
- 中国 ：「http://gengo.appspot.com/china/era/明」
- 朝鮮 ：「http://gengo.appspot.com/korea/era/李氏朝鮮」
- 越南 ：「http://gengo.appspot.com/vietnam/era/阮朝」
(5)地域・国別元号リソース
同様に
- 日本 ：「http://gengo.appspot.com/japan」
- 中国 ：「http://gengo.appspot.com/china」
- 朝鮮 ：「http://gengo.appspot.com/korea」
- 越南 ：「http://gengo.appspot.com/vietnam」
(6)地域・国別西暦年リソース
「(1)西暦年リソース」の下位データと考えて
- 日本 ：「http://gengo.appspot.com/1192/japan」
- 中国 ：「http://gengo.appspot.com/1192/china」
- 朝鮮 ：「http://gengo.appspot.com/1192/korea」
- 越南 ：「http://gengo.appspot.com/1192/vietnam」
(7)トップレベルリソース
「http://gengo.appspot.com」
ここまで考えると、「(3)元号リソース」は串刺し用と地域・国別元号用とに分離した方がすっきりしそうですね。リソースの表記順も順番をかえた方が分かり易そうですし。まあ、正式なURIの仕様書は動くものができてからきちんと整備することにして、こんな感じで進めていきます。
あ〜、今日も文字ばっかりでした。
0 件のコメント:
コメントを投稿