一、Postman背景介绍
用户在开发或者调试网络程序或者是网页B/S模式的程序的时候是需要一些方法来跟踪网页请求的，用户可以使用一些网络的监视工具比如著名的Firebug等网页调试工具。今天给大家介绍的这款网页调试工具不仅可以调试简单的css、html、脚本等简单的网页基本信息，它还可以发送几乎所有类型的HTTP请求！Postman在发送网络HTTP请求方面可以说是Chrome插件类产品中的代表产品之一。
二、Postman的操作环境
postman适用于不同的操作系统，Postman Mac、Windows X32、Windows X64、Linux系统，还支持postman 浏览器扩展程序、postman chrome应用程序等。
Postman使用参考文档：
1.官方英文文档

2.chrome插件整理的 postman中文使用教程
三、Postman下载安装
1> 、postman下载地址：
1.Postman for MAC
2.Postman for windows X64
3.Postman for windows X86
4.Postman for linux X64
5.Postman for Linux X86
2>.  Postman官网下载地址：
https://www.getpostman.com/apps
3.Postman安装
postman的安装方法分好几种，按照我们上文介绍的那样，我们分为三种安装模式介绍：
1、chrome浏览器postman 插件安装 

postman谷歌浏览器的安装插件，所以说它的使用前提是你的电脑上得安装谷歌浏览器才行，在安装了谷歌浏览器后还需要在谷歌网上应用店中下载所需要的Postman插件，该插件的下载方式如下：

不能访问google 应用上商店的朋友 可以 参考这里， 或者下载客户端版本
2.Postman电脑客户端安装

1).macOS安装

一旦你下载的应用程序，你可以拖动文件到“应用程序”文件夹。 双击Postman打开应用程序。
2).Windows安装

下载安装文件

运行安装程序

3). Linux安装

我没有试过，但是找了一些参考资料( 有兴趣的朋友可以自行实验)

ubuntu安装postman: https://blog.csdn.net/qianmosolo/article/details/79353632

Ubuntu16.04上安装Postman应用程序:  https://blog.bluematador.com/posts/postman-how-to-install-on-ubuntu-1604/?utm_source=hootsuite&utm_medium=twitter&utm_campaign=
四、Postman的基础功能

五、接口请求流程
1. GET 请求
GET请求：点击Params，输入参数及value，可输入多个，即时显示在URL链接上，
所以，GET请求的请求头与请求参数如在接口文档中无特别声明时，可以不填。



响应 示例：  这里会有请求的响应状态码，响应时间，以及响应大小



响应体示例：  响应的格式可以有多种，我这里由于请求的是 百度，so,  响应的是 html ,

一般情况下，我们自定义接口的话是 json格式的响应体

2. POST请求
POST请求一：表单提交

下图示例中设置了请求方法，请求URL，请求参数，但是没有设置请求头

在我的使用过程中，请求头是根据请求参数的形式自动生成的

请求头中的Content-Type与请求参数的格式之间是有关联关系，比如：





POST请求二：json提交

下图中，当我们选择JSON(application/json) 是会自动帮我们设置 headers 为 application/json

在这里就不截图 举例了，朋友们可以自行去查看



POST请求三：xml提交



POST请求四：二进制文件提交


其它请求方式如PUT,DELETE 大致流程和GET,POST 差不多，这里就不一一举例说明了
六、管理用例—Collections
在POST基础功能那里有一张图片大致说了一下Collections 的作用， 这里我们再详细说明一下

Collections集合：也就是将多个接口请求可以放在一起，并管理起来。什么样的接口请求可以放在同一个collection里？
在这里告诉大家可以这样：一个工程一个Collection，这样方便查找及统一处理数据。



第一步, 创建Collections

点击上图中的带+号的图标，输入Name:”abc”，Description:”示例demo”，点击Create按钮即创建成功一个Collections.

第二步，在Collections里添加请求
在右侧准备好接口请求的所有数据，并验证后，点击save按钮。


保存好之后就可以在这里看到啦，之后要再次调用时可以点击这里，方便快捷有木有

collections 管理精细化， 这里我们针对不同的请求方式做分组

