スキップしてメイン コンテンツに移動

API for Democracy - APIデザインの極意

APIデザインの極意 Java/NetBeansアーキテクト探究ノート『APIデザインの極意』を読んだ。メイントピックは2つ。APIの選択的無知と後方互換性。詳細に立ち入らなくても使えることと、安心して使い続けられることの重要性について綴られている。

全3部構成になっていて、第1部「理論と正当性」は動機付け。選択的無知と後方互換性の重要性について語られている。第2部「実践的設計」がその手段。デザインパターンほどには抽象化されていないけれど、NetBeansのアーキテクトを務めた著者が解説とともに例示してくれていて、参考になりそう(あまり読み込めていない)。第3部「日々の生活」は、プラクティカルにはどうしていくか? という話がメイン。それから、将来の展望について。

現時点で理解できたのは一部だったけれど、いろいろな実践例が示されていている。覚えておきたいことがいくつもあった。
ライブラリのほとんどのユーザは、ライブラリ内で何が行われているかほとんど分かっていません、そうあるべきなのです。
ライブラリのAPIを「もっと優れた」ものにしたいと思う願望があります。(中略)しかし、最初のリリース後は、既存のAPIクライアントのコードを機能させなくなる問題よりも重要になることはありません。
ライブラリを作るだけでなく、使う時にも参考になる。ライブラリのユーザとしての視点から、将来的に機能しなくなるリスクが大きくなる使い方も読み取れる。

でも読んでいて感じたのは、何を作るにしても、APIを使うだけなんてことはないということ。作っているのがフレームワークやライブラリじゃなくても、使っているライブラリにラッパー(DDDの「腐敗防止層」、GoFの"Adapter"あるいは"Façade")を被せることだって立派なAPI設計だ。何を作るにしても、API設計を全くしないなんてことはなさそうだ。
隣の部屋の同僚が使用するクラスを1つ書いたとしても、APIを実際に作成していることになります。

このブログの人気の投稿

北へ - ゴールデンカムイ 16

『ゴールデンカムイ 15』、『〃 16』を読んだ。16巻を読み始めてから、15巻を買ったものの読んでいなかったことに気がつく。Kindle版の予約注文ではままあること。 15巻は「スチェンカ・ナ・スチェンク」、「バーニャ(ロシア式蒸し風呂)」と男臭いことこのうえなし。軽くWebで調べてみたところ、スチェンカ・ナ・スチェンク (Стенка на стенку) はロシアの祭事マースレニツァで行われる行事のようだ[1]。それなりになじみ深いものらしく、この行事をタイトルに据えたフォークメタルStenka Na StenkuのMVが見つかった。 16巻では杉元一行は巡業中のサーカスに参加することになる。杉元と鯉登の維持の張り合いが、見ていて微笑ましい。鯉登は目的を見失っているようだが、杉元もスチェンカで我を失っていたので、どっこいどっこいか。なお、サーカス/大道芸を通じた日露のつながりは、実際にもこのような形だったようだ[2]。 個々のエピソードから視線を上げて、全体の構図を眺めてみると、各勢力がすっかり入り乱れている。アシㇼパは尾形、キロランケ、白石とともにアチャの足跡を辿り、そのあとを鶴見のもとで家永の治療を受けた杉元が鯉登、月島を追っている。今更だけれど、杉元やアシㇼパは、第七師団と完全に利害が衝突していると考えていないはずだった。一方で、土方一味も入墨人皮を継続。むしろ彼らの方が第七師団との対立が深刻だろう。さらに北上するキロランケはまた別の目的で動いているようだけれど、なんで尾形も一緒なんだっけ? 『進撃の巨人』に引き続き、これもそろそろ読み返す時期か。 [1] 5つの暴力的な伝統:スラヴ戦士のようにマースレニツァを祝おう - ロシア・ビヨンド [2] ボリショイサーカスの源流は、ロシアに渡った幕末日本の大道芸人たちにあった 脈々と息づく「クールジャパン」 | ハフポスト

戦う泡沫 - 終末なにしてますか? もう一度だけ、会えますか? #06, #07

『終末なにしてますか? もう一度だけ、会えますか?』の#06, #07を読んだ。 『終末なにしてますか? もう一度だけ、会えますか?』の#06と#07を読んだ。#06でフェオドールの物語がひとまずは決着して、#07から第二部開始といったところ。 これまでの彼の戦いが通過点のように見えてしまったのがちょっと悲しい。もしも#07がシリーズ3作目の#01になっていたら、もう少し違って見えたかもしれない。物語の外にある枠組みが与える影響は、決して小さくない。 一方で純粋に物語に抱く感情なんてあるんだろうか? とも思う。浮かび上がる感情には周辺情報が引き起こす雑念が内包されていて、やがて損なわれてしまうことになっているのかもしれない。黄金妖精 (レプラカーン) の人格が前世のそれに侵食されていくように。

リアル・シリアル・ソシアル - アイム・ノット・シリアルキラー

『アイム・ノット・シリアルキラー』(原題 "I Am Not a Serial Killer")を見た。 いい意味で期待を裏切ってくれて、悪くなかった。最初はちょっと反応に困るったけれど、それも含めて嫌いじゃない。傑作・良作の類いではないだろうけれど、主人公ジョンに味がある。 この期待の裏切り方に腹を立てる人もいるだろう。でも、万人受けするつもりがない作品が出てくるのって、豊かでいいよね(受け付けないときは本当に受け付けないけれど)。何が出てくるかわからない楽しみがある。