Asp.Net Core WebApi 从开发到部署
WebApi效果图
响应
一、开发Asp.Net Core WebApi
说明：
1、关于如何使用.net core，本文不做介绍，由于这方面的文章现在很多。大家可以去博客园或者微软官方网站根据文档教程一步一步学习。
2、本项目属于个人微信小程序项目。由于后期需要布到小程序平台进行公测使用，所以源代码不公开请各位看官见谅。
3、本项目开发环境及工具：vs2017、MySql5.7、centos7.3
1、项目搭建
解决方案
架构图.jpg
2、开发中使用到的第三方插件
2-1、AutoMapper
关于AutoMapper是什么？请自行百度。这里要说的是AutoMapper已经支持了
.net core开发啦。使用方法请参考官方文档。
AutoMapper官方网站
AutoMapper源码
本项目中使用到的AutoMapper版本
本项目中示例（定义）：
//=============================================================
// Copyright (C) 2017-2100
// CLR版本: 4.0.30319.42000
// 机器名称: YPF-PC
// 命名空间名称/文件名: XiaoDouZi.Invoicing.Utils.AutoMapper/ProdcutCreateMapper
// 创建人: 杨朋飞
// 创建时间: 2017/7/4 9:55:20
// 我的简书： http://www.jianshu.com/u/40fb2e2a8047
//==============================================================
using AutoMapper;
using System;
using System.Collections.Generic;
using System.Text;
using XiaoDouZi.Invoicing.Dto;
using XiaoDouZi.Invoicing.Model;
namespace XiaoDouZi.Invoicing.Utils.AutoMapper
{
public class CategoryCreateMapper
{
public static IMapper CreateMapper()
{
var mapperConfig = new MapperConfiguration(
c =>
{
c.CreateMap<CategoryCreateDto, Category>().ForMember(s => s.Gid, t => t.Ignore());
});
return mapperConfig.CreateMapper();
}
}
}
本项目中示例（使用）：
/// <summary>
/// 添加商品分类
/// </summary>
/// <param name="dto"></param>
/// <returns></returns>
[HttpPost]
public async Task<IActionResult> Post(CategoryCreateDto dto)
{
var s = CategoryCreateMapper.CreateMapper().Map<CategoryCreateDto, Category>(dto);
return await this._categoryService.AddAsync(s) ?
Json(new { code = 200, message = Resource.ResponseMessage.AddCategory }) :
Json(new { code = 200, message = Resource.ResponseMessage.Fail });
}
2-2、Autofac
关于Autofac是什么？请自行百度。这里要说的是Autofac已经支持了
.net core开发啦。使用方法请参考官方文档。
Autofac官方网站
官方示例文档
Autofac
本项目中示例（Program.cs）：
本项目中示例（Startup.cs）：
image.png
3、开发中遇到的各种坑
3-1、Swagger
关于Swagger是什么？请自行百度。这里要说的是Swagger已经支持了
.net core开发啦。使用方法请参考官方文档。
swagger tools
-
注册Swagger中间件
注册Swagger中间件
注释文档生成路径配置
注意生成的注释文档路径和这里填写的要一致。
-
配置Swagger中间件
配置Swagger
这里需要注意的是启用
swagger中间件及配置一定要放在UserMvc之前。
这里需要注意的是启用swagger中间件及配置一定要放在UserMvc之前。
这里需要注意的是启用swagger中间件及配置一定要放在UserMvc之前。
重要的事情说三遍
-
Controller中的各个Action必须要有注释信息、请求的特性
Action的注释及请求特性
注意：是每个Action都必须要有注释信息和请求特性。如果不添加这些，就会导致
swagger报错。
二、发布Asp.Net Core WebApi
1、发布项目
-
命令方式
- 打开项目的根目录
- 按住Shift+右键
- 在此打开命令行
- 在命令行中执行下面这句话
dotnet publish
-
vs2017工具
右键点击WebApi站点→发布
vs2017工具发布
2、配置运行环境
-
安装.net core sdk
-
安装MySql
安装参考博文
注意问题：
1、博文中第四部中的命令存在问题，我已经正确的命令贴在下面。
rpm -ivh mysql-community-common-5.7.18-1.el7.x86_64.rpm
rpm -ivh mysql-community-libs-5.7.18-1.el7.x86_64.rpm
rpm -ivh mysql-community-libs-compat-5.7.18-1.el7.x86_64.rpm
rpm -ivh mysql-community-client-5.7.18-1.el7.x86_64.rpm
rpm -ivh mysql-community-server-5.7.18-1.el7.x86_64.rpm
rpm -ivh mysql-community-devel-5.7.18-1.el7.x87_64.rpm
2、关于执行这些命令时候报错问题，请看下面的解答。
执行上面命令时报错信息
这是由于安装过程中有如上报错。说明缺少依赖包。
解决方法
yum install numactl -y
yum install libaio -y
yum install perl -y
-
安装Nginx
-
安装jexus
- 打开https://www.linuxdot.net/
下载独立版
- 安装官方的手册进行安装。 参考官方手册
jexus和Nginx可以二选一，他们都是通过反向代理的方式来是Asp.Net Core WebApi来运行。
2-1、腾讯云服务器申请
腾讯云、阿里云、xxx云都可以。我这里申请的是腾讯云,操作系统选择centos7.3 x64。由于我没有申请云数据库mysql，所以自己安装了mysql数据库。具体步骤上面已经介绍了。
腾讯云
2-2、测试运行
- 进入到网站部署目录
cd /var/www/default/publish_XiaoDouZi
- 执行命令
dotnet XiaoDouZi.Invoicing.WebApi.dll
- 设置该进程为后台进程(由于我们关闭了shell后，网站服务也会跟着关闭，所以需要将其设置为后台进程)
nohup dotnet XiaoDouZi.Invoicing.WebApi.dll &
