This presentation explains how to design MVC application design pattern for micro services.

1. Spotify Web API Object
modelを使ってMVCアプリを
設計してみましょう（1）
マッシュアップしたWeb APIのモデルをKey-Value storeに永続化
Web API編

2. 自己紹介 髙尾 哲朗
システム構築のプロセス評価、改善、策定、開発フレームワークの設計、実装
管理、プリセールスやプロジェクトの立ち上げなど
ブログ ： http://blog.processtune.com
プロフィール ：Tetsuro Takao on Facebook, Twitter or
http://mvp.microsoft.com
コミュニティ ：.NETラボの運営スタッフ https://dotnetlab.connpass.com
Microsoft MVP：Developer Technologies [July 2010 – June 2020]

3. 本日のお話しするサンプルについて
1)解説はSpotifyを使用していますが、MVCとしてオ
ブジェクトモデルを使うようなアプリケーションで
あれば設計手法は流用できます。
2)Key-Value storeを使用していますが、永続化層は
本題ではありませんので使い慣れているものに置き
換えて流用ください。
3)マイクロ・サービスを題材にしていますが、マイク
ロ・サービスに限った設計方法ではありません。
4)MVC設計パターンのインプリメンテーションの一
例をお話しします。

4. サンプル・シナリオ
Web API
マッシュアップ部分 既存部分
…
…
… …
…
…
DB
ビュー
ステートフル・ミドルウェア
Value
Key
Value
Key
Actor

5. Spotify Web API Object Model
https://developer.spotify.com/documentation/web-api/reference/object-model/

6. Deserialize Object
var currentUser = JsonConvert.DeserializeObject<SpotifyUser>(getMe);

7. Spotify User Object Model

8. Type Resolver

9. Spotify Swagger.yaml
https://github.com/APIs-guru/openapi-directory/blob/master/APIs/spotify.com/v1/swagger.yaml

10. Swagger UI
https://swagger.io/tools/swagger-ui/

11. NSwag と ASP.NET Core の概要
https://docs.microsoft.com/ja-jp/aspnet/core/tutorials/getting-started-with-nswag?view=aspnetcore-3.
0&tabs=visual-studio

12. YamlDotNet
https://github.com/aaubry/YamlDotNet

13. YamlDotNetをインストール

