たけまる / atompub

_ 第6回 RESTful 勉強会が終わりました [restful][atompub]

ちょっと日が空いてしまいましたが，10/16 の第6回 RESTful 勉強会に行っ
てきました．

朝倉さんが AtomPub 標準化にまつわる話をされたので，それを受けて
AtomPub 仕様が策定された意義について議論をふっかけてみました．議論
の流れなんかは id:ikasam_a がキレイにまとめてくれたので，そっちを
みてください．

rws-reading に行ってきた - masakiのはてなダイアリー

子守りのため，懇親会には出られない予定だったのですが，ちょうど親が
来てくれていたので長居することができました．ラッキーでした．

ところで，AtomPub の Perl モジュールを書いてから WebAPI 系の集まり
に呼んでいただけるようになったわけですが，いまだにこの分野には苦手
意識があったりします．性能以外の評価尺度が主であるような技術は，ど
のように主張していいかわかんないんですよねぇ．そういった分野で活躍
されている yohei さんとかはすごいなぁと改めて思ったりしたわけです．

そんなわけで，呼ばれて喋ってきたわりには，本人がもっとも勉強になっ
たような気がしています．これからもちょくちょく顔を出していこうと思
うので，よろしくお願いします．

_ 第6回 RESTful 勉強会 [restful][atompub]

本日，RESTful 勉強会が行われます．テーマは AtomPub です．

第6回勉強会 - RESTful読書会

AtomPub の標準化について，朝倉さんに語ってもらいます．朝倉さんは，
gihyo.jp で AtomPub の解説を書かれており，Google で開催された相互接
続実験などにも参加されています．WEB+DB PRESS vol.46 の REST レシピ
に，朝倉さんの標準化への貢献が少し紹介されています．

僕は，REST/AtomPub についてお題を投げつつみんなで議論したいと思っ
ています．パネルディスカッションの軽いやつみたいなイメージです．

まだ枠がありますので，興味のある方はご参加ください．

_ RESTful 本読書会 [atompub]

9/13 (土) に RESTful 本読書会が行われたのですが，前回，kunit さん
に「次は来ないでください」と言われたので，行きませんでしたw

というのは冗談で，東京の近くにいなかったので，参加できませんでした．
AtomPub がメイントピックだったので顔を出したかったのですが，すみま
せん．

Lingr で少しだけ参加したのですが，Ustream の中継がなく会場の様子が
わからなかったのが残念でした．それでも，何となく気になっていた "は
てなの X-HATENA-PUBLISH" について，他の方々も似た考えを持っていた
ことがわかったのは収穫でした．

kunit さんがブログで「もちろんたけまるさんにもう一度ご参加いただい
てAtomPubの話をがっつりききたい」と言ってくださっているのですが，
AtomPub をもう一回やってみんな退屈しないかと心配です…．まぁ，都合
がつけば行きますんで，気軽に声をかけてください．

2008-09-15 - kunitの日記 - RESTful本読書会 9月分終了

_ AtomPub on Rails2 [atompub][rails]

Rails で AtomPub する方法がよくわからない，というようなページを見
かけました．

AtomPubサーバの開発中

たしかに，Rails による AtomPub サーバ構築については，情報が少ないよ
うに思います．

Rails を使い込んでないので中途半端ですが，誰かの参考になればという
ことで簡単な実装方法を紹介します．Rails 2.0 以降が対象です．エラー
処理などはいい加減なので，適宜追加してください．

《続きを読む》

_ AtomPub on mixi? [atompub]

(2008-08-02 追記) lyokato さんから "N○KIA仕様" とのコメントをいた
だきました．

(2008-08-01 追記) id:mainyaa さんのご指摘通り，updated などを付けて
も投稿できました．mixi さんが修正したのか，僕が typo してたのか (た
ぶんこっち) は不明です．
POST のレスポンスに仕様と異なる部分があったので，追記しました．

mixi 日記が AtomPub に対応したという話題があちこちで盛り上がってま
す．

mixi for iPhoneから発掘されたmixi日記投稿用API « ku

といっても，mixi が正式に AtomPub 対応をアナウンスしたわけではない
し (知ってる限りでは)，使ってみた感じでは "AtomPub に似てるけどちょっ
と違うプロトコル" という印象を受けました．粗探しして，仕様との相違
点を無理矢理探しているわけではなく，たぶん動かない AtomPub クライア
ントが存在するんじゃないかなと思いました．

