import "encoding/base64"

base64实现了 RFC 4648 规定的base64编码。Base64是网络上最常见的用于传输8Bit字节码的编码方式之一,Base64就是一种基于64个可打印字符(即6Bits)来表示二进制数据(即8Bits)的方法。Base64编码是从二进制到字符的过程,可用于在 HTTP 环境下传递较长的标识信息,这样更适合放在URL中进行传递。此时,采用Base64编码具有不可读性,需要解码后才能阅读。

该编码的规则就是:

  • 把3个字符变成4个字符:方法就是先将3个8Bits(3*8=24Bits)的值分成4个6Bits的值(4*6=24Bits),然后在这四个6Bits值前添加两个0将其变为8Bits的值,这样就能够保证生成的4个值表示的值大小为(0~63),即可以将其转成对应的ASCII码(64个可打印字符)举例:
  • 转换前:          01110011 00110001 00110011
    拆分成4份:        011100 110011 000100 110011
    高位补0:          00011100 00110011 00000100 00110011
    对应的值为:       28 51 4 51
    转成对应的ASCII码: c z E z
  • 每76个字符加一个换行符
  • 最后的结束符也要处理
  • 然而,标准的Base64并不适合直接放在URL里传输,因为URL编码器会把标准Base64中的“/”和“+”字符变为形如“%XX”的形式,而这些“%”号在存入数据库时还需要再进行转换,因为ANSI SQL中已将“%”号用作通配符。
    为解决此问题,可采用一种用于URL的改进Base64编码,它不仅在末尾去掉填充的'='号,并将标准Base64中的“+”和“/”分别改成了“-”和“_”,这样就免去了在URL编解码和数据库存储时所要作的转换,避免了编码信息长度在此过程中的增加,并统一了数据库、表单等处对象标识符的格式。
    另有一种用于正则表达式的改进Base64变种,它将“+”和“/”改成了“!”和“-”,因为“+”,“/”以及前面在IRCu中用到的“[”和“]”在正则表达式中都可能具有特殊含义。

    type Encoding

    type Encoding struct {
        // 内含隐藏或非导出字段
    

    双向的编码/解码协议,根据一个64字符的字符集定义,RFC 4648标准化了两种字符集。默认字符集用于MIME(RFC 2045)和PEM(RFC 1421)编码;另一种用于URL和文件名,用'-'和'_'替换了'+'和'/'。

    func NewEncoding

    func NewEncoding(encoder string) *Encoding

    使用给出的字符集生成一个*Encoding,字符集必须是64字节的字符串。

    Variables 

    var StdEncoding = NewEncoding(encodeStd)

    RFC 4648定义的标准base64编码字符集。

    var URLEncoding = NewEncoding(encodeURL)

    RFC 4648定义的另一base64编码字符集,用于URL和文件名。

    下面的两个函数分别就是编码和解码的过程:

    func (*Encoding) EncodeToString

    func (enc *Encoding) EncodeToString(src []byte) string

    返回将src编码后的字符串。

    func (*Encoding) DecodeString

    func (enc *Encoding) DecodeString(s string) ([]byte, error)

    返回base64编码的字符串s代表的数据。

    package main 
    import(
        "fmt"
        "encoding/base64"
    func main() { 
        msg := "Hello,world" //11个字符应该装成15个base64编码的字符
        encoded := base64.StdEncoding.EncodeToString([]byte(msg))
        fmt.Println(encoded) //SGVsbG8sd29ybGQ=,后面的=是作填充用的
        decoded, err := base64.StdEncoding.DecodeString(encoded)
        if err != nil {
            fmt.Println("decode error:", err)
            return
        fmt.Println(string(decoded))//Hello,world
    

    下面的方法不是将他们编码成字符串:

    解码字符:

    func (*Encoding) DecodedLen

    func (enc *Encoding) DecodedLen(n int) int

    返回n字节base64编码的数据解码后的最大长度。

    func (*Encoding) Decode

    func (enc *Encoding) Decode(dst, src []byte) (n int, err error)

    将src的数据解码后存入dst,最多写DecodedLen(len(src))字节数据到dst,并返回写入的字节数。 如果src包含非法字符,将返回成功写入的字符数和CorruptInputError。换行符(\r、\n)会被忽略。

    package main 
    import(
        "encoding/base64"
        "log"
        "fmt"
        "io"
    func main() { 
        encoded := "Zm9vLGJhcg=="
        n := base64.StdEncoding.DecodedLen(len(encoded))//DecodedLen返回len(encoded)字节base64编码的数据解码后的最大长度
        fmt.Println(n) //9
        dbuf := make([]byte, n) 
        _, err :=base64.StdEncoding.Decode(dbuf, []byte(encoded))
        if err != nil && err != io.EOF {
            log.Fatal("Read failed", err)
        fmt.Printf("decoded result : %s\n", dbuf) //decoded result : foo,bar
    

    下面两个代码组合进行编码:

    func (*Encoding) EncodedLen

    func (enc *Encoding) EncodedLen(n int) int

    返回n字节数据进行base64编码后的最大长度。

    func (*Encoding) Encode

    func (enc *Encoding) Encode(dst, src []byte)

    将src的数据编码后存入dst,最多写EncodedLen(len(src))字节数据到dst,并返回写入的字节数。

     函数会把输出设置为4的倍数,因此不建议对大数据流的独立数据块执行此方法,使用NewEncoder()代替。

    package main 
    import(
        "encoding/base64"
        "fmt"
    func main() { 
        decoded := "foo,bar"
        n := base64.StdEncoding.EncodedLen(len(decoded))//DecodedLen返回len(encoded)字节base64编码的数据解码后的最大长度
        fmt.Println(n) //12
        dbuf := make([]byte, n) 
        base64.StdEncoding.Encode(dbuf, []byte(decoded))
        fmt.Printf("encode result : %s\n", dbuf) //encode result : Zm9vLGJhcg==
    

     下面就是生成编码器和解码器的方法,其实和上面的Encode和Decode实现的效果一样,在编码的是大数据流时使用下面的方法:

    func NewEncoder(可写Write)

    func NewEncoder(enc *Encoding, w io.Writer) io.WriteCloser

    创建一个新的base64流编码器。写入的数据会在编码后再写入w,base32编码每3字节执行一次编码操作;写入完毕后,使用者必须调用Close方法以便将未写入的数据从缓存中刷新到w中。

    package main 
    import(
        "encoding/base64"
        "os"
    func main() { 
        input := []byte("foo,bar")
        encoder := base64.NewEncoder(base64.StdEncoding, os.Stdout) //生成一个编码器,会将调用Write()写入的值编码后写到os.Stdout中
        encoder.Write(input)
        encoder.Close()
        //返回Zm9vLGJhcg==
    

    func NewDecoder(可读-Read)

    func NewDecoder(enc *Encoding, r io.Reader) io.Reader

    创建一个新的base64流解码器。

    package main 
    import(
        "encoding/base64"
        "strings"
        "log"
        "fmt"
        "io"
    func main() { 
        encoded := "Zm9vLGJhcg=="
        decoder := base64.NewDecoder(base64.StdEncoding, strings.NewReader(encoded))
        n := base64.StdEncoding.DecodedLen(len(encoded))//DecodedLen返回len(encoded)字节base64编码的数据解码后的最大长度
        fmt.Println(n) //9
        dbuf := make([]byte, n) 
        _, err := decoder.Read(dbuf)//将读取的解码后的值写到dbuf中
        if err != nil && err != io.EOF {
            log.Fatal("Read failed", err)
        fmt.Printf("decoded result : %s\n", dbuf) //decoded result : foo,bar