三、iWriter 文件的新建与保存

Hi,大家好,我是姜友华,上一节我们新建好了工程,并将默认格式设置为人们定义的.iw格式,这一节我们将实现基于.iw格式的读写。

当前工程是基于单文件格式的读写,跟我们的要求不符。前面说过,.iw格式的设计是多文件的打包,类似于.epub格式。对于这种格式的处理,macOS提供的FileWrapper也可以实现,下面让我们来一步步的实现。

一、 修改配置。

Imported Type Identifiers里的Conforms To改为com.apple.package,须便将Exported Type Identifiers也设置了。

  • 如果不设置Conforms Tocom.apple.package的话,那保存下来的文件会以文件夹方式存在。
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. 运行一下看看。

  • 保存,再去打开,可以如下情形。


    保存后,再准备打开
  • Finder里看看。
    选择Untitled.iw,右键菜单Show Package Contents,情形如下:

    Untitled.iw包里文件

    一个独立的main.txt文件在那里,这是我们在代码里设置的文件名。

三、iWriter的文件读写。

这是我们前面设计的UI:

iWriter UI

在这里我们需要将每部分的数据读取作进一步的说明。我们实施的是各自读写原则。

1. 各自读写原则

什么是各自读写呢?

  1. 区块在自身加载时去读文件。
  2. 区块在失去焦点时去写文件。
  3. 区块在自身卸载时清除内容数据。

2. 各区块的数据加载。

  1. 目录,加载“catalog.json”文件。
  2. 章节区,复用“catalog.json”文件数据,按当前章节的展开状态为是加载章节文件。章节数据为章节创建时间戳_版本创建时间戳.txt
  3. 辅助功能区,按约定加载对应用的json文件。如大纲加载outline.json文件。

基于我们的设置,我们需要在document与UI之间添加一个中间层,用来处理文件读取,这里我们使用了一个Filer类。

好,就到这里,我是姜友华,一次见。

你可能感兴趣的:(三、iWriter 文件的新建与保存)