Author: fanningpj
Date: Thu Nov 11 19:29:50 2021
New Revision: 1894959
URL: http://svn.apache.org/viewvc?rev=1894959&view=rev
Log:
update logging info
Modified:
poi/site/publish/changes.html
poi/site/publish/components/index.html
poi/site/publish/components/spreadsheet/eval.html
poi/site/publish/components/spreadsheet/how-to.html
poi/site/publish/encryption.html
Modified: poi/site/publish/changes.html
URL:
http://svn.apache.org/viewvc/poi/site/publish/changes.html?rev=1894959&r1=1894958&r2=1894959&view=diff
==============================================================================
--- poi/site/publish/changes.html (original)
+++ poi/site/publish/changes.html Thu Nov 11 19:29:50 2021
@@ -236,6 +236,14 @@ document.write("Last Published: " + docu
<tr class="action">
<td><img class="icon" alt="add" src="images/add.png"></td><td><a
href="https://bz.apache.org/bugzilla/show_bug.cgi?id=65668";>65668</a></td><td>OOXML</td><td>upgrade
to xmlsec 2.3.0 - make secure validation configurable</td>
</tr>
+
+<tr class="action">
+<td><img class="icon" alt="add" src="images/add.png"></td><td><a
href="https://bz.apache.org/bugzilla/show_bug.cgi?id=65672";>65672</a></td><td>OOXML</td><td>Digitial
Signature - set commitment type and purpose</td>
+</tr>
+
+<tr class="action">
+<td><img class="icon" alt="fix" src="images/fix.png"></td><td><a
href="https://bz.apache.org/bugzilla/show_bug.cgi?id=65676";>65676</a></td><td>XSSF</td><td>Issue
in XSSFReader where string builder is not always cleared between cell
reads</td>
+</tr>
</tbody>
</table>
@@ -274,7 +282,7 @@ document.write("Last Published: " + docu
<li>By default, no DTDs will be accepted in XML files. This can be relaxed by
setting
POIXMLTypeLoader.DEFAULT_XML_OPTIONS.setDisallowDocTypeDeclaration(false).</li>
</ul>
-<a name="Changes-N10078"></a>
+<a name="Changes-N10098"></a>
<h3 class="boxed">Changes</h3>
<table class="POITable">
<colgroup>
@@ -476,7 +484,7 @@ document.write("Last Published: " + docu
5.0.0 (2021-01-20)
</h2>
<div class="section">
-<a name="Summary-N10359"></a>
+<a name="Summary-N10379"></a>
<h3 class="boxed">Summary</h3>
<ul>
@@ -503,7 +511,7 @@ document.write("Last Published: " + docu
<li>new experimental DeferredSXSSFWorkbook which creates fewer temp files by
lazily generating rows (see DeferredGeneration in poi-examples)</li>
</ul>
-<a name="Changes-N1037E"></a>
+<a name="Changes-N1039E"></a>
<h3 class="boxed">Changes</h3>
<table class="POITable">
<colgroup>
@@ -813,7 +821,7 @@ document.write("Last Published: " + docu
4.1.2 (2020-02-17)
</h2>
<div class="section">
-<a name="Summary-N10806"></a>
+<a name="Summary-N10826"></a>
<h3 class="boxed">Summary</h3>
<ul>
@@ -828,7 +836,7 @@ document.write("Last Published: " + docu
<li>updated dependencies to Bouncycastle 1.64</li>
</ul>
-<a name="Changes-N1081C"></a>
+<a name="Changes-N1083C"></a>
<h3 class="boxed">Changes</h3>
<table class="POITable">
<colgroup>
@@ -962,7 +970,7 @@ document.write("Last Published: " + docu
4.1.1 (2019-10-20)
</h2>
<div class="section">
-<a name="Summary-N109E7"></a>
+<a name="Summary-N10A07"></a>
<h3 class="boxed">Summary</h3>
<ul>
@@ -981,7 +989,7 @@ document.write("Last Published: " + docu
<li>CVE-2019-12415 - XML External Entity (XXE) Processing in Apache POI</li>
</ul>
-<a name="Changes-N10A03"></a>
+<a name="Changes-N10A23"></a>
<h3 class="boxed">Changes</h3>
<table class="POITable">
<colgroup>
@@ -1131,7 +1139,7 @@ document.write("Last Published: " + docu
4.1.0 (2019-04-09)
</h2>
<div class="section">
-<a name="Summary-N10C0B"></a>
+<a name="Summary-N10C2B"></a>
<h3 class="boxed">Summary</h3>
<ul>
@@ -1156,7 +1164,7 @@ document.write("Last Published: " + docu
<li>Upgrade to XMLSec 2.1.2</li>
</ul>
-<a name="Changes-N10C30"></a>
+<a name="Changes-N10C50"></a>
<h3 class="boxed">Changes</h3>
<table class="POITable">
<colgroup>
@@ -1330,7 +1338,7 @@ document.write("Last Published: " + docu
4.0.1 (2018-12-03)
</h2>
<div class="section">
-<a name="Summary-N10EA1"></a>
+<a name="Summary-N10EC1"></a>
<h3 class="boxed">Summary</h3>
<ul>
@@ -1341,7 +1349,7 @@ document.write("Last Published: " + docu
<li>Upgrade to XMLBeans 3.0.2</li>
</ul>
-<a name="Changes-N10EB1"></a>
+<a name="Changes-N10ED1"></a>
<h3 class="boxed">Changes</h3>
<table class="POITable">
<colgroup>
@@ -1499,7 +1507,7 @@ document.write("Last Published: " + docu
4.0.0 (2018-09-07)
</h2>
<div class="section">
-<a name="Summary-N110E2"></a>
+<a name="Summary-N11102"></a>
<h3 class="boxed">Summary</h3>
<ul>
@@ -1508,7 +1516,7 @@ document.write("Last Published: " + docu
<li>New OOXML schema (1.4) necessary, because of incompatible XMLBeans loading
not anymore through POIXMLTypeLoader</li>
</ul>
-<a name="Changes-N110EF"></a>
+<a name="Changes-N1110F"></a>
<h3 class="boxed">Changes</h3>
<table class="POITable">
<colgroup>
Modified: poi/site/publish/components/index.html
URL:
http://svn.apache.org/viewvc/poi/site/publish/components/index.html?rev=1894959&r1=1894958&r2=1894959&view=diff
==============================================================================
--- poi/site/publish/components/index.html (original)
+++ poi/site/publish/components/index.html Thu Nov 11 19:29:50 2021
@@ -614,7 +614,7 @@ document.write("Last Published: " + docu
<tr>
<td colspan="1" rowspan="1">poi</td>
- <td colspan="1" rowspan="1"><a
href="https://search.maven.org/#artifactdetails|org.slf4j|jcl-over-slf4j|1.7.32|jar">jcl-over-slf4j
(commons-logging replacement)</a>,
+ <td colspan="1" rowspan="1"><a
href="https://search.maven.org/#artifactdetails|org.apache.logging.log4j|log4j-api|2.14.1|jar">log4j
2.x</a>,
<a
href="https://search.maven.org/#artifactdetails|commons-codec|commons-codec|1.15|jar">commons-codec</a>,
<a
href="https://search.maven.org/#artifactdetails|org.apache.commons|commons-collections4|4.4|jar">commons-collections</a>,
<a
href="https://search.maven.org/#artifactdetails|org.apache.commons|commons-math3|3.6.1|jar">commons-math3</a>
Modified: poi/site/publish/components/spreadsheet/eval.html
URL:
http://svn.apache.org/viewvc/poi/site/publish/components/spreadsheet/eval.html?rev=1894959&r1=1894958&r2=1894959&view=diff
==============================================================================
--- poi/site/publish/components/spreadsheet/eval.html (original)
+++ poi/site/publish/components/spreadsheet/eval.html Thu Nov 11 19:29:50 2021
@@ -1010,25 +1010,13 @@ document.write("Last Published: " + docu
<p>POI is not perfect and you may stumble across formula evaluation problems
(Java exceptions
or just different results) in your special use case. To support
an easy detailed analysis, a special
logging of the full evaluation is provided.</p>
-<p>The output of this logging may be very large (depends on your EXCEL), so
this logging has to be explicitly enabled
- for each single formula evaluation. Should not be used in
production - only for specific development use.</p>
+<p>POI 5.1.0 and above uses <a
href="https://logging.apache.org/log4j/2.x/";>Log4J 2.x</a> as a logging
framework. Try to set up a logging
+ configuration that lets you see the info and other log messages.</p>
<p>Example use:</p>
<div class="code">
<div class="codeline">
<span class="lineno"></span><span class="codebody"></span>
</div>
-<div class="codeline">
-<span class="lineno"></span><span class="codebody">// activate logging to
console</span>
-</div>
-<div class="codeline">
-<span class="lineno"></span><span
class="codebody">System.setProperty("org.apache.poi.util.POILogger",
"org.apache.poi.util.SystemOutLogger");</span>
-</div>
-<div class="codeline">
-<span class="lineno"></span><span
class="codebody">System.setProperty("poi.log.level", POILogger.INFO +
"");</span>
-</div>
-<div class="codeline">
-<span class="lineno"></span><span class="codebody"></span>
-</div>
<div class="codeline">
<span class="lineno"></span><span class="codebody">// open your file</span>
</div>
Modified: poi/site/publish/components/spreadsheet/how-to.html
URL:
http://svn.apache.org/viewvc/poi/site/publish/components/spreadsheet/how-to.html?rev=1894959&r1=1894958&r2=1894959&view=diff
==============================================================================
--- poi/site/publish/components/spreadsheet/how-to.html (original)
+++ poi/site/publish/components/spreadsheet/how-to.html Thu Nov 11 19:29:50 2021
@@ -1972,7 +1972,7 @@ its code is repeated above. To run it:
<li>set up your classpath as follows:
<span class="codefrag">export HSSFDIR={wherever you put HSSF's jar files}
export LOG4JDIR={wherever you put LOG4J's jar files}
-export
CLASSPATH=$CLASSPATH:$HSSFDIR/hssf.jar:$HSSFDIR/poi-poifs.jar:$HSSFDIR/poi-util.jar:$LOG4JDIR/jog4j.jar</span>
+export
CLASSPATH=$CLASSPATH:$HSSFDIR/hssf.jar:$HSSFDIR/poi-poifs.jar:$HSSFDIR/poi-util.jar:$LOG4JDIR/log4j.jar</span>
</li>
<li>type:
Modified: poi/site/publish/encryption.html
URL:
http://svn.apache.org/viewvc/poi/site/publish/encryption.html?rev=1894959&r1=1894958&r2=1894959&view=diff
==============================================================================
--- poi/site/publish/encryption.html (original)
+++ poi/site/publish/encryption.html Thu Nov 11 19:29:50 2021
@@ -827,95 +827,20 @@ document.write("Last Published: " + docu
<h2 class="boxed">Debugging XML signature issues</h2>
<div class="section">
<p>Finding the source of a XML signature problem can be sometimes a pain in
the ... neck, because
- the hashing of the canonicalized form is more or less intransparent
done in the background.</p>
+ the hashing of the canonicalized form is more or less done in the
background.</p>
<p>One of the tripping hazards are <a
href="https://stackoverflow.com/questions/36063375";>different
linebreaks in Windows/Unix</a>, therefore use the non-indent form of
the xmls. Furthermore the
- elements/anchestors containing namespace definitions and the used
prefix might also differ.</p>
+ elements/ancestors containing namespace definitions and the used
prefix might also differ.</p>
<p>The next thing is to compare successful signed documents from Office vs.
POIs generated signature,
i.e. unzip both files and look for differences. Usually the package
relations (*.rels) will be different,
and the sig1.xml, core.xml and [Content_Types].xml due to different
order of the references.</p>
-<p>The package relationsships (*.rels) will be specially handled, i.e. they
will be filtered and only
+<p>The package relationships (*.rels) will be specially handled, i.e. they
will be filtered and only
a subset will be processed - see <a
href="https://www.ecma-international.org/activities/Office%20Open%20XML%20Formats/Draft%20ECMA-376%203rd%20edition,%20March%202011/Office%20Open%20XML%20Part%202%20-%20Open%20Packaging%20Conventions.pdf";>13.2.4.24
Relationships Transform Algorithm</a>.</p>
-<p>POI and Santuario (XmlSec) use <a href="http://www.slf4j.org/";>SLF4J</a>
for logging.
- To get logging information and debug output ...:</p>
+<p>POI and Santuario (XmlSec) use <a
href="https://logging.apache.org/log4j/2.x";>Log4J 2.x</a> and
+ <a href="http://www.slf4j.org/";>SLF4J</a> respectively for
logging.</p>
<ul>
<li>
- add the following JVM parameters:
- <div class="code">
-<div class="codeline">
-<span class="lineno"></span><span class="codebody"></span>
-</div>
-<div class="codeline">
-<span class="lineno"></span><span class="codebody">-Djava.io.tmpdir=<custom
temp directory></span>
-</div>
-<div class="codeline">
-<span class="lineno"></span><span
class="codebody">-Xbootclasspath/p:<preload dir, which contains
/org/apache/xml/security/utils/UnsyncBufferedOutputStream.class></span>
-</div>
-<div class="codeline">
-<span class="lineno"></span><span
class="codebody">-Dorg.apache.poi.util.POILogger=org.apache.poi.util.CommonsLogger</span>
-</div>
-<div class="codeline">
-<span class="lineno"></span><span class="codebody"></span>
-</div>
-</div>
-
-</li>
-
-<li>
- replace commons-logging.jar with <a
href="https://search.maven.org/artifact/org.slf4j/jcl-over-slf4j/1.7.32/jar";>jcl-over-slf4j.jar</a>
-
-</li>
-
-<li>
- beside log4j.jar, add <a
href="https://search.maven.org/artifact/org.slf4j/slf4j-log4j12/1.7.32/jar";>slf4j-log4j12.jar</a>
-
-</li>
-
-<li>
- add a log4j.properties into the path with the following
content:
- <div class="code">
-<div class="codeline">
-<span class="lineno"></span><span class="codebody"></span>
-</div>
-<div class="codeline">
-<span class="lineno"></span><span
class="codebody">log4j.rootLogger=ALL,FILE</span>
-</div>
-<div class="codeline">
-<span class="lineno"></span><span class="codebody"></span>
-</div>
-<div class="codeline">
-<span class="lineno"></span><span class="codebody"># Define the file
appender</span>
-</div>
-<div class="codeline">
-<span class="lineno"></span><span
class="codebody">log4j.appender.FILE=org.apache.log4j.FileAppender</span>
-</div>
-<div class="codeline">
-<span class="lineno"></span><span
class="codebody">log4j.appender.FILE.File=debug.log</span>
-</div>
-<div class="codeline">
-<span class="lineno"></span><span
class="codebody">log4j.appender.FILE.ImmediateFlush=true</span>
-</div>
-<div class="codeline">
-<span class="lineno"></span><span
class="codebody">log4j.appender.FILE.Threshold=debug</span>
-</div>
-<div class="codeline">
-<span class="lineno"></span><span
class="codebody">log4j.appender.FILE.Append=false</span>
-</div>
-<div class="codeline">
-<span class="lineno"></span><span
class="codebody">log4j.appender.FILE.layout=org.apache.log4j.PatternLayout</span>
-</div>
-<div class="codeline">
-<span class="lineno"></span><span
class="codebody">log4j.appender.FILE.layout.conversionPattern=%-5p %c %x -
%m%n</span>
-</div>
-<div class="codeline">
-<span class="lineno"></span><span class="codebody"></span>
-</div>
-</div>
-
-</li>
-
-<li>
To check the processed files in the canonicalized form, the
below UnsyncBufferedOutputStream class needs
to be injected/replaced. Put the .class file in separate
directory and add it to the JVM parameters (see above):
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
