当下很多公司都采取前后端分离的开发模式,前端和后端的工作由不同的工程师完成。在这种开发模式下,维护一份及时更新且完整的API 文档将会极大的提高我们的工作效率。传统意义上的文档都是后端开发人员使用word编写的,相信大家也都知道这种方式很难保证文档的及时性,这种文档久而久之也就会失去其参考意义,反而还会加大我们的沟通成本。而 Swagger 给我们提供了一个全新的维护 API 文档的方式,下面我们就来了解一下它的优点
在阅读本文之前,您先需要了解Swagger的使用,如果您还不知道它是用来干嘛的,请先阅读《Spring Boot中使用Swagger2构建强大的RESTful API文档》一文。 前言 在学会了如何使用Swagger之后,我们已经能够轻松地为Spring MVC的Web项目自动构建出API文档了。但是,如前文方式构建的文档必须通过在项目中整合 swagger-ui、或使用单独部署的 swagger-ui和 /v2/api-docs返回的配置信息才能展现出您所构建的API文档。本文将在使用Swagger的基础
在学会了如何使用Swagger之后,我们已经能够轻松地为Spring MVC或SpringBoot的Web项目自动构建出API文档了。但是,构建的文档必须通过在项目中整合swagger-ui、或使用单独部署的swagger-ui和/v2/api-docs返回的配置信息才能展现出您所构建的API文档。本文将在使用Swagger的基础上,再介绍一种生成静态API文档的方法,以便于构建更轻量部署和使用的API文档。 Swagger使用说明:REST API文档工具Swagger2,以及与SpringBoot的集成
在上一篇《使用Swagger2Markup实现API文档的静态部署(一):AsciiDoc》中,我们介绍了如何使用 Swagger2Markup将Swagger文档转换成AsciiDoc,再将AsciiDoc转换成静态HTML。下面,本文将继续介绍Swagger2Markup可以转换的另外两个格式:Markdown和Confluence。 Swagger2Markup简介 Swagger2Markup是Github上的一个开源项目。该项目主要用来将Swagger自动生成的文档转换成几种流行的格式以便于静态部
在日常的工作中,特别是现在前后端分离模式之下,接口的提供造成了我们前后端开发人员的沟通 成本大量提升,因为沟通不到位,不及时而造成的[撕币]事件都成了日常工作。特别是很多的开发人员 不擅长沟通,造成的结果就会让自己特别的痛苦,也让合作人员恨的牙根痒痒。 为了结束战火蔓延,同时为了提升开发人员的满意度,Swagger应运而生。
写公众号写了一年,穿插着写了一本书,在工具的使用上,也渐渐有了些心得,不敢独专,跟大家分享一下。 最早我使用的是reST [1] ,使用sphinx [2] 来撰写文章。使用reST/sphinx最大的好处是格式简单,扩展性强,便于生成PDF和多种文档结构。 然而我的博客在用octopress等工具生成的 [3] ,使用的是markdown。做类似的事,却用两种格式,这让人十分抓狂。再三考虑后,我决定也使用markdown来写公众号。 使用markdown恼人的是格式太简单,有时候需要一些变化,便只好直接上
文章目录 1. SpringBoot整合Swagger 1.1. 依赖 1.2. 配置类 1.3. 启动类 1.4. 访问api的路径 1.5. 注解说明 1.5.1. @Api 1.5.2. @ApiOperation 1.5.3. @ApiImplicitParams 1.5.4. @ApiImplicitParam 1.5.4.1. paramType属性的详细说明 1.6. 导出到markdown文件 1.6.1. 添加依赖 1.6.2. 添加一个测试类 1.7. 参考文章 SpringBoot
Qt 是一个跨平台C++图形界面开发库,利用Qt可以快速开发跨平台窗体应用程序,在Qt中我们可以通过拖拽的方式将不同组件放到指定的位置,实现图形化开发极大的方便了开发效率,本章将重点介绍SqlTableModule组件的常用方法及灵活运用。
在 Access 使用过程中,自增ID的存在将带来很大的便利性,既可以唯一标识每行记录,又可以快速知晓文件的行数,那么,如何才能在 Access 表中创建和生成自增ID呢?本文简单介绍几种方法,供大家参考使用。
在上一篇《python3 实现自动生成入账记录表》说到通过编辑bat文件进行参数的输入不是很方便,本篇就是用tkinter模块制作输入信息界面,输入完成点击’ok’键,触发写好的脚本,使得自动生成入款对账记录表格。
最近做了一个关于动态生成PDF合同的需求 java生成PDF 网络上随便一搜遍有了
原文:Creating API Documentation with Restdocs 译者:HoldDie 校对:Jitianyu 本指南将引导你了解在 Spring 应用程序中为 HTTP 端点(HTTP endpoints)生成文档的过程。 你会建立什么 你将构建一个简单的 Spring 应用程序,其中包含一些暴露 API 的 HTTP 端点(HTTP endpoints)。你将使用 Spring MockMVC 以及 JUnit 来进行 Web 层测试,然后你将使用相同的测试,来为使用 [Sprin
📷 重装idea时必备插件 IDE Eval Rest 白嫖用的 需要添加插件源 https://plugins.zhile.io GitToolBox inline blame annotation CamelCase 切换命名风格–比如驼峰<->下划线 CTRL+ALT+U CodeGlance 略缩图 CTRL+SHIFT+G Codota AI Autocomplete for Java 代码提示补全工具 GitHub Copilot 代码提示补全工具(比较逆天 慎用) Jrebel 热部署(付费,
大量实践发现后台管理程序,其实90%的代码都是相同的,当然是在抛弃复杂逻辑业务的情况下,那么如何能高效的节约这些时间呢,那就是接下来我要说的,对于后台系统自动生成的一些思考。 适用情景: 1、表编号id为自增(基于现在大部分表编号都是自增的情况); 2、没有太复杂业务关联关系,比如表的某一个字段,存储了一个json对象,为了平衡后台用户使用,需要友好的分段展示给用户的定制ui界面;还比如表中存储了外键的多个id,但为了方便用户使用,只能已标签name的方式,给用户展示,等等这些超强业务黏合逻辑的情景
在 Rafy 领域实体框架中,对自关联的实体结构做了特殊的处理,下面对这一功能进行讲解。 场景 在开发数据库应用程序时,往往会遇到自关联表的场景。例如,分类信息、组织架构中的部门、文件夹信息等,都是不
AsciiDoc,它的设计初衷就是为了解决写书规模的问题,并且是 O’Reilly 的在线出版平台 Atlas 的推荐语言。经过一番学习,我觉得 Asciidoc 确实很适合电子书制作。
最近经常被问 https://t.itmuch.com/doc.html 文档页是怎么制作的,考虑到步骤略复杂,写篇手记总结下吧。
大型公司的年会上总会进行一些优秀员工的评选,大学每个学期期末的时候总会进行奖学金的评选,等等……
例如:如果使用 Navicat、PHPMyAdmin 之类的可视化工具,可以直接点击转储 SQL 文件,或者导出 SQL 文件之类的功能。
数据库设计规范是个技术含量相对低的话题,只需要对标准和规范的坚持即可做到。当系统越来越庞大,严格控制数据库的设计人员,并且有一份规范书供执行参考。在程序框架中,也有一份强制性的约定,当不遵守规范时报错
几年前在 oreilly 看到一本叫 《living documentation》的书,可惜当时没读完。
在我们开始之前,先看看你能否回答这个问题:Visual studio Code 和 Visual Studio 的区别是什么?
住建局经常开展市政工程施工、监理企业工程资料专项检查,施工单位、监理单位的纸质资料原件经常被翻乱,重新整理起来很费事,甚至会遗失。
相信很多后端开发在项目中都会碰到要写 api 文档,不管是给前端、移动端等提供更好的对接,还是以后为了以后交接方便,都会要求写 api 文档。
2. mybatis与hibernate的区别:两者均为ORM框架,但也有一些不同
码 共3图>01 初始化文档 HTML文档需要包含一些固定的标签,比如<html>、<head>、<body>等,现在你只需要1秒钟就可以输入这些标签。比如输入“!”或“html:5”,然后按Tab键或ctrl+e: html:5 或!:用于HTML5文档类型 html:xt:用于XHTML过渡文档类型 html:4s:用于HTML4严格文档类型 >02 轻松添加类、id、文本和属性 1、连续输入元素名称和ID,Emmet会自动为你补全,比如输入p#foo:2、连续输入类和id,比如p.bar#foo,会自动生成: 3、下面来看看如何定义HTML元素的内容和属性。你可以通过输入h1{foo}和a[href=#],就可以自动生成如下代码: >03 嵌套 现在你只需要1行代码就可以实现标签的嵌套 >:子元素符号,表示嵌套的元素 +:同级标签符号 ^:可以使该符号前的标签提升一行 >04 分组 可以通过嵌套和括号来快速生成一些代码块,比如输入(.foo>h1)+(.bar>h2),ctrl+e会自动生成: >05 隐式标签 声明一个带类的标签,只需输入div.item,就会生成。在过去版本中,可以省略掉div,即输入.item即可生成。现在如果只输入.item,则Emmet会根据父标签进行判定。比如在 中输入.item,就会生成。下面是所有的隐式标签名称: li:用于ul和ol中 tr:用于table、tbody、thead和tfoot中 td:用于tr中 option:用于select和optgroup中 >06 定义多个元素 要定义多个元素,可以使用*符号。比如,ul>li*3可以生成如下代码: 共2图>07 定义多个带属性的元素 如输入 ul>li.item$*3,将会生成如下代码 Emmet中如果需要指定反向编号,可以使用"$@-"符号 如果要从指定的数字开始编号,可以使用ul>li.item$@3*5 CSS缩写 >01 值 1、比如要定义元素的宽度,只需输入w100,即可生成 2、除了px,也可以生成其他单位,比如输入h10p+m5e 单位别名列表: p 表示% e 表示 em x 表示 ex >02 附加属性 1、缩写,比如 @f,可以生成: 一些其他的属性,比如background-p_w_picpath、border-radius、font、@font-face,text-outline、text-shadow等额外的选项,可以通过“+”符号来生成; 2、输入@f+,将生成: >03 模糊匹配 如果有些缩写你拿不准,Emmet会根据你的输入内容匹配最接近的语法,比如输入ov:h、ov-h、ovh和oh,生成的代码是相同的: 共3图>04 供应商前缀 1、如果输入非W3C标准的CSS属性,Emmet会自动加上供应商前缀,比如输入trs,则会生成: 2、可以在任意属性前加上“-”符号,也可以为该属性加上前缀。比如输入-super-foo: 3、如果不希望加上所有前缀,可以使用缩写来指定,比如-wm-trf表示只加上-webkit和-moz前缀: 前缀缩写如下: w 表示 -webkit- m 表示 -moz- s 表示 -ms- o 表示 -o- >05 . 渐变输入lg(left, #fff 50%, #000),会生成如下代码: 注意事项 Emmet中需要注意不要添加额外的空格 进一步学习可到官网
在插入新行时,通过遍历表,找到的第一个未分配的主键编号分配给新行,来代替原来自动分配的伪主键机制。
用DataGridView控件,可以显示和编辑来自多种不同类型的数据源的表格数据。
上一回说道, Markdown可以使用一些高级用法进一步提升文档的质量和可读性,以完成高要求的复杂文本写作如论文等。
一个 java restful api 文档生成工具,不用像Swagger一样写大量注解,完全基于接口源码分析来生成接口文档,但是需要按照 java的标准注释写。
前两章我们简单讲解了SpringBoot的易用性,SpringBoot框架内部提供了很多我们需要用到的组件,需要什么你就可以拿到项目里。 在我们平时的项目中,数据的存储以及访问都是最为核心的关键部分,现在有很多企业采用主流的数据库,如关系型数据库:MySQL,oracle,sqlserver。非关系型数据库:redis,mongodb等。 SpringBoot已经为我们提供了很多种的数据库来做数据存储以及读取,上面只是简单的几种,那么我接下来以MySQL为例来讲述下本章的内容。 本章目标 学习并且使用Spr
Markdown 是现在最流行的轻量级标记语言,Github、Stack Overflow、Smashing Magazine 等网站都使用 Markdown。Markdown 格式简单,纯文本具有很好的可读性。但它对复杂格式(例如表格、图片标题)支持不够,也没有预留扩展语法,不同网站各自扩展产生了很多方言。
2、如果该表已经存在,也需要填写这些注解信息,要不然会出现实体跟数据库不对应的错误;
本文以Spring整合MyBatis环境下,介绍MyBatis逆向工程自动生成pojo,mapper,dao的Java类。MyBatis的一个主要的特点就是需要程序员自己编写sql,那么如果表太多的话,难免会很麻烦,所以mybatis官方提供了一个逆向工程,可以针对单表自动生成mybatis执行所需要的代码,一般在开发中,常用的逆向工程方式是通过数据库的表生成代码。下图为逆向工程依赖的jar包。
伪列的数据是由ORACLE进行维护和管理的,用户不能对这个列修改,只能查看。
6 聚合函数 聚合函数是用来做纵向运算的函数: l COUNT():统计指定列不为NULL的记录行数; l MAX():计算指定列的最大值,如果指定列是字符串类型,那么使用字符串排序运算; l MIN():计算指定列的最小值,如果指定列是字符串类型,那么使用字符串排序运算; l SUM():计算指定列的数值和,如果指定列类型不是数值类型,那么计算结果为0; l AVG():计算指定列的平均值,如果指定列类型不是数值类型,那么计算结果为0; 6.1 COUNT 当需要纵向统计时可以使用COUNT()。 l 查
You say you love me, but you don't know me at all! Your love...Your love is all virtual!(Login User: guest)
首先,发货客户与快递公司签订货运合同(货运单),把货物交给快递公司来托运,并按照货运合同的付款方式付款。快递公司根据货物运输线路,为货物配车,找到合适的车辆后,与司机签订运输合同(回执单),并按照运输合同的运费结算方式结算。司机对货物检查无误后,装车,然后发车,发车后,货物的任何损失由司机承担。
mysql自增主键设置 在数据库应用中,经常希望在每次插入新纪录时,系统自动生成字段的主键值。可以通过为表主键添加AUTO_INCREMENT关键字来实现。 默认情况下,在MYSQL中AUTO_INCREMENT的初始值是1,每新增一条记录,字段值自动加1.一个表只能有一个字段属用AUTO_INCREMENT约束,且该字段必须为主键的一部分。AUTO_INCREMENT约束的字段可以是任何整数类型(TINTINT、SMALLINT、INT、BIGINT等) 设置表的属性值自动增加的语法规则如下: 字段名
之前写过一篇如何生成离线官方文档的文章,但也有社区伙伴反馈说,是不是能够导出一个pdf格式的离线文档。
总账科目,它起到统驭整个财务的作用。不同的会计科目在总账主数据中创建会应用到不同的“字段”(field),通过这些不同“字段”的组合,就会形成系统能够识别并能够为我们现行会计核算所接受的会计科目。
主键(PRIMARY KEY)的完整称呼是“主键约束”,是 MySQL 中使用最为频繁的约束。一般情况下,为了便于 DBMS 更快的查找到表中的记录,都会在表中设置一个主键。
IDEA整合LeetCode插件,可以在 IDEA 本地编辑代码并且运行提交,还能关联自己的账号,非常实用。
PhotoShop从CS版本演变到现在的CC版本,切图功能发生了比较大的变化,我们可以把PhotoShop CS版本时的切图功能称为传统切图,而从PhotoShop CC版本开始PS提出了精准切图。所谓传统切图就是切图人员基本上都是自己分割图层切图,传统切图又分为全手工切图和参考线切图;现在CC版本提出的精准切图,切图人员可以依赖计算机把图层对象精确的切割出来,这样切割出来的图层肯定比传统切图切出来的精准度高。另一方面,CC版本可通过脚本执行全自动切图,这样完全解放了切图人员的双手。
title: date: 2018-08-25 19:22:00 categories:
beats组件在云原生的时代,已经是数据采集领域使用最广泛的开源工具集之一。特别是filebeat与metricbeat,被广泛用于各种环境的日志和指标采集。无论是传统的IDC机房中设备,还是基于云原生技术的容器或者k8s pods,或是公有云基础设施组件。beats由elastic提供了数百种用于不同数据源和目的的数据采集模块(modules),以方便我们便捷的采集数据,并以统一的格式和规范的数据发送到不同的数据存储和分析平台。
车间工厂等货物人员密集场所,对消防安全的要求很高。消防设备管理自然是生产制造型企业的核心之一。
领取专属 10元无门槛券
手把手带您无忧上云