<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet type="text/xsl" media="screen" href="/~d/styles/atom10japanesefull.xsl"?><?xml-stylesheet type="text/css" media="screen" href="http://feeds.feedburner.com/~d/styles/itemcontent.css"?><feed xmlns="http://www.w3.org/2005/Atom" xmlns:thr="http://purl.org/syndication/thread/1.0" xml:lang="ja" xml:base="http://blogs.ricollab.jp/webtech/wp-atom.php">
	<title type="text">ricollab Web Tech Blog</title>
	<subtitle type="text">ricollab engineers' blog</subtitle>

	<updated>2010-04-26T02:09:12Z</updated>
	<generator uri="http://wordpress.org/" version="2.8.2">WordPress</generator>

	<link rel="alternate" type="text/html" href="http://blogs.ricollab.jp/webtech" />
	<id>http://blogs.ricollab.jp/webtech/feed/atom/</id>
	

			<atom10:link xmlns:atom10="http://www.w3.org/2005/Atom" rel="self" type="application/atom+xml" href="http://feeds.feedburner.com/ricollab_web_tech" /><feedburner:info xmlns:feedburner="http://rssnamespace.org/feedburner/ext/1.0" uri="ricollab_web_tech" /><atom10:link xmlns:atom10="http://www.w3.org/2005/Atom" rel="hub" href="http://pubsubhubbub.appspot.com/" /><entry>
		<author>
			<name>kinoue</name>
					</author>
		<title type="html"><![CDATA[MySQL Proxyでできること、できないこと]]></title>
		<link rel="alternate" type="text/html" href="http://blogs.ricollab.jp/webtech/2010/04/mysql_proxy/" />
		<id>http://blogs.ricollab.jp/webtech/?p=93</id>
		<updated>2010-04-26T02:09:12Z</updated>
		<published>2010-04-26T02:09:12Z</published>
		<category scheme="http://blogs.ricollab.jp/webtech" term="未分類" /><category scheme="http://blogs.ricollab.jp/webtech" term="MySQL" />		<summary type="html"><![CDATA[こんにちは。リコーの井上です。今回から私もこのブログを書かせていただくことになりました。よろしくお願いします。
今回はMySQL Proxyについて書きたいと思います。MySQLを利用していると、WebアプリケーションなどのMySQLクライアントからサーバに送られるクエリを解析したい場合があります。あるいは、複数のMySQLサーバに処理を振り分けたいということがあります。
MySQL Proxyはその名の通り、MySQLクライアントとMySQLサーバの間に入って、接続やクエリで取り交わされるデータを参照・加工して、いろいろと役立つことをさせようというものです。動作内容は軽量スクリプト言語Luaにより柔軟に記述できますが、機能的制限もあります。
このエントリではMySQL Proxyとはどういうものか、どういうことができそうなのか、できないのかということを感じ取っていただければと思っています。
必要なものとインストール
MySQL Proxyを一からビルドするにはlibevent, glib, Luaなどの依存ライブラリについてもビルドする必要があります。気軽に試すには、ダウンロードサイトからお使いのOS用のバイナリパッケージをダウンロードするのがおすすめです。バイナリパッケージはtarballで提供されているので、これを/opt以下などに展開して利用します。
Red Hat系ディストリビューション用に、/etc/init.dに置くスクリプトなども別途公開されています。
ここでの動作確認は以下の組み合わせで行いました。

CentOS 5.4
MySQL Proxy 0.8.0(Red Hat Enterprise Linux用バイナリ)
MySQL 5.1.45

簡単なLuaスクリプト
MySQL Proxyの大きな特長は、軽量スクリプト言語Luaを利用して任意の処理を記述できることにあります。逆に、Luaを記述しなければ指定されたMySQLサーバに交互に接続を振り分ける単純なロードバランサとなります。
MySQL Proxyでクライアントから発行されたクエリの内容をファイルに出力するLuaスクリプトは以下のようになります。

 1  function read_query(packet)
 2    local fh
 3    if string.byte(packet) == proxy.COM_QUERY then
 4      fh = io.open("/var/tmp/query.log", "a")
 5      fh:write(string.sub(packet, 2) .. [...]]]></summary>
		<content type="html" xml:base="http://blogs.ricollab.jp/webtech/2010/04/mysql_proxy/"><![CDATA[<p>こんにちは。リコーの井上です。今回から私もこのブログを書かせていただくことになりました。よろしくお願いします。</p>
<p>今回は<a href="http://forge.mysql.com/wiki/MySQL_Proxy">MySQL Proxy</a>について書きたいと思います。MySQLを利用していると、WebアプリケーションなどのMySQLクライアントからサーバに送られるクエリを解析したい場合があります。あるいは、複数のMySQLサーバに処理を振り分けたいということがあります。</p>
<p>MySQL Proxyはその名の通り、MySQLクライアントとMySQLサーバの間に入って、接続やクエリで取り交わされるデータを参照・加工して、いろいろと役立つことをさせようというものです。動作内容は軽量スクリプト言語<a href="http://www.lua.org/">Lua</a>により柔軟に記述できますが、機能的制限もあります。</p>
<p>このエントリではMySQL Proxyとはどういうものか、どういうことができそうなのか、できないのかということを感じ取っていただければと思っています。</p>
<h3>必要なものとインストール</h3>
<p>MySQL Proxyを一からビルドするにはlibevent, glib, Luaなどの依存ライブラリについてもビルドする必要があります。気軽に試すには、<a href="http://dev.mysql.com/downloads/mysql-proxy/">ダウンロードサイト</a>からお使いのOS用のバイナリパッケージをダウンロードするのがおすすめです。バイナリパッケージはtarballで提供されているので、これを/opt以下などに展開して利用します。</p>
<p>Red Hat系ディストリビューション用に、/etc/init.dに置くスクリプトなども<a href="http://forge.mysql.com/wiki/MySQL_Proxy_init">別途公開</a>されています。</p>
<p>ここでの動作確認は以下の組み合わせで行いました。</p>
<ul>
<li>CentOS 5.4</li>
<li>MySQL Proxy 0.8.0(Red Hat Enterprise Linux用バイナリ)</li>
<li>MySQL 5.1.45</li>
</ul>
<h3>簡単なLuaスクリプト</h3>
<p>MySQL Proxyの大きな特長は、軽量スクリプト言語<a href="http://www.lua.org">Lua</a>を利用して任意の処理を記述できることにあります。逆に、Luaを記述しなければ指定されたMySQLサーバに交互に接続を振り分ける単純なロードバランサとなります。</p>
<p>MySQL Proxyでクライアントから発行されたクエリの内容をファイルに出力するLuaスクリプトは以下のようになります。</p>
<pre><code>
 1  function read_query(packet)
 2    local fh
 3    if string.byte(packet) == proxy.COM_QUERY then
 4      fh = io.open("/var/tmp/query.log", "a")
 5      fh:write(string.sub(packet, 2) .. "\n")
 6      fh:close()
 7    end
 8  end
</code></pre>
<p>スクリプトをlog.luaという名前で保存し、以下のようにMySQL Proxyを起動します。</p>
<pre><code>
% /opt/mysql-proxy/bin/mysql-proxy \
          --proxy-backend-addresses=127.0.0.1:3306 \
          --proxy-lua-script=`pwd`/log.lua
</code></pre>
<p>オプション <code>--proxy-backend-addresses</code> で中継先のバックエンドつまりMySQLサーバを、 <code>--proxy-lua-script</code> でLuaスクリプトファイル名を指定します。Luaファイル名はフルパスで指定することに注意してください。</p>
<p>MySQLクライアントを起動してデータベースにSELECTを発行してみましょう。MySQL ProxyはデフォルトでTCPの4040ポートを利用します。なお、接続するDBとSELECTするテーブルは事前に作成しておいてください(ここではhogeとitems)。</p>
<pre><code>
% mysql -u root -p -h 127.0.0.1 -P 4040 hoge
Enter password:
Welcome to the MySQL monitor.  Commands end with ; or \g.
...(省略)...
mysql> select * from items;
...(省略)...
mysql> exit
Bye
%
</code></pre>
<p>この後、 /var/tmp/query.log を開くと以下のような内容が記録されています。</p>
<pre><code>
select @@version_comment limit 1
select * from items
</code></pre>
<p>1行目はMySQLクライアントがサーバに接続したときに自動的に発行している文です。2行目は発行したSELECT文がそのまま出力されています。exitはクエリではないので、ログは出力されていません。</p>
<h4>スクリプトの内容</h4>
<p>MySQL ProxyはLua関数により拡張できるポイントをいくつか用意しており、read_queryはその一つです。read_query関数はクライアントからのリクエストがきたときに、そのデータが入ったパケットを引数として呼び出されます。</p>
<p>2行目ではファイルハンドルを格納するローカル変数を定義しています。localキーワードをつけないと変数はグローバルとなり、他のリクエストから呼ばれたLua関数の中でも共通に利用されることになります。なお、関数の外で定義されたローカル変数は、クライアントとの同一コネクションを通して有効です。</p>
<p>3行目のif文では、パケットの最初のバイトを見て、リクエストがクエリなのかどうかを確認しています。MySQL ProxyではCOM_QUERY, COM_QUITといったパケットのタイプを示す定数が定義されています。これをパケットの先頭バイトとマッチすることでパケットを識別することができます。なおstring.byte(str, i, j)はi文字目からj文字目の内部コードを数値として多値で返します。i, jのデフォルト値は1で、文字列の最初1文字ということになります。</p>
<p>4～6行目は実際にファイルを開き、クエリの内容を書き込んでいます。Luaの関数 string.subを使って、関数に渡されたパケットから2バイト目以降を取り出しています。</p>
<p>余談ですが、string.sub() の 「.」 はstringインスタンスのメソッドを呼び出しているように見えますが、Luaはクラスを持ちません。 string は「テーブル」と呼ばれるいわゆる連想配列で、Lua処理系が提供する文字列関数を格納しています。 string.sub() はキー&#8221;sub&#8221;に対応して格納された関数を呼び出すという意味になります。つまり  string["sub"]() と同じ意味です。</p>
<p>MySQL Proxyを使いこなすにはLuaを理解する必要があります。とはいえ、Luaは大変理解しやすい言語なので、<a href="http://www.lua.org/manual/5.1/">Lua 5.1 Reference Manual</a>(<a href="http://sugarpot.sakura.ne.jp/yuno/html/lua51_manual_ja.html">日本語訳</a>)などにざっと目を通すだけでかなりのことができるようになるでしょう。</p>
<h3>カスタマイズできる箇所とその内容</h3>
<p>MySQL Proxyが用意している拡張のための関数は以下の7つです。各関数からアクセスできるデータなどについては<a href="http://dev.mysql.com/doc/refman/5.1/en/mysql-proxy-scripting.html">スクリプティングのリファレンスマニュアル</a>に詳しく書かれています。</p>
<h4>接続に関わる関数</h4>
<dl>
<dt>connect_server</dt>
<dd>クライアントからMySQL Proxyに接続が行われた際、バックエンドとの接続を行う前に呼び出されます。実際に接続および認証を行うサーバを選択できる唯一の場所で、落ちているとマークされているバックエンドを避けるといったことができます。ただしクライアントに関する情報は利用できません。</dd>
<dt>read_handshake</dt>
<dd>MySQL Proxyとバックエンドとの接続が行われた後、バックエンドから送り返されたハンドシェイクのための情報をクライアントに転送する前に呼び出されます。クライアントのIPなどの情報が得られる状態になっているので、IPを見て切断するといった制御ができます。</dd>
<dt>read_auth</dt>
<dd>ハンドシェイクに続き、クライアントから受けとった認証情報をバックエンドに転送する前に呼び出されます。クライアント側のユーザ名にアクセスできますが、認証が成功するのかどうかはこの時点ではわかりません。</dd>
<dt>read_auth_result</dt>
<dd>バックエンドでの認証が終了した後、バックエンドから受けとった認証結果をクライアントに通知する前に呼び出されます。認証の成否がわかるので、認証成功(失敗)後に行いたい処理を記述できます。</dd>
</dl>
<p>認証が終了したコネクションはそのままそのクライアントからのリクエストで利用してもいいですし、バックエンドと結びつけられたコネクションプールに入れて後から利用することもできます。</p>
<h4>リクエストに関わる関数</h4>
<dl>
<dt>read_query</dt>
<dd>クライアントから何らかのリクエストが送られたとき、それをバックエンドに転送する前に呼び出されます。「簡単なLuaスクリプト」で利用していたのもこの関数です。SQLを解析して書き換えたり、結果を作って返したりできます。</dd>
<dt>read_query_result</dt>
<dd>クエリ結果がバックエンドから返されたとき、それをクライアントに転送する前に呼び出されます。結果を操作したり任意の結果を返すようにすることができます。この関数は結果セットにアクセスしたい旨を前述のread_query()の中で明示的に指定しなければ呼び出されません。</dd>
</dl>
<h4>その他の関数</h4>
<dl>
<dt>disconnect_client</dt>
<dd>サーバとクライアントの接続が切断されるときに呼び出されます。実際には切断せずにコネクションをプールするといった処理を記述します。</dd>
</dl>
<h4>コネクションプールへのアクセス</h4>
<p>少し細かい話になりますが、MySQL Proxyのスクリプトで一番わかりにくいと感じたのがコネクションプールとのやりとりなので、説明を加えておきます。これは proxy.connection.backend_ndx という変数によって制御します。</p>
<p>現在利用している(バックエンドとの)コネクションをコネクションプールに入れるには、 proxy.connection.backend_ndx に0を代入します。 代入した段階でプールへの格納が行われます。</p>
<p>逆にプールにあるコネクションを利用するには、対応するバックエンドの番号 (proxy.global.backends配列の添え字) を proxy.connection.backend_ndx に代入します。 代入と同時に、プールにあるアイドルなコネクションのどれか一つが、現在のコンテキストとなっているクライアントとのコネクションに対応づけられます。</p>
<p>Lua層のこの変数への代入が、Cレベルではコネクションプールを操作する関数呼び出しを起こすような実装となっている、ということを覚えておくと多少理解しやすくなります。</p>
<h3>MySQL Proxyでできること、できないこと</h3>
<p>MySQL Proxyの用途として、サイトでは以下のようなものが例として挙げられています。</p>
<ul>
<li>負荷分散</li>
<li>フェイルオーバー(冗長化)</li>
<li>クエリの解析</li>
<li>クエリのフィルタリングや書き換え</li>
</ul>
<p>Luaでかなり自由なことができそうなのですが、現行のバージョンでは機能にいくつかの制限があり、これらを念頭に置いて使い方を考えなければなりません。</p>
<ul>
<li>Luaスクリプトが呼ばれるのはクライアントがアクションを起こしたときのみです。そのため、クライアントからの指示なしに必要な数のコネクションを作ってプールすることや、バックエンドの生死確認をアクティブに行うといったことはできません。</li>
<li>コネクションプールからのコネクションの割り当ては接続してきたユーザの権限に関係なく行われるようです。コネクションの割り当て時にCHANGE_USERコマンドで権限を変更することもできるようなのですが、期待通りの動作を確認できませんでした。そのため、権限の高いユーザと低いユーザが混在するような利用法はうまく動作しません。</li>
<li>これはコネクションプールをアプリケーションと独立に持つ場合の宿命かも知れませんが、コネクション固有の状態をうまくサポートできません。プールに入っているコネクションに固有の状態を設定しても、次にそのクライアントに対して同じコネクションが割り当てられる保証はないからです。コネクション固有の状態としては、文字エンコーディングやセッション変数、そしてテンポラリテーブルなどがあります。</li>
</ul>
<h3>R/W Splittingへの適用</h3>
<p>MySQL Proxyの利用法として、更新系と参照系のクエリをそれぞれマスタとスレーブに振り分けて負荷分散する、いわゆるR/W Splittingがあります。これが完璧に動作すれば、アプリ側での制御が不要になるため開発が楽になります。MySQL Proxyのパッケージに含まれるサンプルスクリプトの中にも rw-splitting.lua としてコンセプト実証のコードが入っています。(0.8.0に付属のものはいくつかバグがあってそのままでは動作しません。例: <a href="http://bugs.mysql.com/bug.php?id=39629">Bug #39629</a>)</p>
<p>実現方法は、認証済みのコネクションをマスタ・スレーブそれぞれに対して一定数プールしておき、クエリがきた段階で書き込みならマスタへの、読み込みならスレーブへのコネクションを使うというものです。LAST_INSERT_ID()やトランザクションに対する考慮もされています。</p>
<p>しかし、前節に書いたような制限があるため、バグを修正して使う場合でもアプリ側で以下のような注意が必要になります。</p>
<ul>
<li>文字エンコーディングなどコネクション固有になる設定はバックエンド側で一括して設定する</li>
<li>MySQL Proxy起動初期にはコネクションプールに書き込みのためのコネクションが不足することがあるため、エラー時に再接続するようアプリ側で制御する</li>
</ul>
<p>R/W Splittingについては<a href="http://forge.mysql.com/wiki/MySQL_Proxy_RW_Splitting">MySQL Proxy RW Splitting</a>に制限を含めた記載があります。</p>
<h3>まとめ</h3>
<p>以上、MySQL Proxyの機能やその制限について書いてみました。開発においてクエリを解析したり、特定の条件で書き換えたりということには利用できるレベルになっていると思います。ただ、MySQLサーバ群の手前に配置してすべてのアプリからの読み書きを分散、という使い方はまだ荷が重いようです。今後の開発に期待したいところです。</p>
]]></content>
		<link rel="replies" type="text/html" href="http://blogs.ricollab.jp/webtech/2010/04/mysql_proxy/#comments" thr:count="20" />
		<link rel="replies" type="application/atom+xml" href="http://blogs.ricollab.jp/webtech/2010/04/mysql_proxy/feed/atom/" thr:count="20" />
		<thr:total>20</thr:total>
	</entry>
		<entry>
		<author>
			<name>hamada</name>
					</author>
		<title type="html"><![CDATA[MySQLパーティショニングについて（その2：性能検証編）]]></title>
		<link rel="alternate" type="text/html" href="http://blogs.ricollab.jp/webtech/2009/11/mysql_partitioning_2/" />
		<id>http://blogs.ricollab.jp/webtech/?p=83</id>
		<updated>2009-11-30T07:38:14Z</updated>
		<published>2009-11-30T07:38:14Z</published>
		<category scheme="http://blogs.ricollab.jp/webtech" term="未分類" /><category scheme="http://blogs.ricollab.jp/webtech" term="DB" /><category scheme="http://blogs.ricollab.jp/webtech" term="MySQL" /><category scheme="http://blogs.ricollab.jp/webtech" term="partitioning" />		<summary type="html"><![CDATA[こんにちは、濱田です。
前回から時間が経ってしまいましたが、今回は「性能検証編」ということで、パーティションドテーブルに対して実際にデータを挿入・参照することでパーティショニングの性能面を検証してみようと思います。
性能検証環境
使用したマシンのスペックは以下の通りです。

OS
CentOS 5.3 32bit (on Windows XP Pro SP3 32bit via VMware Server 2.0.0)
CPU
Core2 Duo E8300 2.83GHz (VMには1CPUを割り当て)
Memory
3.25GB (VMには512MBを割り当て)

MySQL のバージョンおよび設定は以下の通りです。なお、MySQL サーバおよびクライアントは同一マシン上で動作させました。

MySQL
5.1.35-community (設定は my-medium.cnf をそのまま使用)

また、パーティションドテーブルのスキーマは以下の通りです。
CREATE TABLE logs (
    id INT NOT NULL AUTO_INCREMENT,
    client_name VARCHAR(255) NOT NULL,
    log_data VARCHAR(1024) NOT NULL,
    logged_at DATETIME NOT NULL,
 [...]]]></summary>
		<content type="html" xml:base="http://blogs.ricollab.jp/webtech/2009/11/mysql_partitioning_2/"><![CDATA[<p>こんにちは、濱田です。</p>
<p><a href="http://blogs.ricollab.jp/webtech/2009/10/mysql_partitioning_1/">前回</a>から時間が経ってしまいましたが、今回は「性能検証編」ということで、パーティションドテーブルに対して実際にデータを挿入・参照することでパーティショニングの性能面を検証してみようと思います。</p>
<h3>性能検証環境</h3>
<p>使用したマシンのスペックは以下の通りです。</p>
<dl>
<dt>OS</dt>
<dd>CentOS 5.3 32bit (on Windows XP Pro SP3 32bit via VMware Server 2.0.0)</dd>
<dt>CPU</dt>
<dd>Core2 Duo E8300 2.83GHz (VMには1CPUを割り当て)</dd>
<dt>Memory</dt>
<dd>3.25GB (VMには512MBを割り当て)</dd>
</dl>
<p>MySQL のバージョンおよび設定は以下の通りです。なお、MySQL サーバおよびクライアントは同一マシン上で動作させました。</p>
<dl>
<dt>MySQL</dt>
<dd>5.1.35-community (設定は my-medium.cnf をそのまま使用)</dd>
</dl>
<p>また、パーティションドテーブルのスキーマは以下の通りです。</p>
<pre><code>CREATE TABLE logs (
    id INT NOT NULL AUTO_INCREMENT,
    client_name VARCHAR(255) NOT NULL,
    log_data VARCHAR(1024) NOT NULL,
    logged_at DATETIME NOT NULL,
    PRIMARY KEY(id, logged_at),
    INDEX(client_name)
) ENGINE=MyISAM
PARTITION BY RANGE( TO_DAYS(logged_at) ) (
    PARTITION p200901 VALUES LESS THAN ( TO_DAYS('2009-02-01') ),
    PARTITION p200902 VALUES LESS THAN ( TO_DAYS('2009-03-01') ),
    PARTITION p200903 VALUES LESS THAN ( TO_DAYS('2009-04-01') ),
    PARTITION p200904 VALUES LESS THAN ( TO_DAYS('2009-05-01') ),
    PARTITION p200905 VALUES LESS THAN ( TO_DAYS('2009-06-01') ),
    PARTITION p200906 VALUES LESS THAN ( TO_DAYS('2009-07-01') ),
    PARTITION p200907 VALUES LESS THAN ( TO_DAYS('2009-08-01') ),
    PARTITION p200908 VALUES LESS THAN ( TO_DAYS('2009-09-01') ),
    PARTITION p200909 VALUES LESS THAN ( TO_DAYS('2009-10-01') ),
    PARTITION p200910 VALUES LESS THAN ( TO_DAYS('2009-11-01') ),
    PARTITION p200911 VALUES LESS THAN ( TO_DAYS('2009-12-01') ),
    PARTITION p200912 VALUES LESS THAN ( TO_DAYS('2010-01-01') ),
    PARTITION pmax VALUES LESS THAN MAXVALUE
);
</code></pre>
<h3>データ挿入の性能検証</h3>
<h4>検証内容</h4>
<p>データ挿入の性能検証には下記 INSERT 文を1万回連続で発行し、それに要した時間を測定しました。INSERT 文の「?」の部分には &#8216;client_1&#8242; ～ &#8216;client_1000&#8242; がそれぞれ10回ずつ入ります。（実際には上記の処理を行なう Ruby スクリプトを作成し、その実行時間を time コマンドで測定しました）</p>
<pre><code>INSERT INTO logs (client_name, log_data, logged_at) \
VALUES (?, 'test log data', '2009-11-01');
</code></pre>
<p>logs テーブルの事前条件として、以下の2パターンで測定しました。</p>
<dl>
<dt>条件1</dt>
<dd>1件もレコードが格納されていない状態</dd>
<dt>条件2</dt>
<dd>1～10月の各月に1000クライアント×1000件分のログデータ（計1000万件）が格納されている状態</p>
<ul>
<li>logged_at : 10通り (&#8217;2009-01-01&#8242; ～ &#8216;2009-10-01&#8242;)</li>
<li>client_name : 1000通り (&#8217;client_1&#8242; ～ &#8216;client_1000&#8242;)</li>
<li>上記組み合わせをそれぞれ1000件ずつ</li>
</ul>
</dd>
</dl>
<h4>検証結果</h4>
<p>結果は図1のようになりました。</p>
<div style="text-align: center;"><img style="float: none; margin-bottom: 0em;" src="http://blogs.ricollab.jp/webtech/wp-content/uploads/2009/11/result_insert_myisam.png" alt="result_insert_myisam.png" /><br />
図1 : データ挿入の性能検証結果 (MyISAM)</div>
<p></p>
<p>条件1を見ると、パーティションあり／なしで処理時間が殆ど変わっていません。これはデータ挿入時にパーティション振り分け処理のオーバーヘッドが殆どないことを示しています。今回振り分け処理に用いたパーティショニング表現は TO_DAYS(logged_at) であり、この程度の処理ではパーティション振り分けのオーバーヘッドを全く気にしなくてよいことが分かります。</p>
<p>逆に言えば、パーティショニング表現に時間のかかる処理を用いてしまうとそこがボトルネックになってしまいます。それが気になる場合は、以下のように BENCHMARK() 関数を用いて事前にパーティショニング表現の処理時間を確認しておくとよいと思います。</p>
<pre><code>mysql&gt; SELECT BENCHMARK(10000, TO_DAYS('20091101') );
+---------------------------------------+
| benchmark(10000, TO_DAYS('20091101')) |
+---------------------------------------+
|                                     0 |
+---------------------------------------+
1 row in set (<strong>0.00 sec</strong>)
</code></pre>
<p>また条件1、2での処理時間を比較すると、パーティションなしの場合は処理時間が増加しているのに対し、パーティションありの場合は処理時間が殆ど変わっていないことが分かります。これはインデックスデータがパーティション毎に独立して作成されることを示しています。今回のスキーマで作成されるインデックスは (id, logged_at) の複合インデックスと client_name ですが、このうち client_name はユニークなカラムではありません。そのため、事前に格納されているレコード数が多いほどインデックスデータ（BTREE 構造）の更新処理に時間がかかり、故にデータ挿入処理も遅くなります。</p>
<p>パーティションなしの場合に事前に0件と1000万件格納されている場合とで挿入時間に差が出ているのはそのためです。しかし、パーティションありの場合、条件2において p200911 （以降）には1件もレコードが格納されていない状態であるため、logged_at が &#8216;2009-11-01&#8242; （以降）のデータを挿入する場合はテーブルが空の場合と同じ処理時間になるのです。つまり、ログ情報のような日毎に蓄積されるデータを格納する場合、月別にパーティションを設定しておくことで、レコード数増加に伴い累積的に遅くなるデータ挿入処理の影響を一ヶ月分に抑えられることが分かります。</p>
<p>なお、ストレージエンジンを InnoDB にして同じ検証を行なってみましたが、MyISAM の場合と同様の結果になりました。（図2）</p>
<div style="text-align: center;"><img style="float: none; margin-bottom: 0em;" src="http://blogs.ricollab.jp/webtech/wp-content/uploads/2009/11/result_insert_innodb.png" alt="result_insert_innodb.png" /><br />
図2 : データ挿入の性能検証結果 (InnoDB)</div>
<h3>データ参照の性能検証</h3>
<h4>検証内容</h4>
<p>データ参照の性能検証には、MySQL クライアントから下記2パターンの SELECT 文を1回発行し、それに要した時間を測定しました。</p>
<dl>
<dt>条件1</dt>
<dd>client_name 指定なしで11月分のログデータ参照する</p>
<pre><code>SELECT * FROM logs WHERE logged_at &gt;= '2009-11-01' \
AND logged_at &lt; '2009-12-01';
</code></pre>
</dd>
<dt>条件2</dt>
<dd>client_name 指定ありで11月分のログデータ参照する</p>
<pre><code>SELECT * FROM logs WHERE logged_at &gt;= '2009-11-01' \
AND logged_at &lt; '2009-12-01' AND client_name = 'client_1';
</code></pre>
</dd>
</dl>
<p>logs テーブルの事前条件は、データ挿入の性能検証（条件2）を行なったときの状態としました。つまり、1～10月の各月に1000クライアント×1000件分のログデータが、11月に1000クライアント×10件分のログデータが格納されている状態（計1001万件）です。</p>
<h4>検証結果</h4>
<p>結果は図3のようになりました。</p>
<div style="text-align: center;"><img style="float: none; margin-bottom: 0em;" src="http://blogs.ricollab.jp/webtech/wp-content/uploads/2009/11/result_select_myisam.png" alt="result_select_myisam.png" /><br />
図3 : データ参照の性能検証結果 (MyISAM)</div>
<p></p>
<p>条件1を見ると、パーティションありの方が処理時間が劇的に速いことが分かります。これはパーティションなしでは全レコード（1001万件）を参照しているのに対し、パーティションありでは p200911 のレコード（1万件）のみを参照しているためです。これはオプティマイザが SELECT 文中のクエリ logged_at &gt;= &#8216;2009-11-01&#8242; AND logged_at &lt; &#8216;2009-12-01&#8242; から判断した結果です。理論的には検索件数が1001万から1万に減るので処理時間も1/1000になって欲しいところですが、そうなっていないのはオプティマイザの判断処理等によるオーバーヘッドの影響かもしれません。</p>
<p>なお、SELECT 文の前に EXPLAIN PARTITIONS を付けることで、参照時にアクセスするパーティションを調べることができます。（これを見るとなぜか p200912 にもアクセスしていることが分かります。なぜそうなるのかは分かりませんが…）</p>
<pre><code>mysql&gt; EXPLAIN PARTITIONS SELECT * FROM logs
    -&gt; WHERE logged_at &gt;= '2009-11-01'
    -&gt; AND logged_at &lt; '2009-12-01'\G
*************************** 1. row ***************************
           id: 1
  select_type: SIMPLE
        table: logs
   partitions: <strong>p200911,p200912</strong>
         type: ALL
possible_keys: NULL
          key: NULL
      key_len: NULL
          ref: NULL
         rows: 10010000
        Extra: Using where
</code></pre>
<p>また、条件2を見ると、インデックス併用時にもパーティションありの方が処理時間が劇的に速いことが分かります。この場合、まずオプティマイザが参照に必要なパーティションを判断し、そこからさらに該当するパーティションのインデックス情報を使って参照するデータ数を絞り込んでいるようです。ここまでいくと、データ参照のコストがほぼゼロになりました。</p>
<p>なお、ストレージエンジンを InnoDB にして同じ検証を行なってみましたが、こちらも MyISAM の場合と同様の結果になりました。（図4）</p>
<div style="text-align: center;"><img style="float: none; margin-bottom: 0em;" src="http://blogs.ricollab.jp/webtech/wp-content/uploads/2009/11/result_select_innodb.png" alt="result_select_innodb.png" /><br />
図4 : データ参照の性能検証結果 (InnoDB)</div>
<h3>まとめ</h3>
<p>本エントリでは、パーティションドテーブルに対して実際にデータを挿入・参照することでパーティショニングの性能面を検証しました。その結果、今回検証した条件ではデータ挿入・参照のいずれにおいてもパーティショニングしない場合に比べて性能が向上することが分かりました。</p>
<p>このように、パーティショニングは上手に利用すればいいことずくめとなる機能です。本エントリがパーティショニング活用に役立てれば幸いです。</p>
]]></content>
		<link rel="replies" type="text/html" href="http://blogs.ricollab.jp/webtech/2009/11/mysql_partitioning_2/#comments" thr:count="2" />
		<link rel="replies" type="application/atom+xml" href="http://blogs.ricollab.jp/webtech/2009/11/mysql_partitioning_2/feed/atom/" thr:count="2" />
		<thr:total>2</thr:total>
	</entry>
		<entry>
		<author>
			<name>hamada</name>
					</author>
		<title type="html"><![CDATA[MySQLパーティショニングについて（その1：基本知識編）]]></title>
		<link rel="alternate" type="text/html" href="http://blogs.ricollab.jp/webtech/2009/10/mysql_partitioning_1/" />
		<id>http://blogs.ricollab.jp/webtech/?p=75</id>
		<updated>2009-10-21T04:02:47Z</updated>
		<published>2009-10-21T04:02:47Z</published>
		<category scheme="http://blogs.ricollab.jp/webtech" term="未分類" /><category scheme="http://blogs.ricollab.jp/webtech" term="DB" /><category scheme="http://blogs.ricollab.jp/webtech" term="MySQL" /><category scheme="http://blogs.ricollab.jp/webtech" term="partitioning" />		<summary type="html"><![CDATA[初めまして、リコーの濱田です。このたび私も本ブログを担当することになりました。今後ともよろしくお願いいたします。
本エントリではデータベースに関する技術トピックとして、MySQL 5.1 から導入された機能であるパーティショニングについて書こうと思います。少し長くなりそうなので、「基本知識編」「性能検証編」の2回に分けて書くことにします。
今回は「基本知識編」として、パーティショニングの概要と基本的な使い方について紹介します。
パーティショニングの概要
パーティショニングとは、事前に設定されたルールに従ってデータをパーティションと呼ばれる部分的なテーブルに分割する仕組みです。
データ挿入時には、設定ルールに従ってデータが該当するパーティションに自動的に振り分けられます。データ参照時には、オプティマイザがクエリから必要なパーティションを判断し、該当するパーティションのみにアクセスします。これらは MySQL の内部で行なわれるため、データの操作においてパーティショニングを意識する必要はありません。

パーティショニングを利用することで、以下の利点が得られます。

大量のデータを処理することによる性能上のボトルネックの発生を抑えられる
テーブルサイズに上限がある場合（MyISAMなど）でも、その上限を超える量のデータを格納できる

パーティションドテーブルの作成
それでは実際にパーティションドテーブル（パーティショニングされたテーブル）を作成してみます。パーティショニングにはいくつかの種類がありますが、ここでは RANGE パーティショニングについて説明します。
パーティションドテーブルの作成は簡単で、通常のテーブル作成文の後にパーティション設定ルールの記述を追加するだけです。以下の例は、複数クライアントのログ情報を月別に分けて格納するパーティションドテーブルの作成例です。
CREATE TABLE logs (
    id INT NOT NULL AUTO_INCREMENT,
    client_name VARCHAR(32) NOT NULL,
    log_data VARCHAR(1024) NOT NULL,
    logged_at DATETIME NOT NULL,
    PRIMARY KEY(id, logged_at),
    INDEX(client_name)
) ENGINE=MyISAM
PARTITION BY RANGE( TO_DAYS(logged_at) ) (
 [...]]]></summary>
		<content type="html" xml:base="http://blogs.ricollab.jp/webtech/2009/10/mysql_partitioning_1/"><![CDATA[<p>初めまして、リコーの濱田です。このたび私も本ブログを担当することになりました。今後ともよろしくお願いいたします。</p>
<p>本エントリではデータベースに関する技術トピックとして、MySQL 5.1 から導入された機能であるパーティショニングについて書こうと思います。少し長くなりそうなので、「基本知識編」「性能検証編」の2回に分けて書くことにします。</p>
<p>今回は「基本知識編」として、パーティショニングの概要と基本的な使い方について紹介します。</p>
<h3>パーティショニングの概要</h3>
<p>パーティショニングとは、事前に設定されたルールに従ってデータをパーティションと呼ばれる部分的なテーブルに分割する仕組みです。</p>
<p>データ挿入時には、設定ルールに従ってデータが該当するパーティションに自動的に振り分けられます。データ参照時には、オプティマイザがクエリから必要なパーティションを判断し、該当するパーティションのみにアクセスします。これらは MySQL の内部で行なわれるため、データの操作においてパーティショニングを意識する必要はありません。<br />
<a href="http://blogs.ricollab.jp/webtech/wp-content/uploads/2009/10/partitioning.png"><img class="alignnone size-full wp-image-116" style="float: none" title="partitioning" src="http://blogs.ricollab.jp/webtech/wp-content/uploads/2009/10/partitioning.png" alt="partitioning" width="512" height="340" /></a><br />
パーティショニングを利用することで、以下の利点が得られます。</p>
<ul>
<li>大量のデータを処理することによる性能上のボトルネックの発生を抑えられる</li>
<li>テーブルサイズに上限がある場合（MyISAMなど）でも、その上限を超える量のデータを格納できる</li>
</ul>
<h3>パーティションドテーブルの作成</h3>
<p>それでは実際にパーティションドテーブル（パーティショニングされたテーブル）を作成してみます。パーティショニングにはいくつかの種類がありますが、ここでは RANGE パーティショニングについて説明します。</p>
<p>パーティションドテーブルの作成は簡単で、通常のテーブル作成文の後にパーティション設定ルールの記述を追加するだけです。以下の例は、複数クライアントのログ情報を月別に分けて格納するパーティションドテーブルの作成例です。</p>
<pre><code>CREATE TABLE logs (
    id INT NOT NULL AUTO_INCREMENT,
    client_name VARCHAR(32) NOT NULL,
    log_data VARCHAR(1024) NOT NULL,
    logged_at DATETIME NOT NULL,
    PRIMARY KEY(id, logged_at),
    INDEX(client_name)
) ENGINE=MyISAM
PARTITION BY RANGE( TO_DAYS(logged_at) ) (
    PARTITION p200910 VALUES LESS THAN ( TO_DAYS('2009-11-01') ),
    PARTITION p200911 VALUES LESS THAN ( TO_DAYS('2009-12-01') ),
    PARTITION p200912 VALUES LESS THAN ( TO_DAYS('2010-01-01') ),
    PARTITION pmax VALUES LESS THAN MAXVALUE
);
</code></pre>
<p>PARTITION BY RANGE 以下がパーティション設定ルールです。上記の例では p200910、p200911、p200912、pmax という名前の4つのパーティションが作成され、TO_DAYS(logged_at) の値を基にデータが各パーティションに振り分けられる設定になっています。例えば、logged_at が &#8216;2009-11-01&#8242; より小さいデータは p200910 に格納されるといった具合です。ここで、振り分けに利用される表現（上記例では TO_DAYS(logged_at) ）を「パーティショニング表現」と呼びます。</p>
<p>パーティション設定ルールの最後の行の &#8220;VALUES LESS THAN MAXVALUE&#8221; は「キャッチオール」節と呼ばれるものです。MAXVALUE は表現可能な最大整数値を表すので、logged_at が &#8216;2010-01-01&#8242; 以上となるデータは全て pmax に格納されます。これが無いと、logged_at が &#8216;2010-01-01&#8242; 以上となるデータを格納する場合にエラーが起こります。</p>
<p>なお、パーティションドテーブルの作成に際してはいくつかの制約があります。以下に代表的なものを挙げておきます。</p>
<ul>
<li> パーティショニング表現に用いられるカラムはテーブル内に存在するプライマリキー（またはユニークキー）の一部でなければならない
<ul>
<li>プライマリキー（またはユニークキー）が存在しない場合は例外</li>
</ul>
</li>
<li>パーティション表現は連続した整数値をとるものでなければならない
<ul>
<li>日付データを利用する場合、TO_DAYS() 関数などを使って整数値に直す必要がある</li>
</ul>
</li>
<li>作成できるパーティションの上限は1テーブルにつき1024個</li>
</ul>
<h3>パーティションの追加</h3>
<p>既存のパーティションドテーブルから更にパーティションを追加する方法は2つあります。</p>
<ul>
<li>ADD PARTITION を使って新規パーティションを追加する方法</li>
<li>REORGANIZE PARTITION を使って既存のパーティションを再分割する方法</li>
</ul>
<p>ただし、既存のパーティションドテーブルに「キャッチオール」節が存在する場合は後者の方法しか選択肢がありません。</p>
<p>以下にそれぞれの方法について説明します。</p>
<h4>ADD PARTITION を使う方法</h4>
<p>既存のパーティションドテーブルにパーティションを新規追加するには以下のようにします。</p>
<pre><code>ALTER TABLE logs ADD PARTITION (
    PARTITION p201001 VALUES LESS THAN ( TO_DAYS('2010-02-01') )
);
</code></pre>
<p>注意点として、RANGE パーティショニングされているテーブルにおいて、ADD PARTITION は既存パーティションの「後」にしかパーティション追加ができません（「前」や「間」はNGです）。そのため、「キャッチオール」節（MAXVALUE）が既に存在する場合は（MAXVALUE より後の値は存在し得ないため）、この方法が使えません。</p>
<h4>REORGANIZE PARTITION を使う方法</h4>
<p>既存のパーティションを再分割するには以下のようにします。この例では、pmax を p201001 と、（新しい） pmax に再分割しています。</p>
<pre><code>ALTER TABLE logs REORGANIZE PARTITION pmax INTO (
    PARTITION p201001 VALUES LESS THAN ( TO_DAYS('2010-02-01') ),
    PARTITION pmax VALUES LESS THAN MAXVALUE
);
</code></pre>
<p>REORGANIZE PARTITION を行なうと、既存のデータが再分割後のパーティションに適切に振り分けられます。例えば上記の例では、旧 pmax に格納されていたデータのうち logged_at が &#8216;2009-02-01&#8242; より小さいものは p201001 に、&#8217;2009-02-01&#8242; 以上のものは 新 pmax に格納されます。この再振り分け処理により、既存データが大量にある場合は REORGANIZE PARTITION の実行にそれなりの時間がかかります。</p>
<p>REORGANIZE PARTITION は、既存パーティションの結合にも利用できます。例えば、p200910 と p200911 を結合したい場合は以下のようにします。</p>
<pre><code>ALTER TABLE logs REORGANIZE PARTITION p200910, p200911 INTO (
    PARTITION p200910_11 VALUES LESS THAN ( TO_DAYS('2009-12-01') )
);
</code></pre>
<p>さらに、既存の複数パーティションを新しい複数パーティションに再構成することもできます。</p>
<pre><code>ALTER TABLE logs REORGANIZE PARTITION p200910, p200911, p200911, pmax INTO (
    PARTITION p200909_10 VALUES LESS THAN ( TO_DAYS('2009-11-01') ),
    PARTITION p200911_12 VALUES LESS THAN ( TO_DAYS('2010-01-01') ),
    PARTITION pmax VALUES LESS THAN MAXVALUE
);
</code></pre>
<h3>パーティションの削除</h3>
<p>パーティションドテーブルから特定のパーティションを削除するには、以下のようにしてパーティションごと DROP します。</p>
<pre><code>ALTER TABLE logs DROP PARTITION p200912;
</code></pre>
<p>上記の例では、パーティション p200912 および p200912 に格納されているデータが全て削除されます。また、上記例の実行前に p200910、p200911、p200912、pmax のパーティションがあった場合、p200912 が削除されたことで logged_at が ‘2009-12-01′ 以上となるデータは全て pmax に格納されるようになります。</p>
<p>パーティションの削除は内部的にテーブルの DROP とほぼ同じであるため、（ストレージエンジンが MyISAM や InnoDB の場合であれば）格納されているデータ件数によらず一瞬で処理が完了します。</p>
<h3>パーティショニングの解除</h3>
<p>パーティションドテーブルからパーティションを取り除き、通常のテーブルにするには以下のようにします。</p>
<pre><code>ALTER TABLE logs REMOVE PARTITIONING;
</code></pre>
<p>DROP PARTITION とは異なり、各パーティションに格納されているデータは削除されません。各パーティションのデータを一つのテーブルにマージするため、既存データが大量にある場合は REMOVE PARTITIONING の実行にそれなりの時間がかかります。</p>
<h3>まとめ</h3>
<p>本エントリでは、MySQL 5.1 から導入された機能であるパーティショニングについて概要を説明し、RANGE パーティショニングによるパーティションドテーブルの作成、パーティションの追加・削除、パーティショニングの解除方法について具体例を交えて説明しました。RANGE パーティショニング以外のパーティショニング方法などパーティショニングについてより深く知りたい方は、<a href="http://dev.mysql.com/doc/refman/5.1/ja/partitioning.html">MySQL 5.1 リファレンスマニュアル :: 15 パーティショニング</a> を一読されると良いと思います。</p>
<p>次回のエントリでは、パーティションドテーブルに対して実際にデータを挿入・参照することでパーティショニングの性能面を検証してみようと思います。お楽しみに！</p>
]]></content>
		<link rel="replies" type="text/html" href="http://blogs.ricollab.jp/webtech/2009/10/mysql_partitioning_1/#comments" thr:count="0" />
		<link rel="replies" type="application/atom+xml" href="http://blogs.ricollab.jp/webtech/2009/10/mysql_partitioning_1/feed/atom/" thr:count="0" />
		<thr:total>0</thr:total>
	</entry>
		<entry>
		<author>
			<name>umehara</name>
					</author>
		<title type="html"><![CDATA[進化する携帯電話]]></title>
		<link rel="alternate" type="text/html" href="http://blogs.ricollab.jp/webtech/2009/10/android/" />
		<id>http://blogs.ricollab.jp/webtech/?p=70</id>
		<updated>2009-10-15T03:16:14Z</updated>
		<published>2009-10-15T03:16:14Z</published>
		<category scheme="http://blogs.ricollab.jp/webtech" term="未分類" /><category scheme="http://blogs.ricollab.jp/webtech" term="android" /><category scheme="http://blogs.ricollab.jp/webtech" term="google" /><category scheme="http://blogs.ricollab.jp/webtech" term="mobile" />		<summary type="html"><![CDATA[はじめまして。リコーの梅原です。今回から私もブログを書くことになりました。宜しくお願いします。私の一つ目のエントリーは、Androidについて書こうと思います。
Android携帯
国内初のAndroid搭載端末HT-03Aが2009年7月にNTT docomoから発売されました。皆様ご存知でしょうか？
海外でもMotorola CLIQ、HTC Hero、LG-GW62等の端末が続々とリリースされていて、最近ではDellもAndroid搭載のスマートフォンを発売すると報道されています。Android端末が世界中で増えつつありますね。
実は私もHT-03Aの購入者の一人なのですが、携帯電話の変更連絡を友人や家族にしたときに、多くの人から「何それ？」と言われてしまいました。いやいや、これは今までに無い素晴らしい携帯電話なんです。
今回は、私が感じたAndroid携帯の魅力を3つに絞って皆様にお伝えできればと思います。
魅力1　携帯電話もリアルタイムの世界へ
まずAndroid携帯を使っていて驚かされる事はデータの同期および通知がリアルタイムであるということです。
一つ目のデータの同期とはGmail、アドレス帳、Google Calendar等のアプリケーションのローカルデータとGoogleのクラウド上にあるデータがリアルタイムに同期するということです。
今までの同期といえば、デバイスとPCをUSBでつないで・・・、という面倒な作業が頭をよぎりますが、何もしなくてもインターネット経由で勝手に同期してくれます。例えば、携帯電話で作成しているメールの内容をリアルタイムにPCで確認することができます。これなら携帯電話で作成した文書を途中からPCで編集！ってことも簡単です。他にもPCでアドレス帳を編集したり顔写真を追加したりしていると、気がついたときには携帯電話にデータ・画像が反映されています。データの同期がリアルタイムであるというメリットはおわかりいただけたでしょうか。
二つ目のデータの通知というのは、Gmail、GTalk、Twitter等の複数のアプリケーションからリアルタイムにデータが通知されるということです。
これはAndroidの特徴でもある「マルチタスク」が威力を発揮しています。例えば、Gmailでメールを作成しているときに、GTalkからのメッセージ受信通知、Twitterの発言通知、アプリケーションのアップデート通知等々、ありとあらゆる情報がどんどん通知されてきて、それが容易にタスクバーで把握可能です。
今までの携帯電話では考えられない世界だと思いませんか？Googleはリアルタイムな通信基盤を構築しようとしています。Androidはその一部です。この周辺技術を理解していくとリアルタイム通信というのが重要であることがわかるので、関連するChrome OSやGoogle Waveも紹介したいところですが、紙面の都合で次回以降に回します。
魅力2　オープンな携帯電話
次の魅力はAndroidがオープンソース、ロイヤリティーフリーであるということです。
Androidは携帯電話のためのものだけではありません。Androidはフルスタックソフトウェアであり、OS、ミドルウェア、アプリケーションフレームワークをモバイル機器（組み込み機器）向けに提供しているのです。メーカーは携帯電話をはじめとするモバイル機器を開発し、その上で動くアプリケーションを3rdパーティーが開発することが可能になるというわけです。
携帯電話だけでなく、情報家電、車載機器、セットトップボックス等がAndroidへの新しいプラットフォームへ移行することで、OSのロイヤリティがかからない上に機器による開発環境の違いも吸収できることになります。エミュレーターも充実しているので開発コストも低く抑えられることでしょう。そして言語はJava。私はJavaが好きなのでかなり魅力を感じています（笑）。
「How Android works: The big picture」の記事のAndroidのシステムアーキテクチャを見てみると、Web開発者であればご存知の「WebKit」や「SQLite」を初めとするライブラリとアプリケーションフレームワークがありとても魅力的です。携帯電話の開発といえばDoja、MIDP、starプロファイルが頭をよぎるのですが、自由度や機能面でいうと全然違います。「All application are created equal」というように、電話帳アプリケーションだって置きかえられるくらいの高い自由度を備えてます。もちろんユーザインタフェースはiPhoneにはまだまだ及びませんが、洗練されたUIを作る事も可能でしょう。
これはAndroidプラットフォームの魅力のほんの一部です。これからどんどん新しい端末がローコストで出てくるのが楽しみですね。
魅力3　強力なアプリケーション
AndroLib.comの統計によると2009年10月1日現在、約1万2000本のアプリケーションが登録されています。統計を見ると面白いですね。毎日約50もの新しいアプリケーションが生まれています。
そして、未完成の携帯電話をどんどん自分に最適な機能を持つアプリケーションをインストールしてカスタマイズしていくわけです。今までの携帯電話より愛着が湧きますよね。アプリケーションは新着やランキングを見て気に入ったアプリケーションをインストールするのが一番良いと思います。
最後に私の愛用しているアプリケーションの一部を紹介して終わりにしたいと思います。Android携帯をお持ちの方はこのアプリをインストールしてみてください。
・OpenWnnフリック入力対応版　フリック入力に対応しており、素早く文字入力が可能です。最近は絵文字入力に対応しています。（標準だと絵文字入力はできないんです）
・Any Cut、UltimateFaves　　さまざまなショートカットを作成できます
・PicSay　　画像編集ならこれが便利です
・e電話帳　今までの携帯電話の検索に近い形になるので重宝しています
・QR我風　　自分の連絡先のQRコードを作成できます
・路線ドロイド　　乗り換え案内はこれを使っています
・WiFi OnOff　　WiFiの切り替えを簡単にすることができます
]]></summary>
		<content type="html" xml:base="http://blogs.ricollab.jp/webtech/2009/10/android/"><![CDATA[<p>はじめまして。リコーの梅原です。今回から私もブログを書くことになりました。宜しくお願いします。私の一つ目のエントリーは、<a title="Android" href="http://www.android.com/" id="cl6q">Android</a>について書こうと思います。</p>
<h2>Android携帯</h2>
<p>国内初のAndroid搭載端末<a title="HT-03A" href="http://www.nttdocomo.co.jp/product/foma/pro/ht03a/" id="clza">HT-03A</a>が2009年7月にNTT docomoから発売されました。皆様ご存知でしょうか？</p>
<p>海外でも<a title="Motorola CLIQ" href="http://www.motorola.com/Consumers/US-EN/Consumer-Product-and-Services/Mobile-Phones/Motorola-CLIQ-US-EN" id="ng6n">Motorola CLIQ</a>、<a title="HTC Hero" href="http://www.htc.com/www/product/hero" id="u4se">HTC Hero</a>、<a title="LG-GW62" href="http://www.lge.com/about/press_release/detail/21912.jhtml" id="v7o6">LG-GW62</a>等の端末が続々とリリースされていて、最近ではDellもAndroid搭載のスマートフォンを発売すると報道されています。Android端末が世界中で増えつつありますね。</p>
<p>実は私もHT-03Aの購入者の一人なのですが、携帯電話の変更連絡を友人や家族にしたときに、多くの人から「何それ？」と言われてしまいました。いやいや、これは今までに無い素晴らしい携帯電話なんです。</p>
<p>今回は、私が感じたAndroid携帯の魅力を3つに絞って皆様にお伝えできればと思います。</p>
<h3>魅力1　携帯電話もリアルタイムの世界へ</h3>
<p>まずAndroid携帯を使っていて驚かされる事は<b>データの同期および通知がリアルタイム</b>であるということです。</p>
<p>一つ目のデータの同期とはGmail、アドレス帳、Google Calendar等のアプリケーションのローカルデータとGoogleのクラウド上にあるデータがリアルタイムに同期するということです。</p>
<p>今までの同期といえば、デバイスとPCをUSBでつないで・・・、という面倒な作業が頭をよぎりますが、何もしなくてもインターネット経由で勝手に同期してくれます。例えば、携帯電話で作成しているメールの内容をリアルタイムにPCで確認することができます。これなら携帯電話で作成した文書を途中からPCで編集！ってことも簡単です。他にもPCでアドレス帳を編集したり顔写真を追加したりしていると、気がついたときには携帯電話にデータ・画像が反映されています。データの同期がリアルタイムであるというメリットはおわかりいただけたでしょうか。</p>
<p>二つ目のデータの通知というのは、Gmail、GTalk、Twitter等の複数のアプリケーションからリアルタイムにデータが通知されるということです。</p>
<p>これはAndroidの特徴でもある「マルチタスク」が威力を発揮しています。例えば、Gmailでメールを作成しているときに、GTalkからのメッセージ受信通知、Twitterの発言通知、アプリケーションのアップデート通知等々、ありとあらゆる情報がどんどん通知されてきて、それが容易にタスクバーで把握可能です。</p>
<p>今までの携帯電話では考えられない世界だと思いませんか？Googleはリアルタイムな通信基盤を構築しようとしています。Androidはその一部です。この周辺技術を理解していくとリアルタイム通信というのが重要であることがわかるので、関連する<a title="Chrome OS" href="http://en.wikipedia.org/wiki/Google_Chrome_OS" id="e5ii">Chrome OS</a>や<a title="Google Wave" href="http://wave.google.com" id="y5ez">Google Wave</a>も紹介したいところですが、紙面の都合で次回以降に回します。</p>
<h3>魅力2　オープンな携帯電話</h3>
<p>次の魅力はAndroidが<b>オープンソース、ロイヤリティーフリー</b>であるということです。</p>
<p>Androidは携帯電話のためのものだけではありません。Androidはフルスタックソフトウェアであり、OS、ミドルウェア、アプリケーションフレームワークをモバイル機器（組み込み機器）向けに提供しているのです。メーカーは携帯電話をはじめとするモバイル機器を開発し、その上で動くアプリケーションを3rdパーティーが開発することが可能になるというわけです。</p>
<p>携帯電話だけでなく、情報家電、車載機器、セットトップボックス等がAndroidへの新しいプラットフォームへ移行することで、OSのロイヤリティがかからない上に機器による開発環境の違いも吸収できることになります。エミュレーターも充実しているので開発コストも低く抑えられることでしょう。そして言語はJava。私はJavaが好きなのでかなり魅力を感じています（笑）。</p>
<p>「<a href="http://blogs.zdnet.com/Burnette/?p=515">How Android works: The big picture</a>」の記事のAndroidのシステムアーキテクチャを見てみると、Web開発者であればご存知の「<a title="WebKit" href="http://webkit.org/" id="yhfg">WebKit</a>」や「<a title="SQLite" href="http://www.sqlite.org/" id="pc4y">SQLite</a>」を初めとするライブラリとアプリケーションフレームワークがありとても魅力的です。携帯電話の開発といえばDoja、MIDP、starプロファイルが頭をよぎるのですが、自由度や機能面でいうと全然違います。「All application are created equal」というように、電話帳アプリケーションだって置きかえられるくらいの高い自由度を備えてます。もちろんユーザインタフェースはiPhoneにはまだまだ及びませんが、洗練されたUIを作る事も可能でしょう。</p>
<p>これはAndroidプラットフォームの魅力のほんの一部です。これからどんどん新しい端末がローコストで出てくるのが楽しみですね。</p>
<h3>魅力3　強力なアプリケーション</h3>
<p><a title="AndroLib.com" href="http://www.androlib.com/appstats.aspx" id="muec">AndroLib.com</a>の統計によると2009年10月1日現在、<b>約1万2000本</b>のアプリケーションが登録されています。統計を見ると面白いですね。毎日約50もの新しいアプリケーションが生まれています。</p>
<p>そして、未完成の携帯電話をどんどん自分に最適な機能を持つアプリケーションをインストールしてカスタマイズしていくわけです。今までの携帯電話より愛着が湧きますよね。アプリケーションは<a title="新着" href="http://jp.androlib.com/android.application-news.aspx" id="b9x4">新着</a>や<a title="ランキング" href="http://jp.androlib.com/topofday.aspx" id="ssj6">ランキング</a>を見て気に入ったアプリケーションをインストールするのが一番良いと思います。</p>
<p>最後に私の愛用しているアプリケーションの一部を紹介して終わりにしたいと思います。<br />Android携帯をお持ちの方はこのアプリをインストールしてみてください。</p>
<p>・<a title="OpenWnnフリック入力対応版" href="http://jp.androlib.com/android.application.com-pm9-flickwnn-jEnE.aspx" id="ao_s">OpenWnnフリック入力対応版</a><br />　フリック入力に対応しており、素早く文字入力が可能です。最近は絵文字入力に対応しています。（標準だと絵文字入力はできないんです）</p>
<p>・<a title="Any Cut" href="http://jp.androlib.com/android.application.com-appdroid-anycut-jpBC.aspx" id="y115">Any Cut</a>、<a title="UltimateFaves" href="http://jp.androlib.com/android.application.com-anddev-applications-ultimatefaves-qwnB.aspx" id="mkk2">UltimateFaves</a>　<br />　さまざまなショートカットを作成できます</p>
<p>・<a title="PicSay" href="http://jp.androlib.com/android.application.com-shinycore-picsayfree-wit.aspx" id="n6x6">PicSay</a>　<br />　画像編集ならこれが便利です</p>
<p>・<a title="e電話帳" href="http://jp.androlib.com/android.application.esoft-contacts-BBF.aspx" id="q085">e電話帳</a><br />　今までの携帯電話の検索に近い形になるので重宝しています</p>
<p>・<a title="QR我風" href="http://jp.androlib.com/android.application.exec-android-blow-qrmeprofile-jBCD.aspx" id="biag">QR我風</a>　<br />　自分の連絡先のQRコードを作成できます</p>
<p>・<a title="路線ドロイド" href="http://jp.androlib.com/android.application.net-uhmaro-android-rosen-jAzA.aspx" id="z-nu">路線ドロイド</a>　<br />　乗り換え案内はこれを使っています</p>
<p>・<a title="WiFi OnOff" href="http://jp.androlib.com/android.application.com-curvefish-widgets-wifionoff-jAjE.aspx" id="sue9">WiFi OnOff</a>　<br />　WiFiの切り替えを簡単にすることができます</p>
]]></content>
		<link rel="replies" type="text/html" href="http://blogs.ricollab.jp/webtech/2009/10/android/#comments" thr:count="2" />
		<link rel="replies" type="application/atom+xml" href="http://blogs.ricollab.jp/webtech/2009/10/android/feed/atom/" thr:count="2" />
		<thr:total>2</thr:total>
	</entry>
		<entry>
		<author>
			<name>okitan</name>
					</author>
		<title type="html"><![CDATA[Mock と Stub について]]></title>
		<link rel="alternate" type="text/html" href="http://blogs.ricollab.jp/webtech/2009/09/mock_and_stub/" />
		<id>http://blogs.ricollab.jp/webtech/?p=67</id>
		<updated>2009-09-24T02:18:12Z</updated>
		<published>2009-09-24T02:18:12Z</published>
		<category scheme="http://blogs.ricollab.jp/webtech" term="未分類" /><category scheme="http://blogs.ricollab.jp/webtech" term="rr" /><category scheme="http://blogs.ricollab.jp/webtech" term="ruby" /><category scheme="http://blogs.ricollab.jp/webtech" term="test" />		<summary type="html"><![CDATA[初めまして、リコーの沖田です。この度私もこの blog を書くことになりました。以後よろしくお願いいたします。
みなさんテストは好きですか？私も含めて私の同僚は皆テストが大好きなので、しばしばテストの議論で白熱しすぎてしまいます。今日はそのテストの中から Mock（モック） と Stub（スタブ） について書いてみたいと思います。
Test Double
まずテストにおける Mock と Stub についてですが、これらは Test Double という概念の一部です。Double とは代役という意味で、テスト対象となるシステムが依存する外部のコンポーネントの代わりに、それらしく振舞ってくれるコンポーネントを代役として利用しようということです。
例えば Web アプリの Controller の単体テストがしたい場合に、Model の実装が完了するまでテストができないっていうのでは大変ですよね。そこで、Model の Mock や Stub を利用することにより、Model の影響を受けることなく、Controller の単体テストだけに専念することができます。
このように Test Double を利用することで、依存を排除し、テストを効率良く作成・実行することができます。
Test Double についての詳細は「xUnit Test Patterns(Gerard Meszaros, 2007)」という本や
http://xunitpatterns.com/Test%20Double.html
に書いてあります。なお、Mock と Stub 以外にも Spy, Fake, Dummy 等の Test Double もあるとのことです。
Mock と Stub の違い
さて、では Mock と Stub の違いはなんでしょうか。
先ほどの Test [...]]]></summary>
		<content type="html" xml:base="http://blogs.ricollab.jp/webtech/2009/09/mock_and_stub/"><![CDATA[<p>初めまして、リコーの沖田です。この度私もこの blog を書くことになりました。以後よろしくお願いいたします。</p>
<p>みなさんテストは好きですか？私も含めて私の同僚は皆テストが大好きなので、しばしばテストの議論で白熱しすぎてしまいます。今日はそのテストの中から Mock（モック） と Stub（スタブ） について書いてみたいと思います。</p>
<h3>Test Double</h3>
<p>まずテストにおける Mock と Stub についてですが、これらは Test Double という概念の一部です。Double とは代役という意味で、テスト対象となるシステムが依存する外部のコンポーネントの代わりに、それらしく振舞ってくれるコンポーネントを代役として利用しようということです。</p>
<p>例えば Web アプリの Controller の単体テストがしたい場合に、Model の実装が完了するまでテストができないっていうのでは大変ですよね。そこで、Model の Mock や Stub を利用することにより、Model の影響を受けることなく、Controller の単体テストだけに専念することができます。</p>
<p>このように Test Double を利用することで、依存を排除し、テストを効率良く作成・実行することができます。</p>
<p>Test Double についての詳細は「xUnit Test Patterns(Gerard Meszaros, 2007)」という本や<br />
<a href="http://xunitpatterns.com/Test%20Double.html">http://xunitpatterns.com/Test%20Double.html</a><br />
に書いてあります。なお、Mock と Stub 以外にも Spy, Fake, Dummy 等の Test Double もあるとのことです。</p>
<h3>Mock と Stub の違い</h3>
<p>さて、では Mock と Stub の違いはなんでしょうか。</p>
<p>先ほどの Test Double の定義では、Mock はテスト時の呼び出しの仕様をあらわしたもので、Stub はテスト時の呼び出しに対して決められた値を返すものです。</p>
<p>これを単に Mock は呼び出しの verification をして、Stub はそれをしないと認識してしまうと、どのようにして Mock と Stub を使い分けるかわからなくなってしまいます。さらにいえば、Mock と Stub が区別されている理由さえわからなくなります。</p>
<p>Mock と Stub の違いはテストの観点の違いです。相互作用（振る舞い）中心のテストに利用するのがMockで、状態中心のテストに利用するのがStubです。</p>
<p>相互作用中心のテストとはテスト対象のシステムと外部のコンポーネントとの間で正しいやり取りがされるかのテスト、いわばプロトコルのテストです。外部のコンポーネントは Mock により置き換えられ、システムから正しい呼び出しがなされているかを監視します。<br />
したがって、例えばWebアプリの Controller の単体テストにおいて相互作用中心のテストが正しく行われてパスしているならば、Model が正しく実装された時に Controller が正しく動作するということが、Model が実装されなくても保障されます。</p>
<p>一方状態中心のテストとはテスト対象のシステムが正しい結果を返すかというテストです。したがって、最終的に返ってくる結果だけが重要なのですが、その過程において外部のシステムとの統合が面倒な時に Stub を利用してテストを簡単にします。なので、 Stub は信頼できる外部のコンポーネント（例えばDBとかLDAPとか）に対して適応するといいと思います。</p>
<h3>相互作用中心のテストと状態中心のテスト</h3>
<p>さて相互作用中心のテストと状態中心のテスト2種類の観点でのテストが出てきましたが、どちらのテストをやればよいのでしょうか？ 結論からいうと両方やるべきです。</p>
<p>例えば BDD(Behavior Driven Development) では、その名前から振る舞いすなわち相互作用中心のテストだけをやればいいと錯覚してしまいます。たしかに Mock を利用して振る舞いの仕様を作成するのが BDD での spec 作成の大半を占めます。しかし、仕様書の観点からすると、振る舞いすなわちアルゴリズムだけの記述だけでは不十分で、入出力の例が書いてある必要があります。その入出力例を記述するのが状態中心のテストなので、両方やるべきなのです。</p>
<p>もちろん、コンポーネント毎に相互作用中心のテストと状態中心のテストのどちらに比重をおくべきかを考えることが重要になるわけですが。</p>
<h3>RR(Double Ruby)</h3>
<p>さて Mock を使った RSpec のテストを実際に書いてみようと思います。RSpec には標準で Mock が用意されているのですが、今回は <a href="http://github.com/btakita/rr/tree/master">RR(Double Ruby)</a> というライブラリを利用してSinatraで作る blog のテストを書いてみようと思います。（記事の都合上基本的な Sinatra, RSpec, DataMapper の説明は省略しています）</p>
<p>まず RSpec の Mock を RR の Mock で置き換える設定をします。これで rspec の Mock が RRの Mock に置き換えられます。また、Sinatra のテストをするため、Rack::Test::Methods を include しています。</p>
<pre><code>Spec::Runner.configure do |config|
  config.include Rack::Test::Methods
  config.mock_with :rr
end</code></pre>
<p>次に、&#8217;/posts/1&#8242; にアクセスすると、DataMapper により ID が 1 の記事が読み込まれ、その article が表示されるという仕様を書いてみます。</p>
<pre><code>describe '/posts/:id' do
  it 'should load Posts with id' do
    mock(Post).get!('1') { mock(Post.new).article { 'article of 1' } }
    get('/posts/1')
    last_response.body.should == 'article of 1'
  end
end</code></pre>
<p>Post は DataMapper で作成した Model です。その Post の Mock に対して get! が呼ばれることを verification しています。中括弧の中は article が呼ばれた時の返り値を指定しています。では、このテストが落ちることを確認したら実装をします。</p>
<pre><code>def '/posts/:id' do
  post = Post.get!(params[:id])
  post.article
end</code></pre>
<p>実装後テストをしてみると、実際にDBに値を入れなくても（DBの状態にかかわらず）テストが通ります。前述したように外部への依存がなく効率の良いテストができる ことが実感できます。</p>
<p>ちなみに RSpec の Mock を利用する場合はこのようにかけます。</p>
<pre><code>Post.should_receive(:get!).with('1')\
  .and_return mock(:article =&gt; 'article of 1')</code></pre>
<p>RR の方が実際のコードに近く、かつ短く書けるので素敵です。さらにいえば mock(Post.new) の部分を Machinist を利用して</p>
<pre><code>Post.make_unsaved(:article =&gt; 'article of 1')</code></pre>
<p>と書くとさらに素敵なのですが、Machinist については次回以降ということにします。</p>
<p>また、私の同僚が RR は RSpec に比べて matcher の機能が足りない部分があるので、既存の rspec での Mock を RR に置き換える時に困ることがあると言っていました。そこで RSpec と RR(0.10.2) の matcher を見比べたところ例えば hash_including という matcher で差異が見られました。</p>
<p>RSpec の matcher では hash_including は</p>
<pre><code>Foo.should_receive(:color).with(:red, :blue =&gt; false)</code></pre>
<p>のように Hash の key の存在確認と key value の組み合わせの両方が指定できます。<br />
一方、RR では</p>
<pre><code>mock(Foo).color(:red =&gt; true, :blue =&gt; false)</code></pre>
<p>のように key value の組み合わせでしか指定できません。</p>
<p>これの解決には例えば satisfy という matcher を利用するか、RR::WildcardMatchers::HashIncluding.wildcard_match? を書き換えるかすればいいと思います。ここでは、satisfy を利用する例を紹介しておこうと思います。</p>
<pre><code>def hash_has_keys(*args)
  satisfy do |hash|
    args.all? do |arg|
      arg.is_a?(Hash) ? arg.all? {|k, v| hash[k] == v } : hash.has_key?(arg)
    end
  end
end</code></pre>
<p>これを以下のような感じで hash_including という matcherの代わりに利用すれば、</p>
<pre><code>mock(Foo).color(hash_has_keys(:red, {:blue =&gt; false, :yellow =&gt; false}))</code></pre>
<p>RSpec の hash_including と同様に使えます。</p>
<p>ただし、こうすると matcher が失敗した場合に、</p>
<pre><code>unexpected method invocation:
  color({:red=&gt;true, :green=&gt;false, :blue=&gt;false})
expected invocations:
- color(satisfy {block}) </code></pre>
<p>と表示されてエラーメッセージがいまいちわかりにくくなってしまうので注意してください。</p>
<p>長くなりましたので、最後にまとめますと、本エントリでは</p>
<ul>
<li>Test Doubleの定義に基づく Mock と Stub の違い</li>
<li>Mock を利用する相互作用中心のテストと Stub を利用することができる状態中心のテストの使い分け</li>
<li>相互作用中心のテストを RR の Mock を使って書く例および RR の tips</li>
</ul>
<p>について説明しました。</p>
]]></content>
		<link rel="replies" type="text/html" href="http://blogs.ricollab.jp/webtech/2009/09/mock_and_stub/#comments" thr:count="0" />
		<link rel="replies" type="application/atom+xml" href="http://blogs.ricollab.jp/webtech/2009/09/mock_and_stub/feed/atom/" thr:count="0" />
		<thr:total>0</thr:total>
	</entry>
		<entry>
		<author>
			<name>yohei</name>
						<uri>http://</uri>
					</author>
		<title type="html"><![CDATA[モダンなXML出力方法について]]></title>
		<link rel="alternate" type="text/html" href="http://blogs.ricollab.jp/webtech/2009/08/output_methods_for_modern_xml_documents/" />
		<id>http://blogs.ricollab.jp/webtech/2009/08/output_methods_for_modern_xml_documents/</id>
		<updated>2009-08-18T06:18:43Z</updated>
		<published>2009-08-18T03:34:09Z</published>
		<category scheme="http://blogs.ricollab.jp/webtech" term="未分類" /><category scheme="http://blogs.ricollab.jp/webtech" term="xml" />		<summary type="html"><![CDATA[XHTML2は残念なことになってしまいましたが、HTML5にしろフィードにしろ、XML構文が重要なことにはかわりのない昨今みなさんいかがお過しですか。ずいぶんとエントリの間隔が空いてしまって申し訳ありません。
さて、XMLの出力には

to_xml()のようなメソッドを呼ぶ
RubyのBuilderのようなDSLを使う
テンプレートエンジンを使う
手書き

などの方法が考えられますが、今回の本題はこれらの方法によって生成される最終的なXML文書(インスタンス)はどう表現されるべきか、についてです。
エンコーディングはUTF-8で
これはもう説明不要ですね。UTF-8が処理できない環境というのは本当に少くなりました。モバイルや組込み等でどうしても対応できない場合以外はUTF-8を使うのが望ましいと思います。
実体参照の件
実体参照というのはXML内で文書の一部に名前を付けて再利用する仕組です。たとえば「&#38;」という文字(文字はXML文書を構成する最小単位です)を出力するときは、XML文書に直接記述することができないので「&#38;amp;」とエスケープします。XML仕様では&#38;や&#60;など5種類の実体参照がビルトインで定義されていますが(これを定義済み実体と呼びます)、DTDを使うことで自分で好きな実体参照を定義することもできます。たとえばハートマーク(&#9829;)を出すために「&#38;hearts;」と書くというのはよく知られているでしょう。この「&#38;hearts;」という実体参照はHTMLのDTDで定義されています。
HTMLのDTDで定義されている実体参照を使うためには、DOCTYPE宣言(「&#60;!DOCTYPE」で始まるものです)でHTML/XHTMLのDTDを読み込まなければなりません。HTMLで定義されている実体参照は個別のファイルで定義されているので(例)、特にHTMLでない文書型を使う場合でもこれを個別に読み込めばHTMLで定義されている実体参照を使うこともできます。
しかし、モダンなXML文書ではDOCTYPE宣言を付けないものもあります。たとえばAtom仕様にはDTDがありません。仕様にDTDがないとしても、DOCTYPE宣言を付けることは可能ですが、通常のライブラリはAtomフィードを出力するときにDOCTYPE宣言を付けないのが一般的です。
このような場合にハート記号を使いたくなったらどうすればいいのでしょうか。まずはその文字を直接入力できないか考えてみましょう。ハート記号を表示するのにわざわざ実体参照を使う必然性はないのです。エンコーディングがUTF-8であれば、その文字をそのまま出力すればよいでしょう。
もし何らかの理由でどうしても直接入力したくない場合は、実体参照を使うのではなく数値文字参照を使うのがよいでしょう。たとえばハート記号は&#38;#9829;です。
xml:baseは使わずに絶対URIを利用する
xml:base属性を使うと相対URIを解決するための基底URIを設定できるのですが、
これをきちんと解釈してくれないクライアントやライブラリがいるのも事実です。
なので、ハイパーリンクとしてURIを埋め込むときには、たとえ同じサイト上
のリンクでも絶対URI(「http://」で始まるURI)を使うのがよいでしょう。
]]></summary>
		<content type="html" xml:base="http://blogs.ricollab.jp/webtech/2009/08/output_methods_for_modern_xml_documents/"><![CDATA[<p>XHTML2は残念なことになってしまいましたが、HTML5にしろフィードにしろ、XML構文が重要なことにはかわりのない昨今みなさんいかがお過しですか。ずいぶんとエントリの間隔が空いてしまって申し訳ありません。</p>
<p>さて、XMLの出力には</p>
<ul>
<li>to_xml()のようなメソッドを呼ぶ</li>
<li>RubyのBuilderのようなDSLを使う</li>
<li>テンプレートエンジンを使う</li>
<li>手書き</li>
</ul>
<p>などの方法が考えられますが、今回の本題はこれらの方法によって生成される最終的なXML文書(インスタンス)はどう表現されるべきか、についてです。</p>
<h3>エンコーディングはUTF-8で</h3>
<p>これはもう説明不要ですね。UTF-8が処理できない環境というのは本当に少くなりました。モバイルや組込み等でどうしても対応できない場合以外はUTF-8を使うのが望ましいと思います。</p>
<h3>実体参照の件</h3>
<p>実体参照というのはXML内で文書の一部に名前を付けて再利用する仕組です。たとえば「&amp;」という文字(文字はXML文書を構成する最小単位です)を出力するときは、XML文書に直接記述することができないので「&amp;amp;」とエスケープします。XML仕様では&amp;や&lt;など5種類の実体参照がビルトインで定義されていますが(これを定義済み実体と呼びます)、DTDを使うことで自分で好きな実体参照を定義することもできます。たとえばハートマーク(&#9829;)を出すために「&amp;hearts;」と書くというのはよく知られているでしょう。この「&amp;hearts;」という実体参照は<a href="http://www.asahi-net.or.jp/~SD5A-UCD/rec-html401j/sgml/entities.html">HTMLのDTD</a>で定義されています。</p>
<p>HTMLのDTDで定義されている実体参照を使うためには、DOCTYPE宣言(「&lt;!DOCTYPE」で始まるものです)でHTML/XHTMLのDTDを読み込まなければなりません。HTMLで定義されている実体参照は個別のファイルで定義されているので(<a href="http://www.w3.org/TR/2000/REC-xhtml1-20000126/DTD/xhtml-special.ent">例</a>)、特にHTMLでない文書型を使う場合でもこれを個別に読み込めばHTMLで定義されている実体参照を使うこともできます。</p>
<p>しかし、モダンなXML文書ではDOCTYPE宣言を付けないものもあります。たとえばAtom仕様にはDTDがありません。仕様にDTDがないとしても、DOCTYPE宣言を付けることは可能ですが、通常のライブラリはAtomフィードを出力するときにDOCTYPE宣言を付けないのが一般的です。</p>
<p>このような場合にハート記号を使いたくなったらどうすればいいのでしょうか。まずはその文字を直接入力できないか考えてみましょう。ハート記号を表示するのにわざわざ実体参照を使う必然性はないのです。エンコーディングがUTF-8であれば、その文字をそのまま出力すればよいでしょう。</p>
<p>もし何らかの理由でどうしても直接入力したくない場合は、実体参照を使うのではなく数値文字参照を使うのがよいでしょう。たとえばハート記号は&amp;#9829;です。</p>
<h3>xml:baseは使わずに絶対URIを利用する</h3>
<p>xml:base属性を使うと相対URIを解決するための基底URIを設定できるのですが、<br />
これをきちんと解釈してくれないクライアントやライブラリがいるのも事実です。<br />
なので、ハイパーリンクとしてURIを埋め込むときには、たとえ同じサイト上<br />
のリンクでも絶対URI(「http://」で始まるURI)を使うのがよいでしょう。</p>
]]></content>
		<link rel="replies" type="text/html" href="http://blogs.ricollab.jp/webtech/2009/08/output_methods_for_modern_xml_documents/#comments" thr:count="3" />
		<link rel="replies" type="application/atom+xml" href="http://blogs.ricollab.jp/webtech/2009/08/output_methods_for_modern_xml_documents/feed/atom/" thr:count="3" />
		<thr:total>3</thr:total>
	</entry>
		<entry>
		<author>
			<name>StL</name>
						<uri>http://</uri>
					</author>
		<title type="html"><![CDATA[第一回 ライブドア テクニカルセミナーに参加しました]]></title>
		<link rel="alternate" type="text/html" href="http://blogs.ricollab.jp/webtech/2009/03/livedoor_technical_seminor_1/" />
		<id>http://blogs.ricollab.jp/webtech/2009/03/livedoor_technical_seminor_1/</id>
		<updated>2009-03-04T05:12:25Z</updated>
		<published>2009-03-04T05:12:25Z</published>
		<category scheme="http://blogs.ricollab.jp/webtech" term="未分類" /><category scheme="http://blogs.ricollab.jp/webtech" term="livedoor" /><category scheme="http://blogs.ricollab.jp/webtech" term="seminor" />		<summary type="html"><![CDATA[日野原です。
週をまたいでしまいましたが、先週末にlivedoor主催のテクニカルセミナーに参加してきました。
検索するとすでにいろいろな方のレポートが見つけられますね。月曜日は別に片付けなくてはいけない仕事があったので相当出遅れてしまいました。やっぱり週末に清書しておけば良かったかと反省しております。…いや、休日に仕事しちゃいけません。ああ悩ましい。
ということで、あまり遅くなってもつまらないのでセミナー中に取っていたメモを整形だけしてスピード優先で掲載します。
後日発表資料が公開されたら、資料と一緒に見ていただけるとよりわかりやすいかと思います。
なお、私が聞いて解釈したとおりに書いているので、間違ったことが書いてあっても発表内容が間違っていたとは限りませんので察してください。指摘をいただけるとさらに幸いです。
セミナーは社員の方の発表はバックエンドの話が中心で、非常におもしろかったです。また、ゲスト講演はWinnyの金子さんとその弁護団事務局長の壇さんで、普段聞けないような話が聞けて刺激的でした。
ただ、壇さんの講演に関しては専門外の法律の話である上に、普通の文字量のプレゼン資料を「高橋メソッド風に（本人談）」進められてしまったのでメモを取る方も追いつけず、十分な報告ができません。申し訳ありません。

開会の挨拶(伊勢さん）
Practical Cicindela 実践ちちんでら（井原さん）
ライブドアブログ公式攻撃マニュアル（井原さん）
インサイド livedoor Blog（垣内さん）
ライブドアのネットワークとトラフィックパターン（市川さん）
P2Pコンテンツ配信技術の現状（金子さん）
デジタルコンテンツ配信の法的問題（壇さん）
閉会の挨拶（出澤さん）

開会の挨拶
livedoor テクニカルセミナー 2009  Open &#38; Share
株式会社ライブドア技術部会
司会 伊勢さん
足下の悪い中ありがとうございます。
アンケートにご協力ください。
「Open &#38; Share」だから撮影や録音はご自由にどうぞ。でもうるさくて迷惑なのはやめてください。
ブログに書いてもオーケーです。
ちなみにねとらじで生中継中なので、質問などオフレコにしたければその旨言ってください。
何かあったら黒いストラップの社員まで。
「Practical Cicindela 実践ちちんでら」
メディア事業部 ブログビジネスユニット 井原さん
最近edgeラボで公開したレコメンデーションエンジン。
実際に運用中で実践経験豊富なので、その運用例を紹介する。
井原さんは「ちちんでら」と呼んでいるけれど、社内では「ししんでら」と呼ばれている。
レコメンデーションは脇役なので、応答速度が重要。
新しいデータがすぐに反映されるかも重要なので夜間バッチ処理とかはよくない。
その辺を考慮した作りになっている。
入力はいったんバッファに入れられ、バッチ処理で一次テーブルに入る。
これは入力の処理を軽くするためで、一次テーブルに後からいろいろ情報を足していく。
集計はできる限りバッチでやって中間集計テーブルを作る。
その後、現在使用中のテーブルと中間集計テーブルをrenameして入れ替える。
応答時間は平均数ミリ秒、ちょっと複雑な処理でも20～30ミリ秒で返すことができている。
livedoorクリップでの事例
一日1万2千件くらいの記事がクリップされる。
ひとつのページに4、5件のクリップがついたころが一番見られるので、そのころまでにレコメンドを準備する。
最新1時間、通常のレコメンド（このページをクリップした人はこのページもクリップしています）、タグを考慮したレコメンド（このタグはこのページにも付いています）の3段階に分けてレコメンドを作る。
「～のトップページ」とか、いかにもクリップされがちなページはレコメンドしない。
同人ダウンロード販売サイトでの事例
同人ダウンロード販売サイトではレーティングに基づいたレコメンドや、独特の配慮をしている。
たとえばほかの作家を薦めすぎないとか、一般向け商品のページで成人向け商品を薦めないとか。
レーティングの得点を正規化したり、フィルタリングをしたりという処理が入る。
レコメンド経由の販売が4%くらいあるらしい。
you bride（結婚情報サービス）での事例
アクションをまったくしない人同士をつなげる工夫をしている。
たとえば、「Eさんを選んでいる男性はDさんを選んでいる」のほかに、「同じ属性の同姓が選んでいる異性と、同じ属性の異性」を薦める。
具体的には、何もアクションを起こさないCさんと同じような属性の人たちが選んだ女性Eさんと同じ属性のFさんをCさんに薦める。
この方式の採用により申し込みが6.5%アップ、交際率が2～4%アップした。
ストレートなレコメンドを採用したときには3割とか1割とか上がってるので、それに比べると地味だけど。
伊勢さんより補足。
livedoorのedge ラボで公開しているから使ってね!
質疑

Aさん

 中間結果の数は制限かけているか?

フィルタリングのときにパフォーマンスの目的でlimitをかけることはある。


ランダム要素はあるか?

レコメンドの結果にランダム要素はないけれど、10件出た中からランダムで2件薦めるとかで一見ランダムに見える工夫はしている。




Bさん

ニュースのおすすめに使ってる。apacheのログベースでやっているけどドキュメントがまだ無い。

ごめんなさい。


IPアドレスをユーザとしてみているけど、なんかいいやり方は無いか?

mod_usertrackでcookieベースでやっている。これだとcookieが文字列で入ってくるが、それをintに変換して性能向上の工夫をしている。


特にモバイルだとIPが同じになるが何か良い方法はないか。

モバイルではやってないので「こうすればいい」というのはない。アプリ側でセッションIDを使うとかするのかな。


HTTPだと遅いかと思ってDB直でたたこうとしてるけど、どうしてる？

livedoorでもHTTPでやっている。





「ライブドアブログ公式攻撃マニュアル」
引き続き井原さん。
2chのコピペブログへの無差別DOS攻撃があった際、社内勉強会で話した内容から。
2008/3/7 22:00攻撃が開始された。
しかしすでに対策済みで、10秒くらい連続アクセスするとアク禁になるようにしてあった。
そのとき、LDブログチームは送別会中だった。
結果、2chでほめられた。
どうすれば落ちるかの部分は社外秘のため発表できません！
まとめ

 ブログでお金儲けたっていいじゃないか。
 livedoorのブログサーバはそんなに簡単に落ちるほど単純じゃない。

伊勢さんより補足。
去年の2008/07号の日経SYSTEMSでコラムになっているので読んでください。
「インサイド livedoor Blog」
メディア事業部 ブログビジネスユニット 垣内さん
agenda

サーバ構成
apache独自モジュール
管理画面
新サービス

2003年11月オープンで、5年ちょっと経つ。
キャッシュとかを抜いて16TBのデータがある。
サーバ構成
構成図をこんなに細かく出していいのかな。
（発表資料が無いとこのあたりは意味不明です、すみません）
この構成図からは検索サーバ等は省いてる。
CMSは管理画面
portal/cmsはlivedoor標準な構成になっている
blog側（攻撃をうけやすいところ）
blog-wwwではApache2.2 mod_ldblog_mapper2 mod_include (SSI)を使っている。
blog-app  （コメント、トラバを受ける場所）
apache2.2 mod_proxy_balancerも使っている。後はsledge。
DB
mysql
user-cluster DB
user単位のパーティショニングで1～2万ユーザ×150クラスタ。
クラスタリングは手動で、運用でカバーしている。
ストレージ
商用でNFSマウント。
DBの内容をhtmlに変換した静的ファイルをキャッシュとしておいてる。
イメージストレージ
容量を安く増やすために自作している。
WebDAVでアクセスする。
どのサーバに何のファイルがあるかをapache + 自作module + mysqlで解決している。
解決の部分とかreplicationはapache moduleだから強い。
ほかのサービスで新版を試験運用中。
サーバ構成のまとめ

 OSはBSDとかLinuxとかばらばら。
 回数の多い処理はmoduleにして性能を上げている。

独自モジュール
mod_counter
画像カウンタ。
mod_ldblog_mapper2
URLからNFSマウントされたストレージのパスを計算する。
memcachedやDBから引いた結果を環境変数に入れている。
キャッシュがあれば mod_rewrite でキャッシュに飛び、無ければblog-appに行く。
キャッシュがあればほとんどApacheで完結するのでDDOS攻撃とかに強い。
ストレージに入った画像はgzipで圧縮されるけれど、その辺もの処理もフロントでやっている。
静的ファイルキャッシュについて
htmlファイルを全部いっぺんにキャッシュしてしまうとよく変更される部分（新着記事、新着コメント）にキャッシュ再構築の頻度が依存する。
→個別ファイルにしてmod_includeでSSIしている。
キャッシュの再構築はファイルを消すだけ。作るのはアクセスがあったとき。
お知らせメールなどqueueの必要な処理には、TheSchwartzを使っている。
新管理画面
今までEUC-JPだったのをUTF-8にした。
蓄積データも新規ユーザはUTF-8。
文字コード多重化
blog単位でcharsetを切り替えられる様になっている。
マルチブログで二つのblogを持ってる場合、EUCとUTF-8と共存したりできる。
複雑になったので、ORMでアクセサを切り替える仕組みを仕込んだ。
URL変更
シングルサインオンをlivedoor.comと分離するのが目的。
OpenID連携にした。
新サービスの準備のため。
新サービス
livedoor Blog ASP
ブログのドメイン名を変えられる。
既存のlivedoor Blogのいろいろな機能と素直に連携できるのが売り。
OpenIDについて
RPをやるわけではないが、裏で使っている。
AXでいろいろ情報を交換している。sregではなくAXを使ったのは、sregだとuser_idをうまく取れなかったため。
IEのURL長の制限の対策もしている。
パートナー募集中。
質疑

Cさん

画像のサーバが別になっていることに関して、blogと一緒に投稿された画像には公開範囲の限定があると思うけど、mod_accesstokenを使っているか？

blogではmod_accesstokenは使ってない。


mod_accesstokenの導入事例はある？

コスプレサイトのCure
会社で見るときには注意してください。ファンクラブに登録すると効果がわかります。




Dさん

守るマニュアル教えてください。

資料中にもあったように、10秒の連続アクセスで防御される（mod_dos_detectorみたいなもの）
他にはYAPC ASIA2008 で発表したスパムチャンプルーも使ってる。
詳細には言えない。ごめんなさい。




伊勢さん

blog ASPはいつから？

4月から





「ライブドアのネットワークとトラフィックパターン」
ネットワーク事業部コアネットワークグループ 市川さん
agenda

DATAHOTEL（データセンター）ネットワーク概要
iDC ISPの立場から見た傾向
最近の話題
IPv6

概要
DATAHOTELではiDC（データセンター）、公衆無線LAN、企業向けISP（ライブドアBB）とトランジットサービスをやっている。
サービスごとに別に接続してるのでどれかに障碍があってもほかには影響しない。
DATAHOTEL内の冗長化はメッシュ型だが、ライブドアBBは拠点が離れてて難しいのでリング型になっている。
トラフィックの傾向
一般的なプロバイダのトラフィックはユーザへの下りがメイン。
平日

 20時から始まり24時がピークで、そこから減少。
 朝のメールチェック時に小さなピークがある。
 昼休みにもちょっとピーク。

休日

 [...]]]></summary>
		<content type="html" xml:base="http://blogs.ricollab.jp/webtech/2009/03/livedoor_technical_seminor_1/"><![CDATA[<p>日野原です。</p>
<p>週をまたいでしまいましたが、先週末にlivedoor主催のテクニカルセミナーに参加してきました。<br />
検索するとすでにいろいろな方のレポートが見つけられますね。月曜日は別に片付けなくてはいけない仕事があったので相当出遅れてしまいました。やっぱり週末に清書しておけば良かったかと反省しております。…いや、休日に仕事しちゃいけません。ああ悩ましい。<br />
ということで、あまり遅くなってもつまらないのでセミナー中に取っていたメモを整形だけしてスピード優先で掲載します。<br />
後日発表資料が公開されたら、資料と一緒に見ていただけるとよりわかりやすいかと思います。<br />
なお、私が聞いて解釈したとおりに書いているので、間違ったことが書いてあっても発表内容が間違っていたとは限りませんので察してください。指摘をいただけるとさらに幸いです。</p>
<p>セミナーは社員の方の発表はバックエンドの話が中心で、非常におもしろかったです。また、ゲスト講演はWinnyの金子さんとその弁護団事務局長の壇さんで、普段聞けないような話が聞けて刺激的でした。</p>
<p>ただ、壇さんの講演に関しては専門外の法律の話である上に、普通の文字量のプレゼン資料を「高橋メソッド風に（本人談）」進められてしまったのでメモを取る方も追いつけず、十分な報告ができません。申し訳ありません。</p>
<ul>
<li><a href="#opening">開会の挨拶(伊勢さん）</a></li>
<li><a href="#cicindela">Practical Cicindela 実践ちちんでら（井原さん）</a></li>
<li><a href="#attack_manual">ライブドアブログ公式攻撃マニュアル（井原さん）</a></li>
<li><a href="#inside_livedoor_blog">インサイド livedoor Blog（垣内さん）</a></li>
<li><a href="#traffic">ライブドアのネットワークとトラフィックパターン（市川さん）</a></li>
<li><a href="#p2p">P2Pコンテンツ配信技術の現状（金子さん）</a></li>
<li><a href="#law">デジタルコンテンツ配信の法的問題（壇さん）</a></li>
<li><a href="#ending">閉会の挨拶（出澤さん）</a></li>
</ul>
<h3 id="opening">開会の挨拶</h3>
<p>livedoor テクニカルセミナー 2009  Open &amp; Share<br />
株式会社ライブドア技術部会</p>
<p>司会 伊勢さん<br />
足下の悪い中ありがとうございます。</p>
<p>アンケートにご協力ください。</p>
<p>「Open &amp; Share」だから撮影や録音はご自由にどうぞ。でもうるさくて迷惑なのはやめてください。<br />
ブログに書いてもオーケーです。<br />
ちなみに<a href="http://ladio.net/src/8rNd">ねとらじ</a>で生中継中なので、質問などオフレコにしたければその旨言ってください。<br />
何かあったら黒いストラップの社員まで。</p>
<h3 id="cicindela">「Practical Cicindela 実践ちちんでら」</h3>
<p>メディア事業部 ブログビジネスユニット 井原さん</p>
<p>最近edgeラボで公開したレコメンデーションエンジン。<br />
実際に運用中で実践経験豊富なので、その運用例を紹介する。</p>
<p>井原さんは「ちちんでら」と呼んでいるけれど、社内では「ししんでら」と呼ばれている。</p>
<p>レコメンデーションは脇役なので、応答速度が重要。<br />
新しいデータがすぐに反映されるかも重要なので夜間バッチ処理とかはよくない。<br />
その辺を考慮した作りになっている。</p>
<p>入力はいったんバッファに入れられ、バッチ処理で一次テーブルに入る。<br />
これは入力の処理を軽くするためで、一次テーブルに後からいろいろ情報を足していく。<br />
集計はできる限りバッチでやって中間集計テーブルを作る。<br />
その後、現在使用中のテーブルと中間集計テーブルをrenameして入れ替える。</p>
<p>応答時間は平均数ミリ秒、ちょっと複雑な処理でも20～30ミリ秒で返すことができている。</p>
<h4>livedoorクリップでの事例</h4>
<p>一日1万2千件くらいの記事がクリップされる。<br />
ひとつのページに4、5件のクリップがついたころが一番見られるので、そのころまでにレコメンドを準備する。</p>
<p>最新1時間、通常のレコメンド（このページをクリップした人はこのページもクリップしています）、タグを考慮したレコメンド（このタグはこのページにも付いています）の3段階に分けてレコメンドを作る。</p>
<p>「～のトップページ」とか、いかにもクリップされがちなページはレコメンドしない。</p>
<h4>同人ダウンロード販売サイトでの事例</h4>
<p>同人ダウンロード販売サイトではレーティングに基づいたレコメンドや、独特の配慮をしている。<br />
たとえばほかの作家を薦めすぎないとか、一般向け商品のページで成人向け商品を薦めないとか。</p>
<p>レーティングの得点を正規化したり、フィルタリングをしたりという処理が入る。</p>
<p>レコメンド経由の販売が4%くらいあるらしい。</p>
<h4>you bride（結婚情報サービス）での事例</h4>
<p>アクションをまったくしない人同士をつなげる工夫をしている。</p>
<p>たとえば、「Eさんを選んでいる男性はDさんを選んでいる」のほかに、「同じ属性の同姓が選んでいる異性と、同じ属性の異性」を薦める。</p>
<p>具体的には、何もアクションを起こさないCさんと同じような属性の人たちが選んだ女性Eさんと同じ属性のFさんをCさんに薦める。</p>
<p>この方式の採用により申し込みが6.5%アップ、交際率が2～4%アップした。</p>
<p>ストレートなレコメンドを採用したときには3割とか1割とか上がってるので、それに比べると地味だけど。</p>
<h4>伊勢さんより補足。</h4>
<p>livedoorのedge ラボで<a href="http://labs.edge.jp/cicindela/">公開している</a>から使ってね!</p>
<h4>質疑</h4>
<ul>
<li>Aさん
<ul>
<li> 中間結果の数は制限かけているか?
<ul>
<li>フィルタリングのときにパフォーマンスの目的でlimitをかけることはある。</li>
</ul>
</li>
<li>ランダム要素はあるか?
<ul>
<li>レコメンドの結果にランダム要素はないけれど、10件出た中からランダムで2件薦めるとかで一見ランダムに見える工夫はしている。</li>
</ul>
</li>
</ul>
</li>
<li>Bさん
<ul>
<li>ニュースのおすすめに使ってる。apacheのログベースでやっているけどドキュメントがまだ無い。
<ul>
<li>ごめんなさい。</li>
</ul>
</li>
<li>IPアドレスをユーザとしてみているけど、なんかいいやり方は無いか?
<ul>
<li>mod_usertrackでcookieベースでやっている。これだとcookieが文字列で入ってくるが、それをintに変換して性能向上の工夫をしている。</li>
</ul>
</li>
<li>特にモバイルだとIPが同じになるが何か良い方法はないか。
<ul>
<li>モバイルではやってないので「こうすればいい」というのはない。アプリ側でセッションIDを使うとかするのかな。</li>
</ul>
</li>
<li>HTTPだと遅いかと思ってDB直でたたこうとしてるけど、どうしてる？
<ul>
<li>livedoorでもHTTPでやっている。</li>
</ul>
</li>
</ul>
</li>
</ul>
<h3 id="attack_manual">「ライブドアブログ公式攻撃マニュアル」</h3>
<p>引き続き井原さん。</p>
<p>2chのコピペブログへの無差別DOS攻撃があった際、社内勉強会で話した内容から。</p>
<p>2008/3/7 22:00攻撃が開始された。</p>
<p>しかしすでに対策済みで、10秒くらい連続アクセスするとアク禁になるようにしてあった。</p>
<p>そのとき、LDブログチームは送別会中だった。</p>
<p>結果、2chでほめられた。</p>
<p>どうすれば落ちるかの部分は社外秘のため発表できません！</p>
<p>まとめ</p>
<ul>
<li> ブログでお金儲けたっていいじゃないか。</li>
<li> livedoorのブログサーバはそんなに簡単に落ちるほど単純じゃない。</li>
</ul>
<h4>伊勢さんより補足。</h4>
<p>去年の2008/07号の日経SYSTEMSでコラムになっているので読んでください。</p>
<h3 id="inside_livedoor_blog">「インサイド livedoor Blog」</h3>
<p>メディア事業部 ブログビジネスユニット 垣内さん</p>
<p>agenda</p>
<ul>
<li>サーバ構成</li>
<li>apache独自モジュール</li>
<li>管理画面</li>
<li>新サービス</li>
</ul>
<p>2003年11月オープンで、5年ちょっと経つ。<br />
キャッシュとかを抜いて16TBのデータがある。</p>
<h4>サーバ構成</h4>
<p>構成図をこんなに細かく出していいのかな。<br />
（発表資料が無いとこのあたりは意味不明です、すみません）<br />
この構成図からは検索サーバ等は省いてる。<br />
CMSは管理画面</p>
<p>portal/cmsはlivedoor標準な構成になっている</p>
<p>blog側（攻撃をうけやすいところ）<br />
blog-wwwではApache2.2 mod_ldblog_mapper2 mod_include (SSI)を使っている。</p>
<p>blog-app  （コメント、トラバを受ける場所）<br />
apache2.2 mod_proxy_balancerも使っている。後はsledge。</p>
<p>DB<br />
mysql<br />
user-cluster DB<br />
user単位のパーティショニングで1～2万ユーザ×150クラスタ。<br />
クラスタリングは手動で、運用でカバーしている。</p>
<p>ストレージ<br />
商用でNFSマウント。<br />
DBの内容をhtmlに変換した静的ファイルをキャッシュとしておいてる。</p>
<p>イメージストレージ<br />
容量を安く増やすために自作している。<br />
WebDAVでアクセスする。<br />
どのサーバに何のファイルがあるかをapache + 自作module + mysqlで解決している。<br />
解決の部分とかreplicationはapache moduleだから強い。<br />
ほかのサービスで新版を試験運用中。</p>
<p>サーバ構成のまとめ</p>
<ul>
<li> OSはBSDとかLinuxとかばらばら。</li>
<li> 回数の多い処理はmoduleにして性能を上げている。</li>
</ul>
<h4>独自モジュール</h4>
<p>mod_counter<br />
画像カウンタ。</p>
<p>mod_ldblog_mapper2<br />
URLからNFSマウントされたストレージのパスを計算する。<br />
memcachedやDBから引いた結果を環境変数に入れている。<br />
キャッシュがあれば mod_rewrite でキャッシュに飛び、無ければblog-appに行く。<br />
キャッシュがあればほとんどApacheで完結するのでDDOS攻撃とかに強い。<br />
ストレージに入った画像はgzipで圧縮されるけれど、その辺もの処理もフロントでやっている。</p>
<p>静的ファイルキャッシュについて<br />
htmlファイルを全部いっぺんにキャッシュしてしまうとよく変更される部分（新着記事、新着コメント）にキャッシュ再構築の頻度が依存する。<br />
→個別ファイルにしてmod_includeでSSIしている。</p>
<p>キャッシュの再構築はファイルを消すだけ。作るのはアクセスがあったとき。</p>
<p>お知らせメールなどqueueの必要な処理には、TheSchwartzを使っている。</p>
<h4>新管理画面</h4>
<p>今までEUC-JPだったのをUTF-8にした。<br />
蓄積データも新規ユーザはUTF-8。</p>
<p>文字コード多重化<br />
blog単位でcharsetを切り替えられる様になっている。<br />
マルチブログで二つのblogを持ってる場合、EUCとUTF-8と共存したりできる。<br />
複雑になったので、ORMでアクセサを切り替える仕組みを仕込んだ。</p>
<p>URL変更<br />
シングルサインオンをlivedoor.comと分離するのが目的。<br />
OpenID連携にした。<br />
新サービスの準備のため。</p>
<h4>新サービス</h4>
<p>livedoor Blog ASP</p>
<p>ブログのドメイン名を変えられる。<br />
既存のlivedoor Blogのいろいろな機能と素直に連携できるのが売り。</p>
<p>OpenIDについて<br />
RPをやるわけではないが、裏で使っている。</p>
<p>AXでいろいろ情報を交換している。sregではなくAXを使ったのは、sregだとuser_idをうまく取れなかったため。</p>
<p>IEのURL長の制限の対策もしている。</p>
<p>パートナー募集中。</p>
<h4>質疑</h4>
<ul>
<li>Cさん
<ul>
<li>画像のサーバが別になっていることに関して、blogと一緒に投稿された画像には公開範囲の限定があると思うけど、mod_accesstokenを使っているか？
<ul>
<li>blogではmod_accesstokenは使ってない。</li>
</ul>
</li>
<li>mod_accesstokenの導入事例はある？
<ul>
<li>コスプレサイトの<a href="http://ja.curecos.com/">Cure</a></li>
<li>会社で見るときには注意してください。ファンクラブに登録すると効果がわかります。</li>
</ul>
</li>
</ul>
</li>
<li>Dさん
<ul>
<li>守るマニュアル教えてください。
<ul>
<li>資料中にもあったように、10秒の連続アクセスで防御される（mod_dos_detectorみたいなもの）</li>
<li>他にはYAPC ASIA2008 で発表したスパムチャンプルーも使ってる。</li>
<li>詳細には言えない。ごめんなさい。</li>
</ul>
</li>
</ul>
</li>
<li>伊勢さん
<ul>
<li>blog ASPはいつから？
<ul>
<li>4月から</li>
</ul>
</li>
</ul>
</li>
</ul>
<h3 id="traffic">「ライブドアのネットワークとトラフィックパターン」</h3>
<p>ネットワーク事業部コアネットワークグループ 市川さん</p>
<p>agenda</p>
<ul>
<li>DATAHOTEL（データセンター）ネットワーク概要</li>
<li>iDC ISPの立場から見た傾向</li>
<li>最近の話題</li>
<li>IPv6</li>
</ul>
<h4>概要</h4>
<p>DATAHOTELではiDC（データセンター）、公衆無線LAN、企業向けISP（ライブドアBB）とトランジットサービスをやっている。</p>
<p>サービスごとに別に接続してるのでどれかに障碍があってもほかには影響しない。</p>
<p>DATAHOTEL内の冗長化はメッシュ型だが、ライブドアBBは拠点が離れてて難しいのでリング型になっている。</p>
<h4>トラフィックの傾向</h4>
<p>一般的なプロバイダのトラフィックはユーザへの下りがメイン。<br />
平日</p>
<ul>
<li> 20時から始まり24時がピークで、そこから減少。</li>
<li> 朝のメールチェック時に小さなピークがある。</li>
<li> 昼休みにもちょっとピーク。</li>
</ul>
<p>休日</p>
<ul>
<li> 昼の12時から増え始めて24～25時がピーク。</li>
</ul>
<p>P2Pのトラフィック</p>
<ul>
<li> 上りと下りがほぼ同じ。</li>
<li> livedoorでは帯域制限は基本的にかけていない。</li>
</ul>
<p>iDC（データセンター）のトラフィック</p>
<ul>
<li> ISPと逆になる。</li>
<li> ピークになる時間帯は同じ。</li>
</ul>
<p>ルータのメンテナンスをするのはトラフィックの落ち込む2時から5時くらい。</p>
<p>休日は一日中ネットをやっているユーザが多いらしい。<br />
「土日」じゃなくて「休日」。</p>
<h5>トラフィックの例：コンテンツダウンロード販売系のラック</h5>
<p>「これがピーク」と言う時間帯が無い。一番少ない時間帯でもそこそこの量が流れている。<br />
アキバ系は強い。<br />
ピークで1G弱。</p>
<h5>トラフィックの例：ポータル系のトラフィック</h5>
<p>livedoor Blog</p>
<ul>
<li> 0時過ぎの落ち方が緩やか。ユーザに夜更かしする若者が多いのか?</li>
</ul>
<p>livedoor ねとらじ</p>
<ul>
<li> お昼休みピークが無い。</li>
<li> 就業時間後にまた下がる。</li>
<li> 仕事中にBGMとして聴いてるのかな?</li>
<li> 夜に最大値を迎えるのは変わらない。</li>
</ul>
<h4>インターネットのトピック</h4>
<p>1/31～2/1にかけてGoogleが正常なサイトをフィッシングと誤認する障碍が発生したが、livedoorのトラフィックにはほとんど影響はなかった。</p>
<p>年末年始、12/31～1/1には夜中の大きなピークが無い。0時前後に「あけおめ」書き込みか？という小さなピークがある程度。</p>
<p>2/17 01:30～02:30ごろにインターネットに障害。<br />
上位回線で回線が切断されたりしたらしい。<br />
livedoorの上流では幸い影響なかったが、インターネットって意外と脆弱だという印象を受けた。</p>
<h4>IPv6に関して</h4>
<p>実験だからお客さんには出してないが、WIDEとつながっている。</p>
<p>２ちゃんのIPv6板を運用している。IPv6がreachableな人は書き込みができるから書いてみてください。</p>
<p>IPv6のトラフィックは少ない。20kとか1Mとか、バックボーンでは考えられない量。</p>
<p>Tokyo6to4というprojectに参加してみてね。</p>
<h4>伊勢さんより補足</h4>
<ul>
<li>ネットユーザって初詣行くんだね。意外と信心深いのかな。</li>
<li>DLサイト、平日は少なくて休日は多いってことから同人ファンはサラリーマンが多いってのがわかるね。</li>
</ul>
<h4>質疑</h4>
<ul>
<li>伊勢さん
<ul>
<li>18:00-20:00のトラフィックの落ち込みの原因はわかる?
<ul>
<li>ご飯?</li>
</ul>
</li>
<li>正解。「飯落ち」と呼ばれる現象。</li>
<li>blogのトラフィックってお昼にキューンとあがる。みんな見ているんですね。</li>
</ul>
</li>
</ul>
<h3 id="p2p">「P2Pコンテンツ配信技術の現状」</h3>
<p>金子さん</p>
<p>自己紹介<br />
（株） Dreamboat 技術顧問<br />
コンテンツ配信システムSkeedCastの開発中。</p>
<p>agenda</p>
<ul>
<li>P2Pの紹介</li>
<li>WinnyとSkeedCast</li>
<li>SkeedCast</li>
</ul>
<h4>P2Pの紹介</h4>
<p>P2P（型ファイル共有ソフト）の発展<br />
第一世代 Napsterなど<br />
→ハイブリッド（P2Pなのはデータ転送のみ）<br />
第二世代 Gnuteraなど<br />
→pure P2P（検索もP2P）<br />
第三世代 Winnyなど<br />
→キャッシュ型（転送キャッシュ）<br />
第四世代<br />
→商用（P2P教科書（インプレス）による）<br />
インプレスによる分類は技術的な分類ではない。<br />
金子さんによると第四世代にはSkeedCastやWinny2が該当し、ノード群をサーバとみなしてクラサバ的挙動をする</p>
<h4>Winny→SkeedCast</h4>
<p>Winny1<br />
→ファイル共有ソフト<br />
Winny2<br />
→もっと汎用的なものを目指した。BBSをP2Pでやる。BBS部分だけ第4世代的。</p>
<p>Winny2ははるかな高みを目指していた。<br />
Winny1の落穂ひろいにWinny2の要素を入れていったのがSkeedCast</p>
<h4>SkeedCastの特徴</h4>
<p>P2Pノードがサーバになる→分散サーバとP2Pのハイブリッド</p>
<p>Winnyにも速度による上下関係はあったが、SkeedCastではもっっとノードの役割を意識している。</p>
<p>アップローダ（投入ノード)、中継（共有ノード)、ダウンローダ（レシーバ）の3つがあり、ダウンローダは中継もできる。</p>
<p>投入ノードは課金とかDRMとかを考えてる。<br />
共有ノードはUNIX、レシーバはWindowsで動く。</p>
<p>共有ノードはコントロールノードからコントロール可能。<br />
キャッシュコントロールとか。<br />
ある人気コンテンツを優先的にキャッシュに入れるとかもできる。</p>
<p>P2Pは不安定という弱点があるので、サーバのトラフィックが予定外に増えすぎたときにユーザノードを中継ノードとして動かしてしのげる。P2Pのいいところ。</p>
<p>SkeedCastはファイル共有ではなくコンテンツ配信のシステムなので、普段はCDN的に動作して、サーバが大変なときにP2P的に動作して凌ぐ。</p>
<p>特徴<br />
Winnyはハッシュを多用していたが、SkeedCastは代わりにデジタル署名を多用する。<br />
ホワイトリストのフィルタリングやキャッシュのライフタイム管理に使う。</p>
<p>コンテンツにデジタル署名をする。<br />
コンテンツプロバイダが秘密鍵を持ち、流通段階で署名をチェックして問題があれば流通させないといったコントロールが可能。<br />
公開鍵をホワイトリストとして使う（後述）</p>
<p>流通フィルタリング<br />
Winnyはダウンロードフィルタ、無視フィルタ（ブラックリスト）の二つのフィルタがあった。<br />
SkeedCastはダウンロードフィルタ、無視フィルタ、許可フィルタ（ホワイトリスト）の三つのフィルタを持つ。<br />
許可フィルタは公開鍵の束なので偽装は不可能。</p>
<p>再中継の制御<br />
Winnyはどこかにキャッシュがあると再中継可能だが、SkeedCastは投入ノードがコントロール可能。</p>
<p>レシーバ（PCに入れるソフト）<br />
Webと連携する。<br />
ブラウザでリンクをクリックすると起動する。<br />
SkeedReceiverはWebサーバとして動作し、裏でCacheとしてダウンロードする。<br />
また、SkeedReceiverがストリーミングサーバになって、メディアプレーヤで視聴する。ストリーミングだけどローカルにあるからシークもできる。</p>
<p>展開可能フラグがたってればCacheをファイルに展開することもできるよ。</p>
<p>視聴のコントロールにはDRMを使う。</p>
<p>言ってみれば巨大なProxyになる。</p>
<p>（株）Dreamboatではほかにもいろいろやってるから使ってください。<br />
社内ネットワークでの配信もできる。</p>
<h4>質疑</h4>
<ul>
<li>伊勢さん
<ul>
<li>receiverはプラグイン？ デーモン？
<ul>
<li>常駐はしない。ブラウザのプラグイン経由で必要なときに起動して、終わったら終了する。タスクバーにも出るので、気になったら消すこともできる。</li>
</ul>
</li>
<li>ヒントをもらった。ありがとうございます。ストリーミングサーバのランニングコストは馬鹿にならないから。</li>
</ul>
</li>
<li>Eさん
<ul>
<li>ダウンロード可能性は投入ノードで管理といってたけど、ダウンロード済みのものをレシーバでストリーミングするかどうかはチェックするのか？
<ul>
<li>ダウンロード済みの物はWinny的な感じで処理している。詳細は想像してください。</li>
</ul>
</li>
</ul>
</li>
</ul>
<h3 id="law">「デジタルコンテンツ配信の法的問題」</h3>
<p>壇さん<br />
金子さんの弁護団の事務局長</p>
<p>P2P教科書は私も書いているので買って読んでください。</p>
<p>cocologでblogを書いています。</p>
<p>Livedoorには壇さんを誹謗中傷するwikiがある。</p>
<h4>ネットのせいでコンテンツ産業は損害を受けてるってホント!?</h4>
<p>CDやレコードはの売り上げは落ちてるけど、着うたとか増えてるから消費シフトと見るべきではないか。<br />
映画の興行収入は年ごとに上がったり下がったりしている。<br />
結論：ネットは関係無いんじゃないか? むしろうまく使えば利益もたらすんじゃないか。</p>
<h4>著作権について</h4>
<p>厳密には著作権と言う名前の権利は無い。<br />
いろいろな法律で規定されてるいろいろな権利をまとめて著作権と総称してる。</p>
<p>Winnyは大容量コンテンツの配信を可能にした。<br />
それまでは映画一本流すなんてできなかった。</p>
<p>（以下、追いつけなかった部分はキーワードのみで失礼します。）<br />
プロバイダ責任制限法<br />
カラオケ法理とか<br />
私的目的での複製<br />
著作権侵害はP2Pに固有の問題ではない。ニコ動とか。<br />
アメリカ：セーフハーバーとかDMCAとか<br />
クラブキャッツアイ事件<br />
カラオケ法理がP2Pのファイルローグに適用された。</p>
<p>開発者、提供者が刑事事件の当事者になったのは日本、韓国、台湾のみ。<br />
有罪になってるのは金子さんと台湾の1件（Kuro事件）のみ。<br />
金子さんは確定してないので最高裁まででひっくり返すよ!</p>
<p>Winny事件地裁判決における幇助成立の基準<br />
証拠として提出されたWinnyの利用状況がなぜかアンケート結果。</p>
<p>よくある誤解<br />
Winnyに匿名性があるから有罪？<br />
→匿名性は関係ない。<br />
金子さんの目的が著作権侵害蔓延だったから有罪？<br />
→そんなことのためにわざわざソフトを開発するわけ無い。</p>
<p>IP-TVのニーズ<br />
海外で日本の番組を見たい<br />
東京ローカルを地方で見たい。<br />
しかし地方免許制度の枠組みでしか見られない。</p>
<p>IP-TVの訴訟<br />
録画ネットと選撮見撮は著作権者側が勝っているけど、まねきTVとロクラクはサービス提供者側が勝っている。</p>
<p>著作権の問題<br />
カラオケ法理の適用範囲<br />
非親告罪化<br />
ダウンロード違法化<br />
日本版フェアユース（ぜひとも立法化すべき）<br />
ただし裁判所の判断にゆだねることになるので危険性はある</p>
<h4>質疑</h4>
<ul>
<li>Aさん
<ul>
<li>日本の著作権関連団体は強い主張を繰り返していて、徐々にその主張に引きずられている気がするが、彼らの言うような方向にこのまま行ったらどうなる？
<ul>
<li>アメリカから制度変えろといわれて終わるんじゃないか。</li>
</ul>
</li>
</ul>
</li>
<li>伊勢さん
<ul>
<li>SkeedCastと連携しろなんてあったけどメディア事業部の担当役員さん、どう思う?
<ul>
<li>やりたい。</li>
</ul>
</li>
</ul>
</li>
</ul>
<h3 id="ending">閉会の挨拶</h3>
<p>代表取締役社長 出澤さん</p>
<p>みなさん、雨の中ありがとうございます。<br />
金子さん、壇さん、ありがとうございます。<br />
新規サービス（最後の質疑のSkeedCastの連携）も決まってうれしいねｗ</p>
<p>Open &amp; Shareという企業理念でやっています。</p>
<p>今後ともがんばるのでよろしくお願いします。</p>
]]></content>
		<link rel="replies" type="text/html" href="http://blogs.ricollab.jp/webtech/2009/03/livedoor_technical_seminor_1/#comments" thr:count="2" />
		<link rel="replies" type="application/atom+xml" href="http://blogs.ricollab.jp/webtech/2009/03/livedoor_technical_seminor_1/feed/atom/" thr:count="2" />
		<thr:total>2</thr:total>
	</entry>
		<entry>
		<author>
			<name>yohei</name>
						<uri>http://</uri>
					</author>
		<title type="html"><![CDATA[はてなダイアリーAtomPubレビュー: その3 設計編]]></title>
		<link rel="alternate" type="text/html" href="http://blogs.ricollab.jp/webtech/2009/02/hatena_diary_atompub_no3/" />
		<id>http://blogs.ricollab.jp/webtech/2009/02/hatena_diary_atompub_no3/</id>
		<updated>2009-02-09T03:17:55Z</updated>
		<published>2009-02-09T03:17:55Z</published>
		<category scheme="http://blogs.ricollab.jp/webtech" term="未分類" /><category scheme="http://blogs.ricollab.jp/webtech" term="atompub" />		<summary type="html"><![CDATA[さて、このシリーズも今回で最後です。遅れに遅れて申し訳ありません…ちなみに昨年の12/22付けで仕様書が改訂され、私が指摘したところが直っていました。どうもありがとうございます&#62;中の人
最後は設計編です。
今回、私がはてなダイアリーAtomPubの仕様を見ていて、設計面で疑問に思ったのは次の2点です。

X-HATENA-PUBLISH HTTP ヘッダ
エントリ文書の対称性

以下ではそれぞれについて具体的に検討してみます。
X-HATENA-PUBLISHヘッダ
いくつかのブログでも指摘されていますが、はてなダイアリーAtomPubではapp:draft 要素を利用しません。
はてなダイアリーAtomPub仕様書によると、以下のような理由があるそうです。
 はてなダイアリーAtomPubでは、AtomPubで規定されているapp:draft要素を使用しません。はてなダイアリーでは日記エントリと下書きエントリを別々に管理しています。そのため、日記エントリと下書きエントリを一つのコレクションとして扱い、app:draft要素によって下書きかどうかを区別するような構成は不自然になります。むしろ、下書きエントリを日記エントリとして公開するという操作を行う仕組みであるほうが自然であると考え、以下のような方法をとっています。
なるほど、コレクションを分ける際の実装上の都合なわけですね。
これは、これで一つの設計判断だと考えます。コレクション間のエントリのコピーや移動は AtomPub では定義されていませんので、何らかの拡張仕様が必要になります。WebDAV の MOVE を使うなど、マニアックな方法も考えられますが、独自ヘッダは悪くない判断だと思います。
ただし2点、よくない点があります。
1点目は、X-HATENA-PUBLISH の値の仕様です。このヘッダが取りうる値は「1」なのですが、いったいこれは何を意味するのでしょうか。おそらく内部的に Perl の &#8220;1&#8243; としてそのまま実装されているのでしょうが、これはたとえば &#8220;true&#8221; にするなど、もう少し可読性を考慮した方がよいでしょう。
また、&#8221;1&#8243; 以外の値を値を入れたときの挙動も不明です。たとえば &#8220;111&#8243;, &#8220;01&#8243;, &#8220;hoge&#8221; などを入れたらどうなるのでしょうか。
2点目は、PUT メソッドの挙動です。
はてなダイアリーAtomPubの仕様では、下書きを公開するときは既存の下書きエントリに対して X-HATENA-PUBLISH を 1 にした PUT を送ります。このリクエストが成功すると、レスポンスとして 201 Created が返り、Location ヘッダに公開されたブログコレクションのエントリが入ります。これは少し違和感を感じるところです。
HTTP/1.1 における PUT の仕様は以下のとおりです。
 PUT メソッドは、同封されたエンティティを供給される Request-URI の元に保存するように要求する。 Request-URI が既に存在するリソースを参照している場合は、同封されるエンティティはオリジンサーバにあるそれの修正版とみなされるべきである。 Request-URI が既存のリソースを指していない場合に、その URI がリクエストしているユーザエージェントによって新しいリソースとして定義する事ができる時は、オリジンサーバはその URI にリソースを作成できる。新しいリソースが作成された場合、オリジンサーバは 201 (Created) レスポンスをもってユーザエージェントに知らせなければならない。既存のリソースが更新された場合は、リクエストが成功し終了した事を示すために 200 (OK) か 204 [...]]]></summary>
		<content type="html" xml:base="http://blogs.ricollab.jp/webtech/2009/02/hatena_diary_atompub_no3/"><![CDATA[<p>さて、このシリーズも今回で最後です。遅れに遅れて申し訳ありません…ちなみに昨年の12/22付けで仕様書が改訂され、私が指摘したところが直っていました。どうもありがとうございます&gt;中の人</p>
<p>最後は設計編です。</p>
<p>今回、私が<a href="http://d.hatena.ne.jp/keyword/%A4%CF%A4%C6%A4%CA%A5%C0%A5%A4%A5%A2%A5%EA%A1%BCAtomPub">はてなダイアリーAtomPubの仕様</a>を見ていて、設計面で疑問に思ったのは次の2点です。</p>
<ul>
<li>X-HATENA-PUBLISH HTTP ヘッダ</li>
<li>エントリ文書の対称性</li>
</ul>
<p>以下ではそれぞれについて具体的に検討してみます。</p>
<h3>X-HATENA-PUBLISHヘッダ</h3>
<p>いくつかのブログでも指摘されていますが、はてなダイアリーAtomPubでは<a href="http://www.ricoh.co.jp/src/rd/webtech/rfc5023_ja.html#sec-13-1-1">app:draft 要素</a>を利用しません。</p>
<p>はてなダイアリーAtomPub仕様書によると、以下のような理由があるそうです。</p>
<blockquote><p> はてなダイアリーAtomPubでは、AtomPubで規定されているapp:draft要素を使用しません。はてなダイアリーでは日記エントリと下書きエントリを別々に管理しています。そのため、日記エントリと下書きエントリを一つのコレクションとして扱い、app:draft要素によって下書きかどうかを区別するような構成は不自然になります。むしろ、下書きエントリを日記エントリとして公開するという操作を行う仕組みであるほうが自然であると考え、以下のような方法をとっています。</p></blockquote>
<p>なるほど、コレクションを分ける際の実装上の都合なわけですね。</p>
<p>これは、これで一つの設計判断だと考えます。コレクション間のエントリのコピーや移動は AtomPub では定義されていませんので、何らかの拡張仕様が必要になります。WebDAV の MOVE を使うなど、マニアックな方法も考えられますが、独自ヘッダは悪くない判断だと思います。</p>
<p>ただし2点、よくない点があります。</p>
<p>1点目は、X-HATENA-PUBLISH の値の仕様です。このヘッダが取りうる値は「1」なのですが、いったいこれは何を意味するのでしょうか。おそらく内部的に Perl の &#8220;1&#8243; としてそのまま実装されているのでしょうが、これはたとえば &#8220;true&#8221; にするなど、もう少し可読性を考慮した方がよいでしょう。</p>
<p>また、&#8221;1&#8243; 以外の値を値を入れたときの挙動も不明です。たとえば &#8220;111&#8243;, &#8220;01&#8243;, &#8220;hoge&#8221; などを入れたらどうなるのでしょうか。</p>
<p>2点目は、PUT メソッドの挙動です。</p>
<p>はてなダイアリーAtomPubの仕様では、下書きを公開するときは既存の下書きエントリに対して X-HATENA-PUBLISH を 1 にした PUT を送ります。このリクエストが成功すると、レスポンスとして 201 Created が返り、Location ヘッダに公開されたブログコレクションのエントリが入ります。これは少し違和感を感じるところです。</p>
<p>HTTP/1.1 における <a href="http://www.studyinghttp.net/cgi-bin/rfc.cgi?2616#Sec9.6">PUT の仕様</a>は以下のとおりです。</p>
<blockquote><p> PUT メソッドは、同封されたエンティティを供給される Request-URI の元に保存するように要求する。 Request-URI が既に存在するリソースを参照している場合は、同封されるエンティティはオリジンサーバにあるそれの修正版とみなされるべきである。 Request-URI が既存のリソースを指していない場合に、その URI がリクエストしているユーザエージェントによって新しいリソースとして定義する事ができる時は、オリジンサーバはその URI にリソースを作成できる。新しいリソースが作成された場合、オリジンサーバは 201 (Created) レスポンスをもってユーザエージェントに知らせなければならない。既存のリソースが更新された場合は、リクエストが成功し終了した事を示すために 200 (OK) か 204 (No Content) のいずれかのレスポンスコードを送るべきである。</p></blockquote>
<p>つまり PUT のレスポンスは</p>
<ul>
<li>その URI が存在しない場合はリソースを新規作成して 201 を返す</li>
<li>その URI が存在する場合は、リソースを変更して 200 か 204 を返す</li>
</ul>
<p>となります。これは SHALL (べきである)なので、絶対に従わなければならないことはありませんが、いずれにせよ既存の URI に対しての PUT で 201 が返るというのは、仕様上のグレーゾーンでクライアントを混乱させる可能性があります。</p>
<h4>私だったらどうするか</h4>
<p>もし私がこの機能を設計するなら以下のように考えます。</p>
<p>下書き機能は AtomPub の app:draft 要素に非常に近い(というかほぼ同じ)機能であるため、いかにこれを活かすかを考えます。今回の問題はドラフト状態を公開すると URI が変更になってしまうところなのですが、これをいかに違和感なくクライアントに教えるか、が課題です。</p>
<p>PUT すると URI が変更される(リソースが移動するイメージ)というのがクライアントからの一番の違和感だと思うので、そこをどうにかするようにしたいですね。そのためには、ドラフトの URI を残しつつ、そのリソースに別の URI (エイリアス)を付与するのが良いように思います。</p>
<p>これには HTTP に標準で付いてくる Content-Location ヘッダを使うことで解決できそうです。この方式を採用したときのリクエスト・レスポンスは以下のようになります。</p>
<pre>
PUT /yohei/atom/draft/12345678 HTTP/1.1
Host: d.hatena.ne.jp

&lt;entry xmlns="http://www.w3.org/2005/Atom"
    xmlns:app="http://www.w3.org/2007/app"&gt;
  &lt;title&gt;テスト&lt;/title&gt;
  &lt;app:control&gt;
    &lt;app:draft&gt;yes&lt;/app:draft&gt;
  &lt;/app:control&gt;
  ...</pre>
<pre>
HTTP/1.1 200 OK
Content-Location: http://d.hatena.ne.jp/yohei/20081224/abcdefg</pre>
<p>/draft 以下の URI も依然として有効ですが(おそらく作者だけがアクセスできるリソースになるでしょう)、ダイアリーの方のリソースも別名で有効になります。</p>
<p>もちろん、サーバ側の実装の都合で、ドラフトエントリを公開するとドラフトコレクションからは必ず消さないといけないのかもしれません。上記のような理想形で設計したとおりに実装できるわけではないですが、一つのヒントとして提案してみます。</p>
<h3>エントリ文書の対称性</h3>
<p>2点目はエントリ文書の対称性についてです。<br />
現在の仕様では、ブログコレクションで日記エントリを更新するとき、以下の<br />
ようなリクエストを送ります。</p>
<pre>
PUT /yohei/atom/blog/20090203/xxx HTTP/1.1
Host: d.hatena.ne.jp
Content-Type: application/atom+xml; type=entry; charset=utf-8

&lt;entry xmlns="http://www.w3.org/2005/Atom"&gt;
  &lt;updated&gt;2009-02-03T00:00:00Z&lt;/updated&gt;
  &lt;id&gt;tag:d.hatena.ne.jp,2008:diary-yohei-20081226-p1
  &lt;author&gt;&lt;name&gt;yohei&lt;/name&gt;&lt;/author&gt;
  &lt;title&gt;test&lt;/title&gt;
  &lt;content type="text"&gt;this is a test&lt;/content&gt;
&lt;/entry&gt;</pre>
<p>これに対して、以下のようなレスポンスが返ってきます。</p>
<pre>
HTTP/1.0 200 OK
Date: Wed, 04 Feb 2009 04:13:59 GMT
Server: Apache/2.2.3 (CentOS)
Content-Length: 694
Content-Type: application/atom+xml;type=entry; charset=utf-8

&lt;?xml version="1.0" encoding="utf-8"?&gt;
&lt;entry xmlns="http://www.w3.org/2005/Atom"&gt;
  &lt;updated&gt;2008-12-26T00:00:00+09:00&lt;/updated&gt;
  &lt;published&gt;2008-12-26T00:00:00+09:00&lt;/published&gt;
  &lt;app:edited xmlns:app="http://www.w3.org/2007/app"&gt;2008-12-26T00:00:00+09:00&lt;/app:edited&gt;
  &lt;id&gt;tag:d.hatena.ne.jp,2008:diary-yohei-20081226-p1&lt;/id&gt;
  &lt;link rel="edit" href="http://d.hatena.ne.jp/yohei/atom/blog/20081226/p1"/&gt;
  &lt;link rel="alternate" type="text/html" href="http://d.hatena.ne.jp/yohei/20081226/p1"/&gt;
  &lt;author&gt;
    &lt;name&gt;yohei&lt;/name&gt;
  &lt;/author&gt;
  &lt;title&gt;test&lt;/title&gt;
  &lt;content type="html"&gt;
                &amp;lt;div class="section"&amp;gt;
                        &amp;lt;p&amp;gt;this is a test&amp;lt;/p&amp;gt;
                &amp;lt;/div&amp;gt;
&lt;/content&gt;
&lt;/entry&gt;</pre>
<p>このリソースを再び GET してみると以下のようになります。</p>
<pre>
GET http://d.hatena.ne.jp/yohei/atom/blog/20081226/p1 HTTP/1.1
Host: d.hatena.ne.jp</pre>
<pre>
HTTP/1.0 200 OK
Date: Wed, 04 Feb 2009 05:13:52 GMT
Server: Apache/2.2.3 (CentOS)
Content-Length: 793
Content-Type: application/atom+xml;type=entry; charset=utf-8

&lt;?xml version="1.0" encoding="utf-8"?&gt;
&lt;entry xmlns="http://www.w3.org/2005/Atom"&gt;
  &lt;updated&gt;2008-12-26T00:00:00+09:00&lt;/updated&gt;
  &lt;published&gt;2008-12-26T00:00:00+09:00&lt;/published&gt;
  &lt;app:edited xmlns:app="http://www.w3.org/2007/app"&gt;2008-12-26T00:00:00+09:00&lt;/app:edited&gt;
  &lt;id&gt;tag:d.hatena.ne.jp,2008:diary-yohei-20081226-p1
  &lt;link rel="edit" href="http://d.hatena.ne.jp/yohei/atom/blog/20081226/p1"/&gt;
  &lt;link rel="alternate" type="text/html" href="http://d.hatena.ne.jp/yohei/20081226/p1"/&gt;
  &lt;author&gt;
    &lt;name&gt;yohei&lt;/name&gt;
  &lt;/author&gt;
  &lt;title&gt;test&lt;/title&gt;
  &lt;content type="html"&gt;
                &amp;lt;div class="section"&amp;gt;
                        &amp;lt;p&amp;gt;this is a test&amp;lt;/p&amp;gt;
                &amp;lt;/div&amp;gt;
&lt;/content&gt;
  &lt;hatena:syntax xmlns:hatena="http://www.hatena.ne.jp/info/xmlns#"&gt;this is a test&lt;/hatena:syntax&gt;
&lt;/entry&gt;</pre>
<p>ブログコレクションのエントリを編集するときは、以下のことに気をつける必要があります。</p>
<ul>
<li>追加・更新を行うときは /entry/content/@type は &#8220;text&#8221; ではてな記法を入れる</li>
<li>サーバから取得できる /entry/content は @type=&#8221;html&#8221; ではてな記法がHTML にレンダリングされたものが入り、/entry/hatena:syntax にはてな記法が入る</li>
</ul>
<p>これはクライアント側ではてな記法を入れる要素について注意しながら、はてな独自のロジックを実装しなければならない点で、あまり良い設計ではないと言えるでしょう。</p>
<p>この問題を解決する方法はいくつか考えられますが、完璧なソリューションは存在しないと思います。私が即興で考えたソリューションのそれぞれのメリット・デメリットを挙げておきます。</p>
<h4>/entry/content に常にはてな記法を入れる</h4>
<dl>
<dt>Pros</dt>
<dd>既存の AtomPub クライアントをほぼそのまま利用可能</dd>
<dt>Cons</dt>
<dd>既存のブログクライアントのユーザははてな記法を使うことを理解しなければならない</dd>
<dd>フィードをフィードリーダーで見たときにはてな記法が出てしまう</dd>
</dl>
<h4>/entry/hatena:syntax を常に使うようにする</h4>
<dl>
<dt>Pros</dt>
<dd>content を HTML にできる</dd>
<dt>Cons</dt>
<dd>AtomPub クライアントが hatena:syntax を理解しなければ更新ができない</dd>
</dl>
<h3>まとめ</h3>
<p>先日、会社の超先輩エンジニア(ソフトだけじゃなくてエレキよりの設計も含めて全般されてきた方です)の方と話をしたのですが、そのときに「設計はバランスだよ」という言葉をもらいました。</p>
<p>今回の件でもわかるとおり、設計というのはあちらを立てればこちらが立たず、ということが多く、全てを満足させることは不可能です。</p>
<p>私はよく「REST 的に理想的な設計にするにはどうしたらいいんでしょう」というような質問を受けるのですが、正直なところ理想ばかり追いかけても仕方がないだろう、と思います。REST はあくまでも設計のためのヒントなのであり、それ自体が目的になってしまったら本末転倒です。</p>
<p>高い理想をバックグラウンドに、現実的でバランスの取れた設計をするのが優れたエンジニアなのではないでしょうか。</p>
]]></content>
		<link rel="replies" type="text/html" href="http://blogs.ricollab.jp/webtech/2009/02/hatena_diary_atompub_no3/#comments" thr:count="4" />
		<link rel="replies" type="application/atom+xml" href="http://blogs.ricollab.jp/webtech/2009/02/hatena_diary_atompub_no3/feed/atom/" thr:count="4" />
		<thr:total>4</thr:total>
	</entry>
		<entry>
		<author>
			<name>StL</name>
						<uri>http://</uri>
					</author>
		<title type="html"><![CDATA[プロキシ認証の通し方まとめ その2]]></title>
		<link rel="alternate" type="text/html" href="http://blogs.ricollab.jp/webtech/2008/12/how_to_pass_proxy_auth_2/" />
		<id>http://blogs.ricollab.jp/webtech/2008/12/how_to_pass_proxy_auth_2/</id>
		<updated>2008-12-03T06:33:51Z</updated>
		<published>2008-12-03T06:33:51Z</published>
		<category scheme="http://blogs.ricollab.jp/webtech" term="未分類" /><category scheme="http://blogs.ricollab.jp/webtech" term="proxy" /><category scheme="http://blogs.ricollab.jp/webtech" term="tips" />		<summary type="html"><![CDATA[お久しぶりです、日野原です。
読者の皆さんは山本のレビューの設計編を楽しみにしていらっしゃると思いますが、彼は最近何やら忙しく飛び歩いていて、ここの記事を書く時間がとれそうにないのでもう少々お待ちください。
私はこの3ヶ月の間にまたプロキシの設定をしなければいけないケースに遭遇したので追記しておきます。
今回もプロキシの情報は同じとします。


ホスト
proxy.example.com


ポート
8080


ユーザ
foo


パスワード
bar


sudo 編
まず、前回基本編で挙げた
export http_proxy=http://foo:bar@proxy.example.com:8080
ですが、これの適用範囲が広がりました。
rubygems編で「sudo では環境変数を引き継げない」と書いてしまったのですが、これは私の無知で、実は設定で引き継ぐ環境変数を指定できることがわかりました。
設定するためには、/etc/sudoers の env_keep という変数に引き継ぎたい環境変数を指定します。
具体的には、
Defaults env_keep = "COLORS DISPLAY HOSTNAME HISTSIZE INPUTRC KDEDIR \
         LS_COLORS MAIL PS1 PS2 QTDIR USERNAME \
         LANG LC_ADDRESS LC_CTYPE LC_COLLATE LC_IDENTIFICATION \
         LC_MEASUREMENT LC_MESSAGES [...]]]></summary>
		<content type="html" xml:base="http://blogs.ricollab.jp/webtech/2008/12/how_to_pass_proxy_auth_2/"><![CDATA[<p>お久しぶりです、日野原です。</p>
<p>読者の皆さんは山本のレビューの設計編を楽しみにしていらっしゃると思いますが、彼は最近何やら忙しく飛び歩いていて、ここの記事を書く時間がとれそうにないのでもう少々お待ちください。</p>
<p>私はこの3ヶ月の間にまたプロキシの設定をしなければいけないケースに遭遇したので追記しておきます。</p>
<p>今回もプロキシの情報は同じとします。</p>
<table>
<tr>
<td>ホスト</td>
<td>proxy.example.com</td>
</tr>
<tr>
<td>ポート</td>
<td>8080</td>
</tr>
<tr>
<td>ユーザ</td>
<td>foo</td>
</tr>
<tr>
<td>パスワード</td>
<td>bar</td>
</tr>
</table>
<h3 id="sudo">sudo 編</h3>
<p>まず、前回<a href="http://blogs.ricollab.jp/webtech/2008/09/how_to_pass_proxy_auth#basic_setting">基本編</a>で挙げた</p>
<pre><code>export http_proxy=http://foo:bar@proxy.example.com:8080</code></pre>
<p>ですが、これの適用範囲が広がりました。</p>
<p><a href="http://blogs.ricollab.jp/webtech/2008/09/how_to_pass_proxy_auth#rubygems">rubygems編</a>で「sudo では環境変数を引き継げない」と書いてしまったのですが、これは私の無知で、実は設定で引き継ぐ環境変数を指定できることがわかりました。</p>
<p>設定するためには、/etc/sudoers の env_keep という変数に引き継ぎたい環境変数を指定します。</p>
<p>具体的には、</p>
<pre><code>Defaults env_keep = "COLORS DISPLAY HOSTNAME HISTSIZE INPUTRC KDEDIR \
         LS_COLORS MAIL PS1 PS2 QTDIR USERNAME \
         LANG LC_ADDRESS LC_CTYPE LC_COLLATE LC_IDENTIFICATION \
         LC_MEASUREMENT LC_MESSAGES LC_MONETARY LC_NAME LC_NUMERIC \
         LC_PAPER LC_TELEPHONE LC_TIME LC_ALL LANGUAGE LINGUAS \
         _XKB_CHARSET XAUTHORITY"</code></pre>
<p>という箇所があるので、これの最後の行を</p>
<pre><code>         _XKB_CHARSET XAUTHORITY http_proxy NO_PROXY"</code></pre>
<p>と変更します。<br />
これで rubygems や yum を sudo で動かすときには別途プロキシを設定する必要がなくなりました。</p>
<p>ちなみに /etc/sudoers を編集するときには chmod して編集して戻してなんてせずに、visudo を使ってくださいね。</p>
<h3 id="pear_pecl">pear / pecl 編</h3>
<p>PHP のモジュールを追加するときに使う pear や pecl は、プロキシ対応を独自でやっているので設定しなくてはいけません。</p>
<p>設定するには次のようにします。</p>
<pre><code>% pear config-set http_proxy=http://foo:bar@proxy.example.com:8080</code></pre>
<p>ちなみに、これで設定すると pecl にも反映されるので pear だけ設定すれば OK です。<br />
試しに確認してみましょう。</p>
<pre><code>% pecl config-get http_proxy
http://foo:bar@proxy.example.com:8080</code></pre>
<h3 id="air_adt">air 編</h3>
<p>Adobe の air のアプリケーションを作って配布するためには .air ファイルにパッケージングする必要がありますが、その際にタイムスタンプを付与するためにタイムスタンプサーバにアクセスします。そう、ここでプロキシの壁に阻まれるのです。</p>
<p>そこで、プロキシの内側にタイムスタンプサーバがある場合は -tsa オプションに url を指定し、無い場合にはやむを得ないので -tsa none と指定してタイムスタンプの付与を省略します。<br />
タイムスタンプを省略した場合は署名証明書の有効期限切れ後にインストールできなくなってしまいますが、正式に製品としてリリースするときまでは考えなくても大丈夫でしょう。</p>
<p>ちなみにこれは http ではなく、<a href="http://www.ietf.org/rfc/rfc3161.txt">RFC3161</a>で定義された Time-Stamp Protocol(TSP) で、318番のポートを使用するので -Dhttp.proxyHost 等で設定してもダメです。</p>
<p>socksで通れば -DsocksProxyHost を指定することでできるかもしれませんが、私の環境ではまだうまく行っていません。</p>
<p>今回は<a href="http://blogs.ricollab.jp/webtech/2008/09/how_to_pass_proxy_auth#google_chrome">前回の Chrome</a> のような目玉はありませんでしたが、また何かあったら追加していきます。</p>
]]></content>
		<link rel="replies" type="text/html" href="http://blogs.ricollab.jp/webtech/2008/12/how_to_pass_proxy_auth_2/#comments" thr:count="7" />
		<link rel="replies" type="application/atom+xml" href="http://blogs.ricollab.jp/webtech/2008/12/how_to_pass_proxy_auth_2/feed/atom/" thr:count="7" />
		<thr:total>7</thr:total>
	</entry>
		<entry>
		<author>
			<name>yohei</name>
						<uri>http://</uri>
					</author>
		<title type="html"><![CDATA[はてなダイアリーAtomPubレビュー: その2 ドキュメンテーション編]]></title>
		<link rel="alternate" type="text/html" href="http://blogs.ricollab.jp/webtech/2008/10/hatena_diary_atompub_no2/" />
		<id>http://blogs.ricollab.jp/webtech/2008/10/hatena_diary_atompub_no2/</id>
		<updated>2008-11-06T05:07:18Z</updated>
		<published>2008-10-27T00:47:33Z</published>
		<category scheme="http://blogs.ricollab.jp/webtech" term="未分類" /><category scheme="http://blogs.ricollab.jp/webtech" term="atompub" />		<summary type="html"><![CDATA[その1を公開してからだいぶ時間が経ってしまいましたが、その2を公開します。今回はドキュメンテーション編です。
レビュー対象ははてなダイアリーAtomPubの仕様書です。普段私が業務で仕様書をレビューするときに気をつけている観点をご紹介しながら、いくつか指摘をしてみます。
なお、レビューの指摘はどうしても細かくなってしまうので、粗探し的と感じられてしまうかもしれませんが、技術的な完成度を上げるためには必要な作業なのでご容赦ください。
基本的な文章チェック
まず、仕様書に記述されている文章の「てにをは」や文法レベルでのチェックをします。表記ゆれなども含まれます。
今回の仕様書は、たとえば以下のような記述がありました。

「ヘッダ」と「ヘッダー」、「XML文書」と「XML文章」、「はてなID」と「はてなアカウントのid」などの表記ゆれ。document に対する訳語は通常は「文書」を用います
「～することができます」という冗長表現。私もよくやってしまうのですが、これは「～できる」にとした方がシンプルで読みやすくなります
「GETをリクエストする」と「リクエストXML文章をPOSTする」。これも表記ゆれの一種ですが、私だったら「GETする」「XML文書をPOSTする」にします
単純なコピペミスっぽいですが、下書きコレクションの段落で、「XXXXXXXXXXは実際には」で切れてしまっている文章がありました

こういった基本的な文章のバグは、ワードの文書校正ツールなどを使うと簡単に検出できるものも多いので、機械的に処理するのがおすすめです。
必須項目のチェック
次に、仕様書として必要な項目が足りているかを確認します。
基本設計仕様書やテスト仕様書など、フォーマットがある程度決っているものであれば、それに沿っているかをチェックします。今回の場合は Web API の仕様書なので、これが標準、というフォーマットはないと思いますが、以下の項目が足りないかなと思いました。

目次
仕様書は全体が長いので、さっと目を通せるように目次を入れる方がよいでしょう
エラー仕様
Web API の場合、エラー仕様というのはなかなか書きづらいのですが、それ
でも不正な操作に対して、API がどのように反応するかを一言記述しておく方
がよいと思います
セキュリティに関する考察
RFC などでは必須になっています

変更点、拡張点のチェック
AtomPub のように、ベースとなる仕様書があり、それに基づいた形でAPIを設計する場合は、オリジナルとの変更点や拡張点を明記する方がよいでしょう。逆に言うとオリジナルの方で詳しく記述されている部分は、概要だけを書いて詳細はオリジナルを参照してもらう方がよいと思います。
今回のAPI仕様でいえば、変更点は X-HATENA-PUBLISH ヘッダ、拡張点は hatena:syntax 要素になります。
オリジナルの仕様を変更した場合は、なぜそのような設計になったのか、その理由を書いておく方が親切です。特にある程度標準に従っている場合、利用者はオリジナルの方法に慣れているため、変更点はつまづきポイントになるからです。
この理由とはたとえば、レガシーシステムの実装上の都合であるとか、開発効率の問題であるとか、はたまたオリジナル仕様が間違っている、などが考えられます。残念ながら、現状のはてなダイアリーAtomPubの仕様では、なぜ AtomPub 標準の app:draft 要素ではなく X-HATENA-PUBLISH が必要だったのかの記述はありませんでした。
拡張点については、はてなダイアリーAtomPubの仕様では hatena:syntax 要素がはてな記法を入れるために導入されたことが明記されているので問題ありませんね。
技術的なチェック
最後に、技術的な正確性を検証します。
今回、私が気づいたものとしては以下の点があります。

content/@type が text/html なのに、要素内容のタグがエスケープされていません(実装は正しくされています)
パラメータ付きURIは URI Templates の記法を利用した方がよいでしょう(/はてなID/atom/draft/XXXXXXXXXX → /{はてなID}/atom/draft/{entry-id})
HTTP/1.1 201 CREATED の Reason-Phrase は Created が一般的です(CREATEDでもHTTP仕様としては間違いではありません)

まとめ
技術文書にはプログラムだけでは伝えきれない設計の意図を伝えるという目的があります。プログラムもそうですが、文書もひとりで書くだけではなくレビューすることが大切です。人に読んでもらうことで初めてわかることも多々あるので、ソースコードレビューと同じくらいドキュメントのレビューにも力を入れるべきです。
また、文章の書き方自体の勉強も大切です。私も偉そうなことは言えないのですが、学生のころにかずさんの正確な文章の書き方を読んだり、檜山さん(プロのテクニカルライター)のライティングスキルを目の当たりにしたりして(参考)、技術者のライティングスキルの重要性を認識しました。
ということで、このエントリでライティングスキルもプログラミングスキルと同じくらい重要である、と認識してくれる人が増えることを願っています。
ちなみにこのレビューシリース、まだ続きます。
]]></summary>
		<content type="html" xml:base="http://blogs.ricollab.jp/webtech/2008/10/hatena_diary_atompub_no2/"><![CDATA[<p><a href="http://blogs.ricollab.jp/webtech/2008/09/hatena_diary_atompub_no1/">その1</a>を公開してからだいぶ時間が経ってしまいましたが、その2を公開します。今回はドキュメンテーション編です。</p>
<p>レビュー対象は<a href="http://d.hatena.ne.jp/keyword/%A4%CF%A4%C6%A4%CA%A5%C0%A5%A4%A5%A2%A5%EA%A1%BCAtomPub">はてなダイアリーAtomPubの仕様書</a>です。普段私が業務で仕様書をレビューするときに気をつけている観点をご紹介しながら、いくつか指摘をしてみます。</p>
<p>なお、レビューの指摘はどうしても細かくなってしまうので、粗探し的と感じられてしまうかもしれませんが、技術的な完成度を上げるためには必要な作業なのでご容赦ください。</p>
<h3>基本的な文章チェック</h3>
<p>まず、仕様書に記述されている文章の「てにをは」や文法レベルでのチェックをします。表記ゆれなども含まれます。</p>
<p>今回の仕様書は、たとえば以下のような記述がありました。</p>
<ul>
<li>「ヘッダ」と「ヘッダー」、「XML文書」と「XML文章」、「はてなID」と「はてなアカウントのid」などの表記ゆれ。document に対する訳語は通常は「文書」を用います</li>
<li>「～することができます」という冗長表現。私もよくやってしまうのですが、これは「～できる」にとした方がシンプルで読みやすくなります</li>
<li>「GETをリクエストする」と「リクエストXML文章をPOSTする」。これも表記ゆれの一種ですが、私だったら「GETする」「XML文書をPOSTする」にします</li>
<li>単純なコピペミスっぽいですが、下書きコレクションの段落で、「XXXXXXXXXXは実際には」で切れてしまっている文章がありました</li>
</ul>
<p>こういった基本的な文章のバグは、ワードの文書校正ツールなどを使うと簡単に検出できるものも多いので、機械的に処理するのがおすすめです。</p>
<h3>必須項目のチェック</h3>
<p>次に、仕様書として必要な項目が足りているかを確認します。</p>
<p>基本設計仕様書やテスト仕様書など、フォーマットがある程度決っているものであれば、それに沿っているかをチェックします。今回の場合は Web API の仕様書なので、これが標準、というフォーマットはないと思いますが、以下の項目が足りないかなと思いました。</p>
<dl>
<dt>目次</dt>
<dd>仕様書は全体が長いので、さっと目を通せるように目次を入れる方がよいでしょう</dd>
<dt>エラー仕様</dt>
<dd>Web API の場合、エラー仕様というのはなかなか書きづらいのですが、それ<br />
でも不正な操作に対して、API がどのように反応するかを一言記述しておく方<br />
がよいと思います</dd>
<dt>セキュリティに関する考察</dt>
<dd>RFC などでは必須になっています</dd>
</dl>
<h3>変更点、拡張点のチェック</h3>
<p>AtomPub のように、ベースとなる仕様書があり、それに基づいた形でAPIを設計する場合は、オリジナルとの変更点や拡張点を明記する方がよいでしょう。逆に言うとオリジナルの方で詳しく記述されている部分は、概要だけを書いて詳細はオリジナルを参照してもらう方がよいと思います。</p>
<p>今回のAPI仕様でいえば、変更点は X-HATENA-PUBLISH ヘッダ、拡張点は hatena:syntax 要素になります。</p>
<p>オリジナルの仕様を変更した場合は、なぜそのような設計になったのか、その理由を書いておく方が親切です。特にある程度標準に従っている場合、利用者はオリジナルの方法に慣れているため、変更点はつまづきポイントになるからです。</p>
<p>この理由とはたとえば、レガシーシステムの実装上の都合であるとか、開発効率の問題であるとか、はたまたオリジナル仕様が間違っている、などが考えられます。残念ながら、現状のはてなダイアリーAtomPubの仕様では、なぜ AtomPub 標準の app:draft 要素ではなく X-HATENA-PUBLISH が必要だったのかの記述はありませんでした。</p>
<p>拡張点については、はてなダイアリーAtomPubの仕様では hatena:syntax 要素がはてな記法を入れるために導入されたことが明記されているので問題ありませんね。</p>
<h3>技術的なチェック</h3>
<p>最後に、技術的な正確性を検証します。</p>
<p>今回、私が気づいたものとしては以下の点があります。</p>
<ul>
<li>content/@type が text/html なのに、要素内容のタグがエスケープされていません(実装は正しくされています)</li>
<li>パラメータ付きURIは <a href="http://bitworking.org/projects/URI-Templates/">URI Templates</a> の記法を利用した方がよいでしょう(/はてなID/atom/draft/XXXXXXXXXX → /{はてなID}/atom/draft/{entry-id})</li>
<li>HTTP/1.1 201 CREATED の Reason-Phrase は Created が一般的です(CREATEDでもHTTP仕様としては間違いではありません)</li>
</ul>
<h3>まとめ</h3>
<p>技術文書にはプログラムだけでは伝えきれない設計の意図を伝えるという目的があります。プログラムもそうですが、文書もひとりで書くだけではなくレビューすることが大切です。人に読んでもらうことで初めてわかることも多々あるので、ソースコードレビューと同じくらいドキュメントのレビューにも力を入れるべきです。</p>
<p>また、文章の書き方自体の勉強も大切です。私も偉そうなことは言えないのですが、学生のころにかずさんの<a href="http://www.mew.org/~kazu/doc/japanese.html">正確な文章の書き方</a>を読んだり、<a href="http://d.hatena.ne.jp/m-hiyama/">檜山さん</a>(プロのテクニカルライター)のライティングスキルを目の当たりにしたりして(<a href="http://www.prop.or.jp/flanker/16/16-05.html">参考</a>)、技術者のライティングスキルの重要性を認識しました。</p>
<p>ということで、このエントリでライティングスキルもプログラミングスキルと同じくらい重要である、と認識してくれる人が増えることを願っています。</p>
<p>ちなみにこのレビューシリース、まだ続きます。</p>
]]></content>
		<link rel="replies" type="text/html" href="http://blogs.ricollab.jp/webtech/2008/10/hatena_diary_atompub_no2/#comments" thr:count="4" />
		<link rel="replies" type="application/atom+xml" href="http://blogs.ricollab.jp/webtech/2008/10/hatena_diary_atompub_no2/feed/atom/" thr:count="4" />
		<thr:total>4</thr:total>
	</entry>
	</feed>

