apple.foundation.enums

Class NSFileCoordinatorReadingOptions

java.lang.Object

apple.foundation.enums.NSFileCoordinatorReadingOptions

public final class NSFileCoordinatorReadingOptions
extends java.lang.Object

Field Summary

Fields

Modifier and Type	Field and Description
static long	ForUploading Whether reading of an item is being done for the purpose of uploading.
static long	ImmediatelyAvailableMetadataOnly Whether the reading to be done will only attempt to get an item's metadata that is immediately available (name, modification date, tags, and other attributes), and not its contents.
static long	ResolvesSymbolicLink Whether reading of an item that might be a symbolic link file causes the resolution of the link if it is.
static long	WithoutChanges Whether reading does _not_ trigger sending of -savePresentedItemChangesWithCompletionHandler: to certain NSFilePresenters in the system and waiting for those NSFilePresenters to respond.

Method Summary

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

WithoutChanges

public static final long WithoutChanges

Whether reading does _not_ trigger sending of -savePresentedItemChangesWithCompletionHandler: to certain NSFilePresenters in the system and waiting for those NSFilePresenters to respond. The default behavior during coordinated reading is to send -savePresentedItemChangesWithCompletionHandler: to NSFilePresenters.

See Also:

Constant Field Values

ResolvesSymbolicLink

public static final long ResolvesSymbolicLink

Whether reading of an item that might be a symbolic link file causes the resolution of the link if it is. This affects the URL passed to the block passed to an invocation of one of the -coordinateReadingItemAtURL:... methods. This is not a valid option to use with -prepareForReadingItemsAtURLs:options:writingItemsAtURLs:options:error:byAccessor:.

See Also:

Constant Field Values

ImmediatelyAvailableMetadataOnly

public static final long ImmediatelyAvailableMetadataOnly

Whether the reading to be done will only attempt to get an item's metadata that is immediately available (name, modification date, tags, and other attributes), and not its contents. For ubiquitous items, specifying this option will cause coordinated reads to be granted immediately (barring other coordinated readers or writers or file presenters on the same system on the same system preventing this) instead of waiting for any downloading of contents or additional metadata like conflicting versions or thumbnails. Attempting to read the item's contents during such a coordinated read may give you unexpected results or fail.

See Also:

Constant Field Values

ForUploading

public static final long ForUploading

Whether reading of an item is being done for the purpose of uploading. When using this option, NSFileCoordinator will create a temporary snapshot of the item being read and will relinquish its claim on the file once that snapshot is made to avoid blocking other coordinated writes during a potentially long upload. If the item at the URL being read is a directory (such as a document package), then the snapshot will be a new file that contains the zipped contents of that directory, and the URL passed to the accessor block will locate that file.

When using this option, you may upload the document outside of the accessor block. However, you should open a file descriptor to the file or relocate the file within the accessor block before you do so, because NSFileCoordinator will unlink the file after the block returns, rendering it inaccessible via the URL.

See Also:

Constant Field Values