ドキュメントとコードが乖離しないように DMM .com のエンジニアが教えるGoaを使ったAPIサーバーの作りかた
DMM Groupのエンジニアが、Goを活用したプロダクト事例やトレンド、現場のリアルを話すイベント「DMM.go」。2回目の今回は、DMM.com プラットフォーム事業本部 エンジニアの本田雄亮氏が、Goaを使ってAPIサーバーを作る方法について紹介しました。関連資料はこちら。 手作業のドキュメントとコードとは乖離する 本田雄亮氏：今回、「Goaを使ってAPIサーバー開発してみた」というタイトルでお話ししたいなと思います。 まず自己紹介です。プラットフォーム部というところで基盤システムの開発をしています。バックエンドのエンジニアです。名前は本田です。興味あるのは、Goとかアーキテクチャ。DDDとかがけっこう好きなので、もし懇親会に参加される方がおられたら、Goaだけの話じゃなくて、Go全般だったりアーキテクチャ、DDDまわりでもお話できたらなと思っています。 さっそくメインテーマのGoa
goa で Type と MediaType を混ぜないでうまく再利用する - 押してダメならふて寝しろ
概要 goa では レスポンスの形式を MediaType で定義します．一方，Type は Payload の形式などを定義します． MediaType は Type の特殊な形で，Veiw とか Link が増えたやつなので，Type の代わりに使えるんですけど， Type の代わりに使うと振る舞いが微妙に違うことから変なことになったりするので，代わりに使うのはやめておきたいところです． でも，Payload で使う要素とMediaTypeで使う要素は大体一緒のことが多く，同じ事を何度も書いたりするのはダルいこともありますし， Attribute を流用したいということも多いのではないでしょうか． Attribute を流用するいくつかの場面，方法について説明したいと思います． Reference 関数を使う Reference 関数を使うと，すでに定義済みの Type や Media
goa tips : Type と MediaType を使い分けよう - 押してダメならふて寝しろ
はじめに MediaType と Type の意味を理解してを適切に使い分けましょう（自戒． よく間違えます．github の issue とか goa の slack channel にもよく質問が上がってます． MediaType はレスポンスの形式 MediaType は Type としても利用できますが，本来の意味的にはレスポンスデータです． Payload の要素に MediaType を利用することは可能ですが，MediaType で指定したいと思っているデータ形式と同等のものを Type で定義してそれで指定するのが無難でしょう．Payload の要素に MediaType を使って，これに Example を適用するとうまく設定できないケースがあるため（バグ？）その観点からも避けた方がよさそうです． また，MediaType の定義には，MediaType を利用することは
Swagger 定義から goa の design を生成する ago という CLI を作りはじめた - tchsskのブログ
これは Go (その2) Advent Calendar 2016 の 17 日目の記事です。 ここ半年ほど goa というフレームワークを気に入って使っているのですが、思うところがあって goa に関連する ago という CLI を作りはじめました。この記事では、簡単な goa の説明から、今回の開発に至った経緯と、このツールで行えることについて記述します。 goa とは Go でマイクロサービスな Web API を作るためのフレームワークです。 github.com goa の DSL で design と呼ばれる定義を書いたら、 goagen というジェネレータを使ってサーバやクライアントなど各種のコードを生成することができます。毎度リンクを貼らせて頂いているのですが @ikawaha さんによる連載記事が本当にオススメです。 ikawaha.hateblo.jp goa 流行ら
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
Go APIs: Just Generate Everything With Goa
