Enterprise APIs Hack Night #1で発表したスライドです。 http://eahn.connpass.com/event/18013/

1. レガシーなシステムに
WebAPIを実装して
なみだ目になったので
ちょっといろいろ教えてください
2015.9.3 Enterprise APIs Hack Night #1
Isamu Suzuki
Rakus Co., Ltd.

2. 鈴木 勇
• 株式会社ラクス
• 請求書発行サービスを開発してます
• 仕事ではJava＋JavaScript少し
• プライベートはJavaScriptに全力投資中
• 最近Pythonに浮気開始

3. 弊社サービスに
WebAPIを実装した話

4. 使っているもの
• Seasar2 + 自社Framework
• Apache 2.2 + Tomcat 7.0
• PostgreSQL 9.1
• CentOS 6.5

5. こんなことやりました
• Seasar2を拡張
→PUT, DELETEに対応
→RequestボディのJSONを
クエリパラメタ同様に扱えるように
• HTML(JSP)ではなくJSON返すように実装
→ファイルDLとかでmime-typeを指定する要領

6. こんなことやりました
• ビジネスロジックは既存をほぼ完全に共有
→業務要件の2重管理は死亡フラグ
• Viewは新規作成
• ViewとLogicのI/F部分も新規作成
• 主要機能のみ対応（スモールスタート的に）

7. 参考文献
apigeeさん
マジ神

8. なみだ目になったことなど

9. こうすればいいのに
このツール良いよ
情熱的に考えてこうするだろJK
教えていただきたく(必死)

10. ハッシュタグはこちら
#entapihack

11. その1

12. BtoBならJSONだけじゃなく
XMLも対応したほうが
いいんじゃない？
（社内の声）

13. #entapihack

14. 現実
↓
#entapihack

15. WebAPI呼ぶ側は
レスポンスを処理するから
これから実装するはず
#entapihack

16. XML扱えて
JSON扱えないはずがない
#entapihack

17. お客さんから要望来るまで
保留になりました
#entapihack

18. その2

19. リソース設計慣れないと
イケてない設計しちゃう

20. 既存画面の設計に
リソース設計が引きずられた
#entapihack

21. 各リソースの状態を
一覧する画面を
API化しようとした
#entapihack

22. リソースの状態を
取得するAPI
#entapihack

23. こんな設計にした
GET /resources/999/state
※999はリソースID
#entapihack

24. 素直に
GET /resources/999
で良かったと反省
進 以外の状態も
まとめて返せばいいだけだった
#entapihack

25. その3

26. ドキュメントつらたん

27. APIには充実した
ドキュメントが必要

28. みなさんどうやってますか？
#entapihack

29. ①apigee API Management
#entapihack

30. ②SwaggerとかのOSSな
マニュアルフレームワーク
#entapihack
これもapigeeさんだったり

33. ③API仕様のページを公開
#entapihack
NTT Com Developer Portalみたいな

34. ＿人人人人人人人人人＿
＞ ④Word / Excel ＜
￣Y^Y^Y^Y^Y^Y^Y￣
#entapihack

35. みなさんなら
どうや(ることにな)りそう
ですか？
#entapihack

36. 頑張ってみたこと

37. HATEOAS
• WEBページのように次に参照するリソースの
URIをレスポンスに含んであげること
• 初期設計が甘かったせいで
GET /path/to/resources が実装されていない
リソースがある

38. 最後に

39. 株式会社ラクスは
エンジニアを募集しています
「鈴木の発表を見た」
とお問い合わせください
会社WEBページより
申し込みどうぞ