golang中net/http包用法

youngfan007

type Request struct {　　

// Method指定HTTP方法(GET,POST,PUT等)默认使用GET方法。　　
Method string

　　
// URL在服务端表示被请求的URI(uniform resource>　　
// 在服务端,URL字段是解析请求行的URI（保存在RequestURI字段）得到的,对大多数请求来说,除了Path和RawQuery之外的字段都是空字符串。
　　
// 在客户端,URL的Host字段指定了要连接的服务器,而Request的Host字段指定要发送的HTTP请求的Host头的值。
　　
URL *url.URL
　　
// 接收到的请求的协议版本。client的Request总是使用HTTP/1.1
　　
Proto      string // "HTTP/1.0"
　　
ProtoMajor int    // 1
　　
ProtoMinor int    // 0
　　
// Header字段用来表示HTTP请求的头域。如果header（多行键值对格式）为：
　　
//    accept-encoding: gzip, deflate
　　
//    Accept-Language: en-us
　　
//    Connection: keep-alive
　　
// 则：
　　
//    Header = map[string][]string{
　　
//        "Accept-Encoding": {"gzip, deflate"},
　　
//        "Accept-Language": {"en-us"},
　　
//        "Connection": {"keep-alive"},
　　
//    }
　　
// HTTP规定header的键名（头名）是区分大小写的，请求的解析器通过规范化头域的键名来实现这点,即首字母大写,其他字母小写,通过"-"进行分割。
　　
// 在客户端的请求，可能会被自动添加或重写Header中的特定的头，参见Request.Write方法。
　　
    Header Header
　　
// Body是请求的主体.对于客户端请求来说,一个nil body意味着没有body,http Client的Transport字段负责调用Body的Close方法。
　　
// 在服务端，Body字段总是非nil的；但在没有主体时，读取Body会立刻返回EOF.Server会关闭请求主体，而ServeHTTP处理器不需要关闭Body字段。
　　
    Body io.ReadCloser
　　
// ContentLength记录相关内容的长度.如果为-1,表示长度未知,如果values>=0，表示可以从Body字段读取ContentLength字节数据。
　　
// 在客户端,如果Body非nil而该字段为0,表示不知道Body的长度。
　　
    ContentLength int64
　　
// TransferEncoding按从最外到最里的顺序列出传输编码，空切片表示"identity"编码。
　　
// 本字段一般会被忽略。当发送或接受请求时，会自动添加或移除"chunked"传输编码。
　　
TransferEncoding []string
　　
// Close在服务端指定是否在回复请求后关闭连接，在客户端指定是否在发送请求后关闭连接。
　　
Close bool
　　
// 对于服务器端请求,Host指定URL指向的主机,可能的格式是host:port.对于客户请求,Host用来重写请求的Host头,如过该字段为""，Request.Write方法会使用URL.Host来进行赋值。
　　
Host string
　　
// Form是解析好的表单数据，包括URL字段的query参数和POST或PUT的表单数据.本字段只有在调用ParseForm后才有效。在客户端，会忽略请求中的本字段而使用Body替代。
　　
    Form url.Values
　　
// PostForm是解析好的POST或PUT的表单数据.本字段只有在调用ParseForm后才有效。在客户端，会忽略请求中的本字段而使用Body替代。
　　
    PostForm url.Values
　　
// MultipartForm是解析好的多部件表单，包括上传的文件.本字段只有在调用ParseMultipartForm后才有效。http客户端中会忽略MultipartForm并且使用Body替代
　　
MultipartForm *multipart.Form
　　
// Trailer指定了在发送请求体之后额外的headers,在服务端，Trailer字段必须初始化为只有trailer键，所有键都对应nil值。
　　
// （客户端会声明哪些trailer会发送）在处理器从Body读取时，不能使用本字段.在从Body的读取返回EOF后，Trailer字段会被更新完毕并包含非nil的值。
　　
// （如果客户端发送了这些键值对），此时才可以访问本字段。
　　
// 在客户端，Trail必须初始化为一个包含将要发送的键值对的映射.(值可以是nil或其终值),ContentLength字段必须是0或-1，以启用"chunked"传输编码发送请求。
　　
// 在开始发送请求后,Trailer可以在读取请求主体期间被修改，一旦请求主体返回EOF，调用者就不可再修改Trailer。
　　
// 几乎没有HTTP客户端、服务端或代理支持HTTP trailer。
　　
    Trailer Header
　　
// RemoteAddr允许HTTP服务器和其他软件记录该请求的来源地址,该字段经常用于日志.本字段不是ReadRequest函数填写的，也没有定义格式。
　　
// 本包的HTTP服务器会在调用处理器之前设置RemoteAddr为"IP:port"格式的地址.客户端会忽略请求中的RemoteAddr字段。
　　
RemoteAddr string
　　
// RequestURI是客户端发送到服务端的请求中未修改的URI(参见RFC 2616,Section 5.1),如果在http请求中设置该字段便会报错.
　　
RequestURI string
　　
// TLS字段允许HTTP服务器和其他软件记录接收到该请求的TLS连接的信息,本字段不是ReadRequest函数填写的。
　　
// 对启用了TLS的连接，本包的HTTP服务器会在调用处理器之前设置TLS字段，否则将设TLS为nil。
　　
// 客户端会忽略请求中的TLS字段。
　　
TLS *tls.ConnectionState
　　
}