2009/dap/file-system file-dir-sys.html,1.13,1.14

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