IO子系統

Nebula3的IO系統相對于Nebula1和2是一個巨大的進步, 新系統的主要設計目標有:

• 使用更標準的機制, 如用URI來定位資源, 用MIME類型來區分數據格式
• 一個靈活的流模型, 它不關心數據是來自文件, 內存, HTTP連接還是其它地方
• 從流讀寫不數據的數據類型也更方便, 例如要讀取的XML格式數據來自文件/內存/網絡都沒問題
• 另外, 新的流和讀寫類可以在運行時注冊到IO系統中
• 相對于系統平臺的特定IO函數, 像fopen()這樣的C Lib函數會有額外的性能或內存損失. 所以在保證可移植性的前提下不損失性能, 必須使用特定平臺的IO函數

IO子系統的一些主要概念:

• 一個中樞的IO::Console 對象連接控制臺處理器(console handler)來進行文本的輸入和輸出. 這保證了所有的Nebula3的文本輸出都通過一個集中的進出通道. 特定的控制臺處理器可以用特定的方式處理文本輸出(例如輸出到stdout, 游戲控制臺, 日志文件或網絡連接).
• 重定向符做為路徑別名. 大體的功能跟Nebula1和2差不多, 除了從AmigaOS 的重定向符得到的靈感. Nebula3重定向符的一個新特性就是它們可以做為URI的別名. 例如, 重定向符”textures:”可以定義為 "http://www.radonlabs.de/textures", 這樣簡化的資源路徑"textures:mytexture.dds"就會解釋成這個絕對路徑: "http://www.radonlabs.de/textures/mytexture.dds" (太NB了, 把紋理放到網站上加載? 哈哈, 拿來做內置廣告肯定很爽)
• 流(Stream)做為基本的數據進出通道. 它提供了基本的API函數 Open()/Close()/Read()/Write(), 但是可能完全隱藏了傳輸和存儲通道. 典型的例子有IO::FileStream, IO::MemoryStream, 或 Net::HttpStream
• Stream reader 和 writer 是連接到流上并且實現了簡單易用的接口來讀寫數據格式. 例如你可以把IO::XmlReader連接到IO::FileStream來從文件系統讀取XML格式的數據, 或者連接到IO::HttpStream來從HTTP連接讀取XML格式的數據.

這里有個很好的代碼例子可以反映出Nebula3輸入輸出系統的強大:

1: IO::FileServer::Instance()->CopyFile("http://www.radonlabs.de/index.html", "temp:index.html");

這一行代碼從HTTP服務器拷貝了一個文件到當用戶的臨時目錄里去. 再多加幾行代碼, 你可以創建一個流對象指向HTTP服務器上的HTML文件, 連接一個XML reader到這個流上, 然后就可以在不存儲中間文件的基礎上進行解析HTML了.

標準重定向符

Nebula3初始化了以下幾個重定向符:

• home: 指向應用程序目錄, 一般在” C:\Program Files “下. Nebula3把這個目錄當成只讀的, 為的是不需要管理員權限就能運行.
• user: 這個指向當前登錄的用戶目錄, 一般是指” C:\Documents and Settings\[username] “. Nebula3會自動創建一個本地目錄來避免不同程序覆寫掉它們的數據. 所以說一般情況下把數據寫入用戶目錄是安全的. 這個地方可以用于保存游戲數據和配置, 或者程序需要調用的持久性數據.
• temp: 這個指向當前用戶的臨時目錄, 一般是可寫的, 但是不要假設下一次啟動程序時數據還存在.
• bin: 這個指向應用程序可執行文件的目錄. 它可以跟home相同, 也可能不同. 這個目錄應該也當成是只讀的來對待.

其它重定向符可以在程序運行時進行定義. 通常情況下會定義一些抽象資源路徑, 如textuers, sound, data等等. 這樣的話資源的路徑就可以只更改重定向符的定義而是不是去替換所有的路徑. 重定向符的另一個好處就是減少了路徑字符串的長度, 在一定程序上節省了內存占用.

URI(統一資源定位符)

在Nebula3中的資源位置通常都是用URI定義的. URI一般包括下面這幾部, 有一些是可選的:

• 模式(協議?), 如"http:", "file:", 等... Nebula3 沒有硬編碼任何模式, 而跟流類綁定在一起注冊到IO::StreamServer 單件
• 一個可選的用戶信息字段, 這是一個用戶名和密碼用于HTTP或FTP主機的身份驗證
• 一個主機名, 如"www.radonlabs.de"
• 一個在主機名后可選的端口號
• 一個本地路徑, 指向主機上的一個資源
• 一個可選的片段, 通常指向資源內部的一個位置
• 一個可選的查詢部分, 一般包含一個PHP腳本或其它相似的動態響應機制的參數

IO::URI類用來傳遞URI并且解析URI字符串到它的各個部分中. 值得注意的是URI對象比字符串占用更多的內存, 所以有時把URI保存在字符串中, 并在需要分割的時候才使用IO::URI類會更好一些.

這里有一些URI的例子:

1: file:///c:/temp/bla.txt

2: file://samba/temp/bla.txt

3: http://www.radonlabs.de/index.html

4: http://user:password@www.myserver.com:8080/index.html#main

通過使用重定位符會大大簡化路徑名稱. 要引用一個程序目錄的文件你可以使用”home:bla.txt”, 等價于file:///c:/Program Files/[myapp]/bla.txt.

Stream, Reader 和 Writer

流(Stream)提供了用于儲存和傳輸原始數據的接口. 一個流對象提供了傳統的Open()/Close()/Read()/Write()/Seek()接口, 其中有些還提供內存映射, 這樣數據的讀寫可以直接通過內存訪問來實現. Stream對象用一個IO::URI對象來定義它們的資源位置. 通常情況下, 一個URI格式映射到一個特定的流對象. 例如”http:”URI格式一般映射到Net::HttpStream類, 而”file:”格式則映射到IO:FileStream類. 這個映射由StreamServer構造一個流對象并匹配一個URI. 一個Nebula3應用程序通過StreamServer::Register()方法來注冊這個映射關系, 這也是新的流對象和URI格式的注冊方法.

讓我們來看看有哪些重要的類:

• IO::FileStream: 提供了訪問主機文件系統的功能
• IO::MemoryStream: 一個具有流接口的動態內存緩沖
• IO::HttpStream: 提供了一個流接口來訪問HTTP服務器文件

Stream reader和writer類提供了一些舒適的接口專門處理特定的數據格式. 這里有一些stream reader和writer:

• IO::BinaryReader/IOBinaryWriter: 讀寫二進制數據
• IO::TextReader/IOTextWriter: 讀寫文本數據
• IO::XmlReader/IOXmlWriter: 讀寫XML格式的數據
• Messaging::MessageReader/MessagingMessageWriter: 消息序列化

這里有一個用XmlReader從HTTP服務器訪問文件的簡單例子

1:     using namespace IO;

2:

3:     Ptr<Stream> stream = StreamServer::Instance()->CreateStream("http://www.radonlabs.de/index.html");

4:     Ptr<XmlReader> xmlReader = XmlReader::Create();

5:     xmlReader->SetStream(stream);

6: if (xmlReader->Open())

7: {

8: // parse content here using the XmlReader interface

9: }

File Server(文件服務器)

Nebula3 IO::FileServer類提供了一個單件用于訪問主機的文件系統進行一些全局操作, 像定義重定向符, 復制, 刪除和檢查文件是否存在, 列出目錄內容, 等等.

這個代碼片斷介紹FileServer的一些有用的方法:

using namespace IO;

using namespace Util;

FileServer* fs = FileServer::Instance();

// check if a file or directory exists

bool fileExists = fs->FileExists("home:bla.txt");

bool dirExists = fs->DirectoryExists("temp:bla/blub");

// resolve a path with assigns into an absolute filesystem

// path, this is sometimes necessary to interface with

// 3rd party libraries which don't understand Nebula3 paths directly

String absPath = fs->ResolveAssings("user:myapp/savegames");

// create a directory, note that all missing subdirectories will

// be created as well

fs->CreateDirectory("user:myapp/savegames");

// copy and delete files

fs->CopyFile("home:movie.mpg", "temp:movie.mpg");

fs->DeleteFile("temp:movie.mpg");

// list files in a directory matching a pattern

Array<String> files = fs->ListFiles("temp:", "*.txt");

// list all subdirectories in temp:

Array<String> dirs = fs->ListDirectories("temp:", "*");

控制臺

一般不直接調用IO::Console, 直接n_printf(), n_error(), n_dbgout(), n_warning()@_@