添加子文件夹



这是我们精细化划分之后的结果， 是不是看着有条理多了？


七、身份验证Authentication

1、Basic Auth
是基础的验证，所以会比较简单

会直接把用户名、密码的信息放在请求的 Header 中
2、Digest Auth
要比Basic Auth复杂的多。使用当前填写的值生成authorization header。所以在生成header之前要确保设置的正确性。如果当前的header已经存在，postman会移除之前的header。
3、OAuth 1.0
postman的OAuth helper让你签署支持OAuth
1.0基于身份验证的请求。OAuth不用获取access token,你需要去API提供者获取的。OAuth 1.0可以在header或者查询参数中设置value。
4、OAuth 2.0
postman支持获得OAuth 2.0 token并添加到requests中。

2018-07-02 更新

感谢某位兄弟的宝贵意见，及时发现了错误，同时希望其他仁兄在阅读过程中若是发现错误的话，欢迎提出意见与建议，再一次感谢

2018-08-02 更新

Postman Interceptor  Google Chrome 插件下载资源

https://download.csdn.net/download/fxbin123/10578475

2018-10-26 更新

Postman Google Chrome 插件下载资源

https://download.csdn.net/download/fxbin123/10745065

这篇文章源于6月份给公司新人作的关于SVN使用的培训，转眼已经过了几个月的时间，丢了也怪可惜的，于是整理出来希望能够帮助后来人快速入门。

文章目录
安装说明
使用说明
检出项目
导入项目
提交
更新
查看日志
版本回滚
版本控制
总结

安装说明

开发人员强烈建议使用IDE中的SVN插件更加智能与人性化。

首先安装SVN客户端，windows一般选择乌龟客户端https://tortoisesvn.net/downloads.html。

根据系统位数选择相应客户端进行安装。

如果你喜欢用命令行操作，请务必记得勾选command line client tool为will be install on local hard driver,不用命令行的跳过这一步。

然后一路next即可安装。安装完毕后，在任意地方右键查看快捷菜单。发现TortoiseSVN即表示安装成功。

如果勾选了安装命令行工具，那么输入命令SVN，有如下提示也表示安装成功

但是此时菜单全是英文的，如果你不习惯英文，可以去下载语言包，记得下对系统位数。

安装完语言包之后，可以右键进入setting设置。

选择你喜欢的语言（比如中文），然后确定，不出意外，现在的语言已经切换到中文了。

安装教程到此结束，下面开始介绍SVN的使用。
使用说明
检出项目
假如项目已经在服务器的仓库里，那么现在你要做的就是把它检出到本地。

首先创建一个空文件夹。在空文件夹内右键，选择SVN检出。

现在你看到应该是这个界面，填入版本库地址，选择确定。

此时会弹出一个对话框让你输入账号密码，输入你的账号密码即可。记得勾选保存认证，不然每次操作都会让你输入。

等几分钟就可以检出完毕。

此时在你的目录下就能看到你的项目，现在可以开始愉快的工作了。

导入项目
但是有时候你已经在本地建立好了项目，需要把你项目推到SVN上，此时应怎么做呢？

右键选择版本库浏览器。

在相应目录下，右键，加入文件/加入文件夹，选择相应目录即可。

比如我现在有个项目叫SVNProject，我想把它传到SVN上。

那么我只需选择加入文件夹即可。

务必要输入提交信息。这样别人才能知道你干了什么。

导入成功就能看到目录。

但是，不要以为导入成功就可以了。你还得重新检出，重新检出的项目才是受SVN控制的，务必记得检出。

在SVNProject上右键检出到本地，然后在里面进行修改。现在就可以愉快的工作了。

检出过后的右键菜单变成了这样。

提交
绿色表示当前文件没有被修改过（看不见颜色的重启下电脑就好了）。

假如我现在在我是新项目.txt中加了一行字，然后保存。

发现现在变成了红色，红色表示已修改。

怎么提交修改？

在根目录下，右键选择提交。

务必记得输入提交信息（虽然不输入也能提交），提交信息可以方便日后查看。