というわけで，mixi クライアントを作ろうとしている人のために，注意す
るとよさそうな点をコメントしておきます．よかったら参考にしてくださ
い (mixi の人も :-)．

《続きを読む》

_ "AtomPub と呼んでくれ" [atompub]

Atom Publishing Protocol が RFC5023 として標準化されてから 9ヶ月ほ
ど経ちますが，いまさらながら正式に略称が決まりました．"AtomPub" に
落ち着いたようです．

ongoing · It’s Called AtomPub

RFC になる直前にも "これからは AtomPub で" というようなアナウンスが
ありました．しかし，完全には浸透していなかったのと，"P" を大文字に
するか小文字にするかが決められていなかったことから，改めて略称を定
義し直すことになったようです．

正式な略称は，"P" が大文字の "AtomPub" です．

日本では "AtomPub" という略称がもっとも使われていたように思えるので，
"これまでどおり" といったところでしょうか．

Perl のモジュール名は "P" が小文字の "Atompub" ですが，いまさら変更
できないので，そのままにしておきます (小文字派だった Tim Bray の影
響を受けてます)．

引き続き，Logo を募集しているので，デザインに自信のある方は奮って
応募ください．

_ AtomPub の multipart 拡張と OpenSocial のバッチ処理 [atompub][opensocial]

以前に "AtomPub で複数リソースをまとめて POST する方法" というエン
トリを書きました [2008-03-29-1]．このエントリでは，2通りの "エント
リをまとめてPOST する方法" を紹介しました．

このうち，"Media Resource と Media Link Entry を同時に POST" が
multipart 拡張として正式に標準化されることになりました．元々
Picasa API として使われていた方法で，実績もあるため，標準化はすんな
りと進みそうです．

また，もうひとつの "複数の Resource をまとめて POST (BATCH 処理)"
は，OpenSocial 仕様として正式に採用されるようです．いまのところ，
AtomPub にはフィードバックされていません．

基本的な振る舞いについては，以前のエントリ [2008-03-29-1] をみてく
ださい．ここでは，補足事項のみを書きます．

《続きを読む》

_ OpenSocial の XRDS-Simple が AtomPub に与える影響 [atompub][opensocial]

二週間ほど前に えーじさん から AtomPub のことで相談を受けて，あとで
ブログに書きますと言ったきりほったらかしてしまいました．Erlang 関係
でバタバタしてたもんですみません ＞＜

そういえば，数ヶ月前に "AtomPub のマニアックな話題について書いてい
きます" と言ったあと，ほとんど書いてない気もする…．

3月〜4月に書いたエントリに関連した標準化動向もあったことなので，
AtomPub についていくつか書いていこうと思います．Rails2 についても
ちょっとかくつもりです．

というわけで，久々に AtomPub の話題です．お題は OpenSocial の
XRDS-Simple です．

《続きを読む》

_ AtomPub のエラー処理について [atompub]

daiba さんから召還されたので，あんまり書くこともないのですが，
AtomPub のエラー処理について簡単に説明します．

エラーについて AtomPub 仕様 が定めていることはほとんどありません．

- HTTP 仕様に従ってステータスコードを正しく使うように
   - エラー時は 4xx, 5xx を返すように
   - PUT においてバージョン違反 (ETag の不一致など) があったときは
     412 Precondition Failed を返す
   - 認証やアクセス制御のエラーは 401 Unauthorized や 403
     Forbidden を返す
- 人間が読めるようなエラーの説明を含めるべきである

これだけです．レスポンスの書式については何も定めていません．

《続きを読む》

_ AtomPub - Catalyst::Controller::Atompub v0.5.0 [atompub][catalyst]

zigorou さんからアドバイスをもらいつつ，Makefile.PL も直してもらい
つつ，コレクション URI の変更方法を修正しました．いままでは，コレク
ション URI を変更すると EditURI やサービス文書がおかしくなることが
あったのですが，完全に直っていると思います．

http://svn.coderepos.org/share/lang/perl/Catalyst-Controller-Atompub/trunk

# Atompub の export が多いのは，今さら変更できないということで見逃
# してください ＞＜

