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().ForMember(s => s.Gid, t => t.Ignore());
                });

            return mapperConfig.CreateMapper();
        }
    }
}

本项目中示例（使用）：

/// 

        /// 添加商品分类
        /// 
        /// 
        /// 
        [HttpPost]
        public async Task Post(CategoryCreateDto dto)
        {
            var s = CategoryCreateMapper.CreateMapper().Map(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 &