在項目開發中,除了對數據的展示更多的就是對文件的相關操作,例如文件的創建和刪除,以及文件的壓縮和解壓。文件壓縮的好處有很多,主要就是在文件傳輸的方面,文件壓縮的好處就不需要贅述,因為無論是開發者,還是使用者對于文件壓縮的好處都是深有體會。至于文件壓縮的原理,在我的另一篇博客中有簡單的介紹,在這里就不再做介紹,需要了解的可以查看。
.NET在System.IO.Compression命名空間中提供了GZip、Defalate兩種壓縮算法。今天我要介紹的一種壓縮組件是DotNetZip組件。
一.DotNetZip組件概述:
在DotNetZip的自我介紹中號稱是”DotNetZip是.NET最好的開源ZIP庫“,至于是不是最好的壓縮組件,在這里就不做評價,畢竟每個使用者的心態和工作環境不同,項目對組件的需求也不同,在選擇組件的時候,就需要開發者自己衡量了。估計很多人還沒有看到這里就開始在鍵盤上敲字吐槽了,標題是我借用官方對外的宣傳口號,不用太在意這些細節。
DotNetZip - Zip和解壓縮在C#,VB,任何.NET語言都可使用。DotNetZip是一個FAST,免費類庫和用于操縱zip文件的工具集。 使用VB,C#或任何.NET語言輕松創建,解壓縮或更新zip文件。DotNetZip在具有完整.NET Framework的PC上運行,并且還在使用.NET Compact Framework的移動設備上運行。在VB,C#或任何.NET語言或任何腳本環境中創建和讀取zip文件。
DotNetZip組件的使用環境,畢竟軟件的使用環境是每一個開發者都需要考慮的,這個世界沒有絕對的好事,當然也沒有絕對的壞事。接下來看一下其實用環境的說明吧:
1.一個動態創建zip文件的Silverlight應用程序。
2.一個ASP.NET應用程序,動態創建ZIP文件并允許瀏覽器下載它們。
3.一個Windows服務,定期地為了備份和歸檔目的上拉一個目錄。
4.修改現有歸檔的WPF程序 - 重命名條目,從歸檔中刪除條目或向歸檔中添加新條目。
5.一個Windows窗體應用程序,用于為歸檔內容的隱私創建AES加密的zip存檔。
6.解壓縮或拉鏈的SSIS腳本。
7.PowerShell或VBScript中的一個管理腳本,用于執行備份和歸檔。
8.WCF服務,接收作為附件的zip文件,并動態地將zip解壓縮到流以進行分析。
9.一個老式的ASP(VBScript)應用程序,通過COM接口為DotNetZIp生成一個ZIP文件。
10.讀取或更新ODS文件的Windows Forms應用程序。
11.從流內容創建zip文件,保存到流,提取到流,從流讀取。
12.創建自解壓檔案。
DotNetZip是一個100%的托管代碼庫,可用于任何.NET應用程序 - 控制臺,Winforms,WPF,ASP.NET,Sharepoint,Web服務應用程序等。 新的v1.9.1.6:Silverlight。 它還可以從腳本環境或具有COM功能的環境(如Powershell腳本,VBScript,VBA,VB6,PHP,Perl,Javascript等)中使用。 無論使用什么環境,DotNetZip生成的zip文件可與Windows資源管理器以及Java應用程序,在Linux上運行的應用程序完全互操作。
該組件設計簡單,易于使用。 DotNetZip打包為一個單一的DLL,大小約400k。 它沒有第三方依賴。 它是中等信任,因此可以在大多數托管商使用。 通過引用DLL來獲取壓縮。 該庫支持zip密碼,Unicode,ZIP64,流輸入和輸出,AES加密,多個壓縮級別,自解壓縮存檔,跨區存檔等。
以上的一些描述來自與官網,就不再吹捧這個組件了,在這里需要說明的是在組件的選擇和使用上,主要取決與項目的實際情況。詳情見:http://dotnetzip.codeplex.com/
二.DotNetZip相關核心類和方法解析:
由于下載的是DLL文件,還是采用.NET Reflector對DLL文件進行反編譯,以此查看源代碼。一下主要介紹一些類和方法,沒有完全介紹,首先是由于篇幅所限,其實是完全沒有必要,因為對于開發者而言,沒有必要全部了解這些類,在實際的開發中,可以根據API進行對應的方法調用,這些技能應該是一個開發人員應該具備的。
1.ZipFile類的AddEntry()、Save()和IsZipFile()方法:
1
2
3
4
5
6
7
8
9
|
public ZipEntry AddEntry( string entryName, WriteDelegate writer) { ZipEntry ze = ZipEntry.CreateForWriter(entryName, writer); if ( this .Verbose) { this .StatusMessageTextWriter.WriteLine( "adding {0}..." , entryName); } return this ._InternalAddEntry(ze); } |
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
|
public void Save() { try { bool flag = false ; this ._saveOperationCanceled = false ; this ._numberOfSegmentsForMostRecentSave = 0; this .OnSaveStarted(); if ( this .WriteStream == null ) { throw new BadStateException( "You haven't specified where to save the zip." ); } if ((( this ._name != null ) && this ._name.EndsWith( ".exe" )) && ! this ._SavingSfx) { throw new BadStateException( "You specified an EXE for a plain zip file." ); } if (! this ._contentsChanged) { this .OnSaveCompleted(); if ( this .Verbose) { this .StatusMessageTextWriter.WriteLine( "No save is necessary...." ); } } else { this .Reset( true ); if ( this .Verbose) { this .StatusMessageTextWriter.WriteLine( "saving...." ); } if (( this ._entries.Count >= 0xffff) && ( this ._zip64 == Zip64Option.Default)) { throw new ZipException( "The number of entries is 65535 or greater. Consider setting the UseZip64WhenSaving property on the ZipFile instance." ); } int current = 0; ICollection<ZipEntry> entries = this .SortEntriesBeforeSaving ? this .EntriesSorted : this .Entries; foreach (ZipEntry entry in entries) { this .OnSaveEntry(current, entry, true ); entry.Write( this .WriteStream); if ( this ._saveOperationCanceled) { break ; } current++; this .OnSaveEntry(current, entry, false ); if ( this ._saveOperationCanceled) { break ; } if (entry.IncludedInMostRecentSave) { flag |= entry.OutputUsedZip64.Value; } } if (! this ._saveOperationCanceled) { ZipSegmentedStream writeStream = this .WriteStream as ZipSegmentedStream; this ._numberOfSegmentsForMostRecentSave = (writeStream != null ) ? writeStream.CurrentSegment : 1; bool flag2 = ZipOutput.WriteCentralDirectoryStructure( this .WriteStream, entries, this ._numberOfSegmentsForMostRecentSave, this ._zip64, this .Comment, new ZipContainer( this )); this .OnSaveEvent(ZipProgressEventType.Saving_AfterSaveTempArchive); this ._hasBeenSaved = true ; this ._contentsChanged = false ; flag |= flag2; this ._OutputUsesZip64 = new bool ?(flag); if (( this ._name != null ) && (( this ._temporaryFileName != null ) || (writeStream != null ))) { this .WriteStream.Dispose(); if ( this ._saveOperationCanceled) { return ; } if ( this ._fileAlreadyExists && ( this ._readstream != null )) { this ._readstream.Close(); this ._readstream = null ; foreach (ZipEntry entry2 in entries) { ZipSegmentedStream stream2 = entry2._archiveStream as ZipSegmentedStream; if (stream2 != null ) { stream2.Dispose(); } entry2._archiveStream = null ; } } string path = null ; if (File.Exists( this ._name)) { path = this ._name + "." + Path.GetRandomFileName(); if (File.Exists(path)) { this .DeleteFileWithRetry(path); } File.Move( this ._name, path); } this .OnSaveEvent(ZipProgressEventType.Saving_BeforeRenameTempArchive); File.Move((writeStream != null ) ? writeStream.CurrentTempName : this ._temporaryFileName, this ._name); this .OnSaveEvent(ZipProgressEventType.Saving_AfterRenameTempArchive); if (path != null ) { try { if (File.Exists(path)) { File.Delete(path); } } catch { } } this ._fileAlreadyExists = true ; } NotifyEntriesSaveComplete(entries); this .OnSaveCompleted(); this ._JustSaved = true ; } } } finally { this .CleanupAfterSaveOperation(); } } |
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
|
public static bool IsZipFile(Stream stream, bool testExtract) { if (stream == null ) { throw new ArgumentNullException( "stream" ); } bool flag = false ; try { if (!stream.CanRead) { return false ; } Stream @ null = Stream.Null; using (ZipFile file = Read(stream, null , null , null )) { if (testExtract) { foreach (ZipEntry entry in file) { if (!entry.IsDirectory) { entry.Extract(@ null ); } } } } flag = true ; } catch (IOException) { } catch (ZipException) { } return flag; } |
2.Read()讀取數據流:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
|
private static ZipFile Read(Stream zipStream, TextWriter statusMessageWriter, Encoding encoding, EventHandler<ReadProgressEventArgs> readProgress) { if (zipStream == null ) { throw new ArgumentNullException( "zipStream" ); } ZipFile zf = new ZipFile { _StatusMessageTextWriter = statusMessageWriter, _alternateEncoding = encoding ?? DefaultEncoding, _alternateEncodingUsage = ZipOption.Always }; if (readProgress != null ) { zf.ReadProgress += readProgress; } zf._readstream = (zipStream.Position == 0L) ? zipStream : new OffsetStream(zipStream); zf._ReadStreamIsOurs = false ; if (zf.Verbose) { zf._StatusMessageTextWriter.WriteLine( "reading from stream..." ); } ReadIntoInstance(zf); return zf; } |
以上是對ZipFile類的一些方法的解析,提供了該組件的一些方法的源碼,至于源碼的解讀上難度不是很大,至于該組件的API,可以在下載DLL文件后,可以直接查看相應的方法和屬性,在這里就不做詳細的介紹。
三.DotNetZip組件使用實例:
以上是對該組件的一些解析,接下來我們看看實例:
1.壓縮ZIP文件:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
|
/// <summary> /// 壓縮ZIP文件 /// 支持多文件和多目錄,或是多文件和多目錄一起壓縮 /// </summary> /// <param name="list">待壓縮的文件或目錄集合</param> /// <param name="strZipName">壓縮后的文件名</param> /// <param name="isDirStruct">是否按目錄結構壓縮</param> /// <returns>成功:true/失敗:false</returns> public static bool CompressMulti(List< string > list, string strZipName, bool isDirStruct) { if (list == null ) { throw new ArgumentNullException( "list" ); } if ( string .IsNullOrEmpty(strZipName)) { throw new ArgumentNullException(strZipName); } try { //設置編碼,解決壓縮文件時中文亂碼 using (var zip = new ZipFile(Encoding.Default)) { foreach (var path in list) { //取目錄名稱 var fileName = Path.GetFileName(path); //如果是目錄 if (Directory.Exists(path)) { //按目錄結構壓縮 if (isDirStruct) { zip.AddDirectory(path, fileName); } else { //目錄下的文件都壓縮到Zip的根目錄 zip.AddDirectory(path); } } if (File.Exists(path)) { zip.AddFile(path); } } //壓縮 zip.Save(strZipName); return true ; } } catch (Exception ex) { throw new Exception(ex.Message); } } |
2.解壓ZIP文件:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
|
/// <summary> /// 解壓ZIP文件 /// </summary> /// <param name="strZipPath">待解壓的ZIP文件</param> /// <param name="strUnZipPath">解壓的目錄</param> /// <param name="overWrite">是否覆蓋</param> /// <returns>成功:true/失敗:false</returns> public static bool Decompression( string strZipPath, string strUnZipPath, bool overWrite) { if ( string .IsNullOrEmpty(strZipPath)) { throw new ArgumentNullException(strZipPath); } if ( string .IsNullOrEmpty(strUnZipPath)) { throw new ArgumentNullException(strUnZipPath); } try { var options = new ReadOptions { Encoding = Encoding.Default }; //設置編碼,解決解壓文件時中文亂碼 using (var zip = ZipFile.Read(strZipPath, options)) { foreach (var entry in zip) { if ( string .IsNullOrEmpty(strUnZipPath)) { strUnZipPath = strZipPath.Split( '.' ).First(); } entry.Extract(strUnZipPath,overWrite ? ExtractExistingFileAction.OverwriteSilently : ExtractExistingFileAction.DoNotOverwrite); } return true ; } } catch (Exception ex) { throw new Exception(ex.Message); } } |
3.得到指定的輸入流的ZIP壓縮流對象:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
|
/// <summary> /// 得到指定的輸入流的ZIP壓縮流對象 /// </summary> /// <param name="sourceStream">源數據流</param> /// <param name="entryName">實體名稱</param> /// <returns></returns> public static Stream ZipCompress(Stream sourceStream, string entryName = "zip" ) { if (sourceStream == null ) { throw new ArgumentNullException( "sourceStream" ); } var compressedStream = new MemoryStream(); long sourceOldPosition = 0; try { sourceOldPosition = sourceStream.Position; sourceStream.Position = 0; using (var zip = new ZipFile()) { zip.AddEntry(entryName, sourceStream); zip.Save(compressedStream); compressedStream.Position = 0; } } catch (Exception ex) { throw new Exception(ex.Message); } finally { try { sourceStream.Position = sourceOldPosition; } catch (Exception ex) { throw new Exception(ex.Message); } } return compressedStream; } |
4.得到指定的字節數組的ZIP解壓流對象:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
|
/// <summary> /// 得到指定的字節數組的ZIP解壓流對象 /// 當前方法僅適用于只有一個壓縮文件的壓縮包,即方法內只取壓縮包中的第一個壓縮文件 /// </summary> /// <param name="data"></param> /// <returns></returns> public static Stream ZipDecompress( byte [] data) { Stream decompressedStream = new MemoryStream(); if (data == null ) return decompressedStream; try { var dataStream = new MemoryStream(data); using (var zip = ZipFile.Read(dataStream)) { if (zip.Entries.Count > 0) { zip.Entries.First().Extract(decompressedStream); // Extract方法中會操作ms,后續使用時必須先將Stream位置歸零,否則會導致后續讀取不到任何數據 // 返回該Stream對象之前進行一次位置歸零動作 decompressedStream.Position = 0; } } } catch (Exception ex) { throw new Exception(ex.Message); } return decompressedStream; } |
四.總結:
以上是對DotNetZip組件的一些解析和方法實例,至于這款組件是不是最好的.NET壓縮組件,這個就不做評價。個人在選擇組件的時候,首先考慮的是開源,其次是免費,最后再考慮效率和實用性,畢竟在國內的一些情況是所有開發者都清楚的(不提國外是由于我不知道國外的情況)。客戶需要降低成本,并且組件要可以進行定制。不過個人認為收費應該是一種趨勢,畢竟所有的產品都是需要人員進行維護和開發。以上的博文中有不足之處,還望多多指正。
原文鏈接:http://www.cnblogs.com/pengze0902/p/6124659.html