XUCore.Template.FreeSql 9.6.22

XUCore.Template.FreeSql

XUCore.Template.FreeSql

基于 FreeSql 的精简分层快速开发项目模板，生成 WebApi 项目

使用模板

本地安装模板：可详情见 install-template.bat 文件内

本地安装模板步骤：

如果已经装过旧版，可以先执行下面命令进行卸载：

dotnet new -u xfreesql

然后安装指定版本：

dotnet new --install XUCore.Template.FreeSql::{version}

创建项目

切换到指定创建的目录。

假设我们需要在 E:\demo 创建，

那么先切换到该目录

cd E:\demo

然后执行下面命令创建项目

dotnet new xfreesql -n MyTest -o .

这里的 xfreesql 是使用模板短名称。

MyTest 为新创建的项目名称。

本地构建项目镜像到 Docker（如果使用 jenkins 可以直接在 jenkins 里配置）

前提是 dockerfile 需要放在项目根目录，而非启动项目的目录

不采用微软自带的 dockerfile，我们需要手工打包发布。

1、切换到项目目录

cd E:\demo\MyTest.WebApi2

2、本地编译

dotnet build -c Release

3、本地发布（实际发布到当前项目的 bin/Release/net5.0/publish/ 目录）

dotnet publish -c Release

4、打包进 docker

docker build -t mytest:0.0.1 .

从控制台中，我们可以看到打包过程

E:\MyTest>docker build -t mytest:0.0.1 .
[+] Building 14.7s (12/20)
 => [internal] load build definition from Dockerfile                                                               0.0s
 => => transferring dockerfile: 32B                                                                                0.0s
 => [internal] load .dockerignore                                                                                  0.0s
 => => transferring context: 2B                                                                                    0.0s
 => [internal] load metadata for mcr.microsoft.com/dotnet/sdk:5.0                                                  0.0s
[+] Building 15.1s (12/20)
 => [internal] load build definition from Dockerfile                                                               0.0s
[+] Building 30.4s (12/20)
 => [internal] load build definition from Dockerfile                                                               0.0s
 => => transferring dockerfile: 32B                                                                                0.0s
 => [internal] load .dockerignore                                                                                  0.0s
 => => transferring context: 2B                                                                                    0.0s
[+] Building 56.7s (21/21) FINISHED
 => [internal] load build definition from Dockerfile                                                               0.0s
 => => transferring dockerfile: 32B                                                                                0.0s
 => [internal] load .dockerignore                                                                                  0.0s
 => => transferring context: 2B                                                                                    0.0s
 => [internal] load metadata for mcr.microsoft.com/dotnet/sdk:5.0                                                  0.0s
 => [internal] load metadata for mcr.microsoft.com/dotnet/aspnet:5.0                                               0.0s
 => [build 1/7] FROM mcr.microsoft.com/dotnet/sdk:5.0                                                              0.0s
 => [internal] load build context                                                                                  1.2s
 => => transferring context: 119.91MB                                                                              1.2s
 => [base 1/5] FROM mcr.microsoft.com/dotnet/aspnet:5.0                                                            0.0s
 => CACHED [build 2/7] WORKDIR /src                                                                                0.0s
 => CACHED [build 3/7] COPY [MyTest.WebApi2/MyTest.WebApi2.csproj, MyTest.WebApi2/]                                   0.0s
 => CACHED [build 4/7] RUN dotnet restore "MyTest.WebApi2/MyTest.WebApi2.csproj"                                     0.0s
 => [build 5/7] COPY . .                                                                                           0.4s
 => [build 6/7] WORKDIR /src/MyTest.WebApi2                                                                         0.0s
 => [build 7/7] RUN dotnet build "MyTest.WebApi2.csproj" -c Release -o /app/build                                  43.2s
 => [publish 1/1] RUN dotnet publish "MyTest.WebApi2.csproj" -c Release -o /app/publish                            11.5s
 => CACHED [base 2/5] ADD [sources.list, /etc/apt/]                                                                0.0s
 => CACHED [base 3/5] RUN rm /etc/localtime                                                                        0.0s
 => CACHED [base 4/5] RUN ln -s /usr/share/zoneinfo/Asia/Shanghai /etc/localtime                                   0.0s
 => CACHED [base 5/5] WORKDIR /app                                                                                 0.0s
 => CACHED [final 1/2] WORKDIR /app                                                                                0.0s
 => CACHED [final 2/2] COPY --from=publish /app/publish .                                                          0.0s
 => exporting to image                                                                                             0.0s
 => => exporting layers                                                                                            0.0s
 => => writing image sha256:addb11051debc4cf74c7d048d15cafdb7edbf121ae54fc55960f1b46bce94fda                       0.0s
 => => naming to docker.io/library/mytest:0.0.1                                                                    0.0s
 => => #   Determining projects to restore...
