Hi,大家好,我是姜友华,上一节我们新建好了工程,并将默认格式设置为人们定义的
.iw
格式,这一节我们将实现基于.iw
格式的读写。
当前工程是基于单文件格式的读写,跟我们的要求不符。前面说过,.iw
格式的设计是多文件的打包,类似于.epub
格式。对于这种格式的处理,macOS提供的FileWrapper
也可以实现,下面让我们来一步步的实现。
一、 修改配置。
将Imported Type Identifiers
里的Conforms To
改为com.apple.package
,须便将Exported Type Identifiers
也设置了。
- 如果不设置
Conforms To
为com.apple.package
的话,那保存下来的文件会以文件夹方式存在。
二、修改读写代码。
1. 读。
在这之前writerDocument.swift
文件里,读只需要从FileWrapper
里获取数据转为需要的内容即可。这里面的configuration.file
是一个FileWrapper
对象。现在我们要用它来实现.iw
的基于包的读取。
init(configuration: ReadConfiguration) throws {
guard let wrappers = configuration.file.fileWrappers,
let file = wrappers["main.txt"],
let data = file.regularFileContents,
let string = String(data: data, encoding: .utf8)
else {
throw CocoaError(.fileReadCorruptFile)
}
text = string
}
-
FileWrapper
都有一个fileWrappers属性,该属性可以基于map
读取(设置肯定要与之对应)。
2. 写。
在这之前writerDocument.swift
文件里,写只用把内容转为Data添加到FileWrapper
后返回即可。现在可以用map进行多层组管理,处理好后返回最顶一级即可。
func fileWrapper(configuration: WriteConfiguration) throws -> FileWrapper {
let rootDirectory = FileWrapper(directoryWithFileWrappers: [:])
let data = text.data(using: .utf8)!
let wrapper = FileWrapper(regularFileWithContents: data)
wrapper.filename = "main.txt"
wrapper.preferredFilename = "main.txt"
rootDirectory.addFileWrapper(wrapper)
return rootDirectory
}
3. 运行一下看看。
-
保存,再去打开,可以如下情形。
保存后,再准备打开 -
在
Untitled.iw包里文件Finder
里看看。
选择Untitled.iw
,右键菜单Show Package Contents
,情形如下:
一个独立的main.txt
文件在那里,这是我们在代码里设置的文件名。
三、iWriter的文件读写。
这是我们前面设计的UI:
iWriter UI在这里我们需要将每部分的数据读取作进一步的说明。我们实施的是
各自读写
原则。
1. 各自读写原则
什么是各自读写呢?
- 区块在自身加载时去读文件。
- 区块在失去焦点时去写文件。
- 区块在自身卸载时清除内容数据。
2. 各区块的数据加载。
- 目录,加载“catalog.json”文件。
- 章节区,复用“catalog.json”文件数据,按当前章节的展开状态为是加载章节文件。章节数据为
章节创建时间戳_版本创建时间戳.txt
- 辅助功能区,按约定加载对应用的
json
文件。如大纲加载outline.json
文件。
基于我们的设置,我们需要在document与UI之间添加一个中间层,用来处理文件读取,这里我们使用了一个Filer
类。
好,就到这里,我是姜友华,一次见。
网友评论