1. 极简服务器
大道至简。使用Go语言构建世界上最简单的HTTP服务器,仅需四行代码。
标准库的net/http包提供了多种用于创建HTTP服务器的方法,其中包括:
- http.HandleFunc("/", rootHandler)
第一参数:访问的url
第二参数:处理请求的函数,创建路由,为不同的访问路径指定不同的处理函数
- http.ListenAndServe(":8000", nil)
- 启动服务,侦听给定的通信端口
针对给定访问路径的处理函数需要自己实现,该函数形如:
- func rootHandler(w http.ResponseWriter, r *http.Request) {
- w.Write([]byte("Hello World!"))
- }
- 该函数必然包括两个参数http.ResponseWriter和*http.Request
- 该函数的两个参数一个代表响应,即用于构造响应包的写入器,用于写入返回给浏览器的信息;另一个则代表请求。
- 该函数的核心任务就是根据请求中的各种输入数据,进行业务处理,产生响应输出。
// 最简单的HTTP服务器
// 标准库的net/http包提供了多种创建HTTP服务器的方法,它还提供了一个基本的路由器
package main
import "net/http"
func rootHandler(w http.ResponseWriter, // 定义路由处理函数
r *http.Request) {
w.Write([]byte("Hello World!"))
}
func main() {
http.HandleFunc("/", rootHandler) // web资源访问地址为 "资源根路径/"
http.ListenAndServe(":8000", nil)
}
2.请求与响应
(一)使用curl发送请求:
除了通过浏览器向HTTP服务器发起请求并接收响应以外,还可以使用更专业化的工具,比如curl,来查看往返于客户端和服务器之间请求响应数据包。
Linux和macOS操作系统通常都预先安装了curl工具,Windows操作系统虽然没有预先安装,但可以从这里免费下载并安装:
- https://curl.haxx.se/windows
curl安装好以后,就可以在开发HTTP服务器时,用它做客户端向服务器发送各种请求,并查看服务器的响应。
- 首先启动前面编写的"极简服务器"程序。
- go run main.go
- 打开终端或命令提示符窗口,输入如下命令:
- curl -is "http://localhost:8000"
- 选项-is指定打印包头,并忽略一些次要信息
- 如果命令执行成功,将看到来自HTTP服务器的响应,其中包含响应头和响应体。
服务器返回的响应头包含了如下信息:
- HTTP/1.1 200 OK //协议,状态码,状态描述
- Date: Sat, 29 Dec 2018 06:28:05 GMT //发送响应的日期和时间(格林威治时间)
- Content-Length: 12 //内容长度共12个字节
- Content-Type: text/plain; charset=utf-8 //内容类型为使用UTF-8编码的纯文本
服务器返回的响应体包含了如下信息:
- Hello World! //由12字节UTF-8编码纯文本构成的响应内容
(二)路由
HandleFunc函数用于注册响应给定URL地址映射的处理函数。
- http.HandleFunc("/", rootHandler)
- http.HandleFunc("/users/", usersHandler)
- http.HandleFunc("/projects/", projectsHandler)
服务器依据如下路由规则,将对特定URL地址的访问路由到相应的处理函数
- URL地址必须完全匹配,包括大小写和斜杠。
- 对"/projects"的访问,不会被路由到与"/projects/"相对应的处理函数projectsHandler。
- 如果找不到严格匹配的URL地址,则一律按"/"处理,因此"/"也被称为缺省路由。
- 路由与请求类型无关,只负责调用与URL地址相对应的函数。
- 对每一种请求类型(GET、POST、PUT、DELETE等)的具体处理在处理函数的内部实现。
附录:CURL命令相关参数
// 附录:CURL命令的相关参数,具体使用实例不做赘述。
-a/--append 上传文件时,附加到目标文件
-A/--user-agent <string> 设置用户代理发送给服务器
- anyauth 可以使用“任何”身份验证方法
-b/--cookie <name=string/file> cookie字符串或文件读取位置
- basic 使用HTTP基本验证
-B/--use-ascii 使用ASCII /文本传输
-c/--cookie-jar <file> 操作结束后把cookie写入到这个文件中
-C/--continue-at <offset> 断点续转
-d/--data <data> HTTP POST方式传送数据
--data-ascii <data> 以ascii的方式post数据
--data-binary <data> 以二进制的方式post数据
--negotiate 使用HTTP身份验证
--digest 使用数字身份验证
--disable-eprt 禁止使用EPRT或LPRT
--disable-epsv 禁止使用EPSV
-D/--dump-header <file> 把header信息写入到该文件中
--egd-file <file> 为随机数据(SSL)设置EGD socket路径
--tcp-nodelay 使用TCP_NODELAY选项
-e/--referer 来源网址
-E/--cert <cert[:passwd]> 客户端证书文件和密码 (SSL)
--cert-type <type> 证书文件类型 (DER/PEM/ENG) (SSL)
--key <key> 私钥文件名 (SSL)
--key-type <type> 私钥文件类型 (DER/PEM/ENG) (SSL)
--pass <pass> 私钥密码 (SSL)
--engine <eng> 加密引擎使用 (SSL). "--engine list" for list
--cacert <file> CA证书 (SSL)
--capath <directory> CA目录 (made using c_rehash) to verify peer against (SSL)
--ciphers <list> SSL密码
--compressed 要求返回是压缩的形势 (using deflate or gzip)
--connect-timeout <seconds> 设置最大请求时间
--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 <line>自定义头信息传递给服务器
--ignore-content-length 忽略的HTTP头信息的长度
-i/--include 输出时包括protocol头信息
-I/--head 只显示文档信息
从文件中读取-j/--junk-session-cookies忽略会话Cookie
- 界面<interface>指定网络接口/地址使用
- krb4 <级别>启用与指定的安全级别krb4
-j/--junk-session-cookies 读取文件进忽略session cookie
--interface <interface> 使用指定网络接口/地址
--krb4 <level> 使用指定安全级别的krb4
-k/--insecure 允许不使用证书到SSL站点
-K/--config 指定的配置文件读取
-l/--list-only 列出ftp目录下的文件名称
--limit-rate <rate> 设置传输速度
--local-port<NUM> 强制使用本地端口号
-m/--max-time <seconds> 设置最大传输时间
--max-redirs <num> 设置最大读取的目录数
--max-filesize <bytes> 设置最大下载的文件总量
-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 <address> 使用端口地址,而不是使用PASV
-Q/--quote <cmd>文件传输前,发送命令到服务器
-r/--range <range>检索来自HTTP/1.1或FTP服务器字节范围
--range-file 读取(SSL)的随机文件
-R/--remote-time 在本地生成文件时,保留远程文件时间
--retry <num> 传输出现问题时,重试的次数
--retry-delay <seconds> 传输出现问题时,设置重试间隔时间
--retry-max-time <seconds> 传输出现问题时,设置最大重试时间
-s/--silent静音模式。不输出任何东西
-S/--show-error 显示错误
--socks4 <host[:port]> 用socks4代理给定主机和端口
--socks5 <host[:port]> 用socks5代理给定主机和端口
--stderr <file>
-t/--telnet-option <OPT=val> Telnet选项设置
--trace <file> 对指定文件进行debug
--trace-ascii <file> Like --跟踪但没有hex输出
--trace-time 跟踪/详细输出时,添加时间戳
-T/--upload-file <file> 上传文件
--url <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 <command>指定什么命令
-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 用进度条显示当前的传送状态