Go使用Base64编解码

简介

Base64是网络上最常见的用于传输8Bit字节代码的编码方式之一，可用于在HTTP环境下传递较长的标识信息。Go 的 encoding/base64 提供了对base64的编解码操作。

encoding/base64 定义了一个Encoding结构体，表示Base64的编/解码器。并且导出了四个常用的Encoding对象：StdEncoding、URLEncoding、RawStdEncoding、RawURLEncoding。StdEncoding表示标准的编/解码器。URLEncoding用于对URL编解码，编解码过程中会将Base64编码中的特殊标记+和/替换为-和_。RawStdEncoding和RawURLEncoding是StdEncoding和URLEncoding的非padding版本。主要API如下：

// 四个导出的编码/解码器var StdEncoding = NewEncoding(encodeStd)var URLEncoding = NewEncoding(encodeURL)var RawStdEncoding = StdEncoding.WithPadding(NoPadding)var RawURLEncoding = URLEncoding.WithPadding(NoPadding)// Encoding 结构体表示编码/解码器type Encoding struct {    // ...}// Encoding提供了如下编解码的方法// 解码，[]byte版本将src解码为dest，返回成功写入的字节数和错误// string版本应用于字符串func (enc *Encoding) Decode(dst, src []byte) (n int, err error)func (enc *Encoding) DecodeString(s string) ([]byte, error)// 编码，[]byte版本将src编码为dest// string版本应用于字符串func (enc *Encoding) Encode(dst, src []byte)func (enc *Encoding) EncodeToString(src []byte) string// 设置enc的padding，返回Encoding指针，NoPadding表示不进行padding操作func (enc Encoding) WithPadding(padding rune) *Encoding// 另外 encoding/base64 还提供了流式操作的接口func NewDecoder(enc *Encoding, r io.Reader) io.Readerfunc NewEncoder(enc *Encoding, w io.Writer) io.WriteCloser

Encoding应用

下面的程序演示了 Encoding 的用法：

package mainimport (    "encoding/base64"    "errors"    "fmt")// 为了方便，声明该函数，省去错误处理func mustDecode(enc *base64.Encoding, str string) string {    data, err := enc.DecodeString(str)    if err != nil {        panic(err)    }    return string(data)}// 该函数测试编解码// enc为要测试的Encoding对象，str为要测试的字符串func testEncoding(enc *base64.Encoding, str string) {    // 编码    encStr := enc.EncodeToString([]byte(str))    fmt.Println(encStr)    // 解码    decStr := mustDecode(enc, encStr)    if decStr != str {  // 编码后再解码应该与原始字符串相同                        // 这里判断如果不同，则panic        panic(errors.New("unequal!"))    }}func main() {    const testStr = "Go语言编程"    // 测试StdEncoding，注意打印结果里的/为URL中的特殊字符，最后有一个padding    testEncoding(base64.StdEncoding, testStr)    // 打印：R2/or63oqIDnvJbnqIs=    // 测试URLEncoding，可以看到/被替换为_    testEncoding(base64.URLEncoding, testStr)    // 打印：R2_or63oqIDnvJbnqIs=    // 测试RawStdEncoding，可以看到去掉了padding    testEncoding(base64.RawStdEncoding, testStr) // 打印：R2/or63oqIDnvJbnqIs    // 测试RawURLEncoding，可以看到/被替换Wie_，并且却掉了padding    testEncoding(base64.RawURLEncoding, testStr) // 打印：R2_or63oqIDnvJbnqIs}

流式API的应用

流式API多用于在数据传输过程中对数据进行Base64编码或解码。比如在读取较大文件时，或者网络传输时。下面的程序读取testfile中的数据，利用base64编码后保存到testfile_enc：

package mainimport (    "encoding/base64"    "io"    "log"    "os")type Buf struct {    data []byte    size int}func main() {    f, err := os.Open("E:\\testfile")    if err != nil {        log.Fatalln(err)    }    defer f.Close()    fEnc, err := os.Create("E:\\testfile_enc")    if err != nil {        log.Fatalln(err)    }    defer fEnc.Close()    w := base64.NewEncoder(base64.StdEncoding, fEnc)    io.Copy(w, f)    w.Close()}