提交完毕后，可以发现又恢复到了绿色。

假如现在加入了一个新文件。可以看出是蓝色的。蓝色表示不属于版本库的未知文件，未知文件是不能提交的。

记住选择增加把它加入到版本库里面去。

增加完毕后，变成了蓝色加号，表示新增加的版本库文件。

接下来，只需写代码，然后提交即可。

删除文件也应该右键提交，如下。

记得随时检查你的文件状态，如果没有添加到版本控制里要及时添加进去，不然你的文件提交不上去。
更新
假如你和B同学在协作。B同学写完代码提交到了SVN上，如果你想获取最新修改，就需要选择更新（如果服务器上已经有别人提交过的新的，你是提交不上去的，必须先更新再提交）。

怎么知道服务器有没有更新？你可以直接选择更新，有没有更新一下就知道。或者右键检查修改，然后检查版本库，就能看到服务器上改了哪些文件。

右键选择HEAD和BASE比较。

左边的表示你的代码，右边的表示服务器上的代码。

如果有修改记得及时更新到本地然后再继续工作。
但是有时候更新会冲突，比如你和服务器上的改了同一个地方。

这时候你需要更新下来解决冲突。

它会提示你哪个文件冲突，你只需打开那个文件，按照需求解决冲突即可。

<<<<<<.mine到====表示你的代码，其他表示服务器的代码。你只需改成你想要的。

然后选择解决，告诉SVN我已经解决冲突了就行了。

剩下的就是团队协作间的更新提交操作，这里不做赘述。
查看日志
选择显示日志，可以看出团队里面的人干了什么。

可以看出谁谁谁，什么时间，干了什么事。最后那一列信息是自己提交的时候写的。建议大家提交时务必要填写提交信息，这样别人一看就知道你干了什么。提交信息对于自己也是有好处的，时间长了也能看到当初做了什么。

版本回滚
如果你改了东西，但是还没有提交，可以使用还原功能。

但是如果我们写错了东西并且提交了上去怎么办？通过版本回滚可以将文件恢复到

以前的版本。右键更新至版本，通过查看日志来选择版本，然后回滚即可。

有时候我们需要查看以前版本的代码。此时我们可以新建个文件夹检出到指定版本。

版本控制
版本控制有好几种方法，如下。

在提交发布版本时添加版本信息，这是最简单的一种方法。



打标签

每次发布版本时应该打标签。右键选择分支/标记。在至路径以版本号打上标签即可



这样你就有了一个v1.0版本的标签。

以后如果你想查看某个版本的代码，只需切换过去就行

总结
我们在日常使用中，最常用的是更新和提交操作。这两个步骤务必要非常熟练。其他的可以在遇到问题是查看文档。此外，需要注意的是，所有版本控制工具只能跟踪文本文件（能用记事本打开查看的文件），不要妄想SVN能记录你word改了哪一行。一旦遇到word冲突，记住仔细对比两个版本，然后解决冲突。

推荐阅读

如何写一份让 HR 眼前一亮的简历（附模板）

字节、美团、快手核心部门面试总结（真题解析）

面试阿里，HashMap 这一篇就够了

面试必问的 MySQL，你懂了吗？

面试必问的线程池，你懂了吗？

4 年 Java 经验，阿里网易拼多多面试总结、心得体会

跳槽，如何选择一家公司

如何准备好一场大厂面试

MySQL 8.0 MVCC 核心原理解析（核心源码）

921天，咸鱼到阿里的修仙之路

复习2个月拿下美团offer，我都做了些啥

 

 

概述

在我们的日常工作中，经常会用到SVN，大多数都是搭配Eclipse/MyEclipse使用。本文主要介绍SVN在Eclipse中的一些最长用的功能，包括SVN插件的下载使用、上传代码到服务器、从服务器下载代码、从服务器更新代码、解决代码冲突。

本文链接：http://blog.csdn.net/v123411739/article/details/22512133

 

1.在Eclipse里下载Subclipse插件（建议使用方法三）

方法一：从Eclipse Marketplace里面下载

