概要 Goa v3 のちょっとした説明からサンプルデザインでのサーバ起動、アクセス、swagger-ui の利用までを簡単にまとめました。 Goa v3 について Goa はひとつのデザインを書くだけで、サーバ・クライアント、swagger ドキュメントを生成できる API フレームワークです。 最近、プロジェクトが進み、Goa に v2, v3 という2つのバージョンが加わりました。 といっても、v2, v3 の違いは go.mod サポートなし/ありの違いだけです。 私見としては、v2 は過渡期に用意されたという位置づけで、v3 に移行していくのかなと思います。 また、go 1.13 から GO111MODULE=auto の振る舞いが変更されて、go.mod 対応必須の環境が整いつつあることを考えると、 これから Goa の新しいバージョンを試すなら v3 をやっていくのがいいのでは

goa には静的ファイル配信のための DSL として Files が用意されており、以下のような定義を行うと FileServer を生成してくれます。 Files("/swagger/*filepath", "public/swagger/") 生成される FileServer は http.FileSystem という interface を通してファイルオープンを行うのですが、従来は http.Dir という実装を固定で使う仕様になっていました。 http.Dir は実行環境のネイティブファイルシステムからファイルオープンを行います。これは、ビルドしたバイナリを実行環境にデプロイする際に Files で定義した静的ファイルもそのファイルシステム上に配置する必要がある、ということを意味します。 Go は、ビルドしたバイナリひとつをデプロイすれば動作する、いわゆるシングルバイナリが魅力の

スニペットづくりのためにコード読んでいて気づいたのでメモ。 v1の方。 Attributeとは AttributeはView, Type, Attribute, Attributesの中で使える関数で、属性を指定するのに使用する。nested attributeってのがあるらしく、Attributeの中でAttributeが使えるらしいが、よくわからない。 Attributeの引数 ドキュメントによると、Attributeの定義は以下のようになっている。 https://goa.design/reference/goa/design/apidsl/#func-attribute-a-name-apidsl-attribute-a func Attribute(name string, args ...interface{}) 1つ目がAttributeの名前になるstringで、2つ目はi

istyle.connpass.com LTしてきました。色々学びあって楽しかったです。 会場提供のistyleさんありがとうございました。 少しだけ補足説明とexampleコードを書いたので紹介しようと思います。 LTした資料 speakerdeck.com 注意点 goとgoaについてすでにある程度理解がある人向けです goaのversionは、v1.2.0の前提で話しています go generate使ってコード生成して開発する流れについて –forceをつけることで毎回mainのgenerateは作り直してます。 //go:generate goagen -o gen main --force -d github.com/kyokomi/example_goa_api/_design //go:generate goagen -o gen app -d github.com/kyok

connpass.com goa って何？ goa ってのは golang で APIデザインを書くと，そこから API サーバのモックとかクライアントとかドキュメントとか一通り生成してくれるマイクロサービス用のフレームワークのことです． goa は golang のソースとして DSL が書けて，そいつを goa にかけてやることでコードを生成します．ぱっと聞いた感じ，最初に抱く印象は「キモい」だと思うんですが，json や yaml を書いてコードを生成するよりかなり見通しよくAPIがデザインできると思いますし，なにより，goa の生成するコードがすごく読みやすいコードで，使ってるウチにだんだん「goa (キモ)かわいいな」と思うようになってきました．goa 自体のコードも変態的(コード生成プログラムなのでしょうがない)でありながら読みやすいコードで書かれているのも好印象です． Web