為了示范,我們創建了一個名為 uc 的簡單包,它含有一個?`UpperCase`?函數將字符串的所有字母轉換為大寫。當然這并不值得創建一個自己包,同樣的功能已被包含在?`strings`?包里,但是同樣的技術也可以應用在更復雜的包中。
## 9.8.1 自定義包的目錄結構
下面的結構給了你一個好的示范(uc 代表通用包名, 名字為粗體的代表目錄,斜體代表可執行文件):
~~~
/home/user/goprograms
ucmain.go (uc包主程序)
Makefile (ucmain的2-makefile)
ucmain
src/uc (包含uc包的go源碼)
uc.go
uc_test.go
Makefile (包的1-makefile)
uc.a
_obj
uc.a
_test
uc.a
bin (包含最終的執行文件)
ucmain
pkg/linux_amd64
uc.a (包的目標文件)
~~~
將你的項目放在 goprograms 目錄下(你可以創建一個環境變量 GOPATH,詳見第 2.2/3 章節:在 .profile 和 .bashrc 文件中添加?`export GOPATH=/home/user/goprograms`),而你的項目將作為 src 的子目錄。uc 包 中的功能在 uc.go 中實現。
示例 9.6?[uc.go](https://github.com/Unknwon/the-way-to-go_ZH_CN/blob/master/eBook/examples/chapter_9/uc.go):
~~~
package uc
import "strings"
func UpperCase(str string) string {
return strings.ToUpper(str)
}
~~~
包通常附帶一個或多個測試文件,在這我們創建了一個 uc_test.go 文件,如第 9.8 節所述。
示例 9.7?[test.go](https://github.com/Unknwon/the-way-to-go_ZH_CN/blob/master/eBook/examples/chapter_9/uc.go)
~~~
package uc
import "testing"
type ucTest struct {
in, out string
}
var ucTests = []ucTest {
ucTest{"abc", "ABC"},
ucTest{"cvo-az", "CVO-AZ"},
ucTest{"Antwerp", "ANTWERP"},
}
func TestUC(t *testing.T) {
for _, ut := range ucTests {
uc := UpperCase(ut.in)
if uc != ut.out {
t.Errorf("UpperCase(%s) = %s, must be %s", ut.in, uc,
ut.out)
}
}
}
~~~
通過指令編譯并安裝包到本地:`go install src/uc`, 這會將 uc.a 復制到 pkg/linux_amd64 下面。
另外,使用 make,通過以下內容創建一個包的 Makefile(1) 在 src/uc 目錄下:
~~~
include $GOROOT/src/Make.inc
TARG=uc
GOFILES=\
uc.go\
include $(GOROOT)/scr/Make.pkg
~~~
在該目錄下的命令行調用: gomake
這將創建一個 _obj 目錄并將包編譯生成的存檔 uc.a 放在該目錄下。
這個包可以通過 go test 測試。
創建一個 ud.a 的測試文件在目錄下,輸出為 PASS 時測試通過。
在第 13.8 節我們將給出另外一個測試例子并進行深入研究。
備注:有可能你當前的用戶不具有足夠的資格使用 go install(沒有權限)。這種情況下,選擇 root 用戶 su。確保 Go 環境變量和 Go 源碼路徑也設置給 su,同樣也適用你的普通用戶(詳見第 2.3 節)。
接下來我們創建主程序 ucmain.go:
示例 9.8?[ucmain.go](https://github.com/Unknwon/the-way-to-go_ZH_CN/blob/master/examples/chapter_9/ucmain.go):
~~~
package main
import (
"fmt"
"./uc/uc"
)
func main() {
str1 := "USING package uc"
fmt.Println(uc.UpperCase(str1))
}
~~~
然后在這個目錄下輸入?`go install`。
另外復制 uc.a 到 uc 目錄并創建一個 Makefile(2) 并寫入文本:
~~~
include $GOROOT/src/Make.inc
TARG=ucmain
GOFILES=\
ucmain.go\
include $GOROOT/src/Make.cmd
~~~
執行 gomake 編譯?`ucmain.go`?到 ucmain 目錄
運行?`./ucmain`?顯示:?`USING package uc!`。
## 9.8.2 本地安裝包
本地包在用戶目錄下,使用給出的目錄結構,以下命令用來從源碼安裝本地包:
~~~
go install /home/user/goprograms/src/uc # 編譯安裝uc
cd /home/user/goprograms/uc
go install ./uc # 編譯安裝uc(和之前的指令一樣)
cd ..
go install . # 編譯安裝ucmain
~~~
安裝到?`$GOPATH`?下:
如果我們想安裝的包在系統上的其他 Go 程序中被使用,它一定要安裝到?`$GOPATH`?下。 這樣做,在 .profile 和 .bashrc 中設置?`export GOPATH=/home/user/goprograms`。
然后執行 go install uc 將會復制包存檔到?`$GOPATH/pkg/LINUX_AMD64/uc`。
現在,uc 包可以通過?`import "uc"`?在任何 Go 程序中被引用。
## 9.8.3 依賴系統的代碼
不同操作系統上運行不同的程序是非常少見的:絕大多數情況下語言和標準庫解決了大部分的可移植性問題。
你有一個很好的理由去寫平臺平臺特定的代碼,例如匯編語言。這種情況下,按照下面的約定是合理的:
~~~
prog1.go
prog1_linux.go
prog1_darwin.go
prog1_windows.go
~~~
prog1.go 定義了不同操作系統通用的接口,并將系統特定的代碼寫到 prog1_os.go 中。 對于 Go 工具你可以指定`prog1_$GOOS.go`?或?`prog1_$GOARCH.go`?或在平臺 Makefile 中:`prog1_$(GOOS).go\`?或?`prog1_$(GOARCH).go\`。
- 前言
- 第一部分:學習 Go 語言
- 第1章:Go 語言的起源,發展與普及
- 1.1 起源與發展
- 1.2 語言的主要特性與發展的環境和影響因素
- 第2章:安裝與運行環境
- 2.1 平臺與架構
- 2.2 Go 環境變量
- 2.3 在 Linux 上安裝 Go
- 2.4 在 Mac OS X 上安裝 Go
- 2.5 在 Windows 上安裝 Go
- 2.6 安裝目錄清單
- 2.7 Go 運行時(runtime)
- 2.8 Go 解釋器
- 第3章:編輯器、集成開發環境與其它工具
- 3.1 Go 開發環境的基本要求
- 3.2 編輯器和集成開發環境
- 3.3 調試器
- 3.4 構建并運行 Go 程序
- 3.5 格式化代碼
- 3.6 生成代碼文檔
- 3.7 其它工具
- 3.8 Go 性能說明
- 3.9 與其它語言進行交互
- 第二部分:語言的核心結構與技術
- 第4章:基本結構和基本數據類型
- 4.1 文件名、關鍵字與標識符
- 4.2 Go 程序的基本結構和要素
- 4.3 常量
- 4.4 變量
- 4.5 基本類型和運算符
- 4.6 字符串
- 4.7 strings 和 strconv 包
- 4.8 時間和日期
- 4.9 指針
- 第5章:控制結構
- 5.1 if-else 結構
- 5.2 測試多返回值函數的錯誤
- 5.3 switch 結構
- 5.4 for 結構
- 5.5 Break 與 continue
- 5.6 標簽與 goto
- 第6章:函數(function)
- 6.1 介紹
- 6.2 函數參數與返回值
- 6.3 傳遞變長參數
- 6.4 defer 和追蹤
- 6.5 內置函數
- 6.6 遞歸函數
- 6.7 將函數作為參數
- 6.8 閉包
- 6.9 應用閉包:將函數作為返回值
- 6.10 使用閉包調試
- 6.11 計算函數執行時間
- 6.12 通過內存緩存來提升性能
- 第7章:數組與切片
- 7.1 聲明和初始化
- 7.2 切片
- 7.3 For-range 結構
- 7.4 切片重組(reslice)
- 7.5 切片的復制與追加
- 7.6 字符串、數組和切片的應用
- 第8章:Map
- 8.1 聲明、初始化和 make
- 8.2 測試鍵值對是否存在及刪除元素
- 8.3 for-range 的配套用法
- 8.4 map 類型的切片
- 8.5 map 的排序
- 8.6 將 map 的鍵值對調
- 第9章:包(package)
- 9.1 標準庫概述
- 9.2 regexp 包
- 9.3 鎖和 sync 包
- 9.4 精密計算和 big 包
- 9.5 自定義包和可見性
- 9.6 為自定義包使用 godoc
- 9.7 使用 go install 安裝自定義包
- 9.8 自定義包的目錄結構、go install 和 go test
- 9.9 通過 Git 打包和安裝
- 9.10 Go 的外部包和項目
- 9.11 在 Go 程序中使用外部庫
- 第10章:結構(struct)與方法(method)
- 10.1 結構體定義
- 10.2 使用工廠方法創建結構體實例
- 10.3 使用自定義包中的結構體
- 10.4 帶標簽的結構體
- 10.5 匿名字段和內嵌結構體
- 10.6 方法
- 10.8 垃圾回收和 SetFinalizer
- 第11章:接口(interface)與反射(reflection)
- 11.1 接口是什么
- 11.2 接口嵌套接口
- 11.3 類型斷言:如何檢測和轉換接口變量的類型
- 11.4 類型判斷:type-switch
- 11.5 測試一個值是否實現了某個接口
- 11.6 使用方法集與接口
- 11.7 第一個例子:使用 Sorter 接口排序
- 11.8 第二個例子:讀和寫
- 11.9 空接口
- 11.10 反射包
- 第三部分:Go 高級編程
- 第12章 讀寫數據
- 12.1 讀取用戶的輸入
- 12.2 文件讀寫
- 12.3 文件拷貝
- 12.4 從命令行讀取參數
- 12.5 用buffer讀取文件
- 12.6 用切片讀寫文件
- 12.7 用 defer 關閉文件
- 12.8 使用接口的實際例子:fmt.Fprintf
- 12.9 Json 數據格式
- 12.10 XML 數據格式
- 12.11 用 Gob 傳輸數據
- 12.12 Go 中的密碼學
- 第13章 錯誤處理與測試
- 13.1 錯誤處理
- 13.2 運行時異常和 panic
- 13.3 從 panic 中恢復(Recover)
- 13.4 自定義包中的錯誤處理和 panicking
- 13.5 一種用閉包處理錯誤的模式
- 13.6 啟動外部命令和程序
- 13.7 Go 中的單元測試和基準測試
- 13.8 測試的具體例子
- 13.9 用(測試數據)表驅動測試
- 13.10 性能調試:分析并優化 Go 程序
- 第14章:協程(goroutine)與通道(channel)
- 14.1 并發、并行和協程
- 14.2 使用通道進行協程間通信
- 14.3 協程同步:關閉通道-對阻塞的通道進行測試
- 14.4 使用 select 切換協程
- 14.5 通道,超時和計時器(Ticker)
- 14.6 協程和恢復(recover)
- 第15章:網絡、模版與網頁應用
- 15.1 tcp服務器
- 15.2 一個簡單的web服務器
- 15.3 訪問并讀取頁面數據
- 15.4 寫一個簡單的網頁應用
- 第四部分:實際應用
- 第16章:常見的陷阱與錯誤
- 16.1 誤用短聲明導致變量覆蓋
- 16.2 誤用字符串
- 16.3 發生錯誤時使用defer關閉一個文件
- 16.5 不需要將一個指向切片的指針傳遞給函數
- 16.6 使用指針指向接口類型
- 16.7 使用值類型時誤用指針
- 16.8 誤用協程和通道
- 16.9 閉包和協程的使用
- 16.10 糟糕的錯誤處理
- 第17章:模式
- 17.1 關于逗號ok模式
- 第18章:出于性能考慮的實用代碼片段
- 18.1 字符串
- 18.2 數組和切片
- 18.3 映射
- 18.4 結構體
- 18.5 接口
- 18.6 函數
- 18.7 文件
- 18.8 協程(goroutine)與通道(channel)
- 18.9 網絡和網頁應用
- 18.10 其他
- 18.11 出于性能考慮的最佳實踐和建議
- 附錄