Dapr微服务应用开发系列2：Hello World与SDK初接触

题记：上篇介绍了Dapr的环境配置，这次我们来动手尝试一下Dapr应用的开发

Hello World

Dapr应用的Hello World其实和其他的Hello World一样简单：

首先用你喜欢的语言和框架创建一个Hello World程序。比如在.NET 5下，就可以简单的这样实现 dotnet new console -o dapr-hello-world
只是运行这个Hello World不是直接启动程序，而是通过Dapr来启动：dapr run --app-id hello-dotnet-dapr -- dotnet run
上面这个命令，通过传入一个app-id参数来指明这个Dapr应用的名称为“hello-dotnet-dapr”，当然你也可以忽略这个参数，那么Dapr会自动分配一个（如docker运行容器实例那样）
而“--”之后就是应用程序本身的启动命令行

PS：对于dapr run更多的帮助信息，可以通过 dapr run --help 来查看

服务调用的Hello World

接下来，我们来做一个服务调用的Hello World。我还是基于.NET 5中的ASP.NET Core来作为开发框架：

在命令行中输入如下命令来创建一个ASP.NET Core的Web API项目：dotnet new webapi -o dapr-service-invocation --no-https --no-openapi
然后就可以使用Dapr CLI来运行这个服务了：dapr run --app-id dotnetapp --app-port 5000 --dapr-http-port 13501 -- dotnet run
其中通过app-port参数指明了这个Web API服务的侦听端口为5000，让Dapr知道如何和你的应用进行配对；使用dapr-http-port参数指明了Dapr边车暴露的http端口为13501，方便外部或者其他Dapr边车知道如何和你的应用边车进行交互。
Dapr应用起来之后，就可以使用VS Code的REST Client插件来访问其中的地址了：GET http://localhost:13501/v1.0/invoke/dotnetapp/method/WeatherForecast

示例代码可以参见这里：https://github.com/heavenwing/dapr-dotnet-quickstarts/tree/main/ServiceInvocation

状态管理的Hello World

状态管理的Hello World稍微复杂一点。你可以把对Dapr状态管理接口的访问代码添加到第一个示例当中（控制台程序）也可以添加到第二个示例当中（Web应用程序）。我们来基于控制台程序访问状态管理接口：

1，新建或者打开现有的一个dotnet控制台程序，首先创建如下实体类：

publicclassOrder
{
    publicint Id { get; set; }

    publicint Amount { get; set; }
}

2，在Program中添加如下常量或静态字段：

staticstring daprPort = Environment.GetEnvironmentVariable("DAPR_HTTP_PORT") ?? "3500";
conststring stateStoreName = "statestore";//default state store name
conststring stateKey = "order-17";
staticstring stateUrl = $"http://localhost:{daprPort}/v1.0/state/{stateStoreName}";

其中第1句，从环境变量中得到Dapr边车暴露的http端口；第2句设置状态存储空间名称，Dapr本地开发环境会提供一个默认的statestore给你；第4句定义了Dapr状态管理的访问地址

3，为了保存状态值，需要先定义状态内容：

var state = new List<object>
{
    new
    {
        key = stateKey,
        value = new Order
        {
            Id = 17,
            Amount = 1
        }
    }
};

4，通过Post方法把序列化后的状态值提交到Dapr的接口上：

var request = new HttpRequestMessage(HttpMethod.Post, stateUrl);
request.Content = new StringContent(JsonSerializer.Serialize(state));
var response = await httpClient.SendAsync(request);

5，使用Get方法从Dapr中获取状态值，需要传入你需要获取的状态key：

request = new HttpRequestMessage(HttpMethod.Get, $"{stateUrl}/{stateKey}");
response = await httpClient.SendAsync(request);
Console.WriteLine($"Respone content: {await response.Content?.ReadAsStringAsync()}");

6，使用Delete方法从Dapr中输出状态值，需要传入你需要输出的状态key：

request = new HttpRequestMessage(HttpMethod.Delete, $"{stateUrl}/{stateKey}");
response = await httpClient.SendAsync(request);

7，最后使用如下命令来运行这个Dapr应用：dapr run --app-id dotnetapp --dapr-http-port 13502 -- dotnet run

我们可以在控制台中看到状态值被保存、获取和删除的提示信息。

完整的示例代码可以在这里查看：https://github.com/heavenwing/dapr-dotnet-quickstarts/tree/main/StateManagement

dotnet SDK初接触

上面在应用代码当中直接使用rest api去访问Dapr的状态管理接口，肯定显得稍微复杂。其实我们可以直接通过Dapr提供的dotnet SDK来方便的开发Dapr应用。

dotnet SDK的源代码地址在：https://github.com/dapr/dotnet-sdk

在dotnet SDK中，我最近还合并进去了一个pr，提供如何通过gRPC来包含服务调用接口的示例。大家可以查看这里：https://github.com/dapr/dotnet-sdk/tree/master/samples/AspNetCore/GrpcServiceSample

当然也可以通过Nuget来引用：https://www.nuget.org/packages?q=Tags%3A"Dapr"

通过sdk，我们要访问状态管理就非常简单了，比如如下的示例代码实现一个简单的deposit操作：

var state = await _daprClient.GetStateEntryAsync<Account>(StoreName, transaction.Id);
state.Value ??= new Account() { Id = transaction.Id, };
state.Value.Balance += transaction.Amount;
await state.SaveAsync();

后续与.NET Conf 2020

接下来的文章我将会开始逐一介绍Dapr中的各个构件块。如果对Dapr感兴趣，又希望快点跟着我深入了解的。可以参加本周末12月19日在苏州举行的2020中国.NET开发者峰会，我在这个会议上会分享一个关于Dapr的主题：《Dapr开启微服务应用开发新世界》，欢迎到现场或者线上和我交流讨论。

关于2020中国.NET开发者峰会的信息可以看这里：https://www.cnblogs.com/shanyou/p/14118444.html

另外，我这里送现场票5张，先到先得： dotNETZHYGXH dotNETZHYGCZ dotNETZHYGcU dotNETZHYGas dotNETZHYGVJ

PS:请通过以下链接报名：http://hdxu.cn/yzcnG操作步骤为：

注登录活动行；
先点击【我有优惠码】并输入；
兑换成功，【合作伙伴票】变为 0 后，再进行购买。