commons-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject svn commit: r1170509 - /commons/proper/compress/trunk/src/main/java/org/apache/commons/compress/compressors/pack200/package.html
Date Wed, 14 Sep 2011 10:17:42 GMT
Author: bodewig
Date: Wed Sep 14 10:17:41 2011
New Revision: 1170509

explain why we pack200 package doesn't pump streams.  COMPRESS-142


Modified: commons/proper/compress/trunk/src/main/java/org/apache/commons/compress/compressors/pack200/package.html
--- commons/proper/compress/trunk/src/main/java/org/apache/commons/compress/compressors/pack200/package.html
+++ commons/proper/compress/trunk/src/main/java/org/apache/commons/compress/compressors/pack200/package.html
Wed Sep 14 10:17:41 2011
@@ -60,6 +60,17 @@
       in memory but you should switch to the temporary file option if
       your archives are really big.</p>
-    <p>
+    <p>During development of the initial version several attempts have
+      been made to use a real streaming API based for example
+      on <code>Piped(In|Out)putStream</code> or explicit stream
+      pumping like Commons Exec's <code>InputStreamPumper</code> but
+      they have all failed because they rely on the output end to be
+      consumed completely or else the <code>(un)pack</code> will block
+      forever.  Espectially for <code>Pack200InputStream</code> it is
+      very likely that it will be wrapped in
+      a <code>ZipArchiveInputStream</code> which will never read the
+      archive completely as it is not interested in the ZIP central
+      directory data at the end of the JAR archive.</p>

View raw message