go package官方文件閱讀方式

jilaokang發表於2018-10-27
GoPackage

本文以 net/http 舉例

學習一門新技術，優先的方法是直接看官方文件，如果能夠有效的進行文件劃分，便可以養成快速文件閱讀的能力。

只看快速入門部分

只看快速入門部分

只看快速入門部分

一般文件中都有快速入門部分，該部分從呼叫，示例，核心原理通常都有所講解，適合精看。主要的正文部分可以單看一兩個示例，來測試呼叫，這樣你就學會了一門新package。

快速入門

使用

import "net/http"
複製程式碼

簡介與示例

http包提供了HTTP客戶端和服務端的實現。

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"}})
複製程式碼

目錄

變數合集
可呼叫介面
物件子類
  子類介面
複製程式碼

內容

section1

/*
 * r *Request 傳入引數 
 * PaeseForm 介面 
 * error返回值
 * 示例：r.ParseForm()
 */
 
func (r *Request) ParseForm() error
複製程式碼

section2

/*
 * 使用示例1： ResponseWriter.Header() 
 * 使用示例2： ResponseWriter.Write(arr) 返回值為 (int, error)
 */
 
type ResponseWriter interface {
    // Header返回一個Header型別值，該值會被WriteHeader方法傳送。
    // 在呼叫WriteHeader或Write方法後再改變該物件是沒有意義的。
    Header() Header
    // WriteHeader該方法傳送HTTP回覆的頭域和狀態碼。
    // 如果沒有被顯式呼叫，第一次呼叫Write時會觸發隱式呼叫WriteHeader(http.StatusOK)
    // WriterHeader的顯式呼叫主要用於傳送錯誤碼。
    WriteHeader(int)
    // Write向連線中寫入作為HTTP的一部分回覆的資料。
    // 如果被呼叫時還未呼叫WriteHeader，本方法會先呼叫WriteHeader(http.StatusOK)
    // 如果Header中沒有"Content-Type"鍵，
    // 本方法會使用包函式DetectContentType檢查資料的前512位元組，將返回值作為該鍵的值。
    Write([]byte) (int, error)
}
複製程式碼

相關文章