- From: Eric Uhrhane via cvs-syncmail <cvsmail@w3.org>
- Date: Sat, 14 Aug 2010 00:06:40 +0000
- To: public-dap-commits@w3.org
Update of /sources/public/2009/dap/file-system
In directory hutz:/tmp/cvs-serv14028
Modified Files:
file-dir-sys.html
Log Message:
Moved File inheritance of FileEntry* to a file() method that returns one
instead.
Removed unused FileSystemsCallback.
Changed "persistent" parameter of requestFileSystem* to be a short flag instead,
to allow for later expansion.
Index: file-dir-sys.html
===================================================================
RCS file: /sources/public/2009/dap/file-system/file-dir-sys.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -d -r1.13 -r1.14
--- file-dir-sys.html 16 Jul 2010 23:52:14 -0000 1.13
+++ file-dir-sys.html 14 Aug 2010 00:06:38 -0000 1.14
@@ -287,6 +287,15 @@
<div class='idl' title='WorkerGlobalScope implements
LocalFileSystem'></div> <dl title='[Supplemental, NoInterfaceObject]
interface LocalFileSystem' class='idl'>
+ <dt>const unsigned short TEMPORARY = 0</dt>
+ <dd>
+ Used for storage with no guarantee of persistence.
+ </dd>
+ <dt>const unsigned short PERSISTENT = 1</dt>
+ <dd>
+ Used for storage that should not be removed by the <a>user
+ agent</a> without application or user permission.
+ </dd>
<dt>void requestFileSystem ()</dt>
<dd>
<p>
@@ -297,10 +306,11 @@
origin-private filesystem, as defined above.
</p>
<dl class='parameters'>
- <dt>boolean persistent</dt>
+ <dt>unsigned short type</dt>
<dd>
Whether the filesystem requested should be <a>persistent</a>,
- as defined above.
+ as defined above. Use one of <code>TEMPORARY</code> or
+ <code>PERSISTENT</code>.
</dd>
<dt>long long size</dt>
<dd>
@@ -351,6 +361,15 @@
LocalFileSystemSync'></div>
<dl title='[Supplemental, NoInterfaceObject] interface
LocalFileSystemSync' class='idl'>
+ <dt>const unsigned short TEMPORARY = 0</dt>
+ <dd>
+ Used for storage with no guarantee of persistence.
+ </dd>
+ <dt>const unsigned short PERSISTENT = 1</dt>
+ <dd>
+ Used for storage that should not be removed by the <a>user
+ agent</a> without application or user permission.
+ </dd>
<dt>FileSystemSync requestFileSystemSync ()</dt>
<dd>
<p>
@@ -361,10 +380,11 @@
origin-private filesystem, as defined above.
</p>
<dl class='parameters'>
- <dt>boolean persistent</dt>
+ <dt>unsigned short type</dt>
<dd>
Whether the filesystem requested should be <a>persistent</a>,
- as defined above.
+ as defined above. Use one of <code>TEMPORARY</code> or
+ <code>PERSISTENT</code>.
</dd>
<dt>long long size</dt>
<dd>
@@ -785,14 +805,31 @@
<p>
This interface represents a file on a file system.
</p>
- <dl title='[NoInterfaceObject] interface FileEntry : Entry, File'
+ <dl title='[NoInterfaceObject] interface FileEntry : Entry'
class='idl'>
<dt>FileWriter createWriter ()</dt>
<dd>
<p>
- Creates a new FileWriter associated with the file that this
- FileEntry represents.
+ Creates a new <code>FileWriter</code> associated with the file
+ that this <code>FileEntry</code> represents.
+ </p>
+ </dd>
+ <dt>File file ()</dt>
+ <dd>
+ <p>
+ Returns a <code>File</code> that represents the current state of
+ the file that this <code>FileEntry</code> represents.
</p>
+ <dl class='exception' title='FileException'>
+ <dt>NOT_FOUND_ERR</dt>
+ <dd>The entry no longer exists.</dd>
+ <dt>INVALID_STATE_ERR</dt>
+ <dd>This FileEntry is no longer valid for some reason other
+ than it having been deleted.</dd>
+ <dt>SECURITY_ERR</dt>
+ <dd>The <a>user agent</a> determined that it was not safe to carry
+ out this action.</dd>
+ </dl>
</dd>
</dl>
</section>
@@ -802,28 +839,6 @@
<p>
Several calls in this API are asynchronous, and use callbacks.
</p>
- <section>
- <h2>The <code>FileSystemsCallback</code> interface</h2>
- <p>
- When <code>filesystems()</code> succeeds, the following callback is
- made:
- </p>
- <dl title='[NoInterfaceObject, Callback=FunctionOnly] interface
- FileSystemsCallback' class='idl'>
- <dt>void handleEvent ()</dt>
- <dd>
- <p>
- The list of file systems was successfully obtained.
- </p>
- <dl class='parameters'>
- <dt>FileSystem[] filesystems</dt>
- <dd>
- The array of file systems.
- </dd>
- </dl>
- </dd>
- </dl>
- </section>
<section>
<h2>The <code>FileSystemCallback</code> interface</h2>
@@ -832,7 +847,7 @@
callback is made:
</p>
<dl title='[NoInterfaceObject, Callback=FunctionOnly] interface
- FileSystemsCallback' class='idl'>
+ FileSystemCallback' class='idl'>
<dt>void handleEvent ()</dt>
<dd>
<p>
@@ -1299,14 +1314,31 @@
This interface represents a file on a file system.
</p>
<dl title=
- '[NoInterfaceObject] interface FileEntrySync : EntrySync, File'
+ '[NoInterfaceObject] interface FileEntrySync : EntrySync'
class='idl'>
<dt>FileWriterSync createWriter ()</dt>
<dd>
<p>
- Creates a new FileWriterSync associated with the file that this
- FileEntrySync represents.
+ Creates a new <code>FileWriterSync</code> associated with the file
+ that this <code>FileEntrySync</code> represents.
+ </p>
+ </dd>
+ <dt>File file ()</dt>
+ <dd>
+ <p>
+ Returns a <code>File</code> that represents the current state of
+ the file that this <code>FileEntrySync</code> represents.
</p>
+ <dl class='exception' title='FileException'>
+ <dt>NOT_FOUND_ERR</dt>
+ <dd>The entry no longer exists.</dd>
+ <dt>INVALID_STATE_ERR</dt>
+ <dd>This FileEntrySync is no longer valid for some reason other
+ than it having been deleted.</dd>
+ <dt>SECURITY_ERR</dt>
+ <dd>The <a>user agent</a> determined that it was not safe to carry
+ out this action.</dd>
+ </dl>
</dd>
</dl>
</section>
Received on Saturday, 14 August 2010 00:06:41 UTC