从curl的一个使用实例说起:
将以下代码拷贝到命令行即可执行
curl -X POST \
http://jd.dev.imdada.cn/pickup/addOrder/ \
-H 'cache-control: no-cache' \
-H 'content-type: application/json' \
-H 'postman-token: 2f6b7816-cf06-f821-5658-7b6b3df82de2' \
-d '{
"batchNo": "Q33100223333",
"senderName": "上门揽件",
"senderPhone": "18239922164",
"senderAddress": "上海浦东新区隆宇大厦浦东南路1036",
"orderGoodsList":[{
"goodsId":"1" ,
"goodsName": "123222",
"goodsPrice": 40,
"goodsCount": 1
}
],
"deliverCompanyId": "566358",
"deliverCompanyName": "华北众包站",
"sign": "zy"
}'
这是因为mac或者windows中预装了curl命令行工具。那么curl是什么呢?哪里有用到。
CURL介绍
官方解释
CURL,全称Command Line URL Viewer,是一个Linux命令行工具,能从服务器下载数据,也能往服务器上发送数据,支持多种协议,支持的协议有:DICT,FILE,FTP,FTPS,GOPHER,HTTP,HTTPS,IMAP,IMAPS,LDAP,LDAPS,POP3,POP3S,RTMP,RTSP,SCP,SFTP,SMB,SMBS,SMTP,SMTPS,TELNET和TFTP。
深入理解
curl是一个广泛使用的用来上传和下载的命令行工具,当然严格来讲,它还可以有别的用途。对于测试来讲,它是Web相关测试非常实用的工具,包括debugging,使用起来非常方便。而且另一方面,因为它是纯命令行的工具,所以也可以非常方便的作为一个组件集成到automation或者其他的测试框架里面,将HTTP/HTTPS/FTP相关的上传和下载等任务交给它。
最近因为在做web service相关的测试,用到了curl,觉得还不错,顺便给大家介绍一下。
使用方法
基本用法示例
curl http://www.google.com curl -o f1
ftp://user:pwd@myftp/Ricky/test.ini curl dict://dict.org/d:test 传递请求数据
默认curl使用GET方式请求数据,这种方式下直接通过URL传递数据 可以通过 --data/-d 方式指定使用POST方式传递数据
GET
curl -u username https://api.github.com/user?access_token=XXXXXXXXXX
POST
curl -u username --data “param1=value1¶m2=value”
https://api.github.com
也可以指定一个文件,将该文件中的内容当作数据传递给服务器端
curl --data @filename https://github.api.com/authorizations
除了使用GET和POST协议外,还可以通过 -X 选项指定其它协议,如:
curl -I -X DELETE https://api.github.cim
如果想使用JSON形式post数据,可以使用-H指定头部类型
curl -H “Content-Type:application/json”
总结
CURL的命令参数还有很多,就不一一演示了。下面是CURL的参数及功能列表:
-a/–append 上传文件时,附加到目标文件
-A/–user-agent 设置用户代理发送给服务器
- anyauth 可以使用“任何”身份验证方法
-b/–cookie <name=string/file> cookie字符串或文件读取位置 - basic 使用HTTP基本验证
-B/–use-ascii 使用ASCII /文本传输
-c/–cookie-jar 操作结束后把cookie写入到这个文件中
-C/–continue-at 断点续转
-d/–data HTTP POST方式传送数据
–data-ascii 以ascii的方式post数据
–data-binary 以二进制的方式post数据
–negotiate 使用HTTP身份验证
–digest 使用数字身份验证
–disable-eprt 禁止使用EPRT或LPRT
–disable-epsv 禁止使用EPSV
-D/–dump-header 把header信息写入到该文件中
–egd-file 为随机数据(SSL)设置EGD socket路径
–tcp-nodelay 使用TCP_NODELAY选项
-e/–referer 来源网址
-E/–cert <cert[:passwd]> 客户端证书文件和密码 (SSL)
–cert-type 证书文件类型 (DER/PEM/ENG) (SSL)
–key 私钥文件名 (SSL)
–key-type 私钥文件类型 (DER/PEM/ENG) (SSL)
–pass 私钥密码 (SSL)
–engine 加密引擎使用 (SSL). “–engine list” for list
–cacert CA证书 (SSL)
–capath CA目录 (made using c_rehash) to verify peer against (SSL)
–ciphers SSL密码
–compressed 要求返回是压缩的形势 (using deflate or gzip)
–connect-timeout 设置最大请求时间
–create-dirs 建立本地目录的目录层次结构
–crlf 上传是把LF转变成CRLF
-f/–fail 连接失败时不显示http错误
–ftp-create-dirs 如果远程目录不存在,创建远程目录
–ftp-method [multicwd/nocwd/singlecwd] 控制CWD的使用
–ftp-pasv 使用 PASV/EPSV 代替端口
–ftp-skip-pasv-ip 使用PASV的时候,忽略该IP地址
–ftp-ssl 尝试用 SSL/TLS 来进行ftp数据传输
–ftp-ssl-reqd 要求用 SSL/TLS 来进行ftp数据传输
-F/–form <name=content> 模拟http表单提交数据
-form-string <name=string> 模拟http表单提交数据
-g/–globoff 禁用网址序列和范围使用{}和[]
-G/–get 以get的方式来发送数据
-h/–help 帮助
-H/–header自定义头信息传递给服务器
–ignore-content-length 忽略的HTTP头信息的长度
-i/–include 输出时包括protocol头信息
-I/–head 只显示文档信息
从文件中读取-j/–junk-session-cookies忽略会话Cookie - 界面指定网络接口/地址使用
- krb4 <级别>启用与指定的安全级别krb4
-j/–junk-session-cookies 读取文件进忽略session cookie
–interface 使用指定网络接口/地址
–krb4 使用指定安全级别的krb4
-k/–insecure 允许不使用证书到SSL站点
-K/–config 指定的配置文件读取
-l/–list-only 列出ftp目录下的文件名称
–limit-rate 设置传输速度
–local-port 强制使用本地端口号
-m/–max-time 设置最大传输时间
–max-redirs 设置最大读取的目录数
–max-filesize 设置最大下载的文件总量
-M/–manual 显示全手动
-n/–netrc 从netrc文件中读取用户名和密码
–netrc-optional 使用 .netrc 或者 URL来覆盖-n
–ntlm 使用 HTTP NTLM 身份验证
-N/–no-buffer 禁用缓冲输出
-o/–output 把输出写到该文件中
-O/–remote-name 把输出写到该文件中,保留远程文件的文件名
-p/–proxytunnel 使用HTTP代理
–proxy-anyauth 选择任一代理身份验证方法
–proxy-basic 在代理上使用基本身份验证
–proxy-digest 在代理上使用数字身份验证
–proxy-ntlm 在代理上使用ntlm身份验证
-P/–ftp-port 使用端口地址,而不是使用PASV
-Q/–quote 文件传输前,发送命令到服务器
-r/–range 检索来自HTTP/1.1或FTP服务器字节范围
–range-file 读取(SSL)的随机文件
-R/–remote-time 在本地生成文件时,保留远程文件时间
–retry 传输出现问题时,重试的次数
–retry-delay 传输出现问题时,设置重试间隔时间
–retry-max-time 传输出现问题时,设置最大重试时间
-s/–silent静音模式。不输出任何东西
-S/–show-error 显示错误
–socks4 <host[:port]> 用socks4代理给定主机和端口
–socks5 <host[:port]> 用socks5代理给定主机和端口
–stderr
-t/–telnet-option <OPT=val> Telnet选项设置
–trace 对指定文件进行debug
–trace-ascii Like --跟踪但没有hex输出
–trace-time 跟踪/详细输出时,添加时间戳
-T/–upload-file 上传文件
–url Spet URL to work with
-u/–user <user[:password]>设置服务器的用户和密码
-U/–proxy-user <user[:password]>设置代理用户名和密码
-v/–verbose
-V/–version 显示版本信息
-w/–write-out [format]什么输出完成后
-x/–proxy <host[:port]>在给定的端口上使用HTTP代理
-X/–request 指定什么命令
-y/–speed-time 放弃限速所要的时间。默认为30
-Y/–speed-limit 停止传输速度的限制,速度时间’秒
-z/–time-cond 传送时间设置
-0/–http1.0 使用HTTP 1.0
-1/–tlsv1 使用TLSv1(SSL)
-2/–sslv2 使用SSLv2的(SSL)
-3/–sslv3 使用的SSLv3(SSL)
–3p-quote like -Q for the source URL for 3rd party transfer
–3p-url 使用url,进行第三方传送
–3p-user 使用用户名和密码,进行第三方传送
-4/–ipv4 使用IP4
-6/–ipv6 使用IP6
-#/–progress-bar 用进度条显示当前的传送状态
1.curl 最简单的命令是 curl URL, 以下输入将返回请求地址的内容:
curl http://localhost:1001/GetTest/getTest
2.通过-i 参数返回,还返回 HTTP 头:
curl -i -G http://localhost:1001/GetTest/getTest
3.通过-H 设直请求的 HTTP 头,比如请求体是 JSON 格式:
curl -H “Content-Type:application/json” http://localhost:1001/GetTest/getTest
URL 通常用双引号防止转义,比如&符号在命令行中表示后台运行, 因此这里必须用引号:
curl “http://localhost:1001/GetTest/getTest?q=txt&c=1”
4.通过-d 参数发起 POST 请求,-d 后面是 POST 的内容:
curl http://localhost:1001/GetTest/getTest -d “name=tom&password=123”
如果 POST 内容需要转义,比如中文字符、空格等,可以使用 --data-urlencode:
curl http://localhost:1001/GetTest/getTest --data-urlencode “name=汤姆” --data-urlencode “password=123”
注意:
如果将多个参数用一个--data-urlencode命令发送(curl http://localhost:1001/GetTest/getTest --data-urlencode "name=tom&password=中文"),服务端接收的参数为(name参数:tom&password,password参数:null),所以用--data-urlencode命令时,最好将参数分开传
5.-G参数发起一个 GET请求,可以联合-data-urlencode 来转义 URL 参数里的中文特殊符号, data-urlencode 默认是 POST 请求,如果没有 -G 参数, 则会发起一个 POST 请求:
curl -G http://localhost:1001/GetTest/getTest --data-urlencode “name=汤姆” --data-urlencode “password=123”
以上命令对应了一个请求 http://localhost:1001/GetTest/getTest?paraml=value! ¶m2=中文。
6.用 -X POST 来申明我们的请求方法,用 -d 参数,来传送我们的参数。通过-X 指定 PUT /POST/DELETE/GET协议, JSON 内容可以用引号括起来:
curl -X POST “http://localhost:1001/GetTest/getTest” -H “Content-Type:application/json” -d ““dataparams”:{ “name”:“北京 100 种小吃”,“type”:“food”,“postDate”:“2009-11- 15”}”
@PostMapping(value="/getTest")
public String method(@RequestBody String dataparams) {
System.out.println(dataparams);
return "";
}
7.使用,-F 上传文件:
curl http://localhost:1001/GetTest/getTest2 -F “file=@D:\Users\Fitzgerald_Fu\Desktop\123.txt”
这样, 可以通过 name 字段获取提交的名字,通过File 字段获得 profile.jpg 文件。
@RequestMapping(value="/getTest2")
public String method2(MultipartFile file) {
//注意controller方法中文件参数名与curl命令中的参数名一致“file”
String oName=file.getOriginalFilename();
System.out.println(oName);
return "";
}```