golang中archive/tar包用法

tar包实现对tar归档文件的访问,旨在覆盖大部分的类型,包括GNU和BSD产生的tars。

常量

const (

    // Types
    TypeReg           = '0'    // 普通文件
    TypeRegA          = '\x00' // 普通文件
    TypeLink          = '1'    // 硬连接
    TypeSymlink       = '2'    // 符号连接,软连接
    TypeChar          = '3'    // 字符设备节点
    TypeBlock         = '4'    // 块设备节点
    TypeDir           = '5'    // 目录
    TypeFifo          = '6'    // fifo node
    TypeCont          = '7'    // 保留项
    TypeXHeader       = 'x'    // 可扩展头部
    TypeXGlobalHeader = 'g'    // 全局扩展头
    TypeGNULongName   = 'L'    // Next file has a long name
    TypeGNULongLink   = 'K'    // Next file symlinks to a file w/ a long name
    TypeGNUSparse     = 'S'    // 稀疏文件
)

变量

var (
    ErrWriteTooLong    = errors.New("archive/tar: write too long") //写入数据太长
    ErrFieldTooLong    = errors.New("archive/tar: header field too long") //头部太长
    ErrWriteAfterClose = errors.New("archive/tar: write after close")  //关闭后写入
)

var (
    ErrHeader = errors.New("archive/tar: invalid tar header")  //无效tar 头部
)


type Header //该结构体代表了一个tar归档的头部,一些字段可能不被填充,Header中主要包含文件相关信息。

type Header struct {
   Name       string    // 文件名称
   Mode       int64     // 文件的权限和模式位
   Uid        int       // 文件所有者的用户 ID
   Gid        int       // 文件所有者的组 ID
   Size       int64     // 文件的字节长度
   ModTime    time.Time // 文件修改时间
   Typeflag   byte      // 文件的类型
   Linkname   string    // 链接文件的目标名称
   Uname      string    // 文件所有者的用户名
   Gname      string    // 文件所有者的组名
   Devmajor   int64     // 字符设备或块设备的主设备号
   Devminor   int64     // 字符设备或块设备的次设备号
   AccessTime time.Time // 文件的访问时间
   ChangeTime time.Time // 文件的状态更改时间
}

func FileInfoHeader(fi os.FileInfo,link string) (*Header,error)//该函数通过os.fileInfo便可创建一个Header,Header中大部分内容自动填充,一些内容需要自己设定。

func (h *Header) FileInfo() os.FileInfo //该函数获取该Header的os.FileInfo信息

举例说明Header用法

package main

import (
	"archive/tar"
	"fmt"
	"os"
)

func main() {
	fileinfo,err := os.Stat("/home/chenbaoke/test.go")
	if err != nil {
		fmt.Println(err)
	}
	h,err := tar.FileInfoHeader(fileinfo,"")
	h.Linkname = "haha"
	h.Gname = "test"
	if err != nil {
		fmt.Println(err)
	}
	fmt.Println(h.AccessTime,h.ChangeTime,h.Devmajor,h.Devminor,h.Gid,h.Gname,h.Linkname,h.ModTime,h.Mode,h.Name,h.Size,h.Typeflag,h.Uid,h.Uname,h.Xattrs)

}
输出结果如下:
2015-08-28 21:26:03.636592126 +0800 CST 2015-08-28 21:26:03.092592112 +0800 CST 0 0 1000 test haha 2015-08-28 21:26:03.092592112 +0800 CST 33206 test.go 581
48 1000 map[]

由此可见,通过fileinfoheader可以创建tar.header,并自动填写了tar.Header 中的大部分信息,当然,还有一些信息无法从 os.FileInfo 中获取,所以需要你自己去补充,
如Linkname,Gname等。



type Reader
type Reader struct {
 r io.Reader
 err error
 pad int64 //当前文件实体之后填充的
 curr numBytesReader //当前文件实体的reader
 hdrBuff [blockSize]byte // 读header中使用的buffer缓存
}<span style="font-size:12px;">
</span>


func NewReader(r io.Reader) *Reader// 从r中创建一个新的reader

func (tr *Reader) Next() (*Header,error)//该函数指向tar文件的下一个实体,在输入的最后返回io.EOF

func (tr *Reader) Read(b []byte) (n int,err error)//该函数读取在tar中当前实体,当读取到实体的结束位置时,返回io.EOF,当调用Next时,读取下一个实体。

