Go HTTP编程
<p></p><div class="toc"><div class="toc-container-header">目录</div><ul><li>net/http介绍</li><li>服务端<ul><li>默认的Server<ul><li>http.HandleFunc</li><li>http.Handle</li></ul></li><li>http.Request</li><li>自定义Server</li></ul></li><li>HTML模板<ul><li>定义模板文件</li><li>解析模板文件</li><li>模板渲染</li><li>基本示例<ul><li>定义模板文件</li><li>解析和渲染模板</li><li>{{.}}</li><li>注释</li><li>pipeline</li><li>变量</li><li>移除空格</li><li>if语句</li><li>range</li><li>with</li><li>比较函数</li><li>预定义函数</li><li>自定义函数</li><li>嵌套template</li><li>block</li><li>标识符</li><li>上下文感知</li></ul></li></ul></li><li>客户端<ul><li>基本的HTTP/HTTPS请求</li><li>GET请求示例</li><li>带参数的GET请求示例</li><li>POST请求示例</li><li>自定义Client</li></ul></li></ul></div><p></p><p>当你在浏览器中输入URL时，实际上是在发送一个对Web页面的请求。该请求被发送到服务器。服务器的工作是获取适当的页面并将其作为响应发送回浏览器。</p>
<p>在Web的早期，服务器通常读取服务器硬盘上HTML文件的内容并将该HTML发送回浏览器。</p>
<p><img src="https://img2020.cnblogs.com/blog/720430/202105/720430-20210511162147185-793525466.png" alt="" loading="lazy"></p>
<p>但今天，服务器更常见的是与程序通信来完成请求，而不是读取文件。这个程序可以用任何你想要的语言编写，包括Go！</p>
<p><img src="https://img2020.cnblogs.com/blog/720430/202105/720430-20210511162158379-173328447.png" alt="" loading="lazy"></p>
<h3 id="nethttp介绍">net/http介绍</h3>
<p>Go语言标准库内建提供了net/http包，涵盖了HTTP客户端和服务端的具体实现。使用net/http包，我们可以很方便地编写HTTP客户端或服务端的程序。</p>
<h3 id="服务端">服务端</h3>
<h4 id="默认的server">默认的Server</h4>
<p>首先，我们编写一个最简单的Web服务器。编写这个Web服务只需要两步:</p>
<ol>
<li>注册一个处理器函数(<b>注册到DefaultServeMux</b>)；</li>
<li>设置监听的TCP地址并启动服务；</li>
</ol>
<p>对应到我们的代码里就是这样的：</p>
<pre><code class="language-go">package main
import (
"log"
"net/http"
)
func sayHello(w http.ResponseWriter, r *http.Request) {
_, _ = w.Write([]byte("Hello World!"))
}
func main() {
//1.注册一个给定模式的处理器函数到DefaultServeMux
http.HandleFunc("/", sayHello)
//2.设置监听的TCP地址并启动服务
//参数1：TCP地址(IP+Port)
//参数2：当设置为nil时表示使用DefaultServeMux
err := http.ListenAndServe("127.0.0.1:8080", nil)
log.Fatal(err)
}
</code></pre>
<p>运行该程序，通过浏览器访问，可以看到<code>Hello World!</code>显示在了页面上</p>
<p><img src="https://img2020.cnblogs.com/blog/720430/202105/720430-20210511162224481-1036228225.png" alt="" loading="lazy"></p>
<p>ListenAndServe使用指定的监听地址和处理器启动一个HTTP服务端。当处理器参数是nil时，这表示采用包变量DefaultServeMux作为处理器。</p>
<p>Handle和HandleFunc函数可以向DefaultServeMux添加任意多个处理器函数。</p>
<h5 id="httphandlefunc">http.HandleFunc</h5>
<p>使用Go语言中的<code>net/http</code>包来编写一个简单的接收HTTP请求的Server端示例，<code>net/http</code>包是对net包的进一步封装，专门用来处理HTTP协议的数据。具体的代码如下：</p>
<p>处理器函数的实现原理：</p>
<p><img src="https://img2020.cnblogs.com/blog/720430/202105/720430-20210511162244399-1579889512.png" alt="" loading="lazy"></p>
<p>通过源码可知，这个函数实际上是调用了默认的DefaultServeMux的HandleFunc方法，这也解释了我们第一步里所说的默认的实际注册到DefaultServeMux。</p>
<p>既然说了<code>http.ListenAndServe</code>的第二个参数为<code>nil</code>时采用默认的DefaultServeMux,那么如果我们不想采用默认的，而是想自己创建一个ServerMux该怎么办呢，http给我们提供了方法，NewServeMux创建并返回一个新的*ServeMux</p>
<pre><code class="language-go">// NewServeMux分配并返回一个新的ServeMux。
func NewServeMux() *ServeMux { return new(ServeMux) }
</code></pre>
<p>如果是我们自己创建的ServeMux，我们只需要简单的更新一下代码：</p>
<pre><code class="language-go">package main
import (
"log"
"net/http"
)
func sayHello(w http.ResponseWriter, r *http.Request) {
_, _ = w.Write([]byte("Hello World!"))
}
func main() {
//1.创建一个ServeMux，将处理器函数注册到serverMux
serveMux := http.NewServeMux()
serveMux.HandleFunc("/", sayHello)
//2.设置监听的TCP地址并启动服务
//参数1：TCP地址(IP+Port)
//参数2：当设置为nil时表示使用DefaultServeMux，如果指定了则表示使用自定义ServeMux
err := http.ListenAndServe("127.0.0.1:8080", serveMux)
log.Fatal(err)
}
</code></pre>
<p>运行修改后的代码，和采用默认ServeMux一样正常运行</p>
<h5 id="httphandle">http.Handle</h5>
<p>如果是使用http的handle方法，则handle的第二个参数需要实现handler接口,要想实现这个接口，就得实现这个接口的<code>serveHTTP</code>方法</p>
<p><img src="https://img2020.cnblogs.com/blog/720430/202105/720430-20210511162258027-811206034.png" alt="" loading="lazy"></p>
<p><img src="https://img2020.cnblogs.com/blog/720430/202105/720430-20210511162306290-552808606.png" alt="" loading="lazy"></p>
<p>示例：</p>
<pre><code class="language-go">package main
import (
"log"
"net/http"
)
type MyHandler struct {}
func (m *MyHandler)ServeHTTP(w http.ResponseWriter, r *http.Request) {
_, _ = w.Write([]byte("Hello World!"))
}
func main() {
//1.创建一个ServeMux，将处理器函数注册到serverMux
http.Handle("/", &MyHandler{})
//2.设置监听的TCP地址并启动服务
//参数1：TCP地址(IP+Port)
//参数2：当设置为nil时表示使用DefaultServeMux
err := http.ListenAndServe("127.0.0.1:8080", nil)
log.Fatal(err)
}
</code></pre>
<h4 id="httprequest">http.Request</h4>
<p>一个Web服务器最基本的工作就是接收请求，做出响应。http包帮助我们封装了一个Request结构体，我们通过这个结构体拿到很多用户的一次HTTP请求的所有信息。这个Request结构体定义如下：</p>
<pre><code class="language-go">type Request struct {
//Method指定HTTP方法(GET、POST、PUT等)
//Go的客户端不支持CONNECT方法
Method string
//请求URL相关信息
URL *url.URL
//接收到的请求的协议版本。HTTP客户端代码始终使用HTTP/1.1或HTTP2
Proto string // "HTTP/1.0"
//请求头相关信息
Header Header
//请求主体
Body io.ReadCloser
//客户端IP地址
RemoteAddr string
//请求URI
RequestURI string
.......
//内容上下文
ctx context.Context
}
</code></pre>
<p>我这里列举的并不是完整的Request结构体定义，只是大致的说明一下。完整的定义以及这些字段的中文含义可以查看Go语言标准库文档。</p>
<p>我们通过通过浏览器可以发现，我们一次HTTP请求会携带很多信息</p>
<p><img src="https://img2020.cnblogs.com/blog/720430/202105/720430-20210511162319377-847860514.png" alt="" loading="lazy"></p>
<p>这些信息，我们可以通过http.Request来获取到</p>
<pre><code class="language-go">package main
import (
"fmt"
"log"
"net/http"
)
func HeaderInfo(w http.ResponseWriter, r *http.Request) {
defer r.Body.Close()
fmt.Printf("Method: %#v\n", r.Method)
fmt.Printf("URL: %#v\n", r.URL)
fmt.Printf("Header: %#v\n", r.Header)
fmt.Printf("Body: %#v\n", r.Body)
fmt.Printf("RemoteAddr: %#v\n", r.RemoteAddr)
_, _ = w.Write([]byte("请求成功，请在终端查看！"))
}
func main() {
//1.注册一个给定模式的处理器函数到DefaultServeMux
http.HandleFunc("/header", HeaderInfo)
//2.设置监听的TCP地址并启动服务
//参数1：TCP地址(IP+Port)
//参数2：当设置为nil时表示使用DefaultServeMux
err := http.ListenAndServe("127.0.0.1:8080", nil)
log.Fatal(err)
}
</code></pre>
<p><img src="https://img2020.cnblogs.com/blog/720430/202105/720430-20210511162332940-1399484950.png" alt="" loading="lazy"></p>
<h4 id="自定义server">自定义Server</h4>
<p>要管理服务端的行为，可以创建一个自定义的Server：</p>
<pre><code class="language-go">import (
"fmt"
"net/http"
"time"
)
type MyHandler struct {}
func (h *MyHandler) ServeHTTP (w http.ResponseWriter, r *http.Request) {
fmt.Fprintln(w, "hello world!")
}
func main() {
var handler MyHandler
var server = http.Server{
Addr: ":8080",
Handler: &handler,
ReadTimeout: 2 * time.Second,
MaxHeaderBytes: 1 << 20,
}
var err = server.ListenAndServe()
if err != nil {
fmt.Printf("http server failed, err: %v\n", err)
return
}
}
</code></pre>
<h3 id="html模板">HTML模板</h3>
<p>template包(html/template)实现了数据驱动的模板，以生成可防止代码注入的HTML输出。它提供了与text/template包相同的接口，并且只要实在输出HTML的场景，就应该使用html/template而不是text/template。</p>
<p>Go语言模板的使用可以分为三步：定义模板文件、解析模板文件和渲染模板文件。</p>
<h4 id="定义模板文件">定义模板文件</h4>
<p>定义模板文件时需要我们按照相关语法规则去编写，后面会详细介绍。</p>
<h4 id="解析模板文件">解析模板文件</h4>
<p>上面定义好了模板文件之后，可以使用下面额常用方法去解析模板文件，得到模板对象：</p>
<pre><code class="language-go">func ParseFS(fs fs.FS, patterns ...string) (*Template, error)
func ParseFiles(filenames ...string) (*Template, error)
func ParseGlob(pattern string) (*Template, error)
</code></pre>
<p>当然，你也可以使用<code>func New(name string) *Template</code>函数创建一个名为<code>name</code>的模板，然后对其调用上面的方法去解析模板字符串或模板文件。</p>
<h4 id="模板渲染">模板渲染</h4>
<p>渲染模板简单来说就是使用数据去填充模板，当然实际上可能会复杂很多。</p>
<pre><code class="language-go">func (t *Template) Execute(wr io.Writer, data interface{}) error
func (t *Template) ExecuteTemplate(wr io.Writer, name string, data interface{}) error
</code></pre>
<h4 id="基本示例">基本示例</h4>
<h5 id="定义模板文件-1">定义模板文件</h5>
<p>我们按照Go模板语法定义一个<code>index.html</code>的模板文件，内容如下：</p>
<pre><code class="language-go"><!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>index页面</title>
</head>
<body>
<h2>{{.}}</h2>
<img src="./img/pyy.jpeg" style="width: 30%" alt="彭于晏">
</body>
</html>
</code></pre>
<h5 id="解析和渲染模板">解析和渲染模板</h5>
<p>创建一个<code>main.go</code>文件，服务端代码如下</p>
<pre><code class="language-go">package main
import (
"html/template"
"log"
"net/http"
)
func index(w http.ResponseWriter, r *http.Request) {
//解析指定文件生成模板对象
tmpl, err := template.ParseFiles("./public/index.html")
if err != nil {
log.Fatal(err)
}
err = tmpl.Execute(w, "彭于晏")
if err != nil {
log.Fatal(err)
}
}
func main() {
//1.注册给定模式的处理器函数到DefaultServeMux
files := http.FileServer(http.Dir("./public"))
http.Handle("/", files)
http.HandleFunc("/index", index)
//2.设置监听的TCP地址并启动服务
//参数1：TCP地址(IP+Port)
//参数2：当设置为nil时表示使用DefaultServeMux
err := http.ListenAndServe("127.0.0.1:8080", nil)
log.Fatal(err)
}
</code></pre>
<p>项目结构如下：</p>
<pre><code class="language-shell">.
├── go.mod
├── main.go
├── public
├── img
│ └── pyy.jpeg
└── index.html
</code></pre>
<p>将上面的<code>main.go</code>文件编译执行，然后使用浏览器访问<code>http://127.0.0.1:8080</code>就能看到页面上显示了“彭于晏”。 这就是一个最简单的模板渲染的示例，Go语言模板引擎详细用法请往下阅读。</p>
<h5 id="_">{{.}}</h5>
<p>模板语法都包含在<code>{{</code>和<code>}}</code>中间，其中<code>{{.}}</code>中的点表示当前对象。</p>
<p>当我们传入一个结构体对象时，我们可以根据<code>.</code>来访问结构体的对应字段。例如：</p>
<pre><code class="language-go">package main
import (
"html/template"
"log"
"net/http"
)
type Address struct {
Province string
City string
}
type User struct {
Name string
Ageint
Addr Address
}
func index(w http.ResponseWriter, r *http.Request) {
//解析指定文件生成模板对象
tmpl, err := template.ParseFiles("./public/index.html")
if err != nil {
log.Fatal(err)
}
user := User{
Name: "彭于晏",
Age:28,
Addr: Address{Province: "台湾省", City: "澎湖县"},
}
//利用给定数据渲染模板，并将结果写入
err = tmpl.Execute(w, user)
if err != nil {
log.Fatal(err)
}
}
func main() {
//1.注册给定模式的处理器函数到DefaultServeMux
files := http.FileServer(http.Dir("./public"))
http.Handle("/", files)
http.HandleFunc("/index", index)
//2.设置监听的TCP地址并启动服务
//参数1：TCP地址(IP+Port)
//参数2：当设置为nil时表示使用DefaultServeMux
err := http.ListenAndServe("127.0.0.1:8080", nil)
log.Fatal(err)
}
</code></pre>
<p>模板文件<code>index.html</code>内容如下：</p>
<pre><code class="language-html"><!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>index页面</title>
</head>
<body>
<p>姓名：{{.Name}}</p>
<p>年龄：{{.Age}}</p>
<p>地址：{{.Addr.Province}}-{{.Addr.City}}</p>
<p>你好呀{{/* 这是注释 */}}，彭于晏</p>
<img src="./img/pyy.jpeg" style="width: 10%" alt="彭于晏">
</body>
</html>
</code></pre>
<p>显示效果如下图所示</p>
<p><img src="https://img2020.cnblogs.com/blog/720430/202105/720430-20210511162403692-305587444.png" alt="" loading="lazy"></p>
<p>同理，当我们传入的变量是map时，也可以在模板文件中通过<b><code>.</code></b>根据key来取值。</p>
<blockquote>
<p>注意：在模板中使用的变量应当是可导出的，否则的话对应的变量无法显示。</p>
</blockquote>
<h5 id="注释">注释</h5>
<pre><code class="language-go">//注释，执行时会忽略。可以多行。注释不能嵌套，并且必须紧贴分界符始止。
{{/* 这是注释 */}}
</code></pre>
<h5 id="pipeline">pipeline</h5>
<p><code>pipeline</code>是指产生数据的操作。比如<code>{{.}}</code>、<code>{{.Name}}</code>等。Go的模板语法中支持使用管道符号<code>|</code>链接多个命令，用法和unix下的管道类似：<code>|</code>前面的命令会将运算结果(或返回值)传递给后一个命令的最后一个位置。</p>
<p><b>注意：</b>并不是只有使用了<code>|</code>才是pipeline。Go的模板语法中，<code>pipeline</code>的概念是传递数据，只要能产生数据的，都是<code>pipeline</code></p>
<p>示例：</p>
<pre><code class="language-html"><!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>index页面</title>
</head>
<body>
<div align="center">
<p>姓名：{{.Name|len}}</p>
<p>年龄：{{.Age}}</p>
<p>地址：{{.Addr.Province}}-{{.Addr.City}}</p>
<p>你好呀{{/* 这是注释 */}}，彭于晏</p>
<img src="./img/pyy.jpeg" style="width: 10%" alt="彭于晏">
</div>
</body>
</html>
</code></pre>
<h5 id="变量">变量</h5>
<p>我们还可以在模板中声明变量，用来保存传入模板的数据或其他语句生成的结果。具体语法如下：</p>
<pre><code class="language-go">$obj := {{.}}
</code></pre>
<p>其中<code>$obj</code>是变量的名字，在后续的代码中就可以使用该变量了。</p>
<p>示例：</p>
<pre><code class="language-html"><!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>index页面</title>
</head>
<body>
<div align="center">
{{$obj := .Name}}
<p>姓名：{{ $obj }}</p>
<img src="./img/pyy.jpeg" style="width: 10%" alt="彭于晏">
</div>
</body>
</html>
</code></pre>
<h5 id="移除空格">移除空格</h5>
<p>template引擎在进行替换的时候，是完全按照文本格式进行替换的。除了需要评估和替换的地方，所有的行分隔符、空格等等空白都原样保留。所以，<b>对于要解析的内容，不要随意缩进、随意换行</b>。</p>
<p>有时候我们在使用模板语法的时候会不可避免的引入一下空格或者换行符，这样模板最终渲染出来的内容可能就和我们想的不一样，这个时候可以使用<code>{{-</code>语法去除模板内容左侧的所有空白符号， 使用<code>-}}</code>去除模板内容右侧的所有空白符号。</p>
<p><b>注意</b>：<code>-</code>要紧挨<code>{{</code>和<code>}}</code>，同时与模板值之间需要使用空格分隔。</p>
<pre><code class="language-html"><!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>index页面</title>
</head>
<body>
<div align="center">
<p>姓名：{{- .Name -}} -king</p> <!-- 彭于晏-king -->
<p>姓名：{{ .Name }} -king</p> <!-- 彭于晏 -king -->
<img src="./img/pyy.jpeg" style="width: 10%" alt="彭于晏">
</div>
</body>
</html>
</code></pre>
<h5 id="if语句">if语句</h5>
<p>Go模板语法中的条件判断有以下几种：</p>
<pre><code class="language-go">{{if pipeline}} T1 {{end}}
{{if pipeline}} T1 {{else}} T0 {{end}}
{{if pipeline}} T1 {{else if pipeline}} T0 {{end}}
</code></pre>
<p>需要注意的是，pipeline为false的情况是各种数据对象的0值：数值0，指针或接口是nil，数组、slice、map或string则是len为0。</p>
<p>示例：</p>
<pre><code class="language-html"><!-- 由于.Name不是空字符串，所以可以渲染出彭于晏 -->
<p>姓名：{{if .Name}} 彭于晏 {{end}}</p>
</code></pre>
<h5 id="range">range</h5>
<p>Go的模板语法中使用<code>range</code>关键字进行遍历，有以下两种写法，其中<code>pipeline</code>的值必须是数组、切片、map或者channel。</p>
<pre><code class="language-go">{{range pipeline}} T1 {{end}}
如果pipeline的值其长度为0，不会有任何输出
{{range pipeline}} T1 {{else}} T0 {{end}}
如果pipeline的值其长度为0，则会执行T0。
</code></pre>
<p>需注意的是，range的参数部分是pipeline，所以在迭代的过程中是可以进行赋值的。但有两种赋值情况：</p>
<pre><code class="language-go">{{range $value := .}}
{{range $key,$value := .}}
</code></pre>
<p>如果range中只赋值给一个变量，则这个变量是当前正在迭代元素的值。如果赋值给两个变量，则第一个变量是索引值(数组/切片是数值，map是key)，第二个变量是当前正在迭代元素的值。</p>
<p>示例：</p>
<p><code>index.html</code>文件</p>
<pre><code class="language-html">{{range $x := .}}
<p>{{$x}}</p>
{{else}}
<p>这是一个空切片</p>
{{end}}
</code></pre>
<p>也可以这样</p>
<pre><code class="language-html">{{range .}}
<p>{{.}}</p>
{{else}}
<p>这是一个空切片</p>
{{end}}
</code></pre>
<p><code>main.go</code>文件</p>
<pre><code class="language-go">func index(w http.ResponseWriter, r *http.Request) {
//解析指定文件生成模板对象
tmpl, err := template.ParseFiles("./public/index.html")
if err != nil {
log.Fatal(err)
}
var arr []int
//利用给定数据渲染模板，并将结果写入
err = tmpl.Execute(w, arr)
if err != nil {
log.Fatal(err)
}
}
</code></pre>
<h5 id="with">with</h5>
<pre><code class="language-go">{{with pipeline}} T1 {{end}}
如果pipeline为empty不产生输出，否则将dot设为pipeline的值并执行T1。不修改外面的dot。
{{with pipeline}} T1 {{else}} T0 {{end}}
如果pipeline为empty，不改变dot并执行T0，否则dot设为pipeline的值并执行T1。
</code></pre>
<p>对于第一种格式，当pipeline不为0值的时候，点"."设置为pipeline运算的值，否则跳过。对于第二种格式，当pipeline为0值时，执行else语句块，否则"."设置为pipeline运算的值，并执行T1。</p>
<p>示例：</p>
<pre><code class="language-html"><p>{{with "彭于晏"}} {{.}} {{end}}</p>
</code></pre>
<p>上面将输出<code>彭于晏</code>，因为"."已经设置为"彭于晏"。</p>
<h5 id="比较函数">比较函数</h5>
<p>布尔函数会将任何类型的零值视为假，其余视为真。</p>
<p>下面是定义为函数的二元比较运算的集合：</p>
<pre><code class="language-go">eq 如果arg1 == arg2则返回真
ne 如果arg1 != arg2则返回真
lt 如果arg1 < arg2则返回真
le 如果arg1 <= arg2则返回真
gt 如果arg1 > arg2则返回真
ge 如果arg1 >= arg2则返回真
</code></pre>
<p>为了简化多参数相等检测，eq（只有eq）可以接受2个或更多个参数，它会将第一个参数和其余参数依次比较，返回下式的结果：</p>
<pre><code class="language-go">{{eq arg1 arg2 arg3}}
</code></pre>
<p>等价于</p>
<pre><code class="language-go">arg1==arg2 || arg1==arg3
</code></pre>
<p>比较函数只适用于基本类型（或重定义的基本类型，如”type Celsius float32”）。但是，整数和浮点数不能互相比较。</p>
<p>示例：</p>
<p><code>index.html</code></p>
<pre><code class="language-html"><!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>index页面</title>
</head>
<body>
<div align="center">
{{if (eq .Name "彭于晏") }}
<p>彭于晏</p>
{{else}}
<p>晏晏</p>
{{end}}
<img src="./img/pyy.jpeg" style="width: 10%" alt="彭于晏">
</div>
</body>
</html>
</code></pre>
<h5 id="预定义函数">预定义函数</h5>
<p>预定义的全局函数如下：</p>
<pre><code class="language-go">and
函数返回它的第一个empty参数或者最后一个参数；
就是说"and x y"等价于"if x then y else x"；所有参数都会执行；
or
返回第一个非empty参数或者最后一个参数；
亦即"or x y"等价于"if x then x else y"；所有参数都会执行；
not
返回它的单个参数的布尔值的否定
len
返回它的参数的整数类型长度
index
执行结果为第一个参数以剩下的参数为索引/键指向的值；
如"index x 1 2 3"返回x的值；每个被索引的主体必须是数组、切片或者字典。
即fmt.Sprint
printf
即fmt.Sprintf
println
即fmt.Sprintln
html
返回与其参数的文本表示形式等效的转义HTML。
这个函数在html/template中不可用。
urlquery
以适合嵌入到网址查询中的形式返回其参数的文本表示的转义值。
这个函数在html/template中不可用。
js
返回与其参数的文本表示形式等效的转义JavaScript。
call
执行结果是调用第一个参数的返回值，该参数必须是函数类型，其余参数作为调用该函数的参数；
如"call .X.Y 1 2"等价于go语言里的dot.X.Y(1, 2)；
其中Y是函数类型的字段或者字典的值，或者其他类似情况；
call的第一个参数的执行结果必须是函数类型的值（和预定义函数如print明显不同）；
该函数类型值必须有1到2个返回值，如果有2个则后一个必须是error接口类型；
如果有2个返回值的方法返回的error非nil，模板执行会中断并返回给调用模板执行者该错误；
</code></pre>
<p>示例：</p>
<pre><code class="language-html"><div align="center">
<!-- if (.Name == '彭于晏' && .Age == 28)-->
{{if (and (eq .Name "彭于晏") (eq .Age 28)) }}
<p>彭于晏</p>
{{else}}
<p>晏晏</p>
{{end}}
</div>
</code></pre>
<h5 id="自定义函数">自定义函数</h5>
<p>Go的模板支持自定义函数。需要注意的是自定义函数必须在解析模板之前。</p>
<p><code>main.go</code>文件</p>
<pre><code class="language-go">func index(w http.ResponseWriter, r *http.Request) {
fn := func(name string) string {
return name + "，你好！"
}
//自定义函数必须在解析模板之前
tmpl := template.New("index.html").Funcs(template.FuncMap{"hello": fn})
//解析指定文件生成模板对象
tmpl, err := tmpl.ParseFiles("./public/index.html")
if err != nil {
log.Fatal(err)
}
var user = User{Name: "彭于晏", Age: 28}
//利用给定数据渲染模板，并将结果写入
err = tmpl.Execute(w, user)
if err != nil {
log.Fatal(err)
}
}
</code></pre>
<p><code>index.html</code>文件</p>
<pre><code class="language-html"><p>{{hello .Name}}</p>
</code></pre>
<h5 id="嵌套template">嵌套template</h5>
<p>我们可以在template中嵌套其他的template。这个template可以是单独的文件，也可以是通过<code>define</code>定义的template。</p>
<p>举个例子： <code>index.html</code>文件内容如下：</p>
<pre><code class="language-html"><!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>index页面</title>
</head>
<body>
<div align="center">
<p>嵌套template示例</p>
<br>
{{template "ul.html"}}
<br>
{{template "ol.tmpl"}}
<img src="./img/pyy.jpeg" style="width: 10%" alt="彭于晏">
</div>
</body>
</html>
{{define "ol.tmpl"}}
<ol>
<li>彭于晏</li>
<li>高圆圆</li>
<li>赵又廷</li>
</ol>
{{end}}
</code></pre>
<p><code>ul.html</code>文件内容如下：</p>
<pre><code class="language-html"><ul>
<li>彭于晏</li>
<li>高圆圆</li>
<li>赵又廷</li>
</ul>
</code></pre>
<p><code>main.go</code>文件</p>
<pre><code class="language-go">func index(w http.ResponseWriter, r *http.Request) {
//解析指定文件生成模板对象
tmpl, err := template.ParseFiles("./public/index.html", "./public/ul.html")
if err != nil {
log.Fatal(err)
}
var user = User{Name: "彭于晏", Age: 28}
//利用给定数据渲染模板，并将结果写入
err = tmpl.Execute(w, user)
if err != nil {
log.Fatal(err)
}
}
</code></pre>
<p><b>注意</b>:在解析模板时，被嵌套的模板一定要在后面解析，例如上面的示例中<code>index.html</code>模板中嵌套了<code>ul.html</code>，所以<code>ul.html</code>要在<code>index.html</code>后进行解析。</p>
<h5 id="block">block</h5>
<p>根据官方文档的解释：block等价于define定义一个名为name的模板，并在"有需要"的地方执行这个模板，执行时将"."设置为pipeline的值。</p>
<pre><code class="language-go">{{block "name" pipeline}} T1 {{end}}
</code></pre>
<p>但应该注意，<b>block的第一个动作是执行名为name的模板，如果不存在，则在此处自动定义这个模板，并执行这个临时定义的模板。换句话说，block可以认为是设置一个默认模板</b>。</p>
<p>例如：</p>
<pre><code class="language-go">{{block "T1" .}} one {{end}}
</code></pre>
<p>它首先表示<code>{{template "T1" .}}</code>，也就是说先找到T1模板，如果T1存在，则执行找到的T1，如果没找到T1，则临时定义一个<code>{{define "T1"}} one {{end}}</code>，并执行它。</p>
<p>示例：</p>
<p><code>index.html</code></p>
<pre><code class="language-html"><!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>index页面</title>
</head>
<body>
<div align="center">
<p>block用法示例</p>
{{block "content" .}}
<p style="color: blue;">彭于晏</p>
{{end}}
<img src="./img/pyy.jpeg" style="width: 10%" alt="彭于晏">
</div>
</body>
</html>
</code></pre>
<p><code>red.html</code></p>
<pre><code class="language-go">{{define "content"}}
<p style="color: red;">彭于晏</p>
{{end}}
</code></pre>
<p><code>main.go</code></p>
<pre><code class="language-go">func index(w http.ResponseWriter, r *http.Request) {
//解析指定文件生成模板对象
var tmpl *template.Template
var err error
if rand.Intn(2) > 0 {
tmpl, err = template.ParseFiles("./public/index.html", "./public/red.html")
} else {
tmpl, err = template.ParseFiles("./public/index.html")
}
if err != nil {
log.Fatal(err)
}
//利用给定数据渲染模板，并将结果写入
err = tmpl.Execute(w, nil)
if err != nil {
log.Fatal(err)
}
}
</code></pre>
<p>这样示例的效果就是刷新页面，彭于晏的名字颜色在红蓝之间反复变化</p>
<p><img src="https://img2020.cnblogs.com/blog/720430/202105/720430-20210511181415129-37297254.gif" alt="" loading="lazy"></p>
<h5 id="标识符">标识符</h5>
<p>Go标准库的模板引擎使用的花括号<code>{{</code>和<code>}}</code>作为标识，而许多前端框架（如<code>Vue</code>和 <code>AngularJS</code>）也使用<code>{{</code>和<code>}}</code>作为标识符，所以当我们同时使用Go语言模板引擎和以上前端框架时就会出现冲突，这个时候我们需要修改标识符，修改前端的或者修改Go语言的。这里演示如何修改Go语言模板引擎默认的标识符：</p>
<pre><code class="language-go">template.New("index.html").Delims("{[", "]}").ParseFiles("./public/index.html")
</code></pre>
<h5 id="上下文感知">上下文感知</h5>
<p>对于html/template包，有一个很好用的功能：上下文感知。text/template没有该功能。</p>
<p>上下文感知具体指的是根据所处环境css、js、html、url的path、url的query，自动进行不同格式的转义。</p>
<p>例如，一个handler函数的代码如下：</p>
<pre><code class="language-go">func index(w http.ResponseWriter, r *http.Request) {
//解析指定文件生成模板对象
tmpl, err := template.ParseFiles("./public/index.html")
if err != nil {
log.Fatal(err)
}
str := `I asked: <i>"What's up?"</i>`
//利用给定数据渲染模板，并将结果写入
err = tmpl.Execute(w, str)
if err != nil {
log.Fatal(err)
}
}
</code></pre>
<p>上面str是Execute的第二个参数，它的内容是包含了特殊符号的字符串。</p>
<p>下面是index.html文件的内容：</p>
<pre><code class="language-html"><!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>index页面</title>
</head>
<body>
<div align="center">
<p>html/template上下文感知示例</p>
<div>{{ . }}</div>
<div><a href="/{{ . }}">Path</a></div>
<div><a href="/?q={{ . }}">Query</a></div>
<div><a onclick="f('{{ . }}')">Onclick</a></div>
<img src="./img/pyy.jpeg" style="width: 10%" alt="彭于晏">
</div>
</body>
</html>
</code></pre>
<p>上面index.html中有4个不同的环境，分别是html环境、url的path环境、url的query环境以及js环境。虽然对象都是<code>{{.}}</code>，但解析执行后的值是不一样的。如果使用curl获取源代码，结果将如下：</p>
<pre><code class="language-html"><!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>index页面</title>
</head>
<body>
<div align="center">
<p>html/template上下文感知示例</p>
<div>I asked: &lt;i&gt;&#34;What&#39;s up?&#34;&lt;/i&gt;</div>
<div><a href="/I%20asked:%20%3ci%3e%22What%27s%20up?%22%3c/i%3e">Path</a></div>
<div><a href="/?q=I%20asked%3a%20%3ci%3e%22What%27s%20up%3f%22%3c%2fi%3e">Query</a></div>
<div><a onclick="f('I asked: \u003ci\u003e\u0022What\u0027s up?\u0022\u003c\/i\u003e')">Onclick</a></div>
<img src="./img/pyy.jpeg" style="width: 10%" alt="彭于晏">
</div>
</body>
</html>
</code></pre>
<p><code>html/template</code>针对的是需要返回HTML内容的场景，在模板渲染过程中会对一些有风险的内容进行转义，以此来防范跨站脚本攻击。</p>
<p>例如，定义下面的模板文件：</p>
<pre><code class="language-html"><!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>index页面</title>
</head>
<body>
<div align="center">
<p>html/template上下文感知示例</p>
{{ . }}
<br>
<img src="./img/pyy.jpeg" style="width: 10%" alt="彭于晏">
</div>
</body>
</html>
</code></pre>
<p>handler控制器代码如下：</p>
<pre><code class="language-go">func index(w http.ResponseWriter, r *http.Request) {
//解析指定文件生成模板对象
tmpl, err := template.ParseFiles("./public/index.html")
if err != nil {
log.Fatal(err)
}
str := `<script>alert('嘿嘿嘿')</script>`
//利用给定数据渲染模板，并将结果写入
err = tmpl.Execute(w, str)
if err != nil {
log.Fatal(err)
}
}
</code></pre>
<p>运行代码显示如下</p>
<p><img src="https://img2020.cnblogs.com/blog/720430/202105/720430-20210511162513029-430691006.png" alt="" loading="lazy"></p>
<p>如果我们将包由html/template改为text/template，重新运行代码，可以发现被注入了js代码</p>
<p><img src="https://img2020.cnblogs.com/blog/720430/202105/720430-20210511162524831-1406913197.png" alt="" loading="lazy"></p>
<h3 id="客户端">客户端</h3>
<p>http包提供了很多访问Web服务器的函数，比如<code>http.Get()</code>、<code>http.Post()</code>、<code>http.Head()</code>等，读到的响应报文数据被保存在 Response 结构体中。</p>
<p>我们通过查看<code>http.Get()</code>方法的源码可知，实际上是默认的DefaultClient调用自己的Get方法。</p>
<pre><code class="language-go">func Get(url string) (resp *Response, err error) {
return DefaultClient.Get(url)
}
</code></pre>
<p>真正用来发送请求的Client结构体定义如下：</p>
<pre><code class="language-go">type Client struct {
// Transport指定执行独立、单次HTTP请求的机制。
// 如果Transport为nil，则使用DefaultTransport。
Transport RoundTripper
// CheckRedirect指定处理重定向的策略。
// 如果CheckRedirect不为nil，客户端会在执行重定向之前调用本函数字段。
// 参数req和via是将要执行的请求和已经执行的请求（切片，越新的请求越靠后）。
// 如果CheckRedirect返回一个错误，本类型的Get方法不会发送请求req，
// 而是返回之前得到的最后一个回复和该错误。（包装进url.Error类型里）
//
// 如果CheckRedirect为nil，会采用默认策略：连续10此请求后停止。
CheckRedirect func(req *Request, via []*Request) error
// Jar指定cookie管理器。
// 如果Jar为nil，请求中不会发送cookie，响应的cookie会被忽略。
Jar CookieJar
// Timeout指定本类型的值执行请求的时间限制。
// 该超时限制包括连接时间、重定向和读取回复主体的时间。
// 计时器会在Head、Get、Post或Do方法返回后继续运作并在超时后中断回复主体的读取。
//
// Timeout为零值表示不设置超时。
//
// Client实例的Transport字段必须支持CancelRequest方法，
// 否则Client会在试图用Head、Get、Post或Do方法执行请求时返回错误。
// 本类型的Transport字段默认值（DefaultTransport）支持CancelRequest方法。
Timeout time.Duration
}
</code></pre>
<h4 id="基本的httphttps请求">基本的HTTP/HTTPS请求</h4>
<p>Get、Head、Post和PostForm函数发出HTTP/HTTPS请求。</p>
<pre><code class="language-go">resp, err := http.Get("http://example.com/")
resp, err := http.Post("http://example.com/upload", "image/jpeg", &buf)
resp, err := http.PostForm("http://example.com/form", url.Values{"key": {"Value"}, "id": {"123"}})
</code></pre>
<p>程序在使用完response后必须关闭回复的主体。</p>
<pre><code class="language-go">resp, err := http.Get("http://example.com/")
if err != nil {
// handle error
}
defer resp.Body.Close()
body, err := ioutil.ReadAll(resp.Body)
</code></pre>
<h4 id="get请求示例">GET请求示例</h4>
<p>使用<code>net/http</code>包编写一个简单的发送HTTP请求的Client端，代码如下：</p>
<pre><code class="language-go">package main
import (
"fmt"
"io"
"log"
"net/http"
)
func main() {
resp, err := http.Get("http://127.0.0.1:8080")
if err != nil {
log.Fatalf("http.Get()函数执行错误，错误为：%v\n", err)
}
defer resp.Body.Close()
//由于ioutil包的歧义性，1.16版本之后不再建议使用ioutil包，包内方法的具体实现都改为了调用的其它包方法
//ioutil.ReadAll(resp.Body)
body, err := io.ReadAll(resp.Body)
if err != nil {
log.Fatalf("io.RedAll()函数执行出错，错误为：%v\n", err)
}
fmt.Println(string(body))
}
</code></pre>
<p>服务端代码如下：</p>
<pre><code class="language-go">package main
import (
"log"
"net/http"
)
func index(w http.ResponseWriter, r *http.Request) {
w.Write([]byte("hello world"))
}
func main() {
http.HandleFunc("/", index)
err := http.ListenAndServe(":8080", nil)
log.Fatal(err)
}
</code></pre>
<p>将上面的代码保存之后编译成可执行文件，执行之后就能在终端打印<code>hello world</code>网站首页的内容了，我们的浏览器其实就是一个发送和接收HTTP协议数据的客户端，我们平时通过浏览器访问网页其实就是从网站的服务器接收HTTP数据，然后浏览器会按照HTML、CSS等规则将网页渲染展示出来。</p>
<h4 id="带参数的get请求示例">带参数的GET请求示例</h4>
<p>关于GET请求的参数需要使用Go语言内置的<code>net/url</code>这个标准库来处理。</p>
<pre><code class="language-go">package main
import (
"fmt"
"io"
"log"
"net/http"
"net/url"
)
func main() {
//1.处理请求参数
params := url.Values{}
params.Set("name", "itbsl")
params.Set("hobby", "fishing")
//2.设置请求URL
rawUrl := "http://127.0.0.1:8080"
reqUrl, err := url.ParseRequestURI(rawUrl)
if err != nil {
fmt.Printf("url.ParseRequestURI()函数执行错误,错误为:%v\n", err)
return
}
//3.整合请求URL和参数
//Encode方法将请求参数编码为url编码格式("bar=baz&foo=foz")，编码时会以键进行排序。
reqUrl.RawQuery = params.Encode()
//4.发送HTTP请求
//说明：reqURL.String() String将URL重构为一个合法URL字符串。
resp, err := http.Get(reqUrl.String())
if err != nil {
log.Fatalf("http.Get()函数执行错误，错误为：%v\n", err)
}
defer resp.Body.Close()
//5.一次性读取响应的所有内容
body, err := io.ReadAll(resp.Body)
if err != nil {
log.Fatalf("io.RedAll()函数执行出错，错误为：%v\n", err)
}
fmt.Println(string(body))
}
</code></pre>
<p>对应的Server端代码如下：</p>
<pre><code class="language-go">package main
import (
"fmt"
"log"
"net/http"
)
func index(w http.ResponseWriter, r *http.Request) {
defer r.Body.Close()
params := r.URL.Query()
fmt.Printf("name: %v, hobby: %v\n", params.Get("name"), params.Get("nobody"))
w.Write([]byte("hello world"))
}
func main() {
http.HandleFunc("/", index)
err := http.ListenAndServe(":8080", nil)
log.Fatal(err)
}
</code></pre>
<h4 id="post请求示例">POST请求示例</h4>
<p>面演示了使用<code>net/http</code>包发送<code>GET</code>请求的示例，发送<code>POST</code>请求的示例代码如下：</p>
<pre><code class="language-go">package main
import (
"fmt"
"io"
"net/http"
"strings"
)
func main() {
url := "http://127.0.0.1:8080"
// 表单数据
//contentType := "application/x-www-form-urlencoded"
//data := "name=itbsl&age=18"
// json
contentType := "application/json"
data := `{"name":"itbsl","age":18}`
resp, err := http.Post(url, contentType, strings.NewReader(data))
if err != nil {
fmt.Printf("post failed, err:%v\n", err)
return
}
defer resp.Body.Close()
body, err := io.ReadAll(resp.Body)
if err != nil {
fmt.Printf("get resp failed,err:%v\n", err)
return
}
fmt.Println(string(body))
}
</code></pre>
<p>对应的Server端HandlerFunc如下：</p>
<pre><code class="language-go">func index(w http.ResponseWriter, r *http.Request) {
defer r.Body.Close()
// 1. 请求类型是application/x-www-form-urlencoded时解析form数据
//r.ParseForm()
//fmt.Println(r.PostForm) // 打印form数据
//fmt.Println(r.PostForm.Get("name"), r.PostForm.Get("age"))
// 2. 请求类型是application/json时从r.Body读取数据
body, err := io.ReadAll(r.Body)
if err != nil {
fmt.Printf("read request.Body failed, err:%v\n", err)
return
}
fmt.Println(string(body))
answer := `{"status": "ok"}`
w.Write([]byte(answer))
}
</code></pre>
<h4 id="自定义client">自定义Client</h4>
<p>要管理HTTP客户端的头域、重定向策略和其他设置，创建一个Client：</p>
<pre><code class="language-go">package main
import (
"fmt"
"io"
"log"
"net/http"
)
func main() {
client := &http.Client{}
req, err := http.NewRequest("GET", "http://127.0.0.1:8080", nil)
if err != nil {
log.Fatal(err)
}
req.Header.Add("sign", "sign_aes")
resp, err := client.Do(req)
defer resp.Body.Close()
body, err := io.ReadAll(resp.Body)
if err != nil {
log.Fatal(err)
}
fmt.Println(string(body))
}
</code></pre>
<p>参考：<br>
Head First Go语言程序设计<br>
Go语言标准库之http/template</p><br><br>
来源：https://www.cnblogs.com/itbsl/p/12175645.html
頁:
[1]