You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@poi.apache.org by ce...@apache.org on 2018/04/27 06:38:49 UTC

svn commit: r1830297 - in /poi/site: publish/faq.html src/documentation/content/xdocs/faq.xml

Author: centic
Date: Fri Apr 27 06:38:49 2018
New Revision: 1830297

URL: http://svn.apache.org/viewvc?rev=1830297&view=rev
Log:
Update FAQ for Java 9 and add preliminary entry for Java 10 and higher

Modified:
    poi/site/publish/faq.html
    poi/site/src/documentation/content/xdocs/faq.xml

Modified: poi/site/publish/faq.html
URL: http://svn.apache.org/viewvc/poi/site/publish/faq.html?rev=1830297&r1=1830296&r2=1830297&view=diff
==============================================================================
--- poi/site/publish/faq.html (original)
+++ poi/site/publish/faq.html Fri Apr 27 06:38:49 2018
@@ -383,6 +383,11 @@ if (VERSION > 3) {
             Can Apache POI be compiled/used with Java 9?
         </a>
 </li>
+<li>
+<a name="faq-N102C9-menu"></a><a href="#faq-N102C9">
+            Can Apache POI be compiled/used with Java 10 or newer?
+        </a>
+</li>
 </ol>
 <a name="Answers"></a>
 <div class="h3">
@@ -1076,13 +1081,23 @@ and
 </h4>
 </div>
             
-<p>We did some work to verify that compilation with Java 9 is working and
+<p>Running the existing binaries with Java 9 should work. You may see
+                some warnings about illegal reflective access, but it should work fine
+                despite those. We are working on getting the code changed so we avoid
+                these discouraged accesses.
+            </p>
+            
+<p>We also did some work to verify that compilation with Java 9 is working and
                 that all unit-tests pass. So Apache POI should be ready to be used with
-                current Java 9 release candidates.
+                current Java 9 releases.
             </p>
             
-<p>NOTE: As Java 9 is still not finally released, there might
-                still be breaking changes introduced in the final release, use with care!
+<p>NOTE: Apache POI does not yet fully support the Java 9 module system as
+                Apache POI is still supporting previous Java versions and the module system
+                cannot be fully supported while maintaining such support.
+                We are working on adding support for automatic modules, but even that is
+                not trivial as Apache POI currently uses the same package in different jar-files
+                which Java 9/Modules/Automatic Modules does not allow any more!
             </p>
             
 <p>For compiling Apache POI, you should set some additional options as follows
@@ -1115,6 +1130,22 @@ and
                 -Dcoverage.enabled=true \
                 test-all
             </pre>
+
+        
+<a name="faq-N102C9"></a>
+<div class="h4">
+<h4>24. 
+            Can Apache POI be compiled/used with Java 10 or newer?
+        <a title="Permanent link" class="headerlink" href="#faq-N102C9">#</a>
+</h4>
+</div>
+            
+<p>Apache POI is not yet fully supported on Java 10 or newer. The binary formats (.xls, .doc, .ppt, ...)
+                should mostly work, but unfortunately reading the newer XML-based formats (.xlsx, .docx, pptx, ...)
+                is broken by a change to the ZIP file handling in Java 10, see
+                <a href="https://bz.apache.org/bugzilla/show_bug.cgi?id=62187">bug 62187</a> for details and
+                the latest state.
+            </p>
         
 </div>
 </div>

Modified: poi/site/src/documentation/content/xdocs/faq.xml
URL: http://svn.apache.org/viewvc/poi/site/src/documentation/content/xdocs/faq.xml?rev=1830297&r1=1830296&r2=1830297&view=diff
==============================================================================
--- poi/site/src/documentation/content/xdocs/faq.xml (original)
+++ poi/site/src/documentation/content/xdocs/faq.xml Fri Apr 27 06:38:49 2018
@@ -599,12 +599,21 @@ and
             Can Apache POI be compiled/used with Java 9?
         </question>
         <answer>
-            <p>We did some work to verify that compilation with Java 9 is working and
+            <p>Running the existing binaries with Java 9 should work. You may see
+                some warnings about illegal reflective access, but it should work fine
+                despite those. We are working on getting the code changed so we avoid
+                these discouraged accesses.
+            </p>
+            <p>We also did some work to verify that compilation with Java 9 is working and
                 that all unit-tests pass. So Apache POI should be ready to be used with
-                current Java 9 release candidates.
+                current Java 9 releases.
             </p>
-            <p>NOTE: As Java 9 is still not finally released, there might
-                still be breaking changes introduced in the final release, use with care!
+            <p>NOTE: Apache POI does not yet fully support the Java 9 module system as
+                Apache POI is still supporting previous Java versions and the module system
+                cannot be fully supported while maintaining such support.
+                We are working on adding support for automatic modules, but even that is
+                not trivial as Apache POI currently uses the same package in different jar-files
+                which Java 9/Modules/Automatic Modules does not allow any more!
             </p>
             <p>For compiling Apache POI, you should set some additional options as follows
                 to open up some modules that are needed and to unset some compiler options
@@ -635,6 +644,20 @@ and
                 -Dcoverage.enabled=true \
                 test-all
             </source>
+
+        </answer>
+    </faq>
+    <faq>
+        <question>
+            Can Apache POI be compiled/used with Java 10 or newer?
+        </question>
+        <answer>
+            <p>Apache POI is not yet fully supported on Java 10 or newer. The binary formats (.xls, .doc, .ppt, ...)
+                should mostly work, but unfortunately reading the newer XML-based formats (.xlsx, .docx, pptx, ...)
+                is broken by a change to the ZIP file handling in Java 10, see
+                <link href="https://bz.apache.org/bugzilla/show_bug.cgi?id=62187">bug 62187</link> for details and
+                the latest state.
+            </p>
         </answer>
     </faq>
 </faqs>



---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@poi.apache.org
For additional commands, e-mail: commits-help@poi.apache.org