com.sun.glass.ui.mac

Class MacFileNSURL

java.lang.Object

java.io.File

com.sun.glass.ui.mac.MacFileNSURL

All Implemented Interfaces:

Serializable, Comparable<File>

public final class MacFileNSURL
extends File

A descendant of the File class that also provides access to the underlying native NSURL object associated with this File instance. Objects of this type are returned as a result of invoking the CommonDialogs.show[File|Folder]Chooser() methods if the "glass.macosx.enableFileNSURL" system property is true.

See Also:

Serialized Form

Field Summary

Fields inherited from class java.io.File

pathSeparator, pathSeparatorChar, separator, separatorChar

Method Summary

Modifier and Type	Method and Description
static MacFileNSURL	createFromBookmark(byte[] data) Returns an instance of the MacFileNSURL class created from bookmark data stored in the byte array passed as an argument.
static MacFileNSURL	createFromDocumentScopedBookmark(byte[] data, MacFileNSURL baseDocument) Returns an instance of the MacFileNSURL class created from a document-scoped bookmark data stored in the byte array passed as an argument, relative to the baseDocument URL.
void	dispose() Releases the underlying NSURL object.
byte[]	getBookmark() Returns a byte array representing a persistent bookmark for this URL.
byte[]	getDocumentScopedBookmark(MacFileNSURL baseDocument) Returns a byte array representing a document-scoped bookmark for this URL relative to the baseDocument URL.
boolean	startAccessingSecurityScopedResource() Makes the resource pointed to by a security-scoped URL available to the app.
void	stopAccessingSecurityScopedResource() Revokes access to the resource pointed to by a security-scoped URL.

Methods inherited from class java.io.File

canExecute, canRead, canWrite, compareTo, createNewFile, createTempFile, createTempFile, delete, deleteOnExit, equals, exists, getAbsoluteFile, getAbsolutePath, getCanonicalFile, getCanonicalPath, getFreeSpace, getName, getParent, getParentFile, getPath, getTotalSpace, getUsableSpace, hashCode, isAbsolute, isDirectory, isFile, isHidden, lastModified, length, list, list, listFiles, listFiles, listFiles, listRoots, mkdir, mkdirs, renameTo, setExecutable, setExecutable, setLastModified, setReadable, setReadable, setReadOnly, setWritable, setWritable, toPath, toString, toURI, toURL

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Method Detail

dispose

public void dispose()

Releases the underlying NSURL object. An application must call this method after it no longer needs to use this object in order to release native resources associated with it.

startAccessingSecurityScopedResource

public boolean startAccessingSecurityScopedResource()

Makes the resource pointed to by a security-scoped URL available to the app. The call must be balanced with a corresponding call to stopAccessingSecurityScopedResource using the try{}finally{} pattern.

Returns:

true if the request to access the resource succeeded; otherwise, false

stopAccessingSecurityScopedResource

public void stopAccessingSecurityScopedResource()

Revokes access to the resource pointed to by a security-scoped URL.

getBookmark

public byte[] getBookmark()

Returns a byte array representing a persistent bookmark for this URL. An app can store this data, and later re-create the URL with a call to createFromBookmark.

Returns:

bookmark data in a form of byte[]

createFromBookmark

public static MacFileNSURL createFromBookmark(byte[] data)

Returns an instance of the MacFileNSURL class created from bookmark data stored in the byte array passed as an argument. The glass.macosx.enableFileNSURL system property must be set to true before calling this method.

Returns:

a new instance of MacFileNSURL

getDocumentScopedBookmark

public byte[] getDocumentScopedBookmark(MacFileNSURL baseDocument)

Returns a byte array representing a document-scoped bookmark for this URL relative to the baseDocument URL. An app can store this data, and later re-create the URL with a call to createFromDocumentScopedBookmark.

Returns:

bookmark data in a form of byte[]

Throws:

NullPointerException - if baseDocument is null

createFromDocumentScopedBookmark

public static MacFileNSURL createFromDocumentScopedBookmark(byte[] data,
                                                            MacFileNSURL baseDocument)

Returns an instance of the MacFileNSURL class created from a document-scoped bookmark data stored in the byte array passed as an argument, relative to the baseDocument URL. The glass.macosx.enableFileNSURL system property must be set to true before calling this method.

Returns:

a new instance of MacFileNSURL

Throws:

NullPointerException - if baseDocument is null