Dapr微服务应用开发系列2:Hello World与SDK初接触
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 后 ,再进行购买。
转自 https://www.cnblogs.com/redmoon/p/14141624.html