Author: nick
Date: Thu Apr 24 19:35:02 2014
New Revision: 1589846
URL: http://svn.apache.org/r1589846
Log:
Update NPOIFS docs
Modified:
poi/site/publish/poifs/how-to.html
poi/site/src/documentation/content/xdocs/poifs/how-to.xml
Modified: poi/site/publish/poifs/how-to.html
URL:
http://svn.apache.org/viewvc/poi/site/publish/poifs/how-to.html?rev=1589846&r1=1589845&r2=1589846&view=diff
==============================================================================
--- poi/site/publish/poifs/how-to.html (original)
+++ poi/site/publish/poifs/how-to.html Thu Apr 24 19:35:02 2014
@@ -250,10 +250,12 @@ if (VERSION > 3) {
<td colspan="1" rowspan="1">Conventional Reading (POIFSFileSystem)</td>
<td colspan="1" rowspan="1">
Simpler API similar to reading a conventional file system.<br>
- Can read documents in any order.
+ Can read documents in any order.<br>
+ Well tested read and write support
</td>
<td colspan="1" rowspan="1">
- All files are resident in memory, whether your application needs
them or not.
+ All files are resident in memory, whether your application needs
them or not.<br>
+ Writes only to OutputStreams, no in-place writing
</td>
</tr>
@@ -264,12 +266,14 @@ if (VERSION > 3) {
<td colspan="1" rowspan="1">
Simpler API similar to reading a conventional file system.<br>
Can read documents in any order.<br>
- Lower memory than POIFSFileSystem
+ Lower memory than POIFSFileSystem<br>
+ Well tested read support<br>
+ Supports in-place writes
</td>
<td colspan="1" rowspan="1">
If created from an InputStream, all files are resident in memory.
(If created from a File, only certain key structures are)<br>
- Currently doesn't support writing
+ Write support is quite recent, not as fully hardened as
POIFSFileSystem
</td>
</tr>
@@ -450,7 +454,7 @@ DocumentInputStream stream = new Documen
budget on memory use of up to 20% of the file size when using a File,
or up to 120% of the file size when using an InputStream.</p>
-<a name="Preparation-N101C0"></a>
+<a name="Preparation-N101C8"></a>
<div class="h2">
<h2>Preparation</h2>
</div>
@@ -505,7 +509,7 @@ DirectoryEntry root = fs.getRoot();
<p>The event-driven API for reading documents is a little more complicated and
requires that your application know, in advance, which files it wants to read.
The benefit of using this API is that each document is in memory just long
enough for your application to read it, and documents that you never read at
all are not in memory at all. When you're finished reading the documents you
wanted, the file system has no data structures associated with it at all and
can be discarded.</p>
-<a name="Preparation-N101DF"></a>
+<a name="Preparation-N101E7"></a>
<div class="h2">
<h2>Preparation</h2>
</div>
Modified: poi/site/src/documentation/content/xdocs/poifs/how-to.xml
URL:
http://svn.apache.org/viewvc/poi/site/src/documentation/content/xdocs/poifs/how-to.xml?rev=1589846&r1=1589845&r2=1589846&view=diff
==============================================================================
--- poi/site/src/documentation/content/xdocs/poifs/how-to.xml (original)
+++ poi/site/src/documentation/content/xdocs/poifs/how-to.xml Thu Apr 24
19:35:02 2014
@@ -87,10 +87,12 @@
<td>Conventional Reading (POIFSFileSystem)</td>
<td>
Simpler API similar to reading a conventional file system.<br/>
- Can read documents in any order.
+ Can read documents in any order.<br/>
+ Well tested read and write support
</td>
<td>
- All files are resident in memory, whether your application needs
them or not.
+ All files are resident in memory, whether your application needs
them or not.<br />
+ Writes only to OutputStreams, no in-place writing
</td>
</tr>
<tr>
@@ -98,12 +100,14 @@
<td>
Simpler API similar to reading a conventional file system.<br/>
Can read documents in any order.<br/>
- Lower memory than POIFSFileSystem
+ Lower memory than POIFSFileSystem<br/>
+ Well tested read support<br />
+ Supports in-place writes
</td>
<td>
If created from an InputStream, all files are resident in memory.
(If created from a File, only certain key structures are)<br/>
- Currently doesn't support writing
+ Write support is quite recent, not as fully hardened as
POIFSFileSystem
</td>
</tr>
<tr>
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
