用Windows的文件映射机制，实现大批量数据的快速存储

上次做的 电子相册软件 ，为了解决大文件读取速度慢的问题，使用了Windows下的文件映射功能，使文件读取效率顿时得到了大幅度提升。（具体见： 一个读取速度超快的FileStream！ ）

    最近在做的一款软件，又使用到了这个函数，不过这次的要求是这样的： 

    系统的主程序会持续的从网络端口上接收数据，这些数据需要变为实时的图像显示，但是同时图像显示部分又需要有回顾功能，也就是说能够任意将历史的数据调出来显示，为此就必须将所有历史数据保存下来，同时在需要的时候又能够快速从历史数据的指定位置将数据读出来。 

    针对此，有两种方案： 
    1）在主程序所在的机器接收数据前，使用另一台电脑，配合一个转发数据的程序，来达到数据的截取功能，由这个转发数据的程序将所有数据存储下来，并在主程序需要使用时，再用网络发送给主程序。 
    2）使用主程序来进行数据存储，提高主程序存储数据的性能。 

    不管采用何种方案，最终的瓶颈都将是大数据量的快速保存。由于整个系统内存使用和速度上的要求都很高，因此不可能将这样的数据放在程序内存里，也不可能使用普通的文件方式来记录数据。最终看来只有求助于Windows的文件映射功能了，它的优点是不会将要操作的文件读入内存，而是直接在系统层对文件进行读写，因此省去了文件的复制过程，特别是在读写大文件时，它能带来的速度提升是非常显著的。这样就可以将文件当作大内存来用了。 

    新的程序写完，才发现原来以前用Delphi实现的那个版本根本不能够访问大文件，只是在读取文件速度上有些优势而已，因为我过去的做法是在CreateFileMapping()之后，将整个文件的内存都MapViewOfFile()到程序内存里，这样文件一大，程序仍然无法打开文件。现在才知道，MapViewOfFile()函数是可以指定从文件的哪个部分进行Map，同时Map多少进入内存的。对于真正的大文件（几个G的）的访问，因该是一块一块的Map，然后进行读写。同时Map的起始地址和Map的内存大小都必须是64K的整数倍，不然MapViewOfFile()函数会失败。 

    最初的一个简单的程序版本花了1个小时不到就写完了，但是一测试却发现有个严重的问题：没有考虑数据在Map内存的边界上时的问题。当要读写的数据正好在Map的内存的边界上时，从当前Map的内存中就只能取到数据的前半部分，另一部分的数据必须Map文件的下一块地址才可能取到。因此对程序又进行了彻底的改造，让其能够在读取一个Map内存发现不够时，自动打开下一个Map内存。

总算大功告成，写了一个简单的测试程序对其进行测试，速度和正确性都都非常理想。
最后，贴上程序代码：

#ifndef enstfilecache_h

#define enstfilecache_h

#include <QtCore/QVariant>
#include <QtCore/QObject>

#include <windows.h>

#include "../enstdefine.h"

/*! \brief sampler::enstFileCache
\author tony (http://www.tonixsoft.com)
\version 0.08
\date 2006.05.10

基于文件镜像的快速大容量数据存储类。该类使用Windows下的 CreateFileMapping() 函数实现，不支持其它系统。\n
该类中的文件镜像原理可以参考：http://www.juntuan.net/hkbc/winbc/n/2006-04-19/14320.html \n
当要读取或写入的数据跨多个MapView的时候，该类会自动处理MapView的切换。
*/
class enstFileCache : public QObject
{
Q_OBJECT

public:
/*!
construct the class.
*/
enstFileCache();

/*!
destruct the class.
*/
~enstFileCache();

/*!
打开镜像文件。
@return 当打开镜像文件失败时返回false，比如磁盘空间不够。
*/
bool CreateFileCache(const QString &pFileName);

/*!
向镜像文件中追加数据。
*/
bool AppendData(T_INT8* pData, int pDataLength);

/*!
从镜像文件的指定位置读取数据。
*/
bool ReadData(T_INT64 pAddressOffset, T_INT8* pData, int pDataLength);

protected:
void DumpWindowsErrorMessage();

private:
T_INT64 mMappingViewSize;

HANDLE mFileHandle;

HANDLE mMappingHandle;

T_INT64 mWriteMappingOffset;

LPVOID mWriteBuffer;

T_INT64 mWriteBufferOffset;

T_INT64 mReadMappingOffset;

LPVOID mReadBuffer;
};

#endif //enstfilecache_h

=====================================================

#include "enstfilecache.h"

#include "../enstsvcpack.h"

//#define FILE_CACHE_SIZE 0x40000000 /* = 1GB */
#define FILE_CACHE_SIZE 0x01E00000 /* = 30MB */

enstFileCache::enstFileCache()
{
mMappingViewSize = 1024*(64*1024); //window's default block size is 64KB

mFileHandle = INVALID_HANDLE_VALUE;
mMappingHandle = NULL;
mWriteMappingOffset = 0;
mWriteBuffer = NULL;
mWriteBufferOffset = 0;
mReadMappingOffset = 0;
mReadBuffer = NULL;
}

enstFileCache::~enstFileCache()
{
if (mWriteBuffer != NULL) {
UnmapViewOfFile(mWriteBuffer);
}
if (mReadBuffer != NULL) {
UnmapViewOfFile(mReadBuffer);
}
if (mMappingHandle != NULL) {
CloseHandle(mMappingHandle);
}
if (mFileHandle != INVALID_HANDLE_VALUE) {
CloseHandle(mFileHandle);
}
}

