2018-09-06

.NET で Firestore

Name: 洋食 八坪亭
Address: 清川1-12-7, 福岡市中央区, 福岡県, 810-0005, JP
Telephone: 092-531-0720

C# Firebase

Firebase を使ってアプリをサクッと作れるようになりたかったので勉強することにした。まずは Firestore。アプリは Xamarin で作るつもりなので、C# から Firestore を触ってみる。NuGet で専用のパッケージが公開されているので、それを使う。まだベータ版だけど、Firestore 自体まだベータ版だし。

www.nuget.org

Firestore で CRUD をやるサンプルを書いてみた。コードはサクッと書けたけど、GCP 外から Firestore にアクセスするために必要な、アクセスキーファイルを入手するのが最初にして最大の関門だった。GCP の「API とサービス」の「認証情報」でサービスアカウントを作成して、アクセスキーファイルをダウンロードしておかないといけない。

using Google.Cloud.Firestore;
using System;
using System.Collections.Generic;
using System.IO;
using System.Threading.Tasks;

namespace FirestoreSample
{
    class Program
    {
        const string ProjectId = "your-project-id";

        static void Main(string[] args)
        {
            // API とサービスの認証情報でサービスアカウントを作成し、
            // ダウンロードしたアクセスキーファイルのパスを環境変数で指定
            Environment.SetEnvironmentVariable(
                "GOOGLE_APPLICATION_CREDENTIALS",
                Path.Combine(AppContext.BaseDirectory, "your-key.json"));

            MainAsync().GetAwaiter().GetResult();

            Console.WriteLine("Press Enter Key.");
            Console.ReadLine();
        }

        static async Task MainAsync()
        {
            var db = FirestoreDb.Create(ProjectId);

            // books コレクションにドキュメント追加
            var book1Ref = await db.Collection("books")
                .AddAsync(new Dictionary<string, object>()
                {
                    ["title"] = "かぐや様は告らせたい",
                    ["price"] = 500,
                });

            // books コレクションに ID 指定でドキュメント追加
            var book2Ref = db.Collection("books").Document("bokuben");
            await book2Ref.CreateAsync(new Dictionary<string, object>()
            {
                ["title"] = "ぼくたちは勉強ができない",
                ["price"] = 450,
            });

            // books を価格順にソートして取得
            var querySnapshot = await db.Collection("books")
                .OrderBy("price")
                .GetSnapshotAsync();
            foreach (var doc in querySnapshot.Documents)
            {
                Console.WriteLine($"{doc.GetValue<string>("title")}({doc.GetValue<int>("price")}円)");
            }

            // ドキュメントを更新
            await db.Collection("books")
                .Document("bokuben")
                .SetAsync(new Dictionary<string, object>()
                {
                    ["price"] = 420,
                }, SetOptions.MergeAll);

            // ID を指定して 1 件取得
            var documentSnapshot = await db.Collection("books")
                .Document("bokuben")
                .GetSnapshotAsync();
            Console.WriteLine($"{documentSnapshot.GetValue<string>("title")}({documentSnapshot.GetValue<int>("price")}円)");

            // ドキュメントを削除
            await db.Collection("books")
                .Document(book1Ref.Id)
                .DeleteAsync();
            await db.Collection("books")
                .Document("bokuben")
                .DeleteAsync();
        }
    }
}

実行してみた結果は下の通り。

f:id:griefworker:20180904163909p:plain

Xamarin だとロジックの大部分を iOS と Android で共有できるので、Firestore を単純にデータベースとして使い、ロジックを .NET Stadard ライブラリとして書いて、iOS と Android から使う戦略が使えそう。

2018-09-05

『WEB+DB PRESS Vol.106』を読んだ

読書

『WEB+DB PRESS Vol.106』を読み終わったので、毎度の感想メモ。

特集1: [コードで超わかる！]実践Android/iOSアプリ設計

.NET の WPF で生まれた MVVM が、今では Android /iOS の開発で有力なアーキテクチャになるとは感慨深いものがある。Android はデータバインディングを公式にサポートしているのに対し、iOS は RxSwift を使って頑張らないといけないのがツライが。

MVVM に Flux を組み合わせるのはやり過ぎなのではと思うんだけど、採用事例が多いんだろうか。自分が MVVM をやるなら、モデルはドメイン駆動開発風味のレイヤーアーキテクチャでやるだろうな。もしくは、View と ViewController に ReSwift(Redux)。

特集2: [速習]Spring Boot

Java は 10 から型推論が入ったし、ラムダ式も 8 から使えるし、IntelliJ IDEA という強力な IDE もあって、その書き心地はだいぶ Lightweight になったと言っていいと思う。 SpringBoot は Rails の scaffolding ほどの衝撃では無いにせよ、Java での Web 開発でツラかった部分が改善されて、LL のメジャーな Web Application Framework と遜色ない生産性に思えた。

もともと Java のエコシステムの充実っぷりは頭一つ抜きでているし、自分なら Scala で Play Framework よりは Java + SpringBoot を選ぶな。エコシステムどうにかしないと .NET は勝ち目ないよねぇ。

特集3: 仮想DOM革命

仮装 DOM の差分更新によって、ビューを「状態を受け取り HTML/JSX を返す関数」と見なせるようになったのは革命だと思う。そこからさらに進んで Flux のような単方向データフローのアーキテクチャが生まれたし、フロントエンドの世界に与えた影響は jQuery と同じかそれ以上かもしれない。

その証拠に、仮装 DOM はブラウザを飛び出し、React Native や Flutter でアプリの世界へ。仮装 DOM を今から初めて遅すぎることはなく、React の他に Vue も仮想 DOM を採用していることからも、jQuery 同様長く生きるのは間違いなさそう。

WEB+DB PRESS Vol.106

作者: 成田元輝,杉浦颯太,小和瀬塁,山中大輔,末田正樹,藤野真聡,竹馬光太郎,桑原仁雄,倉長拓海,牧大輔,秋山卓巳,前田雅央,星北斗,末永恭正,久保田祐史,池田拓司,はまちや2,竹原,WEB+DB PRESS編集部
出版社/メーカー: 技術評論社
発売日: 2018/08/24
メディア: 単行本
この商品を含むブログを見る

2018-09-03

Swashbuckle.AspNetCore で Failed to load API definition に遭遇したら

C# ASP.NET Core

開発中の Web API に後から Swashbuckle.AspNetCore を追加したはいいけど、いざ Swagger UI を表示してみたら「Failed to load API definition」というエラーになって API 一覧が見れない。こんな感じのやつ。

f:id:griefworker:20180903160836p:plain

このエラーに遭遇したら、ググる前にまず swagger.json がちゃんと生成されているか確認すること。

今回の場合、/swagger/v1/swagger.json にアクセスしてみたら、スキーマ ID が重複しているのが原因だとわかった。スキーマ ID はデフォルトだとクラス名が使われるので、名前空間を含めたクラス名をスキーマ ID に使うように、Startup 内で指定したら解決。

services.AddSwaggerGen(c =>
{
    c.SwaggerDoc("v1", new Info
    {
        Title = "My API",
        Version = "v1"
    });

    // スキーマ ID は名前空間含めたクラス名にする
    c.CustomSchemaIds(type => type.FullName);
});

何度もハマったので、忘れないようにメモを残して置く。