本文介绍 ASP.NET 的 Swagger 部署，若您使用 ASP.NET Core 应用程序，请移步 ASP.NET Core Web API Swagger 官方文档：

https://docs.microsoft.com/zh-cn/aspnet/core/tutorials/first-web-api?view=aspnetcore-5.0&tabs=visual-studio

https://github.com/domaindrivendev/Swashbuckle.AspNetCore

安装

NuGet 中搜索安装 Swashbuckle，作者 Richard Morris

访问

http://您的域名/swagger

配置

显示描述

以将描述文件（xml）存放到项目的 bin 目录为例：

打开项目属性，切换到“生成”选项卡
在“配置”下拉框选择“所有配置”
更改“输出路径”为：bin\
勾选“XML 文档文件”：bin\******.xml，（默认以程序集名称命名）
打开文件：App_Start/SwaggerConfig.cs
取消注释：c.IncludeXmlComments(GetXmlCommentsPath());

添加方法：

public static string GetXmlCommentsPath()
{
    return System.IO.Path.Combine(
        System.AppDomain.CurrentDomain.BaseDirectory,
        "bin",
        string.Format("{0}.xml", typeof(SwaggerConfig).Assembly.GetName().Name));
}

其中 Combine 方法的第 2 个参数是项目中存放 xml 描述文件的位置，第 3 个参数即以程序集名称作为文件名，与项目属性中配置一致。

如遇到以下错误，请检查第 2、3、4 步骤中的配置（Debug / Release）

500 : {"Message":"An error has occurred."} /swagger/docs/v1

使枚举类型按实际文本作为参数值（而非转成索引数字）

打开文件：App_Start/SwaggerConfig.cs
取消注释：c.DescribeAllEnumsAsStrings();

xoyozo 7 年前

4,755

百度地图与天地图常用 API 对比

	百度地图	天地图