bool enstFileCache::CreateFileCache(const QString &pFileName)
{
enstLogService *logservice = enstLogService::GetMyAddr();

mFileHandle = CreateFile(pFileName.toAscii(), GENERIC_READ | GENERIC_WRITE, FILE_SHARE_READ, NULL, OPEN_ALWAYS, FILE_ATTRIBUTE_NORMAL, 0);
if (mFileHandle == INVALID_HANDLE_VALUE) {
DumpWindowsErrorMessage();
logservice->AppendLog(this, "Error when create file.");
return false;
}
mMappingHandle = CreateFileMapping(mFileHandle, NULL, PAGE_READWRITE, (DWORD)(FILE_CACHE_SIZE>>32), (DWORD)(FILE_CACHE_SIZE & 0xFFFFFFFF), NULL);
if (mMappingHandle == NULL) {
if (GetLastError() == 112) {
logservice->AppendLog(this, "Looks like it's not enough space on the disk.");
}
DumpWindowsErrorMessage();
logservice->AppendLog(this, "Error when create file mapping.");
return false;
}
mWriteMappingOffset = 0;
mWriteBuffer = NULL;
mWriteBufferOffset = 0;
mReadMappingOffset = 0;
mReadBuffer = NULL;
return true;
}

bool enstFileCache::AppendData(T_INT8* pData, int pDataLength)
{
int datawrote = 0;
do {
int datacanwrite = mMappingViewSize - mWriteBufferOffset;
if (mWriteBuffer && datacanwrite <= 0) {
UnmapViewOfFile(mWriteBuffer);
mWriteBuffer = NULL;
mWriteMappingOffset += mMappingViewSize;
}
if (mWriteBuffer == NULL) {
mWriteBuffer = MapViewOfFile(mMappingHandle, FILE_MAP_WRITE, (DWORD)(mWriteMappingOffset>>32), (DWORD)(mWriteMappingOffset & 0xFFFFFFFF), mMappingViewSize);
mWriteBufferOffset = 0;
datacanwrite = mMappingViewSize - mWriteBufferOffset;
if (! mWriteBuffer) {
DumpWindowsErrorMessage();
enstLogService *logservice = enstLogService::GetMyAddr();
logservice->AppendLog(this, "Error when map view of file.");
return false;
}
}
int datatowrite = pDataLength - datawrote;
int actualdatatowrite = (datacanwrite >= datatowrite)?datatowrite:datacanwrite;
memcpy((PBYTE)mWriteBuffer+mWriteBufferOffset, (PBYTE)pData+datawrote, actualdatatowrite);
mWriteBufferOffset += actualdatatowrite;
datawrote += actualdatatowrite;
} while (datawrote < pDataLength);
return true;
}

bool enstFileCache::ReadData(T_INT64 pAddressOffset, T_INT8* pData, int pDataLength)
{
int datareaded = 0;
do {
int datacanread = mReadMappingOffset + mMappingViewSize - pAddressOffset - datareaded;
if (mReadBuffer && (datacanread <= 0 || datacanread > mMappingViewSize)) {
UnmapViewOfFile(mReadBuffer);
mReadBuffer = NULL;
}
if (mReadBuffer == NULL) {
mReadMappingOffset = (pAddressOffset + datareaded) / mMappingViewSize * mMappingViewSize;
mReadBuffer = MapViewOfFile(mMappingHandle, FILE_MAP_READ, (DWORD)(mReadMappingOffset>>32), (DWORD)(mReadMappingOffset & 0xFFFFFFFF), mMappingViewSize);
datacanread = mReadMappingOffset + mMappingViewSize - pAddressOffset - datareaded;
if (! mReadBuffer) {
DumpWindowsErrorMessage();
enstLogService *logservice = enstLogService::GetMyAddr();
logservice->AppendLog(this, "Error when map view of file.");
return false;
}
}
int datatoread = pDataLength - datareaded;
int actualdatatoread = (datacanread >= datatoread)?datatoread:datacanread;
memcpy((PBYTE)pData+datareaded, (PBYTE)mReadBuffer+pAddressOffset-mReadMappingOffset+datareaded, actualdatatoread);
datareaded += actualdatatoread;
} while (datareaded < pDataLength);
return true;
}

void enstFileCache::DumpWindowsErrorMessage()
{
LPVOID lpMsgBuf;
DWORD dw = GetLastError();
FormatMessage(
FORMAT_MESSAGE_ALLOCATE_BUFFER |
FORMAT_MESSAGE_FROM_SYSTEM,
NULL,
dw,
MAKELANGID(LANG_NEUTRAL, SUBLANG_DEFAULT),
(LPTSTR) &lpMsgBuf,
0, NULL );
enstLogService *logservice = enstLogService::GetMyAddr();
logservice->AppendLog(this, (LPTSTR)lpMsgBuf);
//puts((LPTSTR)lpMsgBuf);

LocalFree(lpMsgBuf);
}

#ifdef WIN32
#include "moc_enstfilecache.cpp"
#endif

由于系统是用QT开发的，因此类中使用了不少QT的类，同时也使用了系统中的部分工具类，不过基本工作原理相信你是能够看懂的。另外，整个系统是计划要跨平台使用的，因此今后还需要实现Linux下的类似功能，目前这个版本被绑定在Windows平台上了，不幸。