golang url 链接地址解析包

golang url 链接地址解析包

url 编码

• QueryEscape 将字符地址转为安全地址 func QueryEscape(s string) string p := url.QueryEscape("/user?id=12") // >>> %2Fuser%3Fid%3D12
• QueryUnescape 还原QueryEscape 转码 func QueryUnescape(s string) (string, error)

URL 类型

• URL 结构 type URL struct { Scheme string Opaque string // 编码后的不透明数据 User *Userinfo // 用户名和密码信息 Host string // host或host:port Path string RawQuery string // 编码后的查询字符串，没有'?' Fragment string // 引用的片段（文档位置），没有'#' }
• url 解析格式 // 双斜杠地址 scheme://[userinfo@]host/path[?query][#fragment] // 非双斜杠地址 scheme:opaque[?query][#fragment] compelePath := "http://lcoalhost:8080/user?id=1" subPath := "/user?id=1" // 双斜杠 cP, _ := url.Parse(compelePath) _log(cP.Host) // >>> lcoalhost:8080 // 非双斜杠 sP, _ := url.Parse(subPath) _log(sP.Host) _log(sP.RawQuery) // >>> （空值） // >>> id=1 // 两者可获取的参数不同

URL 解析

• Parse 将字符解析为URL对象 func Parse(rawurl string) (url *URL, err error)
• ParseRequestURI 解析从http请求中获取的 url地址，该地址将不包含[#fragment] 后缀 func ParseRequestURI(rawurl string) (url *URL, err error)

URL 操作方法

• func IsAbs 是否为绝对地址 func (u *URL) IsAbs() bool compelePath := "http://lcoalhost:8080/user?id=1" subPath := "/user?id=1" cP, _ := url.Parse(compelePath) _log(cP.IsAbs()) // >>> true sP, _ := url.Parse(subPath) _log(sP.IsAbs()) // >>> false
• func Query 获取查询参数 func (u *URL) Query() Values URL, _ := url.Parse("/user?nickname=coco") args := URL.Query() // >>> map[nickname:["coco"]]
• func RequeryURI 获取URL编码后的参数字符 u := url.URL{ Host: "lcoalhost:8080", Path: "/user", RawQuery: "nickname=coco&age=24", } queryStr := u.RequestURI() // >>> /user?nickname=coco&age=24
• func String 获取完整的地址字符 func (u *URL) String() string u := url.URL{ Scheme: "http", Host: "lcoalhost:8080", Path: "/user", RawQuery: "nickname=coco&age=24", } _log(u.String()) // >>> http://lcoalhost:8080/user?nickname=coco&age=24
• func Parse 以当前URL为上下文解析新地址 func (u *URL) Parse(ref string) (*URL, error) u := url.URL{ Scheme: "http", Host: "lcoalhost:8080", Path: "/user", RawQuery: "nickname=coco&age=24", } newUrl, _ := u.Parse("/login") // >>> http://lcoalhost:8080/login

URL 用户结构方法

• User 使用用户名创建用户信息结构 func User(username string) *Userinfo
• UserPassword 使用用户密码创建用户信息结构 func UserPassword(username, password string) *Userinfo
• func Username 获取用户名称 func (u *Userinfo) Username() string
• func Password 是否设置密码 func (u *Userinfo) Password() (string, bool)
• func String 返回用户信息 func (u *Userinfo) String() string

参数对象 Values

• Values 结构 type Values map[string][]string
• ParseQuery 参数解析 func ParseQuery(query string) (m Values, err error) args, _ := url.ParseQuery("name=coco&age=24") // >>> map[age:[24], name:[coco]] prefixArgs, _ := url.ParseQuery("/user?name=coco") // >>> map[/user?name:[coco]] // 需要注意这里解析的字符不包含地址的其他部分， [key]=[value]
• func Get 获取指定参数集合的第一个值 func (v Values) Get(key string) string args, _ := url.ParseQuery("name=coco&age=24") // 添加新元素 args.Add("name", "jeck") _log(args.Get("name")) // >>> coco
• func Set 设置参数 func (v Values) Set(key, value string) args, _ := url.ParseQuery("name=coco&age=24") args.Add("name", "jeck") args.Set("name", "Rogan") // >>> map[age:[24] name:[Rogan]]
• func Add 添加参数 func (v Values) Add(key, value string)
• func Del 删除参数 func (v Values) Del(key string)
• func Encode 转字符串 func (v Values) Encode() string args := url.Values{ "name": []string{"coco"}, "age": []string{"34"}, } queryStr := args.Encode() // >>> age=34&name=coco

总结

• URL 包提供的是对 url 的解析及构建方法
• 按照类型分： URL， Userinfo, Values
• 按照方法分：
  • 类构件[ 将字符地址解析为对应类型 ， url.ParseQuery ]
  • 查询[从解析后的对象获取数据， URL.Query]
  • 操作[ 修改对象信息， Values.Set ]
• 服务端使用 解析较多 例如： url.Parse URL.Query ....
• 客户端, 爬虫 以构建查询为主 例如： Values.Get Values.Encode ....