具体操作：打开Eclipse --> Help --> Eclipse Marketplace --> 在Find中输入subclipse搜索 --> 找到subclipse点击install

 





 

方法二：从Install New Software里下载

具体操作：打开Eclipse --> Help --> Install New Software --> 点击add按钮，输入下载地址：http://subclipse.tigris.org/update_1.10.x，点击OK

 



 

--> 将Subclipse和SVNKit打勾后，一路next或agree到结束即可(此处由于本人已经安装，因此next是灰色的)

 



 

方法三：直接下载subclipse的zip文件（建议使用）

具体操作：百度搜索subclipse-site-1.10.x(看自己想安装哪个版本) --> 解压缩后在eclipse目录下找到dropins文件夹，进入dropins文件夹并新建一个文件夹名为svn，将features和plugins文件夹复制到svn目录下-->重启下Eclipse即可

 



 

2.上传project到SVN服务器

1.在Eclipse中，从Show View里调出SVN资源库视图



 

2.在SVN资源库窗口的空白位置右键选择新建资源库位置



 

3.填好服务器的地址



 

4.资源库导入成功，SVN资源库视图下出现导入的资源库



 

5.新建project，写好project的初始版本



 

6.右键Project --> Team --> Share Project



 

7.选择Repository类型为SVN --> 点击next



 

8.使用已有资源库位置，或者创建新的资源库位置



 

9.使用项目名称作为文件夹名 --> 点击Finish --> 输入用户名和密码（此步不一定每个人都有）



 

10.自由选择是否打开Synchronize视图，建议打开



 

11.右键project --> Team --> 提交



 

12.自由选择是否写日志（建议写）



 

13.点击OK --> 上传到服务器成功，此时刷新对应的资源库，资源库下出现上传的Project



 

3.从服务器下载project到本地

1.在资源库视图点击资源库左边的小三角形后出现该资源库下的所有Project（如果还没有资源库则参考上面新建一个资源库位，填入资源库地址即可）



 

2.选择要下载的project右键 --> 检出为



 

3.自由选择是否更改属性（建议使用默认） --> Finish --> 下载成功



 

4.从服务器更新代码

1.右键项目Project --> 与资源库同步

 



 

2.选择打开Synchronize视图

 





 

3.与本地代码有不同的服务器代码将显示在Synchronize视图下，双击某个代码文件可以查看本地代码和服务器代码的对比，加号的为新增的文件（本地还没有）

 



 

 

4.将模式切换到Incoming Mode，这个模式下的代码都是服务器更新的代码，需要下载到本地的，右键要更新的文件 --> Team --> 更新

 

 



 

 

5.如果出现下图这个符号，则代表本地代码和服务器代码有冲突（即：本地代码在未更新到最新版本的情况下，对代码进行了更改；或者在你对a.java写代码的期间，有人往服务器上传了新的a.java代码，使得代码间出现了冲突），有冲突时需要先解决冲突再合并代码



 

5.冲突情况的解决办法

冲突情况1：服务器代码和自己代码改动的地方相同

这种情况比较复杂，一般只能将自己的代码保存一份到本地，然后直接将服务器代码更新下来，然后在新的代码上修改自己的逻辑。

 

冲突情况2：服务器代码和自己代码改动的地方不同

这种情况比较常见，就是你跟别的开发者都在更改同一个文件，但是由于开发任务是分开的，所以更改的地方是不同的，解决办法如下。

 

1、双击冲突文件进入比较视图



 

2、找到服务器上新增的但本地没有的代码块，选中此代码块，点击右上角的按钮（如下图箭头指向的按钮）将服务器代码复制到本地（其他地方也同此操作），如果点击按钮没用，则关闭比较视图重新打开



下图为成功将服务器代码复制到本地代码，



 

3.将所有服务器上新增的代码复制到本地文件后，右键冲突文件选择标记为合并即可，此时该文件就会消失在Synchronize视图下，并且该文件的代码已经成功将本地代码和远程代码合并到一起



 

 

 



 

 1.这里使用的版本：springfox-swagger2（2.4）springfox-swagger-ui （2.4） 

