NSFilePresenter

protocol NSFilePresenter

Overview 概要

Objects that allow the user to view or edit the content of files or directories should adopt the NSFilePresenter protocol. You use file presenters in conjunction with an NSFileCoordinator object to coordinate access to a file or directory among the objects of your application and between your application and other processes. When changes to an item occur, the system notifies objects that adopt this protocol and gives them a chance to respond appropriately. ユーザにファイルまたはディレクトリの内容を眺めさせるまたは編集させるオブジェクトは、NSFilePresenterプロトコルを採用すべきです。あなたは、ファイルプレゼンタをNSFileCoordinatorオブジェクトと連携して使うことで、あなたのアプリケーションのオブジェクトいくらかの間でそしてあなたのアプリケーションと他のプロセスの間でファイルまたはディレクトリに対してアクセスを協調させます。ある項目に対する変更が起こる場合、システムはこのプロトコルを採用するオブジェクトそれらに通知します、そして適切に応答する機会をそれらに与えます。

Use the methods of this protocol to respond to actions about to be taken on the presented file or directory. When another object or process uses a file coordinator to begin reading or writing a file or directory, the file coordinator notifies all presented objects interested in the item first. It notifies the presenter objects by invoking one of the methods defined by this protocol on that object. The actual invocation of that method occurs on the operation queue in the presentedItemOperationQueue property. Your file presenter must provide this queue. If your queue supports the concurrent execution of operations, the methods of your presenter object must be thread-safe and able to run in multiple queues simultaneously. このプロトコルのメソッドを使うことで、その提示されたファイルまたはディレクトリ上で取られようとしているアクションに応答してください。別のオブジェクトまたはプロセスがファイルコーディネータを使ってファイルまたはディレクトリの読み出しまたは書き込みを始める場合、ファイルコーディネータはその項目に興味を持っている全ての提示されたオブジェクトに通知します、まず最初に。それはプレゼンタオブジェクトそれらに通知することを、このプロトコルによって定義されるメソッドの１つをそのオブジェクト上で発動することで行います。このメソッドの実際の発動は、presentedItemOperationQueueプロパティの中の演算キュー上で起こります。あなたのファイルプレゼンタは、このキューを提供しなければなりません。あなたのキューが演算の並列実行をサポートするならば、あなたのプレゼンタオブジェクトのメソッドそれらはスレッド安全で、そして複数のキューにおいて同時に実行できなければなりません。

You can use file presenters to coordinate access to a file or directory among your application’s objects. If another process uses a file coordinator for the same file or directory, your presenter objects are similarly notified whenever the other process makes its changes. Your presenter objects are not notified about changes made directly using low-level read and write calls to the file. Only changes that go through a file coordinator result in notifications. あなたは、ファイルプレゼンタを使って、あなたのアプリケーションのオブジェクトの間でファイルまたはディレクトリに対するアクセスを協調させることができます。別のプロセスが、ファイルコーディネータを同じファイルまたはディレクトリに対して使うならば、あなたプレゼンタオブジェクトは他のプロセスがそれの変更を為す時はいつでも同様に通知されます。あなたのプレゼンタオブジェクトは、低水準読み出しおよび書き込みを使ってファイルに直接になされる変更については通知されません。ファイルコーディネータを通り抜ける変更だけが通知という結果になります。

For information about how to use file presenters with a file coordinator object, see NSFileCoordinator. ファイルプレゼンタそれらをあるファイルコーディネータオブジェクトとともに使う方法についての情報として、NSFileCoordinatorを見てください。

File Presenters and iOS ファイルプレゼンタとiOS

If your app enters the background with an active file presenter, any other processes that perform a coordinated read or write on the presented file can deadlock. To prevent this situation, call the coordinator's removeFilePresenter(_:) type method to remove the file presenter in the applicationDidEnterBackground(_:) method or in response to a didEnterBackgroundNotification notification. Call addFilePresenter(_:) to add the file presenter again in the applicationWillEnterForeground(_:) method or in response to a willEnterForegroundNotification notification. あなたのアプリが活動中のファイルプレゼンタとともにバックグラウンドに入るならば、協調読み出しまたは書き込みをその提示されたファイル上で実行する何らかの他のプロセスは、膠着状態になりえます。この状況を防止するには、コーディネータのremoveFilePresenter(_:)型メソッドを呼び出してそのファイルプレゼンタをapplicationDidEnterBackground(_:)メソッドにおいてまたはdidEnterBackgroundNotification通知に答えて取り除いてください。addFilePresenter(_:)を呼び出すことで、再びファイルプレゼンタをapplicationWillEnterForeground(_:)メソッドにおいてまたはwillEnterForegroundNotification通知に答えて加えてください。