PyObj-C使用NSDocument报错：readFromData:ofType:error:未重写

错误原因 #

NSDocument是Cocoa中的抽象基类，它并不支持直接实例化。框架要求所有子类必须实现一组核心方法来处理文档的读写逻辑，readFromData:ofType:error:就是其中的强制实现项。你直接调用NSDocument.alloc().initWithContentsOfURL_ofType_error_时，框架检测到缺少这部分关键实现，就触发了NSInternalInconsistencyException断言错误，提示你没有完成子类该承担的实现责任。

解决方案 #

你必须创建NSDocument的子类，并重写以下强制要求的方法：

• readFromData_ofType_error_：负责从文件数据中加载内容到文档对象
• writeToURL_ofType_error_：负责将文档内容写入指定文件路径

完整代码实现 #

import objc
from Foundation import NSDocument, NSURL, NSData

# 创建NSDocument的自定义子类
class MyTextDocument(NSDocument):
    def init(self):
        self = super().init()
        if self is None:
            return None
        # 初始化存储文档内容的属性，可根据需求调整类型
        self.documentContent = ""
        return self

    # 必须重写：从NSData读取内容到文档
    def readFromData_ofType_error_(self, data, typeName, errorPtr):
        try:
            # 将NSData转换为Python字符串，编码格式根据文件类型调整
            self.documentContent = data.bytes().decode('utf-8')
            return True
        except Exception as e:
            # 读取失败时可设置错误信息（可选）
            if errorPtr is not None:
                errorPtr[0] = objc.initWrapperClass(objc.lookUpClass("NSError"))(
                    domain="MyDocumentErrorDomain", code=1, userInfo={"NSLocalizedDescriptionKey": str(e)}
                )
            return False

    # 必须重写：将文档内容写入指定URL
    def writeToURL_ofType_error_(self, url, typeName, errorPtr):
        # 将字符串转换为NSData
        contentData = NSData.dataWithBytes_length_(
            self.documentContent.encode('utf-8'),
            len(self.documentContent.encode('utf-8'))
        )
        # 原子写入避免文件损坏
        success = contentData.writeToURL_atomically_(url, True)
        if not success and errorPtr is not None:
            errorPtr[0] = objc.initWrapperClass(objc.lookUpClass("NSError"))(
                domain="MyDocumentErrorDomain", code=2, userInfo={"NSLocalizedDescriptionKey": "文件写入失败"}
            )
        return success

# 修改原write函数，使用自定义子类
@classmethod
def write(cls, file: str):
    path = NSURL.fileURLWithPath_(file)
    ext = file.split('.')[-1]
    error = [None]
    # 实例化自定义子类，而非NSDocument本身
    doc = MyTextDocument.alloc().initWithContentsOfURL_ofType_error_(path, ext, error)
    if error[0] is not None:
        print(f"文档初始化失败: {error[0].localizedDescription()}")
        return
    
    # 示例：修改文档内容
    doc.documentContent = "这是通过NSDocument子类处理的写入内容"
    
    # 保存文档
    saveError = [None]
    success = doc.saveToURL_ofType_forSaveOperation_error_(path, ext, 0, saveError)
    if not success:
        print(f"文档保存失败: {saveError[0].localizedDescription()}")

额外说明 #

• 关于断言（NSInternalInconsistencyException）：这是Cocoa框架的防御机制，用来确保子类遵守抽象类的设计约定——当框架预期子类实现某个核心逻辑但未实现时，就会触发断言，强制开发者补全必要代码，避免后续出现更隐蔽的运行时错误。
• 可根据实际文档类型（如二进制文件、JSON等）修改读写方法的转换逻辑，核心是完成readFromData和writeToURL的对应数据处理。

内容的提问来源于stack exchange，提问作者vanilla