解压缩包的方法,从 .tar 文件中读出数据是通过 tar.Reader 完成的,所以首先要创建 tar.Reader,可以通过 tar.NewReader 方法来创建它,该方法要求提供一个 os.Reader 对象,以便从该对象中读出数据。可以先打开一个 .tar 文件,然后将该文件提供给 tar.NewReader 使用。这样就可以将 .tar 文件中的数据读出来了:
举例说明其用法

package main

import (
	"archive/tar"
	"fmt"
	"io"
	"os"
)

func main() {
	f,err := os.Open("/home/chenbaoke/10.tar")
	if err != nil {
		fmt.Println(err)
		return
	}
	defer f.Close()
	r := tar.NewReader(f)
	for hdr,err := r.Next(); err != io.EOF; hdr,err = r.Next() {
		if err != nil {
			fmt.Println(err)
			return
		}
		fileinfo := hdr.FileInfo()
		fmt.Println(fileinfo.Name())
		f,err := os.Create("/home/chenbaoke/develop/" + fileinfo.Name())
		if err != nil {
			fmt.Println(err)
		}
		defer f.Close()
		_,err = io.Copy(f,r)
		if err != nil {
			fmt.Println(err)
		}
	}
}




type Writer

type Writer struct {
    		w          io.Writer
    		err        error
    		nb         int64 // 未写入的字节数
    		pad        int64 // 该实体之后需要写入的数量
    		closed     bool
    		usedBinary bool            // whether the binary numeric field extension was used
    		preferPax  bool            // use pax header instead of binary numeric header
    		hdrBuff    [blockSize]byte // buffer to use in writeHeader when writing a regular header
    		paxHdrBuff [blockSize]byte // buffer to use in writeHeader when writing a pax header
    	}

func NewWriter(w io.Writer) *Writer //创建一个新的writer,向w中写入。
func (tw *Writer) Close() error //关闭tar归档文件,并将未写入的数据写入底层writer。
func (tw *Writer) Flush() error //完成写当前文件
func (tw *Writer) Write(b []byte) (n int,err error)

func (tw *Writer) WriteHeader(hdr *Header) error//该函数将hdr写入tar文件中,如果hdr不是第一个header,该函数调用flush。在调用close之后在调用函数就会报错ErrWriteAfterClose。

举例说明如何写入一个tar文件

package main

import (
	"archive/tar"
	"fmt"
	"io"
	"os"
)

func main() {
	f,err := os.Create("/home/chenbaoke/10.tar")  //创建一个tar文件
	if err != nil {
		fmt.Println(err)
		return
	}
	defer f.Close()

	tw := tar.NewWriter(f)        
	defer tw.Close()

	fileinfo,err := os.Stat("/home/chenbaoke/1.go")  //获取文件相关信息
	if err != nil {
		fmt.Println(err)
	}
	hdr,"")
	if err != nil {
		fmt.Println(err)
	}

	err = tw.WriteHeader(hdr)    //写入头文件信息
	if err != nil {
		fmt.Println(err)
		// return
	}

	f1,err := os.Open("/home/chenbaoke/1.go")
	if err != nil {
		fmt.Println(err)
		return
	}
	m,err := io.Copy(tw,f1)   //将文件1.go中信息写入压缩包中
	if err != nil {
		fmt.Println(err)
		// return
	}
	fmt.Println(m)
}


参考:https://golang.org/pkg/archive/tar/

GoLove博客 http://www.cnblogs.com/golove/p/3454630.html

相关文章

程序目录结构 简单实现,用户登录后返回一个jwt的token,下次请求带上token请求用户信息接口并返回信息...
本篇博客的主要内容是用go写一个简单的Proof-of-Work共识机制,不涉及到网络通信环节,只是一个本地的简...
简介 默克尔树(MerkleTree)是一种典型的二叉树结构,其主要特点为: 最下面的叶节点包含存储数据或其...
接下来学习并发编程, 并发编程是go语言最有特色的地方, go对并发编程是原生支持. goroutine是go中最近本...
先普及一下, 什么是广度优先搜索 广度优先搜索类似于树的层次遍历。从图中的某一顶点出发,遍历每一个顶...
第一天: 接口的定义和实现 第二天: 一. go语言是面向接口编程. 在学习继承的时候说过, go语言只有封装,...