14. public Tuple<string, List<Tuple<string, string>>> GetType(string objectName)
{
Tuple<string, List<Tuple<string, string>>> result = null;
var client = new WebClient();
var yamlAddress = new Configuration().Get("SpotifyYaml");
string yamlText = client.DownloadString("https://" + yamlAddress);
var input = new StringReader(yamlText);
var yaml = new YamlStream();
yaml.Load(input);
var mapping =(YamlMappingNode)yaml.Documents[0].RootNode;
var spotifyObjects = new List<Tuple<string, List<Tuple<string,string>>>>();
foreach (var entry in mapping.Children)
{
if (entry.Key.ToString()== "definitions")
{
var classes = (entry.Value as YamlMappingNode).Children.Keys;
foreach (var n in (entry.Value as YamlMappingNode).Children)
{
List <Tuple<string, string>> propertiesTemp = new List<Tuple<string, string>>();
foreach (var cn in (n.Value as YamlMappingNode).Children)
{
if (cn.Key.ToString() == "properties")
{
var properties = (cn.Value as YamlMappingNode).Children.Keys;
Tuple<string, string> temp = null;
foreach (var gcn in (cn.Value as YamlMappingNode).Children)
{
var tempVal = string.Empty;
if ((gcn.Value as YamlMappingNode).Children.Where(c => c.Key.ToString() == "type").Count() > 0)
{
tempVal = (gcn.Value as YamlMappingNode).Children.Where(c => c.Key.ToString() == "type").FirstOrDefault().Value.ToString();
temp = new Tuple<string, string>(gcn.Key.ToString(), tempVal);
propertiesTemp.Add(temp);
}
else if ((gcn.Value as YamlMappingNode).Children.Where(c => c.Key.ToString() == "$ref").Count() > 0)
{
tempVal = (gcn.Value as YamlMappingNode).Children.Where(c => c.Key.ToString() == "$ref").FirstOrDefault().Value.ToString();
tempVal = tempVal.Replace("#/definitions/", "");
tempVal = tempVal.Replace("'", "");
temp = new Tuple<string, string>(gcn.Key.ToString(), tempVal);
propertiesTemp.Add(temp);
}
}
break;
}
}
spotifyObjects.Add(new Tuple<string, List<Tuple<string, string>>>(n.Key.ToString(), propertiesTemp));
}
}
}
result = spotifyObjects.Where(r => r.Item1 == objectName).FirstOrDefault();
return result;
}
public Tuple<string, List<Tuple<string, string>>> GetType(string objectName)
var yamlAddress = new Configuration().Get("SpotifyYaml");
string yamlText = client.DownloadString("https://" + yamlAddress);
var yaml = new YamlStream();
yaml.Load(input);
var mapping =(YamlMappingNode)yaml.Documents[0].RootNode;
foreach (var entry in mapping.Children)
{
if (entry.Key.ToString()== "definitions")
{
var classes = (entry.Value as YamlMappingNode).Children.Keys;
foreach (var n in (entry.Value as YamlMappingNode).Children)
{
var propertiesTemp = new List<Tuple<string, string>>();
foreach (var cn in (n.Value as YamlMappingNode).Children)
{
if (cn.Key.ToString() == "properties")

15. public Tuple<string, List<Tuple<string, string>>> GetType(string objectName)
{
Tuple<string, List<Tuple<string, string>>> result = null;
var client = new WebClient();
var yamlAddress = new Configuration().Get("SpotifyYaml");
string yamlText = client.DownloadString("https://" + yamlAddress);
var input = new StringReader(yamlText);
var yaml = new YamlStream();
yaml.Load(input);
var mapping =(YamlMappingNode)yaml.Documents[0].RootNode;
var spotifyObjects = new List<Tuple<string, List<Tuple<string,string>>>>();
foreach (var entry in mapping.Children)
{
if (entry.Key.ToString()== "definitions")
{
var classes = (entry.Value as YamlMappingNode).Children.Keys;
foreach (var n in (entry.Value as YamlMappingNode).Children)
{
List <Tuple<string, string>> propertiesTemp = new List<Tuple<string, string>>();
foreach (var cn in (n.Value as YamlMappingNode).Children)
{
if (cn.Key.ToString() == "properties")
{
var properties = (cn.Value as YamlMappingNode).Children.Keys;
Tuple<string, string> temp = null;
foreach (var gcn in (cn.Value as YamlMappingNode).Children)
{
var tempVal = string.Empty;
if ((gcn.Value as YamlMappingNode).Children.Where(c => c.Key.ToString() == "type").Count() > 0)
{
tempVal = (gcn.Value as YamlMappingNode).Children.Where(c => c.Key.ToString() == "type").FirstOrDefault().Value.ToString();
temp = new Tuple<string, string>(gcn.Key.ToString(), tempVal);
propertiesTemp.Add(temp);
}
else if ((gcn.Value as YamlMappingNode).Children.Where(c => c.Key.ToString() == "$ref").Count() > 0)
{
tempVal = (gcn.Value as YamlMappingNode).Children.Where(c => c.Key.ToString() == "$ref").FirstOrDefault().Value.ToString();
tempVal = tempVal.Replace("#/definitions/", "");
tempVal = tempVal.Replace("'", "");
temp = new Tuple<string, string>(gcn.Key.ToString(), tempVal);
propertiesTemp.Add(temp);
}
}
break;
}
}
spotifyObjects.Add(new Tuple<string, List<Tuple<string, string>>>(n.Key.ToString(), propertiesTemp));
}
}
}
result = spotifyObjects.Where(r => r.Item1 == objectName).FirstOrDefault();
return result;
}
tempVal = (gcn.Value as YamlMappingNode).Children.Where(c => c.Key.ToString() == "type").FirstOrDefault().Value.ToString();
temp = new Tuple<string, string>(gcn.Key.ToString(), tempVal);
propertiesTemp.Add(temp);
tempVal = (gcn.Value as YamlMappingNode).Children.Where(c => c.Key.ToString() == "$ref").FirstOrDefault().Value.ToString();
tempVal = tempVal.Replace("#/definitions/", "");
tempVal = tempVal.Replace("'", "");
temp = new Tuple<string, string>(gcn.Key.ToString(), tempVal);
propertiesTemp.Add(temp);
foreach (var gcn in (cn.Value as YamlMappingNode).Children)

16. How to dynamically create a class?
https://stackoverflow.com/questions/3862226/how-to-dynamically-create-a-class

17. Configuration：コンストラクタ
public class Configuration
{
IConfigurationRoot config { get; set; }
public string Get(string key,string ver="Current")
public bool Set(string key,string val, string ver =
"Current")
public Configuration()
{
var builder = new ConfigurationBuilder();
builder.AddJsonFile("settings.json");
config = builder.Build();
}
}

18. Configuration：Get
public string Get(string key,string ver="Current")
{
string result = string.Empty;
if (ver == "Current")
{
result = config.GetSection(key).Value;
}
else
{
var builder = new ConfigurationBuilder();
builder.AddJsonFile("settings" + ver + ".json");
config = builder.Build();
result = config.GetSection(key).Value;
}
return result;
}

19. Configuration：Set
try
{
if (ver == "Current")
{
config.GetSection(key).Value = val;
}
else
{
var builder = new ConfigurationBuilder();
builder.AddJsonFile("settings" + ver + ".json");
config = builder.Build();
config.GetSection(key).Value = val;
}
result = true;
}
catch (Exception ex)
{
System.Diagnostics.Debug.WriteLine(ex.Message);
}

20. settings.json
{
"ClientId": "…",
"ClientSecret": "…",
"AesCryptoServiceProvider Key": "…",
"AesCryptoServiceProvider IV": "…",
"SpotifyYaml": "raw.githubusercontent.com/APIs-guru/openapi-directory/master/APIs/spotify.com/v1/swagger.yaml"
}
https://github.com/APIs-guru/openapi-directory/blob/master/APIs/spotify.com/v1/swagger.yaml
raw.githubusercontent.com/APIs-guru/openapi-directory/master/APIs/spotify.com/v1/swagger.yaml

21. Encryptor.cs

22. 認証～ユーザー情報を取得する

23. Microsoft Graph ツールキット
https://docs.microsoft.com/ja-jp/graph/toolkit/overview

24. 認証～ユーザーがログインをクリックした時の動作

25. 認証～認証画面から戻ってきた時の動作

26. Demo
Spotify Developer Consoleを説明する
Postmanでカレントユーザー情報を取得する
Spotify Web APIにアクセスする
プログラムでカレントユーザー情報を取得する
開発時に使用するデータ（yaml）を参照する

27. Conclusion
マイクロサービスでは、ドメイン内のデータソースで
完結するソリューションは多くない
サービス経由で情報の授受を行うときはOpen APIな
どに準拠したインターフェイス情報の公開、および受
信の実装が工数軽減につながる
実装の範囲を的確に判断する。必要のないSwagger
UIの実装やクラスの動的生成は本当に必要かどうか要
件を明確にする

28. Source
Spotify for developers
https://developer.spotify.com/
Postman | API Development Environment
https://www.getpostman.com/
Open API Directory
https://github.com/APIs-guru/openapi-directory
Swagger
https://swagger.io/
Swagger/OpenAPI を使用する ASP.NET Core Web
API のヘルプ ページ
https://docs.microsoft.com/ja-jp/aspnet/core/tutorials/web-api-help-pages-using-
swagger?view=aspnetcore-3.0

29. Source
YamlDotNet
https://github.com/aaubry/YamlDotNet
How to dynamically create a class?
https://stackoverflow.com/questions/3862226/how-to-dynamically-create-a-class
The Microsoft Graph Toolkit
https://github.com/microsoftgraph/microsoft-graph-toolkit
Getting Started with the Microsoft Graph Toolkit
https://www.youtube.com/watch?v=oZCGb2MMxa0
Sampleソリューション・ソースコード
https://github.com/TetsuroTakao/SpotifyWebAPISample