Use 'docker scan' to run Snyk tests against images to find vulnerabilities and learn how to fix them

结束后，我们使用 docker images 查看打包好的镜像

E:\MyTest>docker images
REPOSITORY                        TAG       IMAGE ID       CREATED        SIZE
mytest                            0.0.1     addb11051deb   20 hours ago   258MB
mcr.microsoft.com/dotnet/sdk      5.0       1cfcb8589c29   12 days ago    631MB
mcr.microsoft.com/dotnet/aspnet   5.0       592a912e0dcb   12 days ago    205MB

3、启动容器

docker run --name my-test -d -p 8090:8090 mytest:0.0.1

启动后我们通过 docker ps -a 查看运行的镜像

E:\MyTest>docker ps -a
CONTAINER ID   IMAGE          COMMAND                  CREATED         STATUS                       PORTS     NAMES
35c9010404ae   mytest:0.0.1   "dotnet MyTest.WebAp…"   5 minutes ago   Exited (139) 4 minutes ago             my-test

4、浏览器访问

http://127.0.0.1:8090/swagger

此时容器会报错，因为在创建项目后配置文件内需要修改数据库连接地址（进入容器后，我们的所有数据库地址以及其他相关地址都需要修改为内网访问，或者公网访问）

我们可以查看容器的日志，方便我们定位错误

docker logs 35c9010404ae

此时，在容器日志，我们看到

fail: Microsoft.EntityFrameworkCore.Database.Connection[20004]
      An error occurred using the connection to database '' on server 'localhost'.
fail: Microsoft.EntityFrameworkCore.Database.Connection[20004]
      An error occurred using the connection to database '' on server 'localhost'.
fail: Microsoft.EntityFrameworkCore.Database.Connection[20004]
      An error occurred using the connection to database '' on server 'localhost'.
fail: Microsoft.EntityFrameworkCore.Database.Connection[20004]
      An error occurred using the connection to database '' on server 'localhost'.
fail: Microsoft.EntityFrameworkCore.Database.Connection[20004]
      An error occurred using the connection to database '' on server 'localhost'.
fail: Microsoft.EntityFrameworkCore.Database.Connection[20004]

客户端接入 API

API 隐藏操作说明

1、如何改变 DateTime 的格式？

我们需要在 http 请求的时候，在 head 里加入配置

注意： limit-date-unix的优先级要大于limit-date-format

2、如何重命名和指定输出需要的字段？

注意：当你使用重命名limit-field-rename字段后，指定输出的字段limit-field要以重命名后的字段名为准，大小写也请依照你重命名后的格式。

任何指定输出，均不影响原始定义的结构。

3、如何指定输出小驼峰字段？

任何指定输出，均不影响原始定义的结构。

示例一

如下表设置：

示例二

如下表设置：

示例三

如下表设置：

示例四

如下表设置：

适用范围定义

在一定程度上使 API 接入变得稍微复杂了一点点，但是能优化网络传输，或许我们可以考虑牺牲一点复杂度，按需索取来优化传输问题。