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

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] ボリショイサーカスの源流は、ロシアに渡った幕末日本の大道芸人たちにあった 脈々と息づく「クールジャパン」 | ハフポスト

Memory Free - 楽園追放 2.0 楽園残響 -Goodspeed You-

『楽園追放 2.0 楽園残響 -Goodspeed You-』を読んだ。映画 『楽園追放 -Expelled from Paradise-』 の後日譚にあたる。 前日譚にあたる『楽園追放 mission.0』も読んでおいた方がいい。結末に言及されているので、こちらを先に読んでしまって後悔している。ちなみに、帯には「すべての外伝の総決算」という惹句が踊っているけれど、本作の他の外伝はこれだけ [1] 。 舞台は本編と同じでディーヴァと地球だけれど、遥か遠く外宇宙に飛び立ってしまったフロンティアセッターも〈複製体〉という形で登場する。フロンティアセッター好きなのでたまらない。もし、フロンティアセッターが登場していなかったら、本作を読まなかったんじゃないだろうか [2] 。 フロンティアセッターのだけでなくアンジェラの複製体も登場するのだけれど、物語を牽引するのはそのどちらでもない。3人の学生ユーリ、ライカ、ヒルヴァーだ。彼らの視点で描かれる、普通の (メモリ割り当てが限られている) ディーヴァ市民の不自由さは、本編をよく補完してくれている [3] 。また、この不自由さはアンジェラの上昇志向にもつながっていて、キャラクタの掘り下げにも一役買っていると思う。アンジェラについては前日譚である『mission.0』の方が詳しいだろうけれど。 この3人の学生と、フロンティアセッターとの会話を読んでいると、フロンティアセッターがフロンティアセッターしていて思わず笑みがこぼれてしまう。そうして、エンディングに辿りついたとき、その笑みが顔全体に広がるのを抑えるのに難儀した。 おめでとう、フロンティアセッター。 最後に蛇足。関連ツイートを 『楽園残響 -Goodspeed You-』読書中の自分のツイート - Togetterまとめ にまとめた。 [1] 『楽園追放 rewired サイバーパンクSF傑作選』は『楽園追放』と直接の関係はない。映画の脚本担当・虚淵玄さんが影響を受けたSF作品を集めた短編集。 [2] フロンティアセッターは登場しないと思って『mission.0』を読んでいない。 [3] 本編では、保安局高官の理不尽さを通して不自由さこそ描かれてはいたものの、日常的な不自由は描かれていなかったように思う。アンジェラも凍結される前は豊富なメ

報復前進

『完全なる報復 (原題: Law Abiding Citizen)』 を観た。 本作では、家族を押し入り強盗に殺された男クライドが、その優れた知能と技術でもって犯人に報復する。 ここまでで半分も来ていない。本番はここから。 クライドの報復はまだまだ続く。 一見不可能な状態からでも確実に報復を続けるクライドが、冷静なのか暴走しているのか分からず、 緊張感をもって観ていられた。 欲を言えば、結末にもう一捻りあると嬉しかった。 ちょっとあっさりし過ぎだと感じてしまった。