一ヶ月近く前に，daiba さんから "URI がおかしい" という報告をもらっ
ていたのですが，わりと面倒な修正だったのと，僕自身は問題になるよう
な使い方をしてなかったので，しばらく放置してしまいました (ぉ．ごめ
んなさい．

問題になっていたのは，ユーザごとに別のコレクションを用意する場合で
す．たとえば，foo さんは /collection/foo で，bar さんは
/collectino/bar という感じです．コレクションを GET するときは認証不
要とし，POST などの書き込みは対応するユーザのみ許可します．また，
/service ではサービス文書を提供します．サービス文書にはコレクション
URI が記載されますが，ユーザに合わせて変更します．

ソースコードの samples/OurBlogs にサンプルがありますので，これを使っ
て簡単に説明します．

《続きを読む》

_ AtomPub - サービス文書の記述力 [atompub]

(2008-06-26 追記) その後の動向を [2008-06-26-1] に書きました．

ZIGOROu さんと Catalyst::Controller::Atompub をいじっていて，コレク
ション URI をデフォルトから変更したときのあれやこれやを修正したんで
すが (CodeRepos にあります)，それについて書く前にサービス文書とその
欠点について簡単にふれておきます．

AtomPub サーバを開発していると，コレクションの設計には力を注いでも，
サービス文書はおざなりという人が多いのではないでしょうか．サービス
文書はとても影が薄いように思います．ひとつはサービス文書がなくても
動作する状況が多いこと，もうひとつは Atom API 時代には存在しなかっ
たことが理由でしょう．

《続きを読む》

_ AtomPub で複数リソースをまとめて POST する方法 [atompub][opensocial][gdata]

(2008-06-29 追記) その後の動向を書きました [2008-06-29-1]

(追記) yohei さんからのコメントです．

解決策はたくさんあり、結局要求次第と思われ。やりたいことによって解
決策 が異なるので、仕様に入れないのは正しいと思う。個人的には複数
同時にPOSTすると、レスポンスが multi status に...

(追記) enclosure or content/@src について lyokato さんとのやりとりです．

lyokato: あー、日記と同時に関連写真を投稿したいとか、そういうケー
スかなと思ってました。その場合はここで書かれた処理の後、enclosure
link突っ込んだ日記entryのpostでいいのかしら？
takemaru: あー，そっちかぁ．それならクライアントの意志による関連づ
けなので，enclosure でもいいと思いますし，単純に日記本文
(//entry/content) の中に <img src="..."> を書いておくだけでもいい
と思います．

最近は ZIGOROu さんにお題をもらってからブログを書くようになってきま
したw 今回のお題は，AtomPub で複数の Resource をまとめて POST する
方法についてです．

# 意外に AtomPub ネタにニーズがあるようなので，今後もマニアックな
# ネタを紹介していこうと思います

これまでにいくつか提案がありましたが，そのいずれもが標準にはなって
いません．いまの段階では，ほとんどの AtomPub サーバ・クライアントは
対応していないと思います．ただし，いくつか Google のサービスで実装
されている (されようとしている) ものがあるので，これらは "デファク
ト標準" になる かも しれません．

まとめて POST する方法は大きく 2 つに分けられます．

《続きを読む》

_ Catalyst::Controller::Atompub - コレクション URI の変更 [atompub][perl]

(追記) 情報が古くなってますので [2008-04-10-1] を参考にしてください

ZIGOROu さんから，Catalyst::Controller::Atompub でコレクション URI
を変更する方法について相談を受けました．

Catalyst::Controller::Atompubのdispatch、Slugヘッダとか - Yet Another Hackadelic

結論としては，ZIGOROu さんが自力で解決されたので僕が出る幕はない
のですが，いくつか修正とまとめをしておきます．

《続きを読む》

_ AtomPub Interop 2008 に参加してきた [atompub]

2/12に行われた AtomPub Interop (相互接続実験) に参加してきました．

# 開催後に食べた餃子が良くなかったのか，軽い食中毒になり，報告が遅
# れました．．

前回より少し多い十数名の方に参加していただき，賑やかに実験が行われ
ました．といっても，半分くらいはリコーの方だったと思います．リコー
社内での AtomPub はどういう位置づけになっているんでしょうか? リコー
のコピー機がすべて AtomPub を喋るようになるのは間違いなさそうです ;-)

今回は，会場の都合もあって半日だけという短めの開催でした．すべての
サーバ・クライアントでテストをこなすことはできませんでしたが，密度
の濃い時間を過ごせたと思います．おおむね基本的な機能には問題なく，
Media Resource まわりの複雑な部分の確認などがメインでした．

結果は こちら

僕は過去に何回か参加しているので，もうバグは見つからないかなと高を
くくっていたのですが，やっぱり出てきましたね．．近日中に
Catalyst::Controller::Atompub をアップデートしておきます．

AtomPub に限らず，最近バブルのOpenID や semantic web など幅広い議論
をすることができました．参加していただいた皆様，ありがとうございま
す．また，前回に引き続きホストを引き受けてくださった asakura 様
sakano 様はご苦労様でした．

■ Catalyst::Controller::Atompub に発見されたバグ

- Media Resource を更新したとき，対応する Media Link Entry の
  //content/@src, //content/@type が更新されない．
- Media Link Entry の必須要素である //summary が存在しない．
- エラー処理で正しいステータスコードが返らないことがある．
- POST された Media Resource が存在しないときに，400 ではなく 500
  が返る．
- いくつかの undef チェック漏れ．

_ Fude - AtomPub クライアント [atompub]

gihyo.jp の連載では，テスト用クライアントに Microsoft の Windows
Live Writer を使う予定です．Live Writer を選んだのは，「look &
feel が MS Word そっくりで，説明がいらない」というのが最大の理由で
す．また，Interop (相互接続実験) で動作確認がとれていたというのもあ
ります．

とはいえ，他にも優れたクライアントはあります．このエントリでは，
marumoto さんが開発されている Fude というクライアントを紹介します．

eXeries - XML REST Web Service API Developer Tools

《続きを読む》

_ AtomPub サーバの連載を始めました [atompub]

AtomPub Interop (相互接続実験) [2007-01-30-1] まで一週間となりまし
たが，gihyo.jp で，AtomPub サーバの連載を始めました．

特集：PerlでAtomPubサーバを作ろう！｜gihyo.jp … 技術評論社

Catalyst::Controller::Atompub という Perl モジュールを使って
AtomPub サーバを実装する方法を紹介していきます．基本的な機能だけで
なく，これまでに参加した AtomPub Interop の経験などを生かして，細か
いところまで説明したいと思います．また， 単なる AtomPub サーバだけ
でなく，最終回には全文検索機能を持った GData サーバの作り方も紹介し
ます．

よかったらご一読ください．

_ AtomPub Interop 2008-02-12 [atompub]

atom-protocol-ja でアナウンスがあったように，2/12 に AtomPub
Interop (相互接続実験) が開催されます．Interop は，AtomPub の実装
を持ち寄って，接続実験をして品質を磨いていこうというイベントです．
実装があればどなたでも参加できます．

日時・場所は公式には発表されていませんが，以下のようになると思いま
す (変更があるかもしれないので，atom-protocol-ja で確認してくださ
い)．

- 2/12 (火) 13:00-
- NTTコミュニケーションズ @ 飯田橋 (地図)

《続きを読む》

_ atom:source と XML::Atom へのパッチ [perl][atompub]

12/21 に XML開発者の日に参加してきました．

第十回XML開発者の日

内容についてはメモしてた人がいたので任せるとして，打ち上げで
id:ikasam_a と話した atom:source の扱いについてまとめておきます．

atom:source 要素はほとんど使われていない要素です．そのため，
XML::Atom にバグが残っているようです．

atom:source の使いどころと，XML::Atom のパッチについて書きます．

《続きを読む》

_ Atom on Ruby [atom][atompub][ruby]

XML::Atom や Atompub が ruby に porting されているようです．

atomutil - RubyでAtomPubを操作するパッケージをリリースしました - Codin’ In The Free World

オープンソースっていいなぁ．

_ gihyo.jp でこのサイトの Reference Implementation が紹介 [atompub]

gihyo.jp でこのサイトの Reference Implementation (仕様確認用の実装)
が紹介されています．

Web APIの次世代標準プロトコル「Atom Publishing Protocol」：第4回　Atom Publishing Protocolを試す｜gihyo.jp … 技術評論社

gihyo.jp にはかかれていませんが，GET 以外のメソッドを使うときには認
証を要求されます．詳しくは，[2007-11-19-2] をみてください．