You are viewing a plain text version of this content. The canonical link for it is here.
Posted to site-commits@maven.apache.org by hb...@apache.org on 2016/07/17 07:36:07 UTC
svn commit: r992997 [21/23] - in
/websites/production/maven/components/shared-archives/maven-shared-utils-LATEST:
./ apidocs/ apidocs/org/apache/maven/shared/utils/
apidocs/org/apache/maven/shared/utils/class-use/
apidocs/org/apache/maven/shared/utils/...
Modified: websites/production/maven/components/shared-archives/maven-shared-utils-LATEST/xref/org/apache/maven/shared/utils/io/IOUtil.html
==============================================================================
--- websites/production/maven/components/shared-archives/maven-shared-utils-LATEST/xref/org/apache/maven/shared/utils/io/IOUtil.html (original)
+++ websites/production/maven/components/shared-archives/maven-shared-utils-LATEST/xref/org/apache/maven/shared/utils/io/IOUtil.html Sun Jul 17 07:36:02 2016
@@ -91,8 +91,8 @@
<a class="jxr_linenumber" name="L83" href="#L83">83</a> <em class="jxr_javadoccomment"> *</em>
<a class="jxr_linenumber" name="L84" href="#L84">84</a> <em class="jxr_javadoccomment"> * @author <a href="<a href="mailto:peter@apache.org" target="alexandria_uri">mailto:peter@apache.org</a>">Peter Donald</a></em>
<a class="jxr_linenumber" name="L85" href="#L85">85</a> <em class="jxr_javadoccomment"> * @author <a href="<a href="mailto:jefft@apache.org" target="alexandria_uri">mailto:jefft@apache.org</a>">Jeff Turner</a></em>
-<a class="jxr_linenumber" name="L86" href="#L86">86</a> <em class="jxr_javadoccomment"> * @version CVS $Revision: 1706718 $ $Date: 2015-10-04 21:37:01 +0200 (Sun, 04 Oct 2015) $</em>
-<a class="jxr_linenumber" name="L87" href="#L87">87</a> <em class="jxr_javadoccomment"> * </em>
+<a class="jxr_linenumber" name="L86" href="#L86">86</a> <em class="jxr_javadoccomment"> * @version CVS $Revision: 1750548 $ $Date: 2016-06-28 19:32:21 +0200 (mar., 28 juin 2016) $</em>
+<a class="jxr_linenumber" name="L87" href="#L87">87</a> <em class="jxr_javadoccomment"> *</em>
<a class="jxr_linenumber" name="L88" href="#L88">88</a> <em class="jxr_javadoccomment"> */</em>
<a class="jxr_linenumber" name="L89" href="#L89">89</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">final</strong> <strong class="jxr_keyword">class</strong> <a href="../../../../../../org/apache/maven/shared/utils/io/IOUtil.html">IOUtil</a>
<a class="jxr_linenumber" name="L90" href="#L90">90</a> <em class="jxr_comment">/*</em>
@@ -765,115 +765,525 @@
<a class="jxr_linenumber" name="L757" href="#L757">757</a> <em class="jxr_comment">// ----------------------------------------------------------------------</em>
<a class="jxr_linenumber" name="L758" href="#L758">758</a>
<a class="jxr_linenumber" name="L759" href="#L759">759</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L760" href="#L760">760</a> <em class="jxr_javadoccomment"> * Closes a channel. Channel can be null and any IOException's will be swallowed.</em>
-<a class="jxr_linenumber" name="L761" href="#L761">761</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L762" href="#L762">762</a> <em class="jxr_javadoccomment"> * @param channel The stream to close.</em>
-<a class="jxr_linenumber" name="L763" href="#L763">763</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L764" href="#L764">764</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">void</strong> close( @Nullable Channel channel )
-<a class="jxr_linenumber" name="L765" href="#L765">765</a> {
-<a class="jxr_linenumber" name="L766" href="#L766">766</a> <strong class="jxr_keyword">if</strong> ( channel == <strong class="jxr_keyword">null</strong> )
-<a class="jxr_linenumber" name="L767" href="#L767">767</a> {
-<a class="jxr_linenumber" name="L768" href="#L768">768</a> <strong class="jxr_keyword">return</strong>;
-<a class="jxr_linenumber" name="L769" href="#L769">769</a> }
-<a class="jxr_linenumber" name="L770" href="#L770">770</a>
-<a class="jxr_linenumber" name="L771" href="#L771">771</a> <strong class="jxr_keyword">try</strong>
-<a class="jxr_linenumber" name="L772" href="#L772">772</a> {
-<a class="jxr_linenumber" name="L773" href="#L773">773</a> channel.close();
-<a class="jxr_linenumber" name="L774" href="#L774">774</a> }
-<a class="jxr_linenumber" name="L775" href="#L775">775</a> <strong class="jxr_keyword">catch</strong> ( IOException ex )
-<a class="jxr_linenumber" name="L776" href="#L776">776</a> {
-<a class="jxr_linenumber" name="L777" href="#L777">777</a> <em class="jxr_comment">// ignore</em>
-<a class="jxr_linenumber" name="L778" href="#L778">778</a> }
-<a class="jxr_linenumber" name="L779" href="#L779">779</a> }
-<a class="jxr_linenumber" name="L780" href="#L780">780</a>
-<a class="jxr_linenumber" name="L781" href="#L781">781</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L782" href="#L782">782</a> <em class="jxr_javadoccomment"> * Closes the input stream. The input stream can be null and any IOException's will be swallowed.</em>
-<a class="jxr_linenumber" name="L783" href="#L783">783</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L784" href="#L784">784</a> <em class="jxr_javadoccomment"> * @param inputStream The stream to close.</em>
-<a class="jxr_linenumber" name="L785" href="#L785">785</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L786" href="#L786">786</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">void</strong> close( @Nullable InputStream inputStream )
-<a class="jxr_linenumber" name="L787" href="#L787">787</a> {
-<a class="jxr_linenumber" name="L788" href="#L788">788</a> <strong class="jxr_keyword">if</strong> ( inputStream == <strong class="jxr_keyword">null</strong> )
-<a class="jxr_linenumber" name="L789" href="#L789">789</a> {
-<a class="jxr_linenumber" name="L790" href="#L790">790</a> <strong class="jxr_keyword">return</strong>;
-<a class="jxr_linenumber" name="L791" href="#L791">791</a> }
-<a class="jxr_linenumber" name="L792" href="#L792">792</a>
-<a class="jxr_linenumber" name="L793" href="#L793">793</a> <strong class="jxr_keyword">try</strong>
-<a class="jxr_linenumber" name="L794" href="#L794">794</a> {
-<a class="jxr_linenumber" name="L795" href="#L795">795</a> inputStream.close();
-<a class="jxr_linenumber" name="L796" href="#L796">796</a> }
-<a class="jxr_linenumber" name="L797" href="#L797">797</a> <strong class="jxr_keyword">catch</strong> ( IOException ex )
-<a class="jxr_linenumber" name="L798" href="#L798">798</a> {
-<a class="jxr_linenumber" name="L799" href="#L799">799</a> <em class="jxr_comment">// ignore</em>
-<a class="jxr_linenumber" name="L800" href="#L800">800</a> }
-<a class="jxr_linenumber" name="L801" href="#L801">801</a> }
-<a class="jxr_linenumber" name="L802" href="#L802">802</a>
-<a class="jxr_linenumber" name="L803" href="#L803">803</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L804" href="#L804">804</a> <em class="jxr_javadoccomment"> * Closes the output stream. The output stream can be null and any IOException's will be swallowed.</em>
-<a class="jxr_linenumber" name="L805" href="#L805">805</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L806" href="#L806">806</a> <em class="jxr_javadoccomment"> * @param outputStream The stream to close.</em>
-<a class="jxr_linenumber" name="L807" href="#L807">807</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L808" href="#L808">808</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">void</strong> close( @Nullable OutputStream outputStream )
-<a class="jxr_linenumber" name="L809" href="#L809">809</a> {
-<a class="jxr_linenumber" name="L810" href="#L810">810</a> <strong class="jxr_keyword">if</strong> ( outputStream == <strong class="jxr_keyword">null</strong> )
-<a class="jxr_linenumber" name="L811" href="#L811">811</a> {
-<a class="jxr_linenumber" name="L812" href="#L812">812</a> <strong class="jxr_keyword">return</strong>;
-<a class="jxr_linenumber" name="L813" href="#L813">813</a> }
-<a class="jxr_linenumber" name="L814" href="#L814">814</a>
-<a class="jxr_linenumber" name="L815" href="#L815">815</a> <strong class="jxr_keyword">try</strong>
-<a class="jxr_linenumber" name="L816" href="#L816">816</a> {
-<a class="jxr_linenumber" name="L817" href="#L817">817</a> outputStream.close();
-<a class="jxr_linenumber" name="L818" href="#L818">818</a> }
-<a class="jxr_linenumber" name="L819" href="#L819">819</a> <strong class="jxr_keyword">catch</strong> ( IOException ex )
-<a class="jxr_linenumber" name="L820" href="#L820">820</a> {
-<a class="jxr_linenumber" name="L821" href="#L821">821</a> <em class="jxr_comment">// ignore</em>
-<a class="jxr_linenumber" name="L822" href="#L822">822</a> }
-<a class="jxr_linenumber" name="L823" href="#L823">823</a> }
-<a class="jxr_linenumber" name="L824" href="#L824">824</a>
-<a class="jxr_linenumber" name="L825" href="#L825">825</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L826" href="#L826">826</a> <em class="jxr_javadoccomment"> * Closes the reader. The reader can be null and any IOException's will be swallowed.</em>
-<a class="jxr_linenumber" name="L827" href="#L827">827</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L828" href="#L828">828</a> <em class="jxr_javadoccomment"> * @param reader The reader to close.</em>
-<a class="jxr_linenumber" name="L829" href="#L829">829</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L830" href="#L830">830</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">void</strong> close( @Nullable Reader reader )
-<a class="jxr_linenumber" name="L831" href="#L831">831</a> {
-<a class="jxr_linenumber" name="L832" href="#L832">832</a> <strong class="jxr_keyword">if</strong> ( reader == <strong class="jxr_keyword">null</strong> )
-<a class="jxr_linenumber" name="L833" href="#L833">833</a> {
-<a class="jxr_linenumber" name="L834" href="#L834">834</a> <strong class="jxr_keyword">return</strong>;
-<a class="jxr_linenumber" name="L835" href="#L835">835</a> }
-<a class="jxr_linenumber" name="L836" href="#L836">836</a>
-<a class="jxr_linenumber" name="L837" href="#L837">837</a> <strong class="jxr_keyword">try</strong>
-<a class="jxr_linenumber" name="L838" href="#L838">838</a> {
-<a class="jxr_linenumber" name="L839" href="#L839">839</a> reader.close();
-<a class="jxr_linenumber" name="L840" href="#L840">840</a> }
-<a class="jxr_linenumber" name="L841" href="#L841">841</a> <strong class="jxr_keyword">catch</strong> ( IOException ex )
-<a class="jxr_linenumber" name="L842" href="#L842">842</a> {
-<a class="jxr_linenumber" name="L843" href="#L843">843</a> <em class="jxr_comment">// ignore</em>
-<a class="jxr_linenumber" name="L844" href="#L844">844</a> }
-<a class="jxr_linenumber" name="L845" href="#L845">845</a> }
-<a class="jxr_linenumber" name="L846" href="#L846">846</a>
-<a class="jxr_linenumber" name="L847" href="#L847">847</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L848" href="#L848">848</a> <em class="jxr_javadoccomment"> * Closes the writer. The writer can be null and any IOException's will be swallowed.</em>
-<a class="jxr_linenumber" name="L849" href="#L849">849</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L850" href="#L850">850</a> <em class="jxr_javadoccomment"> * @param writer The writer to close.</em>
-<a class="jxr_linenumber" name="L851" href="#L851">851</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L852" href="#L852">852</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">void</strong> close( @Nullable Writer writer )
-<a class="jxr_linenumber" name="L853" href="#L853">853</a> {
-<a class="jxr_linenumber" name="L854" href="#L854">854</a> <strong class="jxr_keyword">if</strong> ( writer == <strong class="jxr_keyword">null</strong> )
-<a class="jxr_linenumber" name="L855" href="#L855">855</a> {
-<a class="jxr_linenumber" name="L856" href="#L856">856</a> <strong class="jxr_keyword">return</strong>;
-<a class="jxr_linenumber" name="L857" href="#L857">857</a> }
-<a class="jxr_linenumber" name="L858" href="#L858">858</a>
-<a class="jxr_linenumber" name="L859" href="#L859">859</a> <strong class="jxr_keyword">try</strong>
-<a class="jxr_linenumber" name="L860" href="#L860">860</a> {
-<a class="jxr_linenumber" name="L861" href="#L861">861</a> writer.close();
-<a class="jxr_linenumber" name="L862" href="#L862">862</a> }
-<a class="jxr_linenumber" name="L863" href="#L863">863</a> <strong class="jxr_keyword">catch</strong> ( IOException ex )
-<a class="jxr_linenumber" name="L864" href="#L864">864</a> {
-<a class="jxr_linenumber" name="L865" href="#L865">865</a> <em class="jxr_comment">// ignore</em>
-<a class="jxr_linenumber" name="L866" href="#L866">866</a> }
-<a class="jxr_linenumber" name="L867" href="#L867">867</a> }
-<a class="jxr_linenumber" name="L868" href="#L868">868</a> }
+<a class="jxr_linenumber" name="L760" href="#L760">760</a> <em class="jxr_javadoccomment"> * Closes a {@code Channel} suppressing any {@code IOException}.</em>
+<a class="jxr_linenumber" name="L761" href="#L761">761</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L762" href="#L762">762</a> <em class="jxr_javadoccomment"> * <b>Note:</b><br/>The usecase justifying this method is a shortcoming of the Java language up to but not including</em>
+<a class="jxr_linenumber" name="L763" href="#L763">763</a> <em class="jxr_javadoccomment"> * Java 7. For any code targetting Java 7 or later use of this method is highly discouraged and the</em>
+<a class="jxr_linenumber" name="L764" href="#L764">764</a> <em class="jxr_javadoccomment"> * {@code try-with-resources} statement should be used instead. Care must be taken to not use this method in a way</em>
+<a class="jxr_linenumber" name="L765" href="#L765">765</a> <em class="jxr_javadoccomment"> * {@code IOException}s get suppressed incorrectly.</em>
+<a class="jxr_linenumber" name="L766" href="#L766">766</a> <em class="jxr_javadoccomment"> * <strong>You must close all resources in use inside the {@code try} block to not suppress exceptions in the</em>
+<a class="jxr_linenumber" name="L767" href="#L767">767</a> <em class="jxr_javadoccomment"> * {@code finally} block incorrectly by using this method.</strong></em>
+<a class="jxr_linenumber" name="L768" href="#L768">768</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L769" href="#L769">769</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L770" href="#L770">770</a> <em class="jxr_javadoccomment"> * <b>Example:</b><br/></em>
+<a class="jxr_linenumber" name="L771" href="#L771">771</a> <em class="jxr_javadoccomment"> * <pre></em>
+<a class="jxr_linenumber" name="L772" href="#L772">772</a> <em class="jxr_javadoccomment"> * // Introduce variables for the resources and initialize them to null. This cannot throw an exception.</em>
+<a class="jxr_linenumber" name="L773" href="#L773">773</a> <em class="jxr_javadoccomment"> * Closeable resource1 = null;</em>
+<a class="jxr_linenumber" name="L774" href="#L774">774</a> <em class="jxr_javadoccomment"> * Closeable resource2 = null;</em>
+<a class="jxr_linenumber" name="L775" href="#L775">775</a> <em class="jxr_javadoccomment"> * try</em>
+<a class="jxr_linenumber" name="L776" href="#L776">776</a> <em class="jxr_javadoccomment"> * {</em>
+<a class="jxr_linenumber" name="L777" href="#L777">777</a> <em class="jxr_javadoccomment"> * // Obtain a resource object and assign it to variable resource1. This may throw an exception.</em>
+<a class="jxr_linenumber" name="L778" href="#L778">778</a> <em class="jxr_javadoccomment"> * // If successful, resource1 != null.</em>
+<a class="jxr_linenumber" name="L779" href="#L779">779</a> <em class="jxr_javadoccomment"> * resource1 = ...</em>
+<a class="jxr_linenumber" name="L780" href="#L780">780</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L781" href="#L781">781</a> <em class="jxr_javadoccomment"> * // Obtain a resource object and assign it to variable resource2. This may throw an exception.</em>
+<a class="jxr_linenumber" name="L782" href="#L782">782</a> <em class="jxr_javadoccomment"> * // If successful, resource2 != null. Not reached if an exception has been thrown above.</em>
+<a class="jxr_linenumber" name="L783" href="#L783">783</a> <em class="jxr_javadoccomment"> * resource2 = ...</em>
+<a class="jxr_linenumber" name="L784" href="#L784">784</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L785" href="#L785">785</a> <em class="jxr_javadoccomment"> * // Perform operations on the resources. This may throw an exception. Not reached if an exception has been</em>
+<a class="jxr_linenumber" name="L786" href="#L786">786</a> <em class="jxr_javadoccomment"> * // thrown above. Note: Treat the variables resource1 and resource2 the same way as if they would have been</em>
+<a class="jxr_linenumber" name="L787" href="#L787">787</a> <em class="jxr_javadoccomment"> * // declared with the final modifier - that is - do NOT write anyting like resource1 = something else or</em>
+<a class="jxr_linenumber" name="L788" href="#L788">788</a> <em class="jxr_javadoccomment"> * // resource2 = something else here.</em>
+<a class="jxr_linenumber" name="L789" href="#L789">789</a> <em class="jxr_javadoccomment"> * resource1 ...</em>
+<a class="jxr_linenumber" name="L790" href="#L790">790</a> <em class="jxr_javadoccomment"> * resource2 ...</em>
+<a class="jxr_linenumber" name="L791" href="#L791">791</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L792" href="#L792">792</a> <em class="jxr_javadoccomment"> * // Finally, close the resources and set the variables to null indicating successful completion.</em>
+<a class="jxr_linenumber" name="L793" href="#L793">793</a> <em class="jxr_javadoccomment"> * // This may throw an exception. Not reached if an exception has been thrown above.</em>
+<a class="jxr_linenumber" name="L794" href="#L794">794</a> <em class="jxr_javadoccomment"> * resource1.close();</em>
+<a class="jxr_linenumber" name="L795" href="#L795">795</a> <em class="jxr_javadoccomment"> * resource1 = null;</em>
+<a class="jxr_linenumber" name="L796" href="#L796">796</a> <em class="jxr_javadoccomment"> * // Not reached if an exception has been thrown above.</em>
+<a class="jxr_linenumber" name="L797" href="#L797">797</a> <em class="jxr_javadoccomment"> * resource2.close();</em>
+<a class="jxr_linenumber" name="L798" href="#L798">798</a> <em class="jxr_javadoccomment"> * resource2 = null;</em>
+<a class="jxr_linenumber" name="L799" href="#L799">799</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L800" href="#L800">800</a> <em class="jxr_javadoccomment"> * // All resources are closed at this point and all operations (up to here) completed successfully without</em>
+<a class="jxr_linenumber" name="L801" href="#L801">801</a> <em class="jxr_javadoccomment"> * // throwing an exception we would need to handle (by letting it propagate or by catching and handling it).</em>
+<a class="jxr_linenumber" name="L802" href="#L802">802</a> <em class="jxr_javadoccomment"> * }</em>
+<a class="jxr_linenumber" name="L803" href="#L803">803</a> <em class="jxr_javadoccomment"> * finally</em>
+<a class="jxr_linenumber" name="L804" href="#L804">804</a> <em class="jxr_javadoccomment"> * {</em>
+<a class="jxr_linenumber" name="L805" href="#L805">805</a> <em class="jxr_javadoccomment"> * // Cleanup any resource not closed in the try block due to an exception having been thrown and suppress any</em>
+<a class="jxr_linenumber" name="L806" href="#L806">806</a> <em class="jxr_javadoccomment"> * // exception this may produce to not stop the exception from the try block to be propagated. If the try</em>
+<a class="jxr_linenumber" name="L807" href="#L807">807</a> <em class="jxr_javadoccomment"> * // block completed successfully, all variables will have been set to null there and this will not do</em>
+<a class="jxr_linenumber" name="L808" href="#L808">808</a> <em class="jxr_javadoccomment"> * // anything. This is just to cleanup properly in case of an exception.</em>
+<a class="jxr_linenumber" name="L809" href="#L809">809</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L810" href="#L810">810</a> <em class="jxr_javadoccomment"> * IOUtil.close( resource1 );</em>
+<a class="jxr_linenumber" name="L811" href="#L811">811</a> <em class="jxr_javadoccomment"> * IOUtil.close( resource2 );</em>
+<a class="jxr_linenumber" name="L812" href="#L812">812</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L813" href="#L813">813</a> <em class="jxr_javadoccomment"> * // Without that utility method you would need to write the following:</em>
+<a class="jxr_linenumber" name="L814" href="#L814">814</a> <em class="jxr_javadoccomment"> * //</em>
+<a class="jxr_linenumber" name="L815" href="#L815">815</a> <em class="jxr_javadoccomment"> * // try</em>
+<a class="jxr_linenumber" name="L816" href="#L816">816</a> <em class="jxr_javadoccomment"> * // {</em>
+<a class="jxr_linenumber" name="L817" href="#L817">817</a> <em class="jxr_javadoccomment"> * // if ( resource1 != null )</em>
+<a class="jxr_linenumber" name="L818" href="#L818">818</a> <em class="jxr_javadoccomment"> * // {</em>
+<a class="jxr_linenumber" name="L819" href="#L819">819</a> <em class="jxr_javadoccomment"> * // resource1.close();</em>
+<a class="jxr_linenumber" name="L820" href="#L820">820</a> <em class="jxr_javadoccomment"> * // }</em>
+<a class="jxr_linenumber" name="L821" href="#L821">821</a> <em class="jxr_javadoccomment"> * // }</em>
+<a class="jxr_linenumber" name="L822" href="#L822">822</a> <em class="jxr_javadoccomment"> * // catch( IOException e )</em>
+<a class="jxr_linenumber" name="L823" href="#L823">823</a> <em class="jxr_javadoccomment"> * // {</em>
+<a class="jxr_linenumber" name="L824" href="#L824">824</a> <em class="jxr_javadoccomment"> * // Suppressed. If resource1 != null, an exception has already been thrown in the try block we need to</em>
+<a class="jxr_linenumber" name="L825" href="#L825">825</a> <em class="jxr_javadoccomment"> * // propagate instead of this one.</em>
+<a class="jxr_linenumber" name="L826" href="#L826">826</a> <em class="jxr_javadoccomment"> * // }</em>
+<a class="jxr_linenumber" name="L827" href="#L827">827</a> <em class="jxr_javadoccomment"> * // finally</em>
+<a class="jxr_linenumber" name="L828" href="#L828">828</a> <em class="jxr_javadoccomment"> * // {</em>
+<a class="jxr_linenumber" name="L829" href="#L829">829</a> <em class="jxr_javadoccomment"> * // try</em>
+<a class="jxr_linenumber" name="L830" href="#L830">830</a> <em class="jxr_javadoccomment"> * // {</em>
+<a class="jxr_linenumber" name="L831" href="#L831">831</a> <em class="jxr_javadoccomment"> * // if ( resource2 != null )</em>
+<a class="jxr_linenumber" name="L832" href="#L832">832</a> <em class="jxr_javadoccomment"> * // {</em>
+<a class="jxr_linenumber" name="L833" href="#L833">833</a> <em class="jxr_javadoccomment"> * // resource2.close();</em>
+<a class="jxr_linenumber" name="L834" href="#L834">834</a> <em class="jxr_javadoccomment"> * // }</em>
+<a class="jxr_linenumber" name="L835" href="#L835">835</a> <em class="jxr_javadoccomment"> * // }</em>
+<a class="jxr_linenumber" name="L836" href="#L836">836</a> <em class="jxr_javadoccomment"> * // catch ( IOException e )</em>
+<a class="jxr_linenumber" name="L837" href="#L837">837</a> <em class="jxr_javadoccomment"> * // {</em>
+<a class="jxr_linenumber" name="L838" href="#L838">838</a> <em class="jxr_javadoccomment"> * // Suppressed. If resource2 != null, an exception has already been thrown in the try block we need to</em>
+<a class="jxr_linenumber" name="L839" href="#L839">839</a> <em class="jxr_javadoccomment"> * // propagate instead of this one.</em>
+<a class="jxr_linenumber" name="L840" href="#L840">840</a> <em class="jxr_javadoccomment"> * // }</em>
+<a class="jxr_linenumber" name="L841" href="#L841">841</a> <em class="jxr_javadoccomment"> * // }</em>
+<a class="jxr_linenumber" name="L842" href="#L842">842</a> <em class="jxr_javadoccomment"> * }</em>
+<a class="jxr_linenumber" name="L843" href="#L843">843</a> <em class="jxr_javadoccomment"> * </pre></em>
+<a class="jxr_linenumber" name="L844" href="#L844">844</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L845" href="#L845">845</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L846" href="#L846">846</a> <em class="jxr_javadoccomment"> * @param channel The channel to close or {@code null}.</em>
+<a class="jxr_linenumber" name="L847" href="#L847">847</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L848" href="#L848">848</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">void</strong> close( @Nullable Channel channel )
+<a class="jxr_linenumber" name="L849" href="#L849">849</a> {
+<a class="jxr_linenumber" name="L850" href="#L850">850</a> <strong class="jxr_keyword">try</strong>
+<a class="jxr_linenumber" name="L851" href="#L851">851</a> {
+<a class="jxr_linenumber" name="L852" href="#L852">852</a> <strong class="jxr_keyword">if</strong> ( channel != <strong class="jxr_keyword">null</strong> )
+<a class="jxr_linenumber" name="L853" href="#L853">853</a> {
+<a class="jxr_linenumber" name="L854" href="#L854">854</a> channel.close();
+<a class="jxr_linenumber" name="L855" href="#L855">855</a> }
+<a class="jxr_linenumber" name="L856" href="#L856">856</a> }
+<a class="jxr_linenumber" name="L857" href="#L857">857</a> <strong class="jxr_keyword">catch</strong> ( IOException ex )
+<a class="jxr_linenumber" name="L858" href="#L858">858</a> {
+<a class="jxr_linenumber" name="L859" href="#L859">859</a> <em class="jxr_comment">// Suppressed</em>
+<a class="jxr_linenumber" name="L860" href="#L860">860</a> }
+<a class="jxr_linenumber" name="L861" href="#L861">861</a> }
+<a class="jxr_linenumber" name="L862" href="#L862">862</a>
+<a class="jxr_linenumber" name="L863" href="#L863">863</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L864" href="#L864">864</a> <em class="jxr_javadoccomment"> * Closes an {@code InputStream} suppressing any {@code IOException}.</em>
+<a class="jxr_linenumber" name="L865" href="#L865">865</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L866" href="#L866">866</a> <em class="jxr_javadoccomment"> * <b>Note:</b><br/>The usecase justifying this method is a shortcoming of the Java language up to but not including</em>
+<a class="jxr_linenumber" name="L867" href="#L867">867</a> <em class="jxr_javadoccomment"> * Java 7. For any code targeting Java 7 or later use of this method is highly discouraged and the</em>
+<a class="jxr_linenumber" name="L868" href="#L868">868</a> <em class="jxr_javadoccomment"> * {@code try-with-resources} statement should be used instead. Care must be taken to not use this method in a way</em>
+<a class="jxr_linenumber" name="L869" href="#L869">869</a> <em class="jxr_javadoccomment"> * {@code IOException}s get suppressed incorrectly.</em>
+<a class="jxr_linenumber" name="L870" href="#L870">870</a> <em class="jxr_javadoccomment"> * <strong>You must close all resources in use inside the {@code try} block to not suppress exceptions in the</em>
+<a class="jxr_linenumber" name="L871" href="#L871">871</a> <em class="jxr_javadoccomment"> * {@code finally} block incorrectly by using this method.</strong></em>
+<a class="jxr_linenumber" name="L872" href="#L872">872</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L873" href="#L873">873</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L874" href="#L874">874</a> <em class="jxr_javadoccomment"> * <b>Example:</b><br/></em>
+<a class="jxr_linenumber" name="L875" href="#L875">875</a> <em class="jxr_javadoccomment"> * <pre></em>
+<a class="jxr_linenumber" name="L876" href="#L876">876</a> <em class="jxr_javadoccomment"> * // Introduce variables for the resources and initialize them to null. This cannot throw an exception.</em>
+<a class="jxr_linenumber" name="L877" href="#L877">877</a> <em class="jxr_javadoccomment"> * Closeable resource1 = null;</em>
+<a class="jxr_linenumber" name="L878" href="#L878">878</a> <em class="jxr_javadoccomment"> * Closeable resource2 = null;</em>
+<a class="jxr_linenumber" name="L879" href="#L879">879</a> <em class="jxr_javadoccomment"> * try</em>
+<a class="jxr_linenumber" name="L880" href="#L880">880</a> <em class="jxr_javadoccomment"> * {</em>
+<a class="jxr_linenumber" name="L881" href="#L881">881</a> <em class="jxr_javadoccomment"> * // Obtain a resource object and assign it to variable resource1. This may throw an exception.</em>
+<a class="jxr_linenumber" name="L882" href="#L882">882</a> <em class="jxr_javadoccomment"> * // If successful, resource1 != null.</em>
+<a class="jxr_linenumber" name="L883" href="#L883">883</a> <em class="jxr_javadoccomment"> * resource1 = ...</em>
+<a class="jxr_linenumber" name="L884" href="#L884">884</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L885" href="#L885">885</a> <em class="jxr_javadoccomment"> * // Obtain a resource object and assign it to variable resource2. This may throw an exception.</em>
+<a class="jxr_linenumber" name="L886" href="#L886">886</a> <em class="jxr_javadoccomment"> * // If successful, resource2 != null. Not reached if an exception has been thrown above.</em>
+<a class="jxr_linenumber" name="L887" href="#L887">887</a> <em class="jxr_javadoccomment"> * resource2 = ...</em>
+<a class="jxr_linenumber" name="L888" href="#L888">888</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L889" href="#L889">889</a> <em class="jxr_javadoccomment"> * // Perform operations on the resources. This may throw an exception. Not reached if an exception has been</em>
+<a class="jxr_linenumber" name="L890" href="#L890">890</a> <em class="jxr_javadoccomment"> * // thrown above. Note: Treat the variables resource1 and resource2 the same way as if they would have been</em>
+<a class="jxr_linenumber" name="L891" href="#L891">891</a> <em class="jxr_javadoccomment"> * // declared with the final modifier - that is - do NOT write anyting like resource1 = something else or</em>
+<a class="jxr_linenumber" name="L892" href="#L892">892</a> <em class="jxr_javadoccomment"> * // resource2 = something else here.</em>
+<a class="jxr_linenumber" name="L893" href="#L893">893</a> <em class="jxr_javadoccomment"> * resource1 ...</em>
+<a class="jxr_linenumber" name="L894" href="#L894">894</a> <em class="jxr_javadoccomment"> * resource2 ...</em>
+<a class="jxr_linenumber" name="L895" href="#L895">895</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L896" href="#L896">896</a> <em class="jxr_javadoccomment"> * // Finally, close the resources and set the variables to null indicating successful completion.</em>
+<a class="jxr_linenumber" name="L897" href="#L897">897</a> <em class="jxr_javadoccomment"> * // This may throw an exception. Not reached if an exception has been thrown above.</em>
+<a class="jxr_linenumber" name="L898" href="#L898">898</a> <em class="jxr_javadoccomment"> * resource1.close();</em>
+<a class="jxr_linenumber" name="L899" href="#L899">899</a> <em class="jxr_javadoccomment"> * resource1 = null;</em>
+<a class="jxr_linenumber" name="L900" href="#L900">900</a> <em class="jxr_javadoccomment"> * // This may throw an exception. Not reached if an exception has been thrown above.</em>
+<a class="jxr_linenumber" name="L901" href="#L901">901</a> <em class="jxr_javadoccomment"> * resource2.close();</em>
+<a class="jxr_linenumber" name="L902" href="#L902">902</a> <em class="jxr_javadoccomment"> * resource2 = null;</em>
+<a class="jxr_linenumber" name="L903" href="#L903">903</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L904" href="#L904">904</a> <em class="jxr_javadoccomment"> * // All resources are closed at this point and all operations (up to here) completed successfully without</em>
+<a class="jxr_linenumber" name="L905" href="#L905">905</a> <em class="jxr_javadoccomment"> * // throwing an exception we would need to handle (by letting it propagate or by catching and handling it).</em>
+<a class="jxr_linenumber" name="L906" href="#L906">906</a> <em class="jxr_javadoccomment"> * }</em>
+<a class="jxr_linenumber" name="L907" href="#L907">907</a> <em class="jxr_javadoccomment"> * finally</em>
+<a class="jxr_linenumber" name="L908" href="#L908">908</a> <em class="jxr_javadoccomment"> * {</em>
+<a class="jxr_linenumber" name="L909" href="#L909">909</a> <em class="jxr_javadoccomment"> * // Cleanup any resource not closed in the try block due to an exception having been thrown and suppress any</em>
+<a class="jxr_linenumber" name="L910" href="#L910">910</a> <em class="jxr_javadoccomment"> * // exception this may produce to not stop the exception from the try block to be propagated. If the try</em>
+<a class="jxr_linenumber" name="L911" href="#L911">911</a> <em class="jxr_javadoccomment"> * // block completed successfully, all variables will have been set to null there and this will not do</em>
+<a class="jxr_linenumber" name="L912" href="#L912">912</a> <em class="jxr_javadoccomment"> * // anything. This is just to cleanup properly in case of an exception.</em>
+<a class="jxr_linenumber" name="L913" href="#L913">913</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L914" href="#L914">914</a> <em class="jxr_javadoccomment"> * IOUtil.close( resource1 );</em>
+<a class="jxr_linenumber" name="L915" href="#L915">915</a> <em class="jxr_javadoccomment"> * IOUtil.close( resource2 );</em>
+<a class="jxr_linenumber" name="L916" href="#L916">916</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L917" href="#L917">917</a> <em class="jxr_javadoccomment"> * // Without that utility method you would need to write the following:</em>
+<a class="jxr_linenumber" name="L918" href="#L918">918</a> <em class="jxr_javadoccomment"> * //</em>
+<a class="jxr_linenumber" name="L919" href="#L919">919</a> <em class="jxr_javadoccomment"> * // try</em>
+<a class="jxr_linenumber" name="L920" href="#L920">920</a> <em class="jxr_javadoccomment"> * // {</em>
+<a class="jxr_linenumber" name="L921" href="#L921">921</a> <em class="jxr_javadoccomment"> * // if ( resource1 != null )</em>
+<a class="jxr_linenumber" name="L922" href="#L922">922</a> <em class="jxr_javadoccomment"> * // {</em>
+<a class="jxr_linenumber" name="L923" href="#L923">923</a> <em class="jxr_javadoccomment"> * // resource1.close();</em>
+<a class="jxr_linenumber" name="L924" href="#L924">924</a> <em class="jxr_javadoccomment"> * // }</em>
+<a class="jxr_linenumber" name="L925" href="#L925">925</a> <em class="jxr_javadoccomment"> * // }</em>
+<a class="jxr_linenumber" name="L926" href="#L926">926</a> <em class="jxr_javadoccomment"> * // catch( IOException e )</em>
+<a class="jxr_linenumber" name="L927" href="#L927">927</a> <em class="jxr_javadoccomment"> * // {</em>
+<a class="jxr_linenumber" name="L928" href="#L928">928</a> <em class="jxr_javadoccomment"> * // Suppressed. If resource1 != null, an exception has already been thrown in the try block we need to</em>
+<a class="jxr_linenumber" name="L929" href="#L929">929</a> <em class="jxr_javadoccomment"> * // propagate instead of this one.</em>
+<a class="jxr_linenumber" name="L930" href="#L930">930</a> <em class="jxr_javadoccomment"> * // }</em>
+<a class="jxr_linenumber" name="L931" href="#L931">931</a> <em class="jxr_javadoccomment"> * // finally</em>
+<a class="jxr_linenumber" name="L932" href="#L932">932</a> <em class="jxr_javadoccomment"> * // {</em>
+<a class="jxr_linenumber" name="L933" href="#L933">933</a> <em class="jxr_javadoccomment"> * // try</em>
+<a class="jxr_linenumber" name="L934" href="#L934">934</a> <em class="jxr_javadoccomment"> * // {</em>
+<a class="jxr_linenumber" name="L935" href="#L935">935</a> <em class="jxr_javadoccomment"> * // if ( resource2 != null )</em>
+<a class="jxr_linenumber" name="L936" href="#L936">936</a> <em class="jxr_javadoccomment"> * // {</em>
+<a class="jxr_linenumber" name="L937" href="#L937">937</a> <em class="jxr_javadoccomment"> * // resource2.close();</em>
+<a class="jxr_linenumber" name="L938" href="#L938">938</a> <em class="jxr_javadoccomment"> * // }</em>
+<a class="jxr_linenumber" name="L939" href="#L939">939</a> <em class="jxr_javadoccomment"> * // }</em>
+<a class="jxr_linenumber" name="L940" href="#L940">940</a> <em class="jxr_javadoccomment"> * // catch ( IOException e )</em>
+<a class="jxr_linenumber" name="L941" href="#L941">941</a> <em class="jxr_javadoccomment"> * // {</em>
+<a class="jxr_linenumber" name="L942" href="#L942">942</a> <em class="jxr_javadoccomment"> * // Suppressed. If resource2 != null, an exception has already been thrown in the try block we need to</em>
+<a class="jxr_linenumber" name="L943" href="#L943">943</a> <em class="jxr_javadoccomment"> * // propagate instead of this one.</em>
+<a class="jxr_linenumber" name="L944" href="#L944">944</a> <em class="jxr_javadoccomment"> * // }</em>
+<a class="jxr_linenumber" name="L945" href="#L945">945</a> <em class="jxr_javadoccomment"> * // }</em>
+<a class="jxr_linenumber" name="L946" href="#L946">946</a> <em class="jxr_javadoccomment"> * }</em>
+<a class="jxr_linenumber" name="L947" href="#L947">947</a> <em class="jxr_javadoccomment"> * </pre></em>
+<a class="jxr_linenumber" name="L948" href="#L948">948</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L949" href="#L949">949</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L950" href="#L950">950</a> <em class="jxr_javadoccomment"> * @param inputStream The stream to close or {@code null}.</em>
+<a class="jxr_linenumber" name="L951" href="#L951">951</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L952" href="#L952">952</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">void</strong> close( @Nullable InputStream inputStream )
+<a class="jxr_linenumber" name="L953" href="#L953">953</a> {
+<a class="jxr_linenumber" name="L954" href="#L954">954</a> <strong class="jxr_keyword">try</strong>
+<a class="jxr_linenumber" name="L955" href="#L955">955</a> {
+<a class="jxr_linenumber" name="L956" href="#L956">956</a> <strong class="jxr_keyword">if</strong> ( inputStream != <strong class="jxr_keyword">null</strong> )
+<a class="jxr_linenumber" name="L957" href="#L957">957</a> {
+<a class="jxr_linenumber" name="L958" href="#L958">958</a> inputStream.close();
+<a class="jxr_linenumber" name="L959" href="#L959">959</a> }
+<a class="jxr_linenumber" name="L960" href="#L960">960</a> }
+<a class="jxr_linenumber" name="L961" href="#L961">961</a> <strong class="jxr_keyword">catch</strong> ( IOException ex )
+<a class="jxr_linenumber" name="L962" href="#L962">962</a> {
+<a class="jxr_linenumber" name="L963" href="#L963">963</a> <em class="jxr_comment">// Suppressed</em>
+<a class="jxr_linenumber" name="L964" href="#L964">964</a> }
+<a class="jxr_linenumber" name="L965" href="#L965">965</a> }
+<a class="jxr_linenumber" name="L966" href="#L966">966</a>
+<a class="jxr_linenumber" name="L967" href="#L967">967</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L968" href="#L968">968</a> <em class="jxr_javadoccomment"> * Closes an {@code OutputStream} suppressing any {@code IOException}.</em>
+<a class="jxr_linenumber" name="L969" href="#L969">969</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L970" href="#L970">970</a> <em class="jxr_javadoccomment"> * <b>Note:</b><br/>The usecase justifying this method is a shortcoming of the Java language up to but not including</em>
+<a class="jxr_linenumber" name="L971" href="#L971">971</a> <em class="jxr_javadoccomment"> * Java 7. For any code targeting Java 7 or later use of this method is highly discouraged and the</em>
+<a class="jxr_linenumber" name="L972" href="#L972">972</a> <em class="jxr_javadoccomment"> * {@code try-with-resources} statement should be used instead. Care must be taken to not use this method in a way</em>
+<a class="jxr_linenumber" name="L973" href="#L973">973</a> <em class="jxr_javadoccomment"> * {@code IOException}s get suppressed incorrectly.</em>
+<a class="jxr_linenumber" name="L974" href="#L974">974</a> <em class="jxr_javadoccomment"> * <strong>You must close all resources in use inside the {@code try} block to not suppress exceptions in the</em>
+<a class="jxr_linenumber" name="L975" href="#L975">975</a> <em class="jxr_javadoccomment"> * {@code finally} block incorrectly by using this method.</strong></em>
+<a class="jxr_linenumber" name="L976" href="#L976">976</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L977" href="#L977">977</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L978" href="#L978">978</a> <em class="jxr_javadoccomment"> * <b>Example:</b><br/></em>
+<a class="jxr_linenumber" name="L979" href="#L979">979</a> <em class="jxr_javadoccomment"> * <pre></em>
+<a class="jxr_linenumber" name="L980" href="#L980">980</a> <em class="jxr_javadoccomment"> * // Introduce variables for the resources and initialize them to null. This cannot throw an exception.</em>
+<a class="jxr_linenumber" name="L981" href="#L981">981</a> <em class="jxr_javadoccomment"> * Closeable resource1 = null;</em>
+<a class="jxr_linenumber" name="L982" href="#L982">982</a> <em class="jxr_javadoccomment"> * Closeable resource2 = null;</em>
+<a class="jxr_linenumber" name="L983" href="#L983">983</a> <em class="jxr_javadoccomment"> * try</em>
+<a class="jxr_linenumber" name="L984" href="#L984">984</a> <em class="jxr_javadoccomment"> * {</em>
+<a class="jxr_linenumber" name="L985" href="#L985">985</a> <em class="jxr_javadoccomment"> * // Obtain a resource object and assign it to variable resource1. This may throw an exception.</em>
+<a class="jxr_linenumber" name="L986" href="#L986">986</a> <em class="jxr_javadoccomment"> * // If successful, resource1 != null.</em>
+<a class="jxr_linenumber" name="L987" href="#L987">987</a> <em class="jxr_javadoccomment"> * resource1 = ...</em>
+<a class="jxr_linenumber" name="L988" href="#L988">988</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L989" href="#L989">989</a> <em class="jxr_javadoccomment"> * // Obtain a resource object and assign it to variable resource2. This may throw an exception.</em>
+<a class="jxr_linenumber" name="L990" href="#L990">990</a> <em class="jxr_javadoccomment"> * // If successful, resource2 != null. Not reached if an exception has been thrown above.</em>
+<a class="jxr_linenumber" name="L991" href="#L991">991</a> <em class="jxr_javadoccomment"> * resource2 = ...</em>
+<a class="jxr_linenumber" name="L992" href="#L992">992</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L993" href="#L993">993</a> <em class="jxr_javadoccomment"> * // Perform operations on the resources. This may throw an exception. Not reached if an exception has been</em>
+<a class="jxr_linenumber" name="L994" href="#L994">994</a> <em class="jxr_javadoccomment"> * // thrown above. Note: Treat the variables resource1 and resource2 the same way as if they would have been</em>
+<a class="jxr_linenumber" name="L995" href="#L995">995</a> <em class="jxr_javadoccomment"> * // declared with the final modifier - that is - do NOT write anyting like resource1 = something else or</em>
+<a class="jxr_linenumber" name="L996" href="#L996">996</a> <em class="jxr_javadoccomment"> * // resource2 = something else here.</em>
+<a class="jxr_linenumber" name="L997" href="#L997">997</a> <em class="jxr_javadoccomment"> * resource1 ...</em>
+<a class="jxr_linenumber" name="L998" href="#L998">998</a> <em class="jxr_javadoccomment"> * resource2 ...</em>
+<a class="jxr_linenumber" name="L999" href="#L999">999</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1000" href="#L1000">1000</a> <em class="jxr_javadoccomment"> * // Finally, close the resources and set the variables to null indicating successful completion.</em>
+<a class="jxr_linenumber" name="L1001" href="#L1001">1001</a> <em class="jxr_javadoccomment"> * // This may throw an exception. Not reached if an exception has been thrown above.</em>
+<a class="jxr_linenumber" name="L1002" href="#L1002">1002</a> <em class="jxr_javadoccomment"> * resource1.close();</em>
+<a class="jxr_linenumber" name="L1003" href="#L1003">1003</a> <em class="jxr_javadoccomment"> * resource1 = null;</em>
+<a class="jxr_linenumber" name="L1004" href="#L1004">1004</a> <em class="jxr_javadoccomment"> * // This may throw an exception. Not reached if an exception has been thrown above.</em>
+<a class="jxr_linenumber" name="L1005" href="#L1005">1005</a> <em class="jxr_javadoccomment"> * resource2.close();</em>
+<a class="jxr_linenumber" name="L1006" href="#L1006">1006</a> <em class="jxr_javadoccomment"> * resource2 = null;</em>
+<a class="jxr_linenumber" name="L1007" href="#L1007">1007</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1008" href="#L1008">1008</a> <em class="jxr_javadoccomment"> * // All resources are closed at this point and all operations (up to here) completed successfully without</em>
+<a class="jxr_linenumber" name="L1009" href="#L1009">1009</a> <em class="jxr_javadoccomment"> * // throwing an exception we would need to handle (by letting it propagate or by catching and handling it).</em>
+<a class="jxr_linenumber" name="L1010" href="#L1010">1010</a> <em class="jxr_javadoccomment"> * }</em>
+<a class="jxr_linenumber" name="L1011" href="#L1011">1011</a> <em class="jxr_javadoccomment"> * finally</em>
+<a class="jxr_linenumber" name="L1012" href="#L1012">1012</a> <em class="jxr_javadoccomment"> * {</em>
+<a class="jxr_linenumber" name="L1013" href="#L1013">1013</a> <em class="jxr_javadoccomment"> * // Cleanup any resource not closed in the try block due to an exception having been thrown and suppress any</em>
+<a class="jxr_linenumber" name="L1014" href="#L1014">1014</a> <em class="jxr_javadoccomment"> * // exception this may produce to not stop the exception from the try block to be propagated. If the try</em>
+<a class="jxr_linenumber" name="L1015" href="#L1015">1015</a> <em class="jxr_javadoccomment"> * // block completed successfully, all variables will have been set to null there and this will not do</em>
+<a class="jxr_linenumber" name="L1016" href="#L1016">1016</a> <em class="jxr_javadoccomment"> * // anything. This is just to cleanup properly in case of an exception.</em>
+<a class="jxr_linenumber" name="L1017" href="#L1017">1017</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1018" href="#L1018">1018</a> <em class="jxr_javadoccomment"> * IOUtil.close( resource1 );</em>
+<a class="jxr_linenumber" name="L1019" href="#L1019">1019</a> <em class="jxr_javadoccomment"> * IOUtil.close( resource2 );</em>
+<a class="jxr_linenumber" name="L1020" href="#L1020">1020</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1021" href="#L1021">1021</a> <em class="jxr_javadoccomment"> * // Without that utility method you would need to write the following:</em>
+<a class="jxr_linenumber" name="L1022" href="#L1022">1022</a> <em class="jxr_javadoccomment"> * //</em>
+<a class="jxr_linenumber" name="L1023" href="#L1023">1023</a> <em class="jxr_javadoccomment"> * // try</em>
+<a class="jxr_linenumber" name="L1024" href="#L1024">1024</a> <em class="jxr_javadoccomment"> * // {</em>
+<a class="jxr_linenumber" name="L1025" href="#L1025">1025</a> <em class="jxr_javadoccomment"> * // if ( resource1 != null )</em>
+<a class="jxr_linenumber" name="L1026" href="#L1026">1026</a> <em class="jxr_javadoccomment"> * // {</em>
+<a class="jxr_linenumber" name="L1027" href="#L1027">1027</a> <em class="jxr_javadoccomment"> * // resource1.close();</em>
+<a class="jxr_linenumber" name="L1028" href="#L1028">1028</a> <em class="jxr_javadoccomment"> * // }</em>
+<a class="jxr_linenumber" name="L1029" href="#L1029">1029</a> <em class="jxr_javadoccomment"> * // }</em>
+<a class="jxr_linenumber" name="L1030" href="#L1030">1030</a> <em class="jxr_javadoccomment"> * // catch( IOException e )</em>
+<a class="jxr_linenumber" name="L1031" href="#L1031">1031</a> <em class="jxr_javadoccomment"> * // {</em>
+<a class="jxr_linenumber" name="L1032" href="#L1032">1032</a> <em class="jxr_javadoccomment"> * // Suppressed. If resource1 != null, an exception has already been thrown in the try block we need to</em>
+<a class="jxr_linenumber" name="L1033" href="#L1033">1033</a> <em class="jxr_javadoccomment"> * // propagate instead of this one.</em>
+<a class="jxr_linenumber" name="L1034" href="#L1034">1034</a> <em class="jxr_javadoccomment"> * // }</em>
+<a class="jxr_linenumber" name="L1035" href="#L1035">1035</a> <em class="jxr_javadoccomment"> * // finally</em>
+<a class="jxr_linenumber" name="L1036" href="#L1036">1036</a> <em class="jxr_javadoccomment"> * // {</em>
+<a class="jxr_linenumber" name="L1037" href="#L1037">1037</a> <em class="jxr_javadoccomment"> * // try</em>
+<a class="jxr_linenumber" name="L1038" href="#L1038">1038</a> <em class="jxr_javadoccomment"> * // {</em>
+<a class="jxr_linenumber" name="L1039" href="#L1039">1039</a> <em class="jxr_javadoccomment"> * // if ( resource2 != null )</em>
+<a class="jxr_linenumber" name="L1040" href="#L1040">1040</a> <em class="jxr_javadoccomment"> * // {</em>
+<a class="jxr_linenumber" name="L1041" href="#L1041">1041</a> <em class="jxr_javadoccomment"> * // resource2.close();</em>
+<a class="jxr_linenumber" name="L1042" href="#L1042">1042</a> <em class="jxr_javadoccomment"> * // }</em>
+<a class="jxr_linenumber" name="L1043" href="#L1043">1043</a> <em class="jxr_javadoccomment"> * // }</em>
+<a class="jxr_linenumber" name="L1044" href="#L1044">1044</a> <em class="jxr_javadoccomment"> * // catch ( IOException e )</em>
+<a class="jxr_linenumber" name="L1045" href="#L1045">1045</a> <em class="jxr_javadoccomment"> * // {</em>
+<a class="jxr_linenumber" name="L1046" href="#L1046">1046</a> <em class="jxr_javadoccomment"> * // Suppressed. If resource2 != null, an exception has already been thrown in the try block we need to</em>
+<a class="jxr_linenumber" name="L1047" href="#L1047">1047</a> <em class="jxr_javadoccomment"> * // propagate instead of this one.</em>
+<a class="jxr_linenumber" name="L1048" href="#L1048">1048</a> <em class="jxr_javadoccomment"> * // }</em>
+<a class="jxr_linenumber" name="L1049" href="#L1049">1049</a> <em class="jxr_javadoccomment"> * // }</em>
+<a class="jxr_linenumber" name="L1050" href="#L1050">1050</a> <em class="jxr_javadoccomment"> * }</em>
+<a class="jxr_linenumber" name="L1051" href="#L1051">1051</a> <em class="jxr_javadoccomment"> * </pre></em>
+<a class="jxr_linenumber" name="L1052" href="#L1052">1052</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L1053" href="#L1053">1053</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1054" href="#L1054">1054</a> <em class="jxr_javadoccomment"> * @param outputStream The stream to close or {@code null}.</em>
+<a class="jxr_linenumber" name="L1055" href="#L1055">1055</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L1056" href="#L1056">1056</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">void</strong> close( @Nullable OutputStream outputStream )
+<a class="jxr_linenumber" name="L1057" href="#L1057">1057</a> {
+<a class="jxr_linenumber" name="L1058" href="#L1058">1058</a> <strong class="jxr_keyword">try</strong>
+<a class="jxr_linenumber" name="L1059" href="#L1059">1059</a> {
+<a class="jxr_linenumber" name="L1060" href="#L1060">1060</a> <strong class="jxr_keyword">if</strong> ( outputStream != <strong class="jxr_keyword">null</strong> )
+<a class="jxr_linenumber" name="L1061" href="#L1061">1061</a> {
+<a class="jxr_linenumber" name="L1062" href="#L1062">1062</a> outputStream.close();
+<a class="jxr_linenumber" name="L1063" href="#L1063">1063</a> }
+<a class="jxr_linenumber" name="L1064" href="#L1064">1064</a> }
+<a class="jxr_linenumber" name="L1065" href="#L1065">1065</a> <strong class="jxr_keyword">catch</strong> ( IOException ex )
+<a class="jxr_linenumber" name="L1066" href="#L1066">1066</a> {
+<a class="jxr_linenumber" name="L1067" href="#L1067">1067</a> <em class="jxr_comment">// Suppressed</em>
+<a class="jxr_linenumber" name="L1068" href="#L1068">1068</a> }
+<a class="jxr_linenumber" name="L1069" href="#L1069">1069</a> }
+<a class="jxr_linenumber" name="L1070" href="#L1070">1070</a>
+<a class="jxr_linenumber" name="L1071" href="#L1071">1071</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L1072" href="#L1072">1072</a> <em class="jxr_javadoccomment"> * Closes a {@code Reader} suppressing any {@code IOException}.</em>
+<a class="jxr_linenumber" name="L1073" href="#L1073">1073</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L1074" href="#L1074">1074</a> <em class="jxr_javadoccomment"> * <b>Note:</b><br/>The usecase justifying this method is a shortcoming of the Java language up to but not including</em>
+<a class="jxr_linenumber" name="L1075" href="#L1075">1075</a> <em class="jxr_javadoccomment"> * Java 7. For any code targeting Java 7 or later use of this method is highly discouraged and the</em>
+<a class="jxr_linenumber" name="L1076" href="#L1076">1076</a> <em class="jxr_javadoccomment"> * {@code try-with-resources} statement should be used instead. Care must be taken to not use this method in a way</em>
+<a class="jxr_linenumber" name="L1077" href="#L1077">1077</a> <em class="jxr_javadoccomment"> * {@code IOException}s get suppressed incorrectly.</em>
+<a class="jxr_linenumber" name="L1078" href="#L1078">1078</a> <em class="jxr_javadoccomment"> * <strong>You must close all resources in use inside the {@code try} block to not suppress exceptions in the</em>
+<a class="jxr_linenumber" name="L1079" href="#L1079">1079</a> <em class="jxr_javadoccomment"> * {@code finally} block incorrectly by using this method.</strong></em>
+<a class="jxr_linenumber" name="L1080" href="#L1080">1080</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L1081" href="#L1081">1081</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L1082" href="#L1082">1082</a> <em class="jxr_javadoccomment"> * <b>Example:</b><br/></em>
+<a class="jxr_linenumber" name="L1083" href="#L1083">1083</a> <em class="jxr_javadoccomment"> * <pre></em>
+<a class="jxr_linenumber" name="L1084" href="#L1084">1084</a> <em class="jxr_javadoccomment"> * // Introduce variables for the resources and initialize them to null. This cannot throw an exception.</em>
+<a class="jxr_linenumber" name="L1085" href="#L1085">1085</a> <em class="jxr_javadoccomment"> * Closeable resource1 = null;</em>
+<a class="jxr_linenumber" name="L1086" href="#L1086">1086</a> <em class="jxr_javadoccomment"> * Closeable resource2 = null;</em>
+<a class="jxr_linenumber" name="L1087" href="#L1087">1087</a> <em class="jxr_javadoccomment"> * try</em>
+<a class="jxr_linenumber" name="L1088" href="#L1088">1088</a> <em class="jxr_javadoccomment"> * {</em>
+<a class="jxr_linenumber" name="L1089" href="#L1089">1089</a> <em class="jxr_javadoccomment"> * // Obtain a resource object and assign it to variable resource1. This may throw an exception.</em>
+<a class="jxr_linenumber" name="L1090" href="#L1090">1090</a> <em class="jxr_javadoccomment"> * // If successful, resource1 != null.</em>
+<a class="jxr_linenumber" name="L1091" href="#L1091">1091</a> <em class="jxr_javadoccomment"> * resource1 = ...</em>
+<a class="jxr_linenumber" name="L1092" href="#L1092">1092</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1093" href="#L1093">1093</a> <em class="jxr_javadoccomment"> * // Obtain a resource object and assign it to variable resource2. This may throw an exception.</em>
+<a class="jxr_linenumber" name="L1094" href="#L1094">1094</a> <em class="jxr_javadoccomment"> * // If successful, resource2 != null. Not reached if an exception has been thrown above.</em>
+<a class="jxr_linenumber" name="L1095" href="#L1095">1095</a> <em class="jxr_javadoccomment"> * resource2 = ...</em>
+<a class="jxr_linenumber" name="L1096" href="#L1096">1096</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1097" href="#L1097">1097</a> <em class="jxr_javadoccomment"> * // Perform operations on the resources. This may throw an exception. Not reached if an exception has been</em>
+<a class="jxr_linenumber" name="L1098" href="#L1098">1098</a> <em class="jxr_javadoccomment"> * // thrown above. Note: Treat the variables resource1 and resource2 the same way as if they would have been</em>
+<a class="jxr_linenumber" name="L1099" href="#L1099">1099</a> <em class="jxr_javadoccomment"> * // declared with the final modifier - that is - do NOT write anyting like resource1 = something else or</em>
+<a class="jxr_linenumber" name="L1100" href="#L1100">1100</a> <em class="jxr_javadoccomment"> * // resource2 = something else here.</em>
+<a class="jxr_linenumber" name="L1101" href="#L1101">1101</a> <em class="jxr_javadoccomment"> * resource1 ...</em>
+<a class="jxr_linenumber" name="L1102" href="#L1102">1102</a> <em class="jxr_javadoccomment"> * resource2 ...</em>
+<a class="jxr_linenumber" name="L1103" href="#L1103">1103</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1104" href="#L1104">1104</a> <em class="jxr_javadoccomment"> * // Finally, close the resources and set the variables to null indicating successful completion.</em>
+<a class="jxr_linenumber" name="L1105" href="#L1105">1105</a> <em class="jxr_javadoccomment"> * // This may throw an exception. Not reached if an exception has been thrown above.</em>
+<a class="jxr_linenumber" name="L1106" href="#L1106">1106</a> <em class="jxr_javadoccomment"> * resource1.close();</em>
+<a class="jxr_linenumber" name="L1107" href="#L1107">1107</a> <em class="jxr_javadoccomment"> * resource1 = null;</em>
+<a class="jxr_linenumber" name="L1108" href="#L1108">1108</a> <em class="jxr_javadoccomment"> * // This may throw an exception. Not reached if an exception has been thrown above.</em>
+<a class="jxr_linenumber" name="L1109" href="#L1109">1109</a> <em class="jxr_javadoccomment"> * resource2.close();</em>
+<a class="jxr_linenumber" name="L1110" href="#L1110">1110</a> <em class="jxr_javadoccomment"> * resource2 = null;</em>
+<a class="jxr_linenumber" name="L1111" href="#L1111">1111</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1112" href="#L1112">1112</a> <em class="jxr_javadoccomment"> * // All resources are closed at this point and all operations (up to here) completed successfully without</em>
+<a class="jxr_linenumber" name="L1113" href="#L1113">1113</a> <em class="jxr_javadoccomment"> * // throwing an exception we would need to handle (by letting it propagate or by catching and handling it).</em>
+<a class="jxr_linenumber" name="L1114" href="#L1114">1114</a> <em class="jxr_javadoccomment"> * }</em>
+<a class="jxr_linenumber" name="L1115" href="#L1115">1115</a> <em class="jxr_javadoccomment"> * finally</em>
+<a class="jxr_linenumber" name="L1116" href="#L1116">1116</a> <em class="jxr_javadoccomment"> * {</em>
+<a class="jxr_linenumber" name="L1117" href="#L1117">1117</a> <em class="jxr_javadoccomment"> * // Cleanup any resource not closed in the try block due to an exception having been thrown and suppress any</em>
+<a class="jxr_linenumber" name="L1118" href="#L1118">1118</a> <em class="jxr_javadoccomment"> * // exception this may produce to not stop the exception from the try block to be propagated. If the try</em>
+<a class="jxr_linenumber" name="L1119" href="#L1119">1119</a> <em class="jxr_javadoccomment"> * // block completed successfully, all variables will have been set to null there and this will not do</em>
+<a class="jxr_linenumber" name="L1120" href="#L1120">1120</a> <em class="jxr_javadoccomment"> * // anything. This is just to cleanup properly in case of an exception.</em>
+<a class="jxr_linenumber" name="L1121" href="#L1121">1121</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1122" href="#L1122">1122</a> <em class="jxr_javadoccomment"> * IOUtil.close( resource1 );</em>
+<a class="jxr_linenumber" name="L1123" href="#L1123">1123</a> <em class="jxr_javadoccomment"> * IOUtil.close( resource2 );</em>
+<a class="jxr_linenumber" name="L1124" href="#L1124">1124</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1125" href="#L1125">1125</a> <em class="jxr_javadoccomment"> * // Without that utility method you would need to write the following:</em>
+<a class="jxr_linenumber" name="L1126" href="#L1126">1126</a> <em class="jxr_javadoccomment"> * //</em>
+<a class="jxr_linenumber" name="L1127" href="#L1127">1127</a> <em class="jxr_javadoccomment"> * // try</em>
+<a class="jxr_linenumber" name="L1128" href="#L1128">1128</a> <em class="jxr_javadoccomment"> * // {</em>
+<a class="jxr_linenumber" name="L1129" href="#L1129">1129</a> <em class="jxr_javadoccomment"> * // if ( resource1 != null )</em>
+<a class="jxr_linenumber" name="L1130" href="#L1130">1130</a> <em class="jxr_javadoccomment"> * // {</em>
+<a class="jxr_linenumber" name="L1131" href="#L1131">1131</a> <em class="jxr_javadoccomment"> * // resource1.close();</em>
+<a class="jxr_linenumber" name="L1132" href="#L1132">1132</a> <em class="jxr_javadoccomment"> * // }</em>
+<a class="jxr_linenumber" name="L1133" href="#L1133">1133</a> <em class="jxr_javadoccomment"> * // }</em>
+<a class="jxr_linenumber" name="L1134" href="#L1134">1134</a> <em class="jxr_javadoccomment"> * // catch( IOException e )</em>
+<a class="jxr_linenumber" name="L1135" href="#L1135">1135</a> <em class="jxr_javadoccomment"> * // {</em>
+<a class="jxr_linenumber" name="L1136" href="#L1136">1136</a> <em class="jxr_javadoccomment"> * // Suppressed. If resource1 != null, an exception has already been thrown in the try block we need to</em>
+<a class="jxr_linenumber" name="L1137" href="#L1137">1137</a> <em class="jxr_javadoccomment"> * // propagate instead of this one.</em>
+<a class="jxr_linenumber" name="L1138" href="#L1138">1138</a> <em class="jxr_javadoccomment"> * // }</em>
+<a class="jxr_linenumber" name="L1139" href="#L1139">1139</a> <em class="jxr_javadoccomment"> * // finally</em>
+<a class="jxr_linenumber" name="L1140" href="#L1140">1140</a> <em class="jxr_javadoccomment"> * // {</em>
+<a class="jxr_linenumber" name="L1141" href="#L1141">1141</a> <em class="jxr_javadoccomment"> * // try</em>
+<a class="jxr_linenumber" name="L1142" href="#L1142">1142</a> <em class="jxr_javadoccomment"> * // {</em>
+<a class="jxr_linenumber" name="L1143" href="#L1143">1143</a> <em class="jxr_javadoccomment"> * // if ( resource2 != null )</em>
+<a class="jxr_linenumber" name="L1144" href="#L1144">1144</a> <em class="jxr_javadoccomment"> * // {</em>
+<a class="jxr_linenumber" name="L1145" href="#L1145">1145</a> <em class="jxr_javadoccomment"> * // resource2.close();</em>
+<a class="jxr_linenumber" name="L1146" href="#L1146">1146</a> <em class="jxr_javadoccomment"> * // }</em>
+<a class="jxr_linenumber" name="L1147" href="#L1147">1147</a> <em class="jxr_javadoccomment"> * // }</em>
+<a class="jxr_linenumber" name="L1148" href="#L1148">1148</a> <em class="jxr_javadoccomment"> * // catch ( IOException e )</em>
+<a class="jxr_linenumber" name="L1149" href="#L1149">1149</a> <em class="jxr_javadoccomment"> * // {</em>
+<a class="jxr_linenumber" name="L1150" href="#L1150">1150</a> <em class="jxr_javadoccomment"> * // Suppressed. If resource2 != null, an exception has already been thrown in the try block we need to</em>
+<a class="jxr_linenumber" name="L1151" href="#L1151">1151</a> <em class="jxr_javadoccomment"> * // propagate instead of this one.</em>
+<a class="jxr_linenumber" name="L1152" href="#L1152">1152</a> <em class="jxr_javadoccomment"> * // }</em>
+<a class="jxr_linenumber" name="L1153" href="#L1153">1153</a> <em class="jxr_javadoccomment"> * // }</em>
+<a class="jxr_linenumber" name="L1154" href="#L1154">1154</a> <em class="jxr_javadoccomment"> * }</em>
+<a class="jxr_linenumber" name="L1155" href="#L1155">1155</a> <em class="jxr_javadoccomment"> * </pre></em>
+<a class="jxr_linenumber" name="L1156" href="#L1156">1156</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L1157" href="#L1157">1157</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1158" href="#L1158">1158</a> <em class="jxr_javadoccomment"> * @param reader The reader to close or {@code null}.</em>
+<a class="jxr_linenumber" name="L1159" href="#L1159">1159</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L1160" href="#L1160">1160</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">void</strong> close( @Nullable Reader reader )
+<a class="jxr_linenumber" name="L1161" href="#L1161">1161</a> {
+<a class="jxr_linenumber" name="L1162" href="#L1162">1162</a> <strong class="jxr_keyword">try</strong>
+<a class="jxr_linenumber" name="L1163" href="#L1163">1163</a> {
+<a class="jxr_linenumber" name="L1164" href="#L1164">1164</a> <strong class="jxr_keyword">if</strong> ( reader != <strong class="jxr_keyword">null</strong> )
+<a class="jxr_linenumber" name="L1165" href="#L1165">1165</a> {
+<a class="jxr_linenumber" name="L1166" href="#L1166">1166</a> reader.close();
+<a class="jxr_linenumber" name="L1167" href="#L1167">1167</a> }
+<a class="jxr_linenumber" name="L1168" href="#L1168">1168</a> }
+<a class="jxr_linenumber" name="L1169" href="#L1169">1169</a> <strong class="jxr_keyword">catch</strong> ( IOException ex )
+<a class="jxr_linenumber" name="L1170" href="#L1170">1170</a> {
+<a class="jxr_linenumber" name="L1171" href="#L1171">1171</a> <em class="jxr_comment">// Suppressed</em>
+<a class="jxr_linenumber" name="L1172" href="#L1172">1172</a> }
+<a class="jxr_linenumber" name="L1173" href="#L1173">1173</a> }
+<a class="jxr_linenumber" name="L1174" href="#L1174">1174</a>
+<a class="jxr_linenumber" name="L1175" href="#L1175">1175</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L1176" href="#L1176">1176</a> <em class="jxr_javadoccomment"> * Closes a {@code Writer} suppressing any {@code IOException}.</em>
+<a class="jxr_linenumber" name="L1177" href="#L1177">1177</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L1178" href="#L1178">1178</a> <em class="jxr_javadoccomment"> * <b>Note:</b><br/>The usecase justifying this method is a shortcoming of the Java language up to but not including</em>
+<a class="jxr_linenumber" name="L1179" href="#L1179">1179</a> <em class="jxr_javadoccomment"> * Java 7. For any code targeting Java 7 or later use of this method is highly discouraged and the</em>
+<a class="jxr_linenumber" name="L1180" href="#L1180">1180</a> <em class="jxr_javadoccomment"> * {@code try-with-resources} statement should be used instead. Care must be taken to not use this method in a way</em>
+<a class="jxr_linenumber" name="L1181" href="#L1181">1181</a> <em class="jxr_javadoccomment"> * {@code IOException}s get suppressed incorrectly.</em>
+<a class="jxr_linenumber" name="L1182" href="#L1182">1182</a> <em class="jxr_javadoccomment"> * <strong>You must close all resources in use inside the {@code try} block to not suppress exceptions in the</em>
+<a class="jxr_linenumber" name="L1183" href="#L1183">1183</a> <em class="jxr_javadoccomment"> * {@code finally} block incorrectly by using this method.</strong></em>
+<a class="jxr_linenumber" name="L1184" href="#L1184">1184</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L1185" href="#L1185">1185</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L1186" href="#L1186">1186</a> <em class="jxr_javadoccomment"> * <b>Example:</b><br/></em>
+<a class="jxr_linenumber" name="L1187" href="#L1187">1187</a> <em class="jxr_javadoccomment"> * <pre></em>
+<a class="jxr_linenumber" name="L1188" href="#L1188">1188</a> <em class="jxr_javadoccomment"> * // Introduce variables for the resources and initialize them to null. This cannot throw an exception.</em>
+<a class="jxr_linenumber" name="L1189" href="#L1189">1189</a> <em class="jxr_javadoccomment"> * Closeable resource1 = null;</em>
+<a class="jxr_linenumber" name="L1190" href="#L1190">1190</a> <em class="jxr_javadoccomment"> * Closeable resource2 = null;</em>
+<a class="jxr_linenumber" name="L1191" href="#L1191">1191</a> <em class="jxr_javadoccomment"> * try</em>
+<a class="jxr_linenumber" name="L1192" href="#L1192">1192</a> <em class="jxr_javadoccomment"> * {</em>
+<a class="jxr_linenumber" name="L1193" href="#L1193">1193</a> <em class="jxr_javadoccomment"> * // Obtain a resource object and assign it to variable resource1. This may throw an exception.</em>
+<a class="jxr_linenumber" name="L1194" href="#L1194">1194</a> <em class="jxr_javadoccomment"> * // If successful, resource1 != null.</em>
+<a class="jxr_linenumber" name="L1195" href="#L1195">1195</a> <em class="jxr_javadoccomment"> * resource1 = ...</em>
+<a class="jxr_linenumber" name="L1196" href="#L1196">1196</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1197" href="#L1197">1197</a> <em class="jxr_javadoccomment"> * // Obtain a resource object and assign it to variable resource2. This may throw an exception.</em>
+<a class="jxr_linenumber" name="L1198" href="#L1198">1198</a> <em class="jxr_javadoccomment"> * // If successful, resource2 != null. Not reached if an exception has been thrown above.</em>
+<a class="jxr_linenumber" name="L1199" href="#L1199">1199</a> <em class="jxr_javadoccomment"> * resource2 = ...</em>
+<a class="jxr_linenumber" name="L1200" href="#L1200">1200</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1201" href="#L1201">1201</a> <em class="jxr_javadoccomment"> * // Perform operations on the resources. This may throw an exception. Not reached if an exception has been</em>
+<a class="jxr_linenumber" name="L1202" href="#L1202">1202</a> <em class="jxr_javadoccomment"> * // thrown above. Note: Treat the variables resource1 and resource2 the same way as if they would have been</em>
+<a class="jxr_linenumber" name="L1203" href="#L1203">1203</a> <em class="jxr_javadoccomment"> * // declared with the final modifier - that is - do NOT write anyting like resource1 = something else or</em>
+<a class="jxr_linenumber" name="L1204" href="#L1204">1204</a> <em class="jxr_javadoccomment"> * // resource2 = something else here.</em>
+<a class="jxr_linenumber" name="L1205" href="#L1205">1205</a> <em class="jxr_javadoccomment"> * resource1 ...</em>
+<a class="jxr_linenumber" name="L1206" href="#L1206">1206</a> <em class="jxr_javadoccomment"> * resource2 ...</em>
+<a class="jxr_linenumber" name="L1207" href="#L1207">1207</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1208" href="#L1208">1208</a> <em class="jxr_javadoccomment"> * // Finally, close the resources and set the variables to null indicating successful completion.</em>
+<a class="jxr_linenumber" name="L1209" href="#L1209">1209</a> <em class="jxr_javadoccomment"> * // This may throw an exception. Not reached if an exception has been thrown above.</em>
+<a class="jxr_linenumber" name="L1210" href="#L1210">1210</a> <em class="jxr_javadoccomment"> * resource1.close();</em>
+<a class="jxr_linenumber" name="L1211" href="#L1211">1211</a> <em class="jxr_javadoccomment"> * resource1 = null;</em>
+<a class="jxr_linenumber" name="L1212" href="#L1212">1212</a> <em class="jxr_javadoccomment"> * // This may throw an exception. Not reached if an exception has been thrown above.</em>
+<a class="jxr_linenumber" name="L1213" href="#L1213">1213</a> <em class="jxr_javadoccomment"> * resource2.close();</em>
+<a class="jxr_linenumber" name="L1214" href="#L1214">1214</a> <em class="jxr_javadoccomment"> * resource2 = null;</em>
+<a class="jxr_linenumber" name="L1215" href="#L1215">1215</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1216" href="#L1216">1216</a> <em class="jxr_javadoccomment"> * // All resources are closed at this point and all operations (up to here) completed successfully without</em>
+<a class="jxr_linenumber" name="L1217" href="#L1217">1217</a> <em class="jxr_javadoccomment"> * // throwing an exception we would need to handle (by letting it propagate or by catching and handling it).</em>
+<a class="jxr_linenumber" name="L1218" href="#L1218">1218</a> <em class="jxr_javadoccomment"> * }</em>
+<a class="jxr_linenumber" name="L1219" href="#L1219">1219</a> <em class="jxr_javadoccomment"> * finally</em>
+<a class="jxr_linenumber" name="L1220" href="#L1220">1220</a> <em class="jxr_javadoccomment"> * {</em>
+<a class="jxr_linenumber" name="L1221" href="#L1221">1221</a> <em class="jxr_javadoccomment"> * // Cleanup any resource not closed in the try block due to an exception having been thrown and suppress any</em>
+<a class="jxr_linenumber" name="L1222" href="#L1222">1222</a> <em class="jxr_javadoccomment"> * // exception this may produce to not stop the exception from the try block to be propagated. If the try</em>
+<a class="jxr_linenumber" name="L1223" href="#L1223">1223</a> <em class="jxr_javadoccomment"> * // block completed successfully, all variables will have been set to null there and this will not do</em>
+<a class="jxr_linenumber" name="L1224" href="#L1224">1224</a> <em class="jxr_javadoccomment"> * // anything. This is just to cleanup properly in case of an exception.</em>
+<a class="jxr_linenumber" name="L1225" href="#L1225">1225</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1226" href="#L1226">1226</a> <em class="jxr_javadoccomment"> * IOUtil.close( resource1 );</em>
+<a class="jxr_linenumber" name="L1227" href="#L1227">1227</a> <em class="jxr_javadoccomment"> * IOUtil.close( resource2 );</em>
+<a class="jxr_linenumber" name="L1228" href="#L1228">1228</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1229" href="#L1229">1229</a> <em class="jxr_javadoccomment"> * // Without that utility method you would need to write the following:</em>
+<a class="jxr_linenumber" name="L1230" href="#L1230">1230</a> <em class="jxr_javadoccomment"> * //</em>
+<a class="jxr_linenumber" name="L1231" href="#L1231">1231</a> <em class="jxr_javadoccomment"> * // try</em>
+<a class="jxr_linenumber" name="L1232" href="#L1232">1232</a> <em class="jxr_javadoccomment"> * // {</em>
+<a class="jxr_linenumber" name="L1233" href="#L1233">1233</a> <em class="jxr_javadoccomment"> * // if ( resource1 != null )</em>
+<a class="jxr_linenumber" name="L1234" href="#L1234">1234</a> <em class="jxr_javadoccomment"> * // {</em>
+<a class="jxr_linenumber" name="L1235" href="#L1235">1235</a> <em class="jxr_javadoccomment"> * // resource1.close();</em>
+<a class="jxr_linenumber" name="L1236" href="#L1236">1236</a> <em class="jxr_javadoccomment"> * // }</em>
+<a class="jxr_linenumber" name="L1237" href="#L1237">1237</a> <em class="jxr_javadoccomment"> * // }</em>
+<a class="jxr_linenumber" name="L1238" href="#L1238">1238</a> <em class="jxr_javadoccomment"> * // catch( IOException e )</em>
+<a class="jxr_linenumber" name="L1239" href="#L1239">1239</a> <em class="jxr_javadoccomment"> * // {</em>
+<a class="jxr_linenumber" name="L1240" href="#L1240">1240</a> <em class="jxr_javadoccomment"> * // Suppressed. If resource1 != null, an exception has already been thrown in the try block we need to</em>
+<a class="jxr_linenumber" name="L1241" href="#L1241">1241</a> <em class="jxr_javadoccomment"> * // propagate instead of this one.</em>
+<a class="jxr_linenumber" name="L1242" href="#L1242">1242</a> <em class="jxr_javadoccomment"> * // }</em>
+<a class="jxr_linenumber" name="L1243" href="#L1243">1243</a> <em class="jxr_javadoccomment"> * // finally</em>
+<a class="jxr_linenumber" name="L1244" href="#L1244">1244</a> <em class="jxr_javadoccomment"> * // {</em>
+<a class="jxr_linenumber" name="L1245" href="#L1245">1245</a> <em class="jxr_javadoccomment"> * // try</em>
+<a class="jxr_linenumber" name="L1246" href="#L1246">1246</a> <em class="jxr_javadoccomment"> * // {</em>
+<a class="jxr_linenumber" name="L1247" href="#L1247">1247</a> <em class="jxr_javadoccomment"> * // if ( resource2 != null )</em>
+<a class="jxr_linenumber" name="L1248" href="#L1248">1248</a> <em class="jxr_javadoccomment"> * // {</em>
+<a class="jxr_linenumber" name="L1249" href="#L1249">1249</a> <em class="jxr_javadoccomment"> * // resource2.close();</em>
+<a class="jxr_linenumber" name="L1250" href="#L1250">1250</a> <em class="jxr_javadoccomment"> * // }</em>
+<a class="jxr_linenumber" name="L1251" href="#L1251">1251</a> <em class="jxr_javadoccomment"> * // }</em>
+<a class="jxr_linenumber" name="L1252" href="#L1252">1252</a> <em class="jxr_javadoccomment"> * // catch ( IOException e )</em>
+<a class="jxr_linenumber" name="L1253" href="#L1253">1253</a> <em class="jxr_javadoccomment"> * // {</em>
+<a class="jxr_linenumber" name="L1254" href="#L1254">1254</a> <em class="jxr_javadoccomment"> * // Suppressed. If resource2 != null, an exception has already been thrown in the try block we need to</em>
+<a class="jxr_linenumber" name="L1255" href="#L1255">1255</a> <em class="jxr_javadoccomment"> * // propagate instead of this one.</em>
+<a class="jxr_linenumber" name="L1256" href="#L1256">1256</a> <em class="jxr_javadoccomment"> * // }</em>
+<a class="jxr_linenumber" name="L1257" href="#L1257">1257</a> <em class="jxr_javadoccomment"> * // }</em>
+<a class="jxr_linenumber" name="L1258" href="#L1258">1258</a> <em class="jxr_javadoccomment"> * }</em>
+<a class="jxr_linenumber" name="L1259" href="#L1259">1259</a> <em class="jxr_javadoccomment"> * </pre></em>
+<a class="jxr_linenumber" name="L1260" href="#L1260">1260</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L1261" href="#L1261">1261</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1262" href="#L1262">1262</a> <em class="jxr_javadoccomment"> * @param writer The writer to close or {@code null}.</em>
+<a class="jxr_linenumber" name="L1263" href="#L1263">1263</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L1264" href="#L1264">1264</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">void</strong> close( @Nullable Writer writer )
+<a class="jxr_linenumber" name="L1265" href="#L1265">1265</a> {
+<a class="jxr_linenumber" name="L1266" href="#L1266">1266</a> <strong class="jxr_keyword">try</strong>
+<a class="jxr_linenumber" name="L1267" href="#L1267">1267</a> {
+<a class="jxr_linenumber" name="L1268" href="#L1268">1268</a> <strong class="jxr_keyword">if</strong> ( writer != <strong class="jxr_keyword">null</strong> )
+<a class="jxr_linenumber" name="L1269" href="#L1269">1269</a> {
+<a class="jxr_linenumber" name="L1270" href="#L1270">1270</a> writer.close();
+<a class="jxr_linenumber" name="L1271" href="#L1271">1271</a> }
+<a class="jxr_linenumber" name="L1272" href="#L1272">1272</a> }
+<a class="jxr_linenumber" name="L1273" href="#L1273">1273</a> <strong class="jxr_keyword">catch</strong> ( IOException ex )
+<a class="jxr_linenumber" name="L1274" href="#L1274">1274</a> {
+<a class="jxr_linenumber" name="L1275" href="#L1275">1275</a> <em class="jxr_comment">// Suppressed</em>
+<a class="jxr_linenumber" name="L1276" href="#L1276">1276</a> }
+<a class="jxr_linenumber" name="L1277" href="#L1277">1277</a> }
+<a class="jxr_linenumber" name="L1278" href="#L1278">1278</a> }
</pre>
<hr/>
<div id="footer">Copyright © 2002–2016 <a href="https://www.apache.org/">The Apache Software Foundation</a>. All rights reserved.</div>
Modified: websites/production/maven/components/shared-archives/maven-shared-utils-LATEST/xref/org/apache/maven/shared/utils/io/package-frame.html
==============================================================================
--- websites/production/maven/components/shared-archives/maven-shared-utils-LATEST/xref/org/apache/maven/shared/utils/io/package-frame.html (original)
+++ websites/production/maven/components/shared-archives/maven-shared-utils-LATEST/xref/org/apache/maven/shared/utils/io/package-frame.html Sun Jul 17 07:36:02 2016
@@ -3,7 +3,7 @@
<html xml:lang="en" lang="en">
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8" />
- <title>Apache Maven Shared Utils 3.0.1 Reference Package org.apache.maven.shared.utils.io</title>
+ <title>Apache Maven Shared Utils 3.1.0-SNAPSHOT Reference Package org.apache.maven.shared.utils.io</title>
<link rel="stylesheet" type="text/css" href="../../../../../../stylesheet.css" title="style" />
</head>
<body>
Modified: websites/production/maven/components/shared-archives/maven-shared-utils-LATEST/xref/org/apache/maven/shared/utils/io/package-summary.html
==============================================================================
--- websites/production/maven/components/shared-archives/maven-shared-utils-LATEST/xref/org/apache/maven/shared/utils/io/package-summary.html (original)
+++ websites/production/maven/components/shared-archives/maven-shared-utils-LATEST/xref/org/apache/maven/shared/utils/io/package-summary.html Sun Jul 17 07:36:02 2016
@@ -3,7 +3,7 @@
<html xml:lang="en" lang="en">
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8" />
- <title>Apache Maven Shared Utils 3.0.1 Reference Package org.apache.maven.shared.utils.io</title>
+ <title>Apache Maven Shared Utils 3.1.0-SNAPSHOT Reference Package org.apache.maven.shared.utils.io</title>
<link rel="stylesheet" type="text/css" href="../../../../../../stylesheet.css" title="style" />
</head>
<body>