第一节：微服务准备(Webapi复习、PostMan的使用、项目启动方式、业务代码准备）
一. Core下WebApi复习
详细的WebApi请移步：https://www.cnblogs.com/yaopengfei/p/11558525.html
1. 路由规则配置
简单粗暴：把作用于Controller上的特性改为： [Route("api/[controller]/[action]")]，这样可以通过方法名来访问了。
PS:也有其它的配置方式，这里不一一介绍了。
2. 请求方式的接收
(1).对于Get请求，可以分参数接收；也可以用实体接收，实体接收前面要加 [FromQuery]；不能用dynamic接收。
(2).对于Post请求
A. 接收js默认的表单提交：用实体接收，前面加[FromForm]。
B. 接收JSON提交：用实体/dynamic接收，前面[FromBody]可加可不加。
补充PostMan的使用：
用到的方法：
/// <summary> /// 下单接口 /// </summary> /// <param name="param">接收表单提交</param> /// <returns></returns> [HttpPost] public string pOrder2([FromForm]pOrderParam param) { var data = new { status = "ok", msg = $"用户{param.userId}下单了{param.num}个商品{param.goodId}" }; return JsonHelp.ToJsonString(data); } /// <summary> /// 下单接口 /// </summary> /// <param name="param">接收JSON格式提交</param> /// <returns></returns> [HttpPost] public string pOrder4([FromBody]pOrderParam param) { var data = new { status = "ok", msg = $"用户{param.userId}下单了{param.num}个商品{param.goodId}" }; return JsonHelp.ToJsonString(data); }
A.Form表单提交：Body标签下选择【form-data】或【x-www-form-urlencoded】
B.Json格式提交: 首先Headers标签下要设置【Content-Type=application/json】，然后再Body标签下选择【raw】,输入下面格式 { "userId":"ypf001", "goodId":"1111","num":222 }
测试结果：
对于Post请求Json的提交格式，后台用dynamic来接收的问题，用js代码测试时完全可以的(详见开篇webapi章节)，但是这里用postman测试报500.(可能是我postman用的不对？欢迎指正)
3. 返回值的处理
(1).直接返回对应的类型的信息：GetMsg、GetGoodNum
(2).返回JSON序列化的信息：GetGoodById1
(3).使用Content方法：GetGoodById2
PS：GetGoodById1和GetGoodById2的区别在于前端用不用再转一次了。 （详细见开头的 WebApi章节）
[Route("api/[controller]/[action]")] [ApiController] public class CatalogController : ControllerBase { [HttpGet] public string GetMsg() { return "ypf"; } [HttpGet] public int GetGoodNum(int id) { return id; } [HttpGet] public string GetGoodById1(int id) { var myData = new { status = "ok", goods = new Goods() { id = id, goodName = "apple", goodPrice = 6000, addTime = DateTime.Now } }; var jsonData = JsonHelp.ToJsonString(myData); return jsonData; //返回前端的数据不能直接点出来 } [HttpGet] public IActionResult GetGoodById2(int id) { var myData = new { status = "ok", goods = new Goods() { id = id, goodName = "apple", goodPrice = 6000, addTime = DateTime.Now } }; var jsonData = JsonHelp.ToJsonString(myData); return Content(jsonData, "application/json"); //返回前端的数据可以直接点出来 } }
二. Web项目指定端口的启动方式
1. 启动项目
(1). 启动项目：dotnet xxx.dll （eg：dotnet GoodsService.dll）
(2). 指定配置启动： dotnet xxx.dll /test=123 test1=abc 或者 dotnet xxx.dll --test 123 --test1 abc
2.指定ip+端口
(1). 直接Url写死：UseUrls("http://127.0.0.1:7001"); 支持配置多个，然后直接通过 【dotnet xxx.dll 】启动即可。
public static IHostBuilder CreateHostBuilder(string[] args) => Host.CreateDefaultBuilder(args) .ConfigureWebHostDefaults(webBuilder => { //直接写死 webBuilder.UseStartup<Startup>().UseUrls("http://127.0.0.1:7001"); });
(2). 在dll指定目录下设置环境变量:
SET ASPNETCORE_URLS=http://127.0.0.1:7001 ,然后再运行程序 dotnet GoodsService.dll
(3). 读取命令行中输入的指令
前提：都需要添加命令行支持 var config = new ConfigurationBuilder().AddCommandLine(args).Build();
A.写法1：dotnet GoodsService.dll --ip="127.0.0.1" --port=7001，需要UseUrls支持
public static IHostBuilder CreateHostBuilder(string[] args) => Host.CreateDefaultBuilder(args) .ConfigureWebHostDefaults(webBuilder => { //添加命令行支持(写在上面的Main里也可以) var config = new ConfigurationBuilder().AddCommandLine(args).Build(); //写法一 var ip = config["ip"]; var port = config["port"]; webBuilder.UseStartup<Startup>().UseUrls($"http://{ip}:{port}"); });
B.写法2：dotnet GoodsService.dll --urls="http://*:7001" --ip="127.0.0.1" --port=7001 ，不需要再配置任何东西了 (推荐！！)
public static IHostBuilder CreateHostBuilder(string[] args) => Host.CreateDefaultBuilder(args) .ConfigureWebHostDefaults(webBuilder => { //添加命令行支持(写在上面的Main里也可以) var config = new ConfigurationBuilder().AddCommandLine(args).Build(); //默认的 或 写法2 （配合命令行,支持写法2） webBuilder.UseStartup<Startup>(); });
三. 业务代码准备
新建WebApi项目，商品服务 GoodsService 和 订单服务 OrderService，工具类库 MicroUtils。
1. GoodsService的代码准备
[Route("api/[controller]/[action]")] [ApiController] public class CatalogController : ControllerBase { [HttpGet] public string GetMsg() { return "ypf"; } [HttpGet] public int GetGoodNum(int id) { return id; } [HttpGet] public string GetGoodById1(int id) { var myData = new { status = "ok", goods = new Goods() { id = id, goodName = "apple", goodPrice = 6000, addTime = DateTime.Now } }; var jsonData = JsonHelp.ToJsonString(myData); return jsonData; //返回前端的数据不能直接点出来 } [HttpGet] public IActionResult GetGoodById2(int id) { var myData = new { status = "ok", goods = new Goods() { id = id, goodName = "apple", goodPrice = 6000, addTime = DateTime.Now } }; var jsonData = JsonHelp.ToJsonString(myData); return Content(jsonData, "application/json"); //返回前端的数据可以直接点出来 } }
2. OrderService的代码准备
[Route("api/[controller]/[action]")] [ApiController] public class BuyController : ControllerBase { [HttpPost] public string pOrder1() { return "ok"; } /// <summary> /// 下单接口 /// </summary> /// <param name="param">接收表单提交</param> /// <returns></returns> [HttpPost] public string pOrder2([FromForm]pOrderParam param) { var data = new { status = "ok", msg = $"用户{param.userId}下单了{param.num}个商品{param.goodId}" }; return JsonHelp.ToJsonString(data); } }
3. 工具类中序列化代码
/// <summary> /// Json的序列化和反序列化 /// 依赖程序集：【Newtonsoft.Json】 /// </summary> public class JsonHelp { #region 01-将JSON转换成JSON字符串 /// <summary> ///将JSON转换成JSON字符串 /// </summary> /// <typeparam name="T"></typeparam> /// <param name="obj"></param> /// <returns></returns> public static string ToJsonString<T>(T obj) { return JsonConvert.SerializeObject(obj); } #endregion #region 02-将字符串转换成JSON对象 /// <summary> /// 将字符串转换成JSON对象 /// </summary> /// <typeparam name="T"></typeparam> /// <param name="content"></param> /// <returns></returns> public static T ToObject<T>(string content) { return JsonConvert.DeserializeObject<T>(content); } #endregion }
!
- 作 者 : Yaopengfei(姚鹏飞)
- 博客地址 : http://www.cnblogs.com/yaopengfei/
- 声 明1 : 如有错误，欢迎讨论，请勿谩骂^_^。
- 声 明2 : 原创博客请在转载时保留原文链接或在文章开头加上本人博客地址，否则保留追究法律责任的权利。
