在Symbian OS中读取ZIP文件

[ 原著：Antony Pranata  ]
[译:Beover1984 ]

如今最普遍的压缩文件格式就要算ZIP了，它最开始是Phil Katz借鉴ARC格式创建的。Symbian OS提供了一个名为CzipFile的类来读取ZIP文件，它从Symbian 7.X开始被支持。这篇文章将告诉你如何使用CzipFile并给出一个例子。你可以在Series 60 2.x or UIQ 2.x环境下编译，运行这个例子。
虽然SDK文档中有CzipFile的介绍，但还是远远不够的，并且没有例子告诉你如何使用它，这也是我写这篇文章的原因。希望它对你有所帮助。
一、读取ZIP文件
我们以一种简单的情况开始：打开ZIP文件并显示其内部所有文件的信息。首先，我们需要创建一个新的CzipFile 实例。下面是你可以使用的已封装好的两阶段构造函数：

CZipFile* zipFile = CZipFile::NewL(fileSession, aCompressedFile);
CleanupStack::PushL(zipFile);

构造函数的第一个参数是文件服务器的会话，第二个参数是ZIP文件的名字。
下面，我们要得到ZIP文件的迭代器（iterator）来遍历其中的文件，可以通过调用CZipFile::GetMembersL()实现，它返回一个CzipFileMemberIterator类的实例。

CZipFileMemberIterator* members = zipFile->GetMembersL();
CleanupStack::PushL(members);

注意member的所有权已传递到调用者，因此我们在使用完之后需要删除它。
现在，我们怎么得到每一个文件的实例呢？可以调用CZipFileMemberIterator::NextL()进行遍历直到它返回0为止（返回0意为着没有文件了）。看下面的代码：

CZipFileMember* member;
while ((member = members->NextL()) != 0)
{
console->Printf(
KInfoMessage,
member->Name(),
member->CompressedSize(), member->UncompressedSize()); 

delete member;

}

上面的代码打印了ZIP文件中所有文件的名字，压缩后的大小和未压缩的大小。再次注意我们需要删除member，因为我们已经是它的拥有者了。
最后，别忘了释放我们分配的任何资源：

CleanupStack::PopAndDestroy(); // members
CleanupStack::PopAndDestroy(); // zipFile

如果我们有一个含有3个文件的ZIP文件，例如：Example.txt, Example.dat and Example.png。程序的输出就像下面这样（你可以在文章的最后下载这个例子）：

Example.txt - 11 - 11
Example.dat - 15 - 180
Example.png - 4393 – 4393

二、从ZIP文件中提取文件
这段将展示如何从ZIP文件中提取文件。和前面的例子一样，第一步需要创建CzipFile的实例：

CZipFile* zipFile = CZipFile::NewL(fileSession, aCompressedFile);
CleanupStack::PushL(zipFile);

这里我们不再需要一个迭代器，因为我们对一个指定的文件感兴趣，需要调用的方法是CZipFile::CaseInsensitiveMemberL()。这个方法需要一个你想访问文件的名字做为参数：

CZipFileMember* member = zipFile->CaseInsensitiveMemberL(aFileName);
CleanupStack::PushL(member);

下面这步将得到输入流并使用Read()方法提取文件，ZIP文件中的文件输入流使用RzipFileMemberReaderStream类，得到输入流的方法是调用CZipFile::GetInputStreamL()：

RZipFileMemberReaderStream* stream;
zipFile->GetInputStreamL(member, stream);
CleanupStack::PushL(stream);

下面的代码展示如何读取文件，在读文件之前，代码分配了一个文件未压缩大小的buffer（member->UncompressesedSize() ）用来存储文件。

HBufC8* buffer = HBufC8::NewLC(member->UncompressedSize());
TPtr8 bufferPtr(buffer->Des());
User::LeaveIfError(stream->Read(bufferPtr, member->UncompressedSize()));

如果你的文件很大，不要像上面那样通过一次Read()读取所有数据，它会阻塞你的程序。可以通过一个活动对象一块块的读取数据代替上面的方法。例子中使用一次Read()只是为了演示的简单性。
现在我们把文件读到了一个buffer中，你可以立刻使用它，或者选择以文件的形式保存。下面的代码把它保存到文件：

RFile file;
User::LeaveIfError(file.Replace(fileSession, fileName, EFileWrite));
CleanupClosePushL(file);
User::LeaveIfError(file.Write(*buffer));
fileSession.Close();

最后，别忘了释放所有分配的资源：

CleanupStack::PopAndDestroy(5); // file, buffer, stream, member, zipFile

三、例子
例子完成两件事：
1． 显示Example.zip文件中所有的文件的信息。它在IteratorExampleL()函数中实现。
2． 从Example.zip中提取Example.txt并保存到设备的c:\data\Example.txt。它在ExtractionExampleL()函数中实现。

下载地址：