AspNetCore+Swagger 生成Model描述
AspNetCore+Swagger 生成Model 描述
前言:
本篇文章实现是基于上一篇文章,进下补充:多余的就不多说了,只是为了实现Model的描述生成:有兴趣的可以结合上一篇的进行实现:如有更好的办法希望可以告知谢谢大家!
上一篇文章地址:AspNet Core Api Restful +Swagger 发布IIS
内容:
1、:首先根据上一篇文章我们创建AspNetCoreApi的项目,OrderServices 如下如所示:
2、:创建Core的类库项目并添加Users类如下图所示:
打开类库的属性:修改输出项:如图所示:
点击生成后会自动创建 BusinessBll.xml 文档:BusinessBll.xml 属性修改如下图所示:
Users类中内容如下:

using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks; namespace BusinessBll
{
/// <summary>
/// 用户类
/// </summary>
public class Users
{
/// <summary>
/// 用户ID
/// </summary>
public int ID { get; set; } = ;
/// <summary>
/// 用户编号
/// </summary>
public string Name { get; set; }
/// <summary>
/// 密码
/// </summary>
public string Pwd { get; set; }
/// <summary>
/// 用户基本信息
/// </summary>
public UserInfo userInfo { get; set; }
} /// <summary>
/// 用户的基本信息
/// </summary>
public class UserInfo
{
/// <summary>
/// 地址信息
/// </summary>
public string Address { get; set; }
/// <summary>
/// 用户编号
/// </summary>
public int Phone { get; set; }
}
}

3、:在控制器ValuesController 的Post 方法用引用进行引用,如下图所示:
4、:在Startup类中进行引用:
项目生成后:会有两个XML文档:所以要使用两个XML文档,如下图所示
第一个是Web 项目生成的SwaggerDesc.xml文档内容如下:
第二个文档是类库项目生成的 BusinessBll.xml 文档
5、:运行项目:结果如下图所示:
6、:实际项目中是这样使用的:
把读取的XML路径放置Json 文件中。在Startup 中进行引用:如下图所示:
有关路径小注意的有两点:
1)、:在本地运行是代表的是项目文件所在盘的根路径,
2)、:当我们运行在IIS的时候,此路径代表的是,Web项目的根路径。
在Startup中使用如下图:
出处:https://www.cnblogs.com/szlblog/p/9440243.html
AspNetCore+Swagger 生成Model描述的更多相关文章
- AspNetCore+Swagger 生成Model 描述
AspNetCore+Swagger 生成Model 描述 前言: 本篇文章实现是基于上一篇文章,进下补充:多余的就不多说了,只是为了实现Model的描述生成:有兴趣的可以结合上一篇的进行实现:如有更 ...
- asp.net core使用Swashbuckle.AspNetCore(swagger)生成接口文档
asp.net core中使用Swashbuckle.AspNetCore(swagger)生成接口文档 Swashbuckle.AspNetCore:swagger的asp.net core实现 项 ...
- 浅析如何在Nancy中使用Swagger生成API文档
前言 上一篇博客介绍了使用Nancy框架内部的方法来创建了一个简单到不能再简单的Document.但是还有许许多多的不足. 为了能稍微完善一下这个Document,这篇引用了当前流行的Swagger, ...
- asp.net core 使用 swagger 生成接口文档
参考地址:http://www.cnblogs.com/daxnet/p/6181366.html http://www.jianshu.com/p/fa5a9b76f3ed 微软参考文档:https ...
- Swagger 生成 ASP.NET Web API
使用 Swagger 生成 ASP.NET Web API 在线帮助测试文档 原文:ASP.NET Web API Help Pages using Swagger作者:Shayne Boyer翻译: ...
- Asp.net core WebApi 使用Swagger生成帮助页
最近我们团队一直进行.net core的转型,web开发向着前后端分离的技术架构演进,我们后台主要是采用了asp.net core webapi来进行开发,开始每次调试以及与前端人员的沟通上都存在这效 ...
- ASP.NET WebAPI使用Swagger生成测试文档
ASP.NET WebAPI使用Swagger生成测试文档 SwaggerUI是一个简单的Restful API测试和文档工具.简单.漂亮.易用(官方demo).通过读取JSON配置显示API .项目 ...
- ASP.NET Core WebApi使用Swagger生成api说明文档看这篇就够了
引言 在使用asp.net core 进行api开发完成后,书写api说明文档对于程序员来说想必是件很痛苦的事情吧,但文档又必须写,而且文档的格式如果没有具体要求的话,最终完成的文档则完全取决于开发者 ...
- ASP.NET Core WebApi使用Swagger生成api
引言 在使用asp.net core 进行api开发完成后,书写api说明文档对于程序员来说想必是件很痛苦的事情吧,但文档又必须写,而且文档的格式如果没有具体要求的话,最终完成的文档则完全取决于开发者 ...
随机推荐
- python笔记1-基础概念、python安装使用配置
Python 1.基础概念 一.什么是python? python是一种面向对象.解释型的计算机语言,它的特点是语法简洁.优雅.简单易学.在1989诞生,Guido(龟叔)开发.这里的python并不 ...
- 国行 lg g3 D858 刷 lg g3 D858hk 教程(备忘)
纯手打,转载请注明出处~ 刷机有风险,出现问题概不负责! 本着自娱自乐的宗旨 ,分享一下,出了问题不负责! 准备的材料: 1,手机一枚(废话)国行lg g3 d858 2,root 工具 用来root ...
- 人生苦短,我用python,为什么选择python,python简介
认识 Python 人生苦短,我用 Python —— Life is short, you need Python  目标 Python 的起源 为什么要用 Python? Python 的特点 ...
- ob_gzhandler — ob_start callback function to gzip output buffer
<?php ob_start("ob_gzhandler"); ?><html><body><p>This should be a ...
- ionic的actionsheet安卓样式不正常的坑及解决之道
这是actionsheet该有的样子,可是android下变成了这样: 百度后,发现修改lonic.css,注释这段代码就可以了:
- mysql数据库负载均衡
负载均衡集群是有一组相互独立的计算机系统构成,通过常规网络或专用网络进行链接,有路由器衔接在一起,各个节点相互协作,共同负载.均衡压力,对客户端来说,整个群集可以视为一台具有超高性能的独立服务器. 实 ...
- 分类算法的R语言实现案例
最近在读<R语言与网站分析>,书中对分类.聚类算法的讲解通俗易懂,和数据挖掘理论一起看的话,有很好的参照效果. 然而,这么好的讲解,作者居然没提供对应的数据集.手痒之余,我自己动手整理了一 ...
- git 清空缓冲区
git rm与git rm --cached 当我们需要删除暂存区或分支上的文件, 同时工作区也不需要这个文件了, 可以使用 git rm file_path git commit -m 'delet ...
- 2016ICPC-大连 Convex (几何)
We have a special convex that all points have the same distance to origin point. As you know we can ...
- 记第十四届省赛参赛体会&第十三届
emmm....时间还是很久远了 还是流水账 这次比赛我还是挺开心的 因为感觉我们余神就是一把宝剑,然后我是她的Buff 前面四道题就挺顺利都1A过了,十年余神就是强无敌呀 最后两分钟过了第五题,银牌 ...