前言 相信很多后端开发在项目中都会碰到要写 api 文档,不管是给前端.移动端等提供更好的对接,还是以后为了以后交接方便,都会要求写 api 文档. 而手写 api 文档的话有诸多痛点: 文档更新的时候,需要再次发送给对接人 接口太对,手写文档很难管理 接口返回的结果不明确 不能直接在线测试接口,通常需要使用工具,如 postman 等 Swagger 就很好的解决了这个问题. Swagger 简介 Swagger 是一个规范和完整的框架,用于生成.描述.调用和可视化 RESTful 风格的 W…
Export,选中项目或者需要导出api的类,右键 java-->javadoc configure,选择C:\Program Files\Java\jdk1.6.0_29\bin\javadoc.exe 选择导出路径 next-->next 在Extra javadoc options finish,搞定 打开指定路径下的index.html,即可浏览api文档…
本篇文档介绍如何在MyEclipse中导出javadoc(API)帮助文档,并且使用htmlhelp.exe和jd2chm.exe生成chm文档. 具体步骤如下: 打开MyEclipse,选中想要制作API文档的Java项目,右击选择Export弹出窗口,选择Java下面的Javadoc点击Next进入下一个界面.(Export——Java——Javadoc——Next) 2.选择想要导出API文档的项目(默认已选)和目标文件夹(默认在项目目录下,可修改),点击Next进入下一步. (Javad…
导出jar包过程 右击项目名称->export 选择java->JAR file next->选择路径 导出成功 生成api文档 选择doc->右键export java->javadoc 选择项目和路径 途中遇到问题: 错误: 不再支持源选项 1.3.请使用 7 或更高版本. javadoc->next(而不是finish)->next->JRE source compatibility 错误: 编码 GBK 的不可映射字符 javadoc->nex…
一.HighCharts开发说明: HighCharts开发实际上配置HighCharts每个部分,比如配置标题(title),副标题(subtitle)等,其中每个部分又有更细的参数配置,比如标题下有对齐方式(align),标题文字(text)等.下图为整个图表的每个部分位置说明(请对照下面HighCharts整体结构) 二.HighCharts整体结构: 通过查看API文档我们知道HighCharts结构如下:(API文档在文章后面提供下载) var chart = new Highchar…
一.HighCharts开发说明: HighCharts开发实际上配置HighCharts每一个部分,比方配置标题(title),副标题(subtitle)等,当中每一个部分又有更细的參数配置,比方标题下有对齐方式(align),标题文字(text)等.下图为整个图表的每一个部分位置说明(请对比以下HighCharts总体结构) 二.HighCharts总体结构: 通过查看API文档我们知道HighCharts结构例如以下:(API文档在文章后面提供下载) var chart = new Hig…
一.你必须知道的 1.首先,HighCharts是基于Jquery框架开发的,所以需要在页面引入Jquery,具体代码是: <script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/jquery/1.8.2/jquery.min.js"></script> 2.其次,需要引入HighCharts js文件 <script src="http…
swagger,一款api测试工具,详细介绍参考官网:http://swagger.io/ ,这里主要记录下怎么将swagger api应用到我们的node服务中: 1.任意新建node api项目,使用npm init即可 2.安装依赖: cnpm i express body-parser --save 其中express作为api框架,当然你也可以使用其它的,比如thinkjs.koa.koahub.阿里的egg等等(框架只是一种工具),body-parser用来解析json格式的请求.…
前言: 项目开发中遇到了需要将HTML页面的内容导出为一个word文档,所以有了这边随笔. 当然,项目开发又时间有点紧迫,第一时间想到的是用插件,所以百度了下.下面就介绍两个导出word文档的方法. 法一:通过jquery.wordexport.js导出word 备注:兼容IE9以上 大概浏览了下jquery.wordexport.js插件的代码,了解到了通过该插件可以导出文本和图片,而图片首先通过canvas的形式 绘制,文本则需要再依赖FileSaver.js插件,FileSaver.js插…
swagger ui 是一个在线文档生成和测试的利器,目前发现最好用的.为啥好用呢?打开 demo,支持API自动生成同步的在线文档些文档可用于项目内部API审核方便测试人员了解 API这些文档可作为客户产品文档的一部分进行发布支持API规范生成代码,生成的客户端和服务器端骨架代码可以加速开发和测试速度  下面就将总结一下如何快速在本地搭建一个基于 Node和Swagger UI的文档工具环境搭建:1 . 下载 Swaggerr UI (也可以直接下载 zip文件) git clone http…