Instance Property インスタンスプロパティ

purposeIdentifier

A string that uniquely identifies the file access that was performed by this file coordinator. このファイルコーディネータによって実行されたファイルアクセスを特有に識別する文字列。

Declaration 宣言

var purposeIdentifier: String { get set }

Discussion 議論

Coordinated reads and writes performed using the same purpose identifier never block each other, even if they occur in different processes. If you are coordinating file access on behalf of a file presenter, use init(filePresenter:) and do not attempt to set a custom purpose identifier. Every file coordinator instance initialized with the same file presenter has the same purpose identifier. 同じ用途識別子を使っている協調読み出しと書き込みは、決して互いに遮断しません、たとえそれらが異なるプロセスにおいて発生するとしてもです。あなたがファイルプレゼンタに代わってファイルアクセスを協調させているならば、init(filePresenter:)を使用してください、そしてあつらえの用途識別子を設定しようと試みないでください。同じファイルプレゼンタで初期化されるすべてのファイルコーディネータインスタンスは、同じ用途識別子を持ちます。

You may need to set a custom purpose identifier for the following reasons: あなたは、あつらえの用途識別子を以下の理由のために設定する必要があるかもしれません:

  • Your application has a File Provider extension. Any file coordination done on behalf of the File Provider needs to be done using the File Provider’s purpose identifier. あなたのアプリケーションは、File Provider拡張を持ちます。File Providerに代わって行われるあらゆるファイル協調は、File Providerのもつ用途識別子を使って行われる必要があります。

  • You have two separate subsystems that need to work together to perform a single high-level operation, and both subsystems perform their own coordinated reads or writes. Using the same purpose identifier in both subsystems prevents possible deadlocks between the two subsystems. あなたは2つの別々の下位システムを持ちます、それは共同して働いてある単一の高水準演算を実行します、そして両方の下位システムはそれら独自の協調読み出しおよび書き込みを実行します。同じ用途識別子を両方の下位システムにおいて使用することは、2つの下位システムの間に起こりうる膠着状態を防止します。

When creating custom purpose identifiers, you can use a reverse DNS style string, such as com.example.MyApplication.MyPurpose, or a UUID string. You cannot use nil or zero-length strings. あつらえの用途識別子を作成する場合、あなたは逆DNS形式文字列、例えばcom.example.MyApplication.MyPurposeを、またはUUID文字列を使うことができます。あなたは、nilまたはゼロ長文字列を使用できません。

See Also 参照

Managing File Presenters ファイルプレゼンタを管理する