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