在进行app后端开发过程中，后端会提供出来很多的api接口供前端开发使用，为了让前端开发人员顺利使用，我们会写好一份文档，告诉他们这个接口你该用 GET 还是 POST 来访问，同时访问的时候该给我传递一些什么参数，以及正确的时候我会返回什么给你，已经返回的数据样式以及字段解释等等这些事情，我们都需要在文档中写好写清楚。在 app后端开发一：基于swagger-ui构建api接口文档工具...
分类：
移动开发 时间：
2015-07-08 19:10:31
阅读次数：
321
http://swagger.io/tools/ 官网core tool - core - codegen - UI -editoradjacent tool - js - node-express - scoket - parsernodejs--apis 是node-express编辑：swag...
分类：
其他好文 时间：
2015-07-08 10:44:54
阅读次数：
2230
声明之前写过关于app后端开发的一系列文章，那是我第一次做app后端开发，存在很多不足，本想好好修改一下，想想还是重新写吧，这样子也能让我博客文章看起来多一点嘛，万一以后找工作，别人一看我博客这么多内容，是不是很屌？
这次文章先从构建resetful风格的api文档工具开始。没有一个好的文档工具，在app前端人员开发过程中会导致开发效率极低，而且时不时的，他们就来找你跟他们断点一下。我的文档经历...
分类：
移动开发 时间：
2015-06-18 15:23:10
阅读次数：
230
一、前言现在使用WebAPI来作为实现企业服务化的需求非常常见，不可否认它也是很便于使用的，基于注释可以生成对应的帮助文档（Microsoft.AspNet.WebApi.HelpPage），但是比较便利和可持久化的调试官方却没有相应的集成，虽然我们可以使 用诸如Fiddler、Swagger、Po...
一、前言现在使用WebAPI来作为实现企业服务化的需求非常常见，不可否认它也是很便于使用的，基于注释可以生成对应的帮助文档（Microsoft.AspNet.WebApi.HelpPage），但是比较便利和可持久化的调试官方却没有相应的集成，虽然我们可以使 用诸如Fiddler、Swagger、Po...
一、简介
Springfox的前身是swagger-springmvc,是一个开源的API doc框架，可以将我们的Controller的方法以文档的形式展现。
二、接入
1、pom依赖
1）必要
com.mangofactory
swagger-springmvc
1.0.2
com.fasterxml.jack...
分类：
编程语言 时间：
2015-05-20 18:31:38
阅读次数：
309
在上篇文章中，我对Swagger-UI的基本功能进行了一些介绍，今天在这里介绍一下如何在WebAPI中集成Swagger-UI。这里以一个简单的CRUD的REST服务为例。 1 /// 2 /// 用户管理 3 /// 4 public class UserCon...
相信大家开发web项目时和别人合作接口联调并不陌生，写完接口了解接口有很多种沟通方法，写wiki,看源代码，写文档等等，当然还有一些比较出名的文档框架如swagger，但是我对swagger的框架并不满意，首先他的引入不够轻量级，其次他对代理bean的支持非常差。于是我自己开发了一..
分类：
编程语言 时间：
2015-05-06 15:24:57
阅读次数：
192
swagger 是一个可视化RESTful WebService的工具。
官网：http://swagger.io
效果
下图可以看出，swagger清晰地展现了web服务的方法、地址、发送json格式与应答json格式。还可以通过它直接进行服务调用，查看结果。
工作原理
视图部分： swagger-ui是一系列css\js资源，它通过html页面向用户展示一个应用的RESTfu...
Swagger框架学习分享
转至元数据结尾
Created and last modified by 刘新宇 大约1分钟以前
转至元数据起始
*/一、背景介绍1.1.项目简介1.2.coderepository1.3.演示项目二、开发准备2.1.环境准备2.2.项目搭建2.2.1." style="margin:0px; ...
分类：
其他好文 时间：
2015-03-18 18:02:31
阅读次数：
47788