2.这里是说明常用注解的含义和基本用法（也就是说已经对swagger进行集成完成） 

没有集成的请参见 
SpringBoot集成springfox-swagger2构建restful API 
SpringMVC集成springfox-swagger2构建restful API 
官网WIKI 

常用注解： 

- @Api()用于类； 

表示标识这个类是swagger的资源 

- @ApiOperation()用于方法； 

表示一个http请求的操作 

- @ApiParam()用于方法，参数，字段说明； 

表示对参数的添加元数据（说明或是否必填等） 

- @ApiModel()用于类 

表示对类进行说明，用于参数用实体类接收 

- @ApiModelProperty()用于方法，字段 

表示对model属性的说明或者数据操作更改 

- @ApiIgnore()用于类，方法，方法参数 

表示这个方法或者类被忽略 

- @ApiImplicitParam() 用于方法 

表示单独的请求参数 

- @ApiImplicitParams() 用于方法，包含多个 @ApiImplicitParam

具体使用举例说明： 

@Api() 

用于类；表示标识这个类是swagger的资源 

tags–表示说明 

value–也是说明，可以使用tags替代 

但是tags如果有多个值，会生成多个list

@Api(value="用户controller",tags={"用户操作接口"})
@RestController
public class UserController {

}

 

效果图： 


@ApiOperation() 用于方法；表示一个http请求的操作 

value用于方法描述 

notes用于提示内容 

tags可以重新分组（视情况而用） 

@ApiParam() 用于方法，参数，字段说明；表示对参数的添加元数据（说明或是否必填等） 

name–参数名 

value–参数说明 

required–是否必填

@Api(value="用户controller",tags={"用户操作接口"})
@RestController
public class UserController {
     @ApiOperation(value="获取用户信息",tags={"获取用户信息copy"},notes="注意问题点")
     @GetMapping("/getUserInfo")
     public User getUserInfo(@ApiParam(name="id",value="用户id",required=true) Long id,@ApiParam(name="username",value="用户名") String username) {
     // userService可忽略，是业务逻辑
      User user = userService.getUserInfo();

      return user;
  }
}

 

效果图： 


@ApiModel()用于类 ；表示对类进行说明，用于参数用实体类接收 

value–表示对象名 

description–描述 

都可省略 

@ApiModelProperty()用于方法，字段； 表示对model属性的说明或者数据操作更改 

value–字段说明 

name–重写属性名字 

dataType–重写属性类型 

required–是否必填 

example–举例说明 

hidden–隐藏

@ApiModel(value="user对象",description="用户对象user")
public class User implements Serializable{
    private static final long serialVersionUID = 1L;
     @ApiModelProperty(value="用户名",name="username",example="xingguo")
     private String username;
     @ApiModelProperty(value="状态",name="state",required=true)
      private Integer state;
      private String password;
      private String nickName;
      private Integer isDeleted;

      @ApiModelProperty(value="id数组",hidden=true)
      private String[] ids;
      private List<String> idList;
     //省略get/set
}

 

 

  @ApiOperation("更改用户信息")
  @PostMapping("/updateUserInfo")
  public int updateUserInfo(@RequestBody @ApiParam(name="用户对象",value="传入json格式",required=true) User user){

     int num = userService.updateUserInfo(user);
     return num;
  }

 

 

效果图： 




@ApiIgnore()用于类或者方法上，可以不被swagger显示在页面上 

比较简单, 这里不做举例

@ApiImplicitParam() 用于方法 

表示单独的请求参数 

@ApiImplicitParams() 用于方法，包含多个 @ApiImplicitParam 

name–参数ming 

value–参数说明 

dataType–数据类型 

paramType–参数类型 

example–举例说明

  @ApiOperation("查询测试")
  @GetMapping("select")
  //@ApiImplicitParam(name="name",value="用户名",dataType="String", paramType = "query")
  @ApiImplicitParams({
  @ApiImplicitParam(name="name",value="用户名",dataType="string", paramType = "query",example="xingguo"),
  @ApiImplicitParam(name="id",value="用户id",dataType="long", paramType = "query")})
  public void select(){

  }

 

效果图：