初始化地图	var map = new BMap.Map("allmap");	var map = new T.Map("allmap");
将覆盖物添加到地图	addOverlay(overlay: Overlay)	addOverLay(overlay:OverLay)
从 Map 的 click 事件中获取坐标点	map.addEventListener("click", function (e) { Point = e.point; }	map.addEventListener("click", function (e) { LngLat = e.lnglat; }
坐标点	new BMap.Point(lng: Number, lat: Number)	new T.LngLat(lng: Numbe, lat: Number)
像素点	new BMap.Pixel(x: Number, y: Number)	new T.Point(x: Number, y: Number)
文本标注	`new BMap.Label(content: String, { offset: Size, position: Point })`	`new T.Label({ text: string, position: LngLat, offset: Point })`
设置文本标注样式	setStyle(styles: Object)	每个样式使用单独的 set 方法实现
图像标注	`new BMap.Marker(Point, { offset: Size, icon: Icon, enableMassClear: Boolean, enableDragging: Boolean, enableClicking: Boolean, raiseOnDrag: Boolean, draggingCursor: String, rotation: Number, shadow: Icon, title: String })`	`new T.Marker(LngLat, { icon: Icon, draggable: boolean, title: string, zIndexOffset: number, opacity: number })`
为图像标注添加文本标注	Marker.setLabel(label: Label)	无。可借用 title（鼠标掠过显示）属性来实现，并通过 Marker.options.title 来获取值
从图像标注获取坐标点	Point = Marker.getPosition();	LngLat = Marker.getLngLat();
绘制折线	`new BMap.Polyline(points: Array<Point>, { strokeColor: String, strokeWeight: Number, strokeOpacity: Number, strokeStyle: String, enableMassClear: Boolean, enableEditing: Boolean, enableClicking: Boolean, icons: Array<IconSequence> })`	`new T.Polyline(points:Array<LngLat>, { color: string, weight: number, opacity: number, lineStyle: string })`
绘制多边形	`new BMap.Polygon(points: Array<Point>, { strokeColor: String, fillColor: String, strokeWeight: Number, strokeOpacity: Number, fillOpacity: Number, strokeStyle: String, enableMassClear: Boolean, enableEditing: Boolean, enableClicking: Boolean })`	`new T.Polygon(points:Array<LngLat>,{ color: string, weight: number, opacity: number, fillColor: String, fillOpacity: number, lineStyle: string })`
设置多边形的点数组	Polygon.setPath(points: Array<Point>)	Polyline.setLngLats(lnglats: Array<LngLat>)
设置地图视野	Map.setViewport(view: Array<Point> \| Viewport, viewportOptions: ViewportOptions)	Map.setViewport(view: Array<LngLat>)

xoyozo 7 年前

10,382

微信支付接口的 return_code、result_code、trade_state

变量名	字段名	官方描述
return_code	返回状态码	SUCCESS/FAIL 此字段是通信标识，非交易标识，交易是否成功需要查看 trade_state 来判断在“统一下单”和“支付结果通知”中，该描述变成了：交易是否成功需要查看 result_code 来判断
result_code	业务结果	SUCCESS/FAIL
trade_state	交易状态	SUCCESS — 支付成功 REFUND — 转入退款 NOTPAY — 未支付 CLOSED — 已关闭 REVOKED — 已撤销（付款码支付） USERPAYING — 用户支付中（付款码支付） PAYERROR — 支付失败（其他原因，如银行返回失败）

总的来说，

return_code 是用来判断通信状态的，个人理解在“结果通知”时必为 SUCCESS；

result_code 是用来判断业务结果的，指一次调用接口或回调的动作是否如愿执行成功。如“关闭订单”时关闭成功为 SUCCESS，因参数配置错误、找不到订单号、订单状态不允许关闭等其它关闭失败的情况为 FAIL；

trade_state 是用来判断交易状态的，“交易”是指微信支付订单。

另，在“统一下单”和“支付结果通知”中，return_code 的描述变成了：交易是否成功需要查看 result_code 来判断。不知道是官方笔误，还是真的可以用来判断交易是否成功，因为在调用“统一下单”时是未支付状态，根本没有支付成功的可能。

保险起见，我们在异步收到“结果通知”时，不要相信文档去判断 result_code，应调用“查询订单”，并判断 trade_state。

xoyozo 7 年前

8,715

MySQL 的优化表（OPTIMIZE TABLE）

数据表所占用的空间（简称“表空间”）一般会大于其数据空间和索引空间的和。

当数据被删除时，其所占空间并不会立即释放，而是等待新数据写入，这会导致出现许多磁盘碎片。使用 OPTIMIZE TABLE 或 ALTER TABLE 可以回收碎片，重组文件。优化表的过程类似于 Windows 碎片整理。

操作过程会导致该表上的写操作无法执行。

一般在删除了大批量数据或更改了许多可变长度字段后执行优化表。

碎片率 = 100% - (数据空间 + 索引空间) / 表空间

优化后碎片率接近于 0%，数据空间和索引空间也会变小，此时 表空间 接近于“数据空间 + 索引空间”

在 MyISAM 引擎上遇到优化后导致获取行数为 0，SELECT 数据只有 1 条的情况，需要执行修复表（REPAIR TABLE），使数据恢复正常。执行后结果显示：Number of rows changed from 0 to xxxxxx

xoyozo 7 年前

6,817

MySQL for Visual Studio 2019

Visual Studio 2019 已于本月早些时候正式发布，但 MySQL for Visual Studio 却迟迟未更新，目前的 1.2.8 版本只支持到 VS2017。表现在 VS2019 上会发生：

在“服务器资源管理器”中添加连接时，或在新建“ADO.NET 实体数据模型”时，无法看到数据源“MySQL Database (MySQL Data Provider)”
在实体数据模型设计器（Entity Data Model Designer）中执行“从数据库更新数据模型”时出现错误：尝试从数据库进行更新时，遇到类型为“System.ArgumentException”的异常。异常消息为:“无法将运行时连接字符串转换为设计时等效项。没有为提供程序“MySql.Data.MySqlClient”安装为设计目的(DDEX 提供程序)启用 Visual Studio 以便与数据库进行通信所需的库。

幸运的是 VS2019 可以与低版本 VS 共存，使用 ASP.NET 连接 MySQL 的开发者们要再等一等才能用上 VS2019 了。

这几天 MySQL 不断有产品更新，相信 MySQL for Visual Studio 2019 也会在不久的将来面世，本站将第一时间更新下载地址。

2019.8.30 Jose Ramirez（来自 MySQL 的 Windows 团队）：MySQL for Visual Studio 的当前版本不支持 Visual Studio 2019。正在努力提供支持，但根据公司政策，我无法披露日期或对何时可用提供任何承诺。查看

2019.9.26 MySQL for Visual Studio 迟迟未更新，但是 VS2019 更新到最新版本（v16.3）已经一切正常了。

MySQL for Visual Studio 的 Repair 功能是鸡肋，有问题的话，Remove 后重新安装才能解决。

xoyozo 7 年前

8,657

微信小程序登录获取 openid，授权获取 unionid、手机号码、昵称等用户信息

前提：

若需获取用户 unionid，则小程序必须已绑定到微信开放平台。

小程序调用 wx.login()，将 code 发送到开发者服务器
开发者服务器请求微信接口 code2Session，获得 session_key、openid，有机会获得 unionid（参 UnionID 机制说明）。因此无需任何用户授权即可获取 openid
访问须要已获取用户信息的页面时，可通过小程序端使用 button + getUserInfo 的方式请求用户授权
访问须要已获取手机号码的页面时，可通过小程序端使用 button + getPhoneNumber 的方式请求用户授权
code2session、getUserInfo、getPhoneNumber 等接口返回数据存入数据库 dt_weapp_user
服务端的任何接口均返回口令状态包（含自定义会话口令等信息），小程序端应保存于 storage
请求 getUserInfo 后应判断 detail.errMsg 是否为 getUserInfo:ok，请求 getPhoneNumber 后应判断 detail.errMsg 是否为 getPhoneNumber:ok
授权窗口的弹出情况参此文
口令状态包是用来传递到客户端用来标识用户唯一凭证的，包含字段：会话口令（自定义用户凭证）、会话口令有效时间（秒）、是否已获取 unionid 或昵称（视业务需求）、是否已获取手机号码、uid（可选），以及其他用来标识业务身份字段。服务端可根据会话口令从数据库中获取该用户的所有已知信息。
一般情况下，当已获取手机号码时，uid 必有值，否则，uid 必为空。因此 uid 不是必须传递到客户端的。
通过 code2Session 获得的 session_key、以及 openid、unionid、手机号码等机密信息不允许包含在口令状态包中并缓存在客户端，客户端需要用到手机号码时单独调用接口获取。
若业务不要求以手机号码作为用户唯一标识，那么口令状态包中不需要包含是否已获取手机号码，仅 uid 即可。在客户端访问须要业务用户登录的页面时，也仅判断 uid 有值即可。

流程图：

微信小程序授权登录获取 unionid、用户信息流程.png

为更好地适应 2017.7.19 发布的《小程序内用户帐号登录规范调整和优化建议》，开发者服务器提供的所有业务逻辑接口的返回值中都应包含口令状态包，约定有以下相关的返回值和处理动作（返回值按个人喜好来定）：

口令状态	接口返回	ASP.NET Web API 语句	处理动作
access_token 空或失效	401 状态码	return Unauthorized();	login() + code2Session，获取 openid，生成 access_token
access_token 有效，但未获取 uniond 或用户信息	401 状态码，http 头 WWW-Authenticate 中标注 getUserInfo	return Unauthorized(new AuthenticationHeaderValue("getUserInfo"));	getUserInfo()
access_token 有效，但未获取手机号码（即未找到业务用户）	401 状态码，http 头 WWW-Authenticate 中标注 getPhoneNumber	return Unauthorized(new AuthenticationHeaderValue("getPhoneNumber"));	getPhoneNumber()

WWW-Authenticate 有大小写的问题，千万别入坑，参：https://xoyozo.net/Blog/Details/header-www-authenticate
返回内容是根据业务逻辑在服务端决定的，客户端在处理每个接口返回值时对返回内容作相应的处理即可。

xoyozo 7 年前

12,033

微信小程序授权登录获取 unionid、头像、昵称等用户信息流程

【推荐】临时口令和会话口令合二为一的流程（适合随时授权）

前提：

小程序已绑定到微信开放平台。

分两种场景：

场景一：仅需要获取 unionid，且不需要获取头像昵称等用户信息，且已经有很大部分用户仅通过 code2Session 就能获取到 unionid（如：已关注了绑定同一微信开放平台的其它公众号，参 UnionID 机制说明）；

场景二：仅需要获取 unionid，或需要获取 unionid 及头像昵称等用户信息，或很大部分用户不能通过 code2Session 获取到 unionid。

场景一步骤：

小程序调用 wx.login()，将 code 发送到开发者服务器
开发者服务器请求微信接口 code2Session，获得 session_key、openid，有机会获得 unionid
若没有返回 unionid，尝试用 openid 从数据库中获取 unionid
如果数据库中没有找到对应的 unionid，告知小程序端使用 button + getUserInfo 的方式请求用户授权
授权允许（判断 detail.errMsg 是否为 getUserInfo:ok）则将加密数据传回开发者服务器进行解密，得到 unionid、头像、昵称等信息，保存到数据库
若授权拒绝，则无动作，用户再次点击 button 会重新弹起授权框

* 该流程仅部分用户的首次使用才要求授权。其它注意事项和流程细节见下方流程图。

场景二步骤：

小程序调用 wx.login()，将 code 发送到开发者服务器
开发者服务器请求微信接口 code2Session，获得 session_key、openid
尝试用 openid 从数据库中获取 unionid 和/或用户信息
如果数据库中没有找到对应的 unionid 和/或用户信息，告知小程序端使用 button + getUserInfo 的方式请求用户授权
授权允许（判断 detail.errMsg 是否为 getUserInfo:ok）则将加密数据传回开发者服务器进行解密，得到 unionid、头像、昵称等信息，保存到数据库
若授权拒绝，则无动作，用户再次点击 button 会重新弹起授权框

* 该流程仅每个用户的首次使用才要求授权。其它注意事项和流程细节见下方流程图。

上述两种场景的设计流程，只要数据库中已保存用户的 unionid（和/或用户信息），都不再需要用户再次授权（即使在“设置”中关闭了“用户信息”授权，点击小程序右上角三点按钮，选择关于小程序，点击右上角的三点，选择设置）。

场景一流程图：

微信小程序授权登录获取 unionid（仅部分用户的首次使用才要求授权）.png

场景二流程图：

微信小程序授权登录获取 unionid、头像昵称等（仅首次使用才要求授权）.png

流程图中的“临时口令”仅用于关联“通过 code2Session 获得的 session_key”，并在用户授权后带回换取 session_key。原因是 session_key 是机密数据，不允许被传到小程序端。临时口令用完即删（设置表 dt__weapp_code2session 中相应记录的该字段为空）。

【推荐】临时口令和会话口令合二为一的流程（适合随时授权）

xoyozo 7 年前

14,779

HTTP Error 502.5 - ANCM Out-Of-Process Startup Failure

HTTP Error 502.5 - ANCM Out-Of-Process Startup Failure
Common causes of this issue:
The application process failed to start
The application process started but then stopped
The application process started but failed to listen on the configured port
Troubleshooting steps:
Check the system event log for error messages
Enable logging the application process' stdout messages
Attach a debugger to the application process and inspect
For more information visit: https://go.microsoft.com/fwlink/?LinkID=808681

发现装错了东西，服务器上应该安装 dotnet-hosting-*.*.*-win.exe，而非 dotnet-runtime-*.*.*-win-x64.exe

xoyozo 7 年前

6,664

软件开发专有名词的英文翻译（不定时更新）

常用获取英文的方法是查看英文版 App。

微信：WeChat

小程序：Mini Programs

公众号：Official Accounts

订阅号：Subscriptions

朋友圈：Moments

已登录的：Logged

服务通知：Service Messages

置顶：Sticky on Top / Remove from Top

发送给朋友：Share to Friends

微信号：WeChat ID

钱包：Wallet

余额：Balance

资金/零钱/基金：Funds

金额：Amount

明细：Details

账单：Transactions

资产：Assets

收入/收益：Income

财富：Fortune

退出登录：Log Out / Logout

xoyozo 7 年前

6,895

小程序用正则表达式给 <img /> 加上 style

当使用在线编辑器编辑一篇文章（或从 Word 复制）后，会得到包含 HTML 标签的字符串内容，可以直接将它输出到页面上而不需要进行 HTML 编码。

但是，当我们需要改变图片大小时，我们发现有些图片的尺寸是直接使用 style 属性固定的，除了用 JS 进行后期处理，我们可以在服务端对 <img /> 进行修正。

这个场景会在小程序开发的时候遇到。

网上一般使用正则表达式直接将 <img 替换成 <img style="max-width: 100%; height: auto;" ，缺点是如果该 <img /> 本身就带有 style 属性，那么会出现一个标签两个 style，很多情况导致这两个样式同时失效，所以我们应针对有 style 和无 style 分别处理。

// 把 <img src="a.jpg" style="display: block;" /> 替换成 <img src="a.jpg" style="display: block;;max-width:100%;height:auto;" />
Content = Content.replace(/(\<img\s+[^>]*style\s*\=\s*['"][^'"]*)(['"])/gi, '$1;max-width:100%;height:auto;$2');

// 把 <img src="b.jpg" /> 替换成 <img src="b.jpg" style="max-width:100%;height:auto;" />
Content = Content.replace(/(\<img\s+((?!style).)+?)(\/?>)/gi, '$1 style="max-width:100%;height:auto;" $3');

复制以上代码时，半角空格可能会变成全角空格，请注意修正。

当有 style 时，我们将 max-width: 100%; height: auto;追加在原样式之后，以重写原样式。这里没有直接判断原样式是否以 ; 结尾，而是直接追加 ;，这并不会影响实现展示效果。

在判断没有 style 用到正则表达式的“断言”，参：https://blog.csdn.net/xuyangxinlei/article/details/81359366

延伸阅读：C# 用 HtmlAgilityPack 给 HTML 节点加上 style

xoyozo 7 年前

6,558

6 7 8 9 10

安装

访问

配置

HTTP Error 502.5 - ANCM Out-Of-Process Startup Failure

Common causes of this issue:

Troubleshooting steps:

For more information visit: https://go.microsoft.com/fwlink/?LinkID=808681

大家在看

最新发布

查询 / 检测

编程

前端

行业

本站 API

博客 (145)

安装

访问

配置

HTTP Error 502.5 - ANCM Out-Of-Process Startup Failure

Common causes of this issue:

Troubleshooting steps:

For more information visit: https://go.microsoft.com/fwlink/?LinkID=808681

大家在看

最新发布