本文是关于Ogre引擎中的文件部分,该部分相关的头文件有
OgreArchive.h
OgreArchiveFactory.h
OgreArchiveManager.h
OgreFileSystem.h
OgreZip.h
这里所指文件的英文名为Archive,可以理解为文件、文件夹等广义上的文件容器。
在代码设计中,Archive是一个文件抽象类。
UML图如下:
(1)Archive
这个类就是一个定义接口的抽象类。
该类只有三个成员变量,也都很好理解。
[cpp] view plain copy print ?
-
- String mName;
-
- String mType;
-
- bool mReadOnly;
[cpp] view plain copy print ?
-
- String mName;
-
- String mType;
-
- bool mReadOnly;
/// Archive name String mName; /// Archive type code String mType; /// Read-only flag bool mReadOnly;
成员函数部分,定义不少纯虚函数,主要需要子类实现的是文件的load、unload、open、remove基本操作。
(2)ArchiveFactory
该类直接继承了Ogre中实现工厂的模板类FactoryObj<T>,没有任何内容的添加,只是继承实现了Archive的工厂模式。
(3)ArchiveManager
顾名思义,这个类的作用是负责管理Archive与Archive工厂。相应的数据结构如下:
[cpp] view plain copy print ?
- typedef map<String, ArchiveFactory*>::type ArchiveFactoryMap;
-
- ArchiveFactoryMap mArchFactories;
-
-
- typedef map<String, Archive*>::type ArchiveMap;
- ArchiveMap mArchives;
[cpp] view plain copy print ?
- typedef map<String, ArchiveFactory*>::type ArchiveFactoryMap;
-
- ArchiveFactoryMap mArchFactories;
-
-
- typedef map<String, Archive*>::type ArchiveMap;
- ArchiveMap mArchives;
typedef map<String, ArchiveFactory*>::type ArchiveFactoryMap; /// Factories available to create archives, indexed by archive type ArchiveFactoryMap mArchFactories; /// Currently loaded archives typedef map<String, Archive*>::type ArchiveMap; ArchiveMap mArchives;
两个Map,一个管理已经导入的Archive,另一个管理工厂。
每种工厂类型对应不同Archive的子类。在Ogre中主要有两种类型文件,通过UML图可以看到,一类是ZipArchive,还有一类是FileSystemArchive。稍后会简单介绍下这两个类的细节。
在ArchiveManager中,最重要的是实现load和unload函数。
[cpp] view plain copy print ?
- Archive* load( const String& filename, const String& archiveType);
- void unload(Archive* arch);
- void unload(const String& filename);
[cpp] view plain copy print ?
- Archive* load( const String& filename, const String& archiveType);
- void unload(Archive* arch);
- void unload(const String& filename);
Archive* load( const String& filename, const String& archiveType); void unload(Archive* arch); void unload(const String& filename);
Load函数大致如下(省略部分检验代码)
[cpp] view plain copy print ?
- ArchiveFactoryMap::iterator it = mArchFactories.find(archiveType);
- pArch = it->second->createInstance(filename);
- pArch->load();
- mArchives[filename] = pArch;
[cpp] view plain copy print ?
- ArchiveFactoryMap::iterator it = mArchFactories.find(archiveType);
- pArch = it->second->createInstance(filename);
- pArch->load();
- mArchives[filename] = pArch;
ArchiveFactoryMap::iterator it = mArchFactories.find(archiveType); pArch = it->second->createInstance(filename); pArch->load(); mArchives[filename] = pArch;
可以看出load的操作流程大致如下:
- 获取该Archive类型的工厂实例
- 通过工厂创建相应的Archive
- 使用创建出来的Archive进行资源的load
- 将该Archive进行保存以便管理
unload操作流程和上述操作基本一致。
另外ArchiveManager也提供了ArchiveMap的迭代器,方便遍历所有已经导入的Archive。
(4)ZipArchive / FileSystemArchive
这两个类是Archive的子类,实现了抽象类Archive中定义的所有接口。这也代表Ogre所定义两种文件类型:压缩文件和一般文件。文件的读取最终都是以数据流的形式保存在内存中,数据流的类型是DataStream。当然也可以根据自己的文件特点,编写自己的DataStream,如ZipArchive就定义了自己的数据流ZipDataStream。
ZipArchive类主要依赖了第三方类库zzip,这个类的接口在实现的形式上可以理解成是设计模式的Adapter,将zzip的函数调用封装成了Archive的形式。该类通过调用zzip的接口完成zip压缩文件的读取,最终转换成ZipDataStream。压缩文件主要用于图形资源文件。
FileSystemArchive则直接将文件通过fstream读入,是基本的C++的文件操作方法。