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 ti...@apache.org on 2015/06/17 01:06:37 UTC
svn commit: r955072 [33/40] - 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/FileUtils.html
==============================================================================
--- websites/production/maven/components/shared-archives/maven-shared-utils-LATEST/xref/org/apache/maven/shared/utils/io/FileUtils.html (original)
+++ websites/production/maven/components/shared-archives/maven-shared-utils-LATEST/xref/org/apache/maven/shared/utils/io/FileUtils.html Tue Jun 16 23:06:34 2015
@@ -760,1308 +760,1320 @@
<a class="jxr_linenumber" name="L752" href="#L752">752</a> <em class="jxr_javadoccomment"> * @throws java.io.FileNotFoundException if <code>source</code> isn't a normal file.</em>
<a class="jxr_linenumber" name="L753" href="#L753">753</a> <em class="jxr_javadoccomment"> * @throws IllegalArgumentException if <code>destinationDirectory</code> isn't a directory.</em>
<a class="jxr_linenumber" name="L754" href="#L754">754</a> <em class="jxr_javadoccomment"> * @throws IOException if <code>source</code> does not exist, the file in</em>
-<a class="jxr_linenumber" name="L755" href="#L755">755</a> <em class="jxr_javadoccomment"> * <code>destinationDirectory</code> cannot be written to, or an IO error occurs during copying.</em>
-<a class="jxr_linenumber" name="L756" href="#L756">756</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L757" href="#L757">757</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">void</strong> copyFileToDirectory( @Nonnull <strong class="jxr_keyword">final</strong> File source, @Nonnull <strong class="jxr_keyword">final</strong> File destinationDirectory )
-<a class="jxr_linenumber" name="L758" href="#L758">758</a> <strong class="jxr_keyword">throws</strong> IOException
-<a class="jxr_linenumber" name="L759" href="#L759">759</a> {
-<a class="jxr_linenumber" name="L760" href="#L760">760</a> <strong class="jxr_keyword">if</strong> ( destinationDirectory.exists() && !destinationDirectory.isDirectory() )
-<a class="jxr_linenumber" name="L761" href="#L761">761</a> {
-<a class="jxr_linenumber" name="L762" href="#L762">762</a> <strong class="jxr_keyword">throw</strong> <strong class="jxr_keyword">new</strong> IllegalArgumentException( <span class="jxr_string">"Destination is not a directory"</span> );
-<a class="jxr_linenumber" name="L763" href="#L763">763</a> }
-<a class="jxr_linenumber" name="L764" href="#L764">764</a>
-<a class="jxr_linenumber" name="L765" href="#L765">765</a> copyFile( source, <strong class="jxr_keyword">new</strong> File( destinationDirectory, source.getName() ) );
-<a class="jxr_linenumber" name="L766" href="#L766">766</a> }
-<a class="jxr_linenumber" name="L767" href="#L767">767</a>
-<a class="jxr_linenumber" name="L768" href="#L768">768</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L769" href="#L769">769</a> <em class="jxr_javadoccomment"> * Copy file from source to destination only if source is newer than the target file.</em>
-<a class="jxr_linenumber" name="L770" href="#L770">770</a> <em class="jxr_javadoccomment"> * If <code>destinationDirectory</code> does not exist, it</em>
-<a class="jxr_linenumber" name="L771" href="#L771">771</a> <em class="jxr_javadoccomment"> * (and any parent directories) will be created. If a file <code>source</code> in</em>
-<a class="jxr_linenumber" name="L772" href="#L772">772</a> <em class="jxr_javadoccomment"> * <code>destinationDirectory</code> exists, it will be overwritten.</em>
-<a class="jxr_linenumber" name="L773" href="#L773">773</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L774" href="#L774">774</a> <em class="jxr_javadoccomment"> * @param source An existing <code>File</code> to copy.</em>
-<a class="jxr_linenumber" name="L775" href="#L775">775</a> <em class="jxr_javadoccomment"> * @param destinationDirectory A directory to copy <code>source</code> into.</em>
-<a class="jxr_linenumber" name="L776" href="#L776">776</a> <em class="jxr_javadoccomment"> * @throws java.io.FileNotFoundException if <code>source</code> isn't a normal file.</em>
-<a class="jxr_linenumber" name="L777" href="#L777">777</a> <em class="jxr_javadoccomment"> * @throws IllegalArgumentException if <code>destinationDirectory</code> isn't a directory.</em>
-<a class="jxr_linenumber" name="L778" href="#L778">778</a> <em class="jxr_javadoccomment"> * @throws IOException if <code>source</code> does not exist, the file in</em>
-<a class="jxr_linenumber" name="L779" href="#L779">779</a> <em class="jxr_javadoccomment"> * <code>destinationDirectory</code> cannot be written to, or an IO error occurs during copying.</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> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">void</strong> copyFileToDirectoryIfModified( @Nonnull <strong class="jxr_keyword">final</strong> File source,
-<a class="jxr_linenumber" name="L782" href="#L782">782</a> @Nonnull <strong class="jxr_keyword">final</strong> File destinationDirectory )
-<a class="jxr_linenumber" name="L783" href="#L783">783</a> <strong class="jxr_keyword">throws</strong> IOException
-<a class="jxr_linenumber" name="L784" href="#L784">784</a> {
-<a class="jxr_linenumber" name="L785" href="#L785">785</a> <strong class="jxr_keyword">if</strong> ( destinationDirectory.exists() && !destinationDirectory.isDirectory() )
-<a class="jxr_linenumber" name="L786" href="#L786">786</a> {
-<a class="jxr_linenumber" name="L787" href="#L787">787</a> <strong class="jxr_keyword">throw</strong> <strong class="jxr_keyword">new</strong> IllegalArgumentException( <span class="jxr_string">"Destination is not a directory"</span> );
-<a class="jxr_linenumber" name="L788" href="#L788">788</a> }
-<a class="jxr_linenumber" name="L789" href="#L789">789</a>
-<a class="jxr_linenumber" name="L790" href="#L790">790</a> copyFileIfModified( source, <strong class="jxr_keyword">new</strong> File( destinationDirectory, source.getName() ) );
-<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>
-<a class="jxr_linenumber" name="L794" href="#L794">794</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L795" href="#L795">795</a> <em class="jxr_javadoccomment"> * Copy file from source to destination. The directories up to <code>destination</code> will be</em>
-<a class="jxr_linenumber" name="L796" href="#L796">796</a> <em class="jxr_javadoccomment"> * created if they don't already exist. <code>destination</code> will be overwritten if it</em>
-<a class="jxr_linenumber" name="L797" href="#L797">797</a> <em class="jxr_javadoccomment"> * already exists.</em>
-<a class="jxr_linenumber" name="L798" href="#L798">798</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L799" href="#L799">799</a> <em class="jxr_javadoccomment"> * @param source An existing non-directory <code>File</code> to copy bytes from.</em>
-<a class="jxr_linenumber" name="L800" href="#L800">800</a> <em class="jxr_javadoccomment"> * @param destination A non-directory <code>File</code> to write bytes to (possibly</em>
-<a class="jxr_linenumber" name="L801" href="#L801">801</a> <em class="jxr_javadoccomment"> * overwriting).</em>
-<a class="jxr_linenumber" name="L802" href="#L802">802</a> <em class="jxr_javadoccomment"> * @throws IOException if <code>source</code> does not exist, <code>destination</code> cannot be</em>
-<a class="jxr_linenumber" name="L803" href="#L803">803</a> <em class="jxr_javadoccomment"> * written to, or an IO error occurs during copying.</em>
-<a class="jxr_linenumber" name="L804" href="#L804">804</a> <em class="jxr_javadoccomment"> * @throws java.io.FileNotFoundException if <code>destination</code> is a directory</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> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">void</strong> copyFile( @Nonnull <strong class="jxr_keyword">final</strong> File source, @Nonnull <strong class="jxr_keyword">final</strong> File destination )
-<a class="jxr_linenumber" name="L807" href="#L807">807</a> <strong class="jxr_keyword">throws</strong> IOException
-<a class="jxr_linenumber" name="L808" href="#L808">808</a> {
-<a class="jxr_linenumber" name="L809" href="#L809">809</a> <em class="jxr_comment">//check source exists</em>
-<a class="jxr_linenumber" name="L810" href="#L810">810</a> <strong class="jxr_keyword">if</strong> ( !source.exists() )
-<a class="jxr_linenumber" name="L811" href="#L811">811</a> {
-<a class="jxr_linenumber" name="L812" href="#L812">812</a> <strong class="jxr_keyword">final</strong> String message = <span class="jxr_string">"File "</span> + source + <span class="jxr_string">" does not exist"</span>;
-<a class="jxr_linenumber" name="L813" href="#L813">813</a> <strong class="jxr_keyword">throw</strong> <strong class="jxr_keyword">new</strong> IOException( message );
-<a class="jxr_linenumber" name="L814" href="#L814">814</a> }
-<a class="jxr_linenumber" name="L815" href="#L815">815</a>
-<a class="jxr_linenumber" name="L816" href="#L816">816</a> <em class="jxr_comment">//check source != destination, see PLXUTILS-10</em>
-<a class="jxr_linenumber" name="L817" href="#L817">817</a> <strong class="jxr_keyword">if</strong> ( source.getCanonicalPath().equals( destination.getCanonicalPath() ) )
+<a class="jxr_linenumber" name="L755" href="#L755">755</a> <em class="jxr_javadoccomment"> * <code>destinationDirectory</code> cannot be written to, or an IO error</em>
+<a class="jxr_linenumber" name="L756" href="#L756">756</a> <em class="jxr_javadoccomment"> * occurs during copying.</em>
+<a class="jxr_linenumber" name="L757" href="#L757">757</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L758" href="#L758">758</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">void</strong> copyFileToDirectory( @Nonnull <strong class="jxr_keyword">final</strong> File source, @Nonnull <strong class="jxr_keyword">final</strong> File destinationDirectory )
+<a class="jxr_linenumber" name="L759" href="#L759">759</a> <strong class="jxr_keyword">throws</strong> IOException
+<a class="jxr_linenumber" name="L760" href="#L760">760</a> {
+<a class="jxr_linenumber" name="L761" href="#L761">761</a> <strong class="jxr_keyword">if</strong> ( destinationDirectory.exists() && !destinationDirectory.isDirectory() )
+<a class="jxr_linenumber" name="L762" href="#L762">762</a> {
+<a class="jxr_linenumber" name="L763" href="#L763">763</a> <strong class="jxr_keyword">throw</strong> <strong class="jxr_keyword">new</strong> IllegalArgumentException( <span class="jxr_string">"Destination is not a directory"</span> );
+<a class="jxr_linenumber" name="L764" href="#L764">764</a> }
+<a class="jxr_linenumber" name="L765" href="#L765">765</a>
+<a class="jxr_linenumber" name="L766" href="#L766">766</a> copyFile( source, <strong class="jxr_keyword">new</strong> File( destinationDirectory, source.getName() ) );
+<a class="jxr_linenumber" name="L767" href="#L767">767</a> }
+<a class="jxr_linenumber" name="L768" href="#L768">768</a>
+<a class="jxr_linenumber" name="L769" href="#L769">769</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L770" href="#L770">770</a> <em class="jxr_javadoccomment"> * Copy file from source to destination only if source is newer than the target file.</em>
+<a class="jxr_linenumber" name="L771" href="#L771">771</a> <em class="jxr_javadoccomment"> * If <code>destinationDirectory</code> does not exist, it</em>
+<a class="jxr_linenumber" name="L772" href="#L772">772</a> <em class="jxr_javadoccomment"> * (and any parent directories) will be created. If a file <code>source</code> in</em>
+<a class="jxr_linenumber" name="L773" href="#L773">773</a> <em class="jxr_javadoccomment"> * <code>destinationDirectory</code> exists, it will be overwritten.</em>
+<a class="jxr_linenumber" name="L774" href="#L774">774</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L775" href="#L775">775</a> <em class="jxr_javadoccomment"> * @param source An existing <code>File</code> to copy.</em>
+<a class="jxr_linenumber" name="L776" href="#L776">776</a> <em class="jxr_javadoccomment"> * @param destinationDirectory A directory to copy <code>source</code> into.</em>
+<a class="jxr_linenumber" name="L777" href="#L777">777</a> <em class="jxr_javadoccomment"> * @throws java.io.FileNotFoundException if <code>source</code> isn't a normal file.</em>
+<a class="jxr_linenumber" name="L778" href="#L778">778</a> <em class="jxr_javadoccomment"> * @throws IllegalArgumentException if <code>destinationDirectory</code> isn't a directory.</em>
+<a class="jxr_linenumber" name="L779" href="#L779">779</a> <em class="jxr_javadoccomment"> * @throws IOException if <code>source</code> does not exist, the file in</em>
+<a class="jxr_linenumber" name="L780" href="#L780">780</a> <em class="jxr_javadoccomment"> * <code>destinationDirectory</code> cannot be written to, or an IO error</em>
+<a class="jxr_linenumber" name="L781" href="#L781">781</a> <em class="jxr_javadoccomment"> * occurs during copying.</em>
+<a class="jxr_linenumber" name="L782" href="#L782">782</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L783" href="#L783">783</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">void</strong> copyFileToDirectoryIfModified( @Nonnull <strong class="jxr_keyword">final</strong> File source,
+<a class="jxr_linenumber" name="L784" href="#L784">784</a> @Nonnull <strong class="jxr_keyword">final</strong> File destinationDirectory )
+<a class="jxr_linenumber" name="L785" href="#L785">785</a> <strong class="jxr_keyword">throws</strong> IOException
+<a class="jxr_linenumber" name="L786" href="#L786">786</a> {
+<a class="jxr_linenumber" name="L787" href="#L787">787</a> <strong class="jxr_keyword">if</strong> ( destinationDirectory.exists() && !destinationDirectory.isDirectory() )
+<a class="jxr_linenumber" name="L788" href="#L788">788</a> {
+<a class="jxr_linenumber" name="L789" href="#L789">789</a> <strong class="jxr_keyword">throw</strong> <strong class="jxr_keyword">new</strong> IllegalArgumentException( <span class="jxr_string">"Destination is not a directory"</span> );
+<a class="jxr_linenumber" name="L790" href="#L790">790</a> }
+<a class="jxr_linenumber" name="L791" href="#L791">791</a>
+<a class="jxr_linenumber" name="L792" href="#L792">792</a> copyFileIfModified( source, <strong class="jxr_keyword">new</strong> File( destinationDirectory, source.getName() ) );
+<a class="jxr_linenumber" name="L793" href="#L793">793</a> }
+<a class="jxr_linenumber" name="L794" href="#L794">794</a>
+<a class="jxr_linenumber" name="L795" href="#L795">795</a>
+<a class="jxr_linenumber" name="L796" href="#L796">796</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L797" href="#L797">797</a> <em class="jxr_javadoccomment"> * Copy file from source to destination. The directories up to <code>destination</code> will be</em>
+<a class="jxr_linenumber" name="L798" href="#L798">798</a> <em class="jxr_javadoccomment"> * created if they don't already exist. <code>destination</code> will be overwritten if it</em>
+<a class="jxr_linenumber" name="L799" href="#L799">799</a> <em class="jxr_javadoccomment"> * already exists.</em>
+<a class="jxr_linenumber" name="L800" href="#L800">800</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L801" href="#L801">801</a> <em class="jxr_javadoccomment"> * @param source An existing non-directory <code>File</code> to copy bytes from.</em>
+<a class="jxr_linenumber" name="L802" href="#L802">802</a> <em class="jxr_javadoccomment"> * @param destination A non-directory <code>File</code> to write bytes to (possibly</em>
+<a class="jxr_linenumber" name="L803" href="#L803">803</a> <em class="jxr_javadoccomment"> * overwriting).</em>
+<a class="jxr_linenumber" name="L804" href="#L804">804</a> <em class="jxr_javadoccomment"> * @throws IOException if <code>source</code> does not exist, <code>destination</code> cannot be</em>
+<a class="jxr_linenumber" name="L805" href="#L805">805</a> <em class="jxr_javadoccomment"> * written to, or an IO error occurs during copying.</em>
+<a class="jxr_linenumber" name="L806" href="#L806">806</a> <em class="jxr_javadoccomment"> * @throws java.io.FileNotFoundException if <code>destination</code> is a directory</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> copyFile( @Nonnull <strong class="jxr_keyword">final</strong> File source, @Nonnull <strong class="jxr_keyword">final</strong> File destination )
+<a class="jxr_linenumber" name="L809" href="#L809">809</a> <strong class="jxr_keyword">throws</strong> IOException
+<a class="jxr_linenumber" name="L810" href="#L810">810</a> {
+<a class="jxr_linenumber" name="L811" href="#L811">811</a> <em class="jxr_comment">//check source exists</em>
+<a class="jxr_linenumber" name="L812" href="#L812">812</a> <strong class="jxr_keyword">if</strong> ( !source.exists() )
+<a class="jxr_linenumber" name="L813" href="#L813">813</a> {
+<a class="jxr_linenumber" name="L814" href="#L814">814</a> <strong class="jxr_keyword">final</strong> String message = <span class="jxr_string">"File "</span> + source + <span class="jxr_string">" does not exist"</span>;
+<a class="jxr_linenumber" name="L815" href="#L815">815</a> <strong class="jxr_keyword">throw</strong> <strong class="jxr_keyword">new</strong> IOException( message );
+<a class="jxr_linenumber" name="L816" href="#L816">816</a> }
+<a class="jxr_linenumber" name="L817" href="#L817">817</a> <strong class="jxr_keyword">if</strong> ( Java7Support.isAtLeastJava7() && Java7Support.isSymLink( source ) )
<a class="jxr_linenumber" name="L818" href="#L818">818</a> {
-<a class="jxr_linenumber" name="L819" href="#L819">819</a> <em class="jxr_comment">//if they are equal, we can exit the method without doing any work</em>
-<a class="jxr_linenumber" name="L820" href="#L820">820</a> <strong class="jxr_keyword">return</strong>;
-<a class="jxr_linenumber" name="L821" href="#L821">821</a> }
-<a class="jxr_linenumber" name="L822" href="#L822">822</a>
-<a class="jxr_linenumber" name="L823" href="#L823">823</a> mkdirsFor( destination );
-<a class="jxr_linenumber" name="L824" href="#L824">824</a>
-<a class="jxr_linenumber" name="L825" href="#L825">825</a> doCopyFile( source, destination );
-<a class="jxr_linenumber" name="L826" href="#L826">826</a>
-<a class="jxr_linenumber" name="L827" href="#L827">827</a> <strong class="jxr_keyword">if</strong> ( source.length() != destination.length() )
-<a class="jxr_linenumber" name="L828" href="#L828">828</a> {
-<a class="jxr_linenumber" name="L829" href="#L829">829</a> <strong class="jxr_keyword">final</strong> String message = <span class="jxr_string">"Failed to copy full contents from "</span> + source + <span class="jxr_string">" to "</span> + destination;
-<a class="jxr_linenumber" name="L830" href="#L830">830</a> <strong class="jxr_keyword">throw</strong> <strong class="jxr_keyword">new</strong> IOException( message );
-<a class="jxr_linenumber" name="L831" href="#L831">831</a> }
-<a class="jxr_linenumber" name="L832" href="#L832">832</a> }
-<a class="jxr_linenumber" name="L833" href="#L833">833</a>
-<a class="jxr_linenumber" name="L834" href="#L834">834</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">void</strong> mkdirsFor( @Nonnull File destination )
-<a class="jxr_linenumber" name="L835" href="#L835">835</a> {
-<a class="jxr_linenumber" name="L836" href="#L836">836</a> <em class="jxr_comment">//does destination directory exist ?</em>
-<a class="jxr_linenumber" name="L837" href="#L837">837</a> <strong class="jxr_keyword">if</strong> ( destination.getParentFile() != <strong class="jxr_keyword">null</strong> && !destination.getParentFile().exists() )
-<a class="jxr_linenumber" name="L838" href="#L838">838</a> {
-<a class="jxr_linenumber" name="L839" href="#L839">839</a> <em class="jxr_comment">//noinspection ResultOfMethodCallIgnored</em>
-<a class="jxr_linenumber" name="L840" href="#L840">840</a> destination.getParentFile().mkdirs();
-<a class="jxr_linenumber" name="L841" href="#L841">841</a> }
-<a class="jxr_linenumber" name="L842" href="#L842">842</a> }
-<a class="jxr_linenumber" name="L843" href="#L843">843</a>
-<a class="jxr_linenumber" name="L844" href="#L844">844</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">void</strong> doCopyFile( @Nonnull File source, @Nonnull File destination )
-<a class="jxr_linenumber" name="L845" href="#L845">845</a> <strong class="jxr_keyword">throws</strong> IOException
-<a class="jxr_linenumber" name="L846" href="#L846">846</a> {
-<a class="jxr_linenumber" name="L847" href="#L847">847</a> FileInputStream fis = <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L848" href="#L848">848</a> FileOutputStream fos = <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L849" href="#L849">849</a> FileChannel input = <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L850" href="#L850">850</a> FileChannel output = <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L851" href="#L851">851</a> <strong class="jxr_keyword">try</strong>
-<a class="jxr_linenumber" name="L852" href="#L852">852</a> {
-<a class="jxr_linenumber" name="L853" href="#L853">853</a> fis = <strong class="jxr_keyword">new</strong> FileInputStream( source );
-<a class="jxr_linenumber" name="L854" href="#L854">854</a> fos = <strong class="jxr_keyword">new</strong> FileOutputStream( destination );
-<a class="jxr_linenumber" name="L855" href="#L855">855</a> input = fis.getChannel();
-<a class="jxr_linenumber" name="L856" href="#L856">856</a> output = fos.getChannel();
-<a class="jxr_linenumber" name="L857" href="#L857">857</a> <strong class="jxr_keyword">long</strong> size = input.size();
-<a class="jxr_linenumber" name="L858" href="#L858">858</a> <strong class="jxr_keyword">long</strong> pos = 0;
-<a class="jxr_linenumber" name="L859" href="#L859">859</a> <strong class="jxr_keyword">long</strong> count;
-<a class="jxr_linenumber" name="L860" href="#L860">860</a> <strong class="jxr_keyword">while</strong> ( pos < size )
-<a class="jxr_linenumber" name="L861" href="#L861">861</a> {
-<a class="jxr_linenumber" name="L862" href="#L862">862</a> count = size - pos > FILE_COPY_BUFFER_SIZE ? FILE_COPY_BUFFER_SIZE : size - pos;
-<a class="jxr_linenumber" name="L863" href="#L863">863</a> pos += output.transferFrom( input, pos, count );
-<a class="jxr_linenumber" name="L864" href="#L864">864</a> }
-<a class="jxr_linenumber" name="L865" href="#L865">865</a> }
-<a class="jxr_linenumber" name="L866" href="#L866">866</a> <strong class="jxr_keyword">finally</strong>
-<a class="jxr_linenumber" name="L867" href="#L867">867</a> {
-<a class="jxr_linenumber" name="L868" href="#L868">868</a> IOUtil.close( output );
-<a class="jxr_linenumber" name="L869" href="#L869">869</a> IOUtil.close( fos );
-<a class="jxr_linenumber" name="L870" href="#L870">870</a> IOUtil.close( input );
-<a class="jxr_linenumber" name="L871" href="#L871">871</a> IOUtil.close( fis );
-<a class="jxr_linenumber" name="L872" href="#L872">872</a> }
-<a class="jxr_linenumber" name="L873" href="#L873">873</a> }
-<a class="jxr_linenumber" name="L874" href="#L874">874</a>
-<a class="jxr_linenumber" name="L875" href="#L875">875</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L876" href="#L876">876</a> <em class="jxr_javadoccomment"> * Copy file from source to destination only if source timestamp is later than the destination timestamp.</em>
-<a class="jxr_linenumber" name="L877" href="#L877">877</a> <em class="jxr_javadoccomment"> * The directories up to <code>destination</code> will be created if they don't already exist.</em>
-<a class="jxr_linenumber" name="L878" href="#L878">878</a> <em class="jxr_javadoccomment"> * <code>destination</code> will be overwritten if it already exists.</em>
-<a class="jxr_linenumber" name="L879" href="#L879">879</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L880" href="#L880">880</a> <em class="jxr_javadoccomment"> * @param source An existing non-directory <code>File</code> to copy bytes from.</em>
-<a class="jxr_linenumber" name="L881" href="#L881">881</a> <em class="jxr_javadoccomment"> * @param destination A non-directory <code>File</code> to write bytes to (possibly</em>
-<a class="jxr_linenumber" name="L882" href="#L882">882</a> <em class="jxr_javadoccomment"> * overwriting).</em>
-<a class="jxr_linenumber" name="L883" href="#L883">883</a> <em class="jxr_javadoccomment"> * @return true if no problem occured</em>
-<a class="jxr_linenumber" name="L884" href="#L884">884</a> <em class="jxr_javadoccomment"> * @throws IOException if <code>source</code> does not exist, <code>destination</code> cannot be</em>
-<a class="jxr_linenumber" name="L885" href="#L885">885</a> <em class="jxr_javadoccomment"> * written to, or an IO error occurs during copying.</em>
-<a class="jxr_linenumber" name="L886" href="#L886">886</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L887" href="#L887">887</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> copyFileIfModified( @Nonnull <strong class="jxr_keyword">final</strong> File source, @Nonnull <strong class="jxr_keyword">final</strong> File destination )
-<a class="jxr_linenumber" name="L888" href="#L888">888</a> <strong class="jxr_keyword">throws</strong> IOException
-<a class="jxr_linenumber" name="L889" href="#L889">889</a> {
-<a class="jxr_linenumber" name="L890" href="#L890">890</a> <strong class="jxr_keyword">if</strong> ( destination.lastModified() < source.lastModified() )
-<a class="jxr_linenumber" name="L891" href="#L891">891</a> {
-<a class="jxr_linenumber" name="L892" href="#L892">892</a> copyFile( source, destination );
-<a class="jxr_linenumber" name="L893" href="#L893">893</a>
-<a class="jxr_linenumber" name="L894" href="#L894">894</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="L895" href="#L895">895</a> }
-<a class="jxr_linenumber" name="L896" href="#L896">896</a>
-<a class="jxr_linenumber" name="L897" href="#L897">897</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L898" href="#L898">898</a> }
-<a class="jxr_linenumber" name="L899" href="#L899">899</a>
-<a class="jxr_linenumber" name="L900" href="#L900">900</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L901" href="#L901">901</a> <em class="jxr_javadoccomment"> * Copies bytes from the URL <code>source</code> to a file <code>destination</code>.</em>
-<a class="jxr_linenumber" name="L902" href="#L902">902</a> <em class="jxr_javadoccomment"> * The directories up to <code>destination</code> will be created if they don't already exist.</em>
-<a class="jxr_linenumber" name="L903" href="#L903">903</a> <em class="jxr_javadoccomment"> * <code>destination</code> will be overwritten if it already exists.</em>
-<a class="jxr_linenumber" name="L904" href="#L904">904</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L905" href="#L905">905</a> <em class="jxr_javadoccomment"> * @param source A <code>URL</code> to copy bytes from.</em>
-<a class="jxr_linenumber" name="L906" href="#L906">906</a> <em class="jxr_javadoccomment"> * @param destination A non-directory <code>File</code> to write bytes to (possibly</em>
-<a class="jxr_linenumber" name="L907" href="#L907">907</a> <em class="jxr_javadoccomment"> * overwriting).</em>
-<a class="jxr_linenumber" name="L908" href="#L908">908</a> <em class="jxr_javadoccomment"> * @throws IOException if</em>
-<a class="jxr_linenumber" name="L909" href="#L909">909</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L910" href="#L910">910</a> <em class="jxr_javadoccomment"> * <li><code>source</code> URL cannot be opened</li></em>
-<a class="jxr_linenumber" name="L911" href="#L911">911</a> <em class="jxr_javadoccomment"> * <li><code>destination</code> cannot be written to</li></em>
-<a class="jxr_linenumber" name="L912" href="#L912">912</a> <em class="jxr_javadoccomment"> * <li>an IO error occurs during copying</li></em>
-<a class="jxr_linenumber" name="L913" href="#L913">913</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L914" href="#L914">914</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L915" href="#L915">915</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">void</strong> copyURLToFile( @Nonnull <strong class="jxr_keyword">final</strong> URL source, @Nonnull <strong class="jxr_keyword">final</strong> File destination )
-<a class="jxr_linenumber" name="L916" href="#L916">916</a> <strong class="jxr_keyword">throws</strong> IOException
-<a class="jxr_linenumber" name="L917" href="#L917">917</a> {
-<a class="jxr_linenumber" name="L918" href="#L918">918</a> copyStreamToFile( source.openStream(), destination );
-<a class="jxr_linenumber" name="L919" href="#L919">919</a> }
-<a class="jxr_linenumber" name="L920" href="#L920">920</a>
-<a class="jxr_linenumber" name="L921" href="#L921">921</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L922" href="#L922">922</a> <em class="jxr_javadoccomment"> * Copies bytes from the {@link InputStream} <code>source</code> to a file <code>destination</code>.</em>
-<a class="jxr_linenumber" name="L923" href="#L923">923</a> <em class="jxr_javadoccomment"> * The directories up to <code>destination</code> will be created if they don't already exist.</em>
-<a class="jxr_linenumber" name="L924" href="#L924">924</a> <em class="jxr_javadoccomment"> * <code>destination</code> will be overwritten if it already exists.</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"> * @param source An {@link InputStream} to copy bytes from. This stream is</em>
-<a class="jxr_linenumber" name="L927" href="#L927">927</a> <em class="jxr_javadoccomment"> * guaranteed to be closed.</em>
-<a class="jxr_linenumber" name="L928" href="#L928">928</a> <em class="jxr_javadoccomment"> * @param destination A non-directory <code>File</code> to write bytes to (possibly</em>
-<a class="jxr_linenumber" name="L929" href="#L929">929</a> <em class="jxr_javadoccomment"> * overwriting).</em>
-<a class="jxr_linenumber" name="L930" href="#L930">930</a> <em class="jxr_javadoccomment"> * @throws IOException if</em>
-<a class="jxr_linenumber" name="L931" href="#L931">931</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L932" href="#L932">932</a> <em class="jxr_javadoccomment"> * <li><code>source</code> URL cannot be opened</li></em>
-<a class="jxr_linenumber" name="L933" href="#L933">933</a> <em class="jxr_javadoccomment"> * <li><code>destination</code> cannot be written to</li></em>
-<a class="jxr_linenumber" name="L934" href="#L934">934</a> <em class="jxr_javadoccomment"> * <li>an IO error occurs during copying</li></em>
-<a class="jxr_linenumber" name="L935" href="#L935">935</a> <em class="jxr_javadoccomment"> * </ul></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> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">void</strong> copyStreamToFile( @Nonnull <strong class="jxr_keyword">final</strong> @WillClose InputStream source,
-<a class="jxr_linenumber" name="L938" href="#L938">938</a> @Nonnull <strong class="jxr_keyword">final</strong> File destination )
-<a class="jxr_linenumber" name="L939" href="#L939">939</a> <strong class="jxr_keyword">throws</strong> IOException
-<a class="jxr_linenumber" name="L940" href="#L940">940</a> {
-<a class="jxr_linenumber" name="L941" href="#L941">941</a> FileOutputStream output = <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L942" href="#L942">942</a> <strong class="jxr_keyword">try</strong>
-<a class="jxr_linenumber" name="L943" href="#L943">943</a> {
-<a class="jxr_linenumber" name="L944" href="#L944">944</a> <em class="jxr_comment">//does destination directory exist ?</em>
-<a class="jxr_linenumber" name="L945" href="#L945">945</a> <strong class="jxr_keyword">if</strong> ( destination.getParentFile() != <strong class="jxr_keyword">null</strong> && !destination.getParentFile().exists() )
-<a class="jxr_linenumber" name="L946" href="#L946">946</a> {
-<a class="jxr_linenumber" name="L947" href="#L947">947</a> <em class="jxr_comment">//noinspection ResultOfMethodCallIgnored</em>
-<a class="jxr_linenumber" name="L948" href="#L948">948</a> destination.getParentFile().mkdirs();
-<a class="jxr_linenumber" name="L949" href="#L949">949</a> }
-<a class="jxr_linenumber" name="L950" href="#L950">950</a>
-<a class="jxr_linenumber" name="L951" href="#L951">951</a> <em class="jxr_comment">//make sure we can write to destination</em>
-<a class="jxr_linenumber" name="L952" href="#L952">952</a> <strong class="jxr_keyword">if</strong> ( destination.exists() && !destination.canWrite() )
-<a class="jxr_linenumber" name="L953" href="#L953">953</a> {
-<a class="jxr_linenumber" name="L954" href="#L954">954</a> <strong class="jxr_keyword">final</strong> String message = <span class="jxr_string">"Unable to open file "</span> + destination + <span class="jxr_string">" for writing."</span>;
-<a class="jxr_linenumber" name="L955" href="#L955">955</a> <strong class="jxr_keyword">throw</strong> <strong class="jxr_keyword">new</strong> IOException( message );
-<a class="jxr_linenumber" name="L956" href="#L956">956</a> }
-<a class="jxr_linenumber" name="L957" href="#L957">957</a>
-<a class="jxr_linenumber" name="L958" href="#L958">958</a> output = <strong class="jxr_keyword">new</strong> FileOutputStream( destination );
-<a class="jxr_linenumber" name="L959" href="#L959">959</a> IOUtil.copy( source, output );
-<a class="jxr_linenumber" name="L960" href="#L960">960</a> }
-<a class="jxr_linenumber" name="L961" href="#L961">961</a> <strong class="jxr_keyword">finally</strong>
-<a class="jxr_linenumber" name="L962" href="#L962">962</a> {
-<a class="jxr_linenumber" name="L963" href="#L963">963</a> IOUtil.close( source );
-<a class="jxr_linenumber" name="L964" href="#L964">964</a> IOUtil.close( output );
-<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>
-<a class="jxr_linenumber" name="L968" href="#L968">968</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L969" href="#L969">969</a> <em class="jxr_javadoccomment"> * Normalize a path.</em>
-<a class="jxr_linenumber" name="L970" href="#L970">970</a> <em class="jxr_javadoccomment"> * Eliminates "/../" and "/./" in a string. Returns <code>null</code> if the ..'s went past the</em>
-<a class="jxr_linenumber" name="L971" href="#L971">971</a> <em class="jxr_javadoccomment"> * root.</em>
-<a class="jxr_linenumber" name="L972" href="#L972">972</a> <em class="jxr_javadoccomment"> * Eg:</em>
-<a class="jxr_linenumber" name="L973" href="#L973">973</a> <em class="jxr_javadoccomment"> * <pre></em>
-<a class="jxr_linenumber" name="L974" href="#L974">974</a> <em class="jxr_javadoccomment"> * /foo// --> /foo/</em>
-<a class="jxr_linenumber" name="L975" href="#L975">975</a> <em class="jxr_javadoccomment"> * /foo/./ --> /foo/</em>
-<a class="jxr_linenumber" name="L976" href="#L976">976</a> <em class="jxr_javadoccomment"> * /foo/../bar --> /bar</em>
-<a class="jxr_linenumber" name="L977" href="#L977">977</a> <em class="jxr_javadoccomment"> * /foo/../bar/ --> /bar/</em>
-<a class="jxr_linenumber" name="L978" href="#L978">978</a> <em class="jxr_javadoccomment"> * /foo/../bar/../baz --> /baz</em>
-<a class="jxr_linenumber" name="L979" href="#L979">979</a> <em class="jxr_javadoccomment"> * //foo//./bar --> /foo/bar</em>
-<a class="jxr_linenumber" name="L980" href="#L980">980</a> <em class="jxr_javadoccomment"> * /../ --> null</em>
-<a class="jxr_linenumber" name="L981" href="#L981">981</a> <em class="jxr_javadoccomment"> * </pre></em>
-<a class="jxr_linenumber" name="L982" href="#L982">982</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L983" href="#L983">983</a> <em class="jxr_javadoccomment"> * @param path the path to normalize</em>
-<a class="jxr_linenumber" name="L984" href="#L984">984</a> <em class="jxr_javadoccomment"> * @return the normalized String, or <code>null</code> if too many ..'s.</em>
-<a class="jxr_linenumber" name="L985" href="#L985">985</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L986" href="#L986">986</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String normalize( <strong class="jxr_keyword">final</strong> String path )
-<a class="jxr_linenumber" name="L987" href="#L987">987</a> {
-<a class="jxr_linenumber" name="L988" href="#L988">988</a> String normalized = path;
-<a class="jxr_linenumber" name="L989" href="#L989">989</a> <em class="jxr_comment">// Resolve occurrences of "//" in the normalized path</em>
-<a class="jxr_linenumber" name="L990" href="#L990">990</a> <strong class="jxr_keyword">while</strong> ( <strong class="jxr_keyword">true</strong> )
-<a class="jxr_linenumber" name="L991" href="#L991">991</a> {
-<a class="jxr_linenumber" name="L992" href="#L992">992</a> <strong class="jxr_keyword">int</strong> index = normalized.indexOf( <span class="jxr_string">"//"</span> );
-<a class="jxr_linenumber" name="L993" href="#L993">993</a> <strong class="jxr_keyword">if</strong> ( index < 0 )
-<a class="jxr_linenumber" name="L994" href="#L994">994</a> {
-<a class="jxr_linenumber" name="L995" href="#L995">995</a> <strong class="jxr_keyword">break</strong>;
-<a class="jxr_linenumber" name="L996" href="#L996">996</a> }
-<a class="jxr_linenumber" name="L997" href="#L997">997</a> normalized = normalized.substring( 0, index ) + normalized.substring( index + 1 );
-<a class="jxr_linenumber" name="L998" href="#L998">998</a> }
-<a class="jxr_linenumber" name="L999" href="#L999">999</a>
-<a class="jxr_linenumber" name="L1000" href="#L1000">1000</a> <em class="jxr_comment">// Resolve occurrences of "/./" in the normalized path</em>
-<a class="jxr_linenumber" name="L1001" href="#L1001">1001</a> <strong class="jxr_keyword">while</strong> ( <strong class="jxr_keyword">true</strong> )
-<a class="jxr_linenumber" name="L1002" href="#L1002">1002</a> {
-<a class="jxr_linenumber" name="L1003" href="#L1003">1003</a> <strong class="jxr_keyword">int</strong> index = normalized.indexOf( <span class="jxr_string">"/./"</span> );
-<a class="jxr_linenumber" name="L1004" href="#L1004">1004</a> <strong class="jxr_keyword">if</strong> ( index < 0 )
-<a class="jxr_linenumber" name="L1005" href="#L1005">1005</a> {
-<a class="jxr_linenumber" name="L1006" href="#L1006">1006</a> <strong class="jxr_keyword">break</strong>;
-<a class="jxr_linenumber" name="L1007" href="#L1007">1007</a> }
-<a class="jxr_linenumber" name="L1008" href="#L1008">1008</a> normalized = normalized.substring( 0, index ) + normalized.substring( index + 2 );
-<a class="jxr_linenumber" name="L1009" href="#L1009">1009</a> }
-<a class="jxr_linenumber" name="L1010" href="#L1010">1010</a>
-<a class="jxr_linenumber" name="L1011" href="#L1011">1011</a> <em class="jxr_comment">// Resolve occurrences of "/../" in the normalized path</em>
-<a class="jxr_linenumber" name="L1012" href="#L1012">1012</a> <strong class="jxr_keyword">while</strong> ( <strong class="jxr_keyword">true</strong> )
-<a class="jxr_linenumber" name="L1013" href="#L1013">1013</a> {
-<a class="jxr_linenumber" name="L1014" href="#L1014">1014</a> <strong class="jxr_keyword">int</strong> index = normalized.indexOf( <span class="jxr_string">"/../"</span> );
-<a class="jxr_linenumber" name="L1015" href="#L1015">1015</a> <strong class="jxr_keyword">if</strong> ( index < 0 )
-<a class="jxr_linenumber" name="L1016" href="#L1016">1016</a> {
-<a class="jxr_linenumber" name="L1017" href="#L1017">1017</a> <strong class="jxr_keyword">break</strong>;
-<a class="jxr_linenumber" name="L1018" href="#L1018">1018</a> }
-<a class="jxr_linenumber" name="L1019" href="#L1019">1019</a> <strong class="jxr_keyword">if</strong> ( index == 0 )
-<a class="jxr_linenumber" name="L1020" href="#L1020">1020</a> {
-<a class="jxr_linenumber" name="L1021" href="#L1021">1021</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>; <em class="jxr_comment">// Trying to go outside our context</em>
-<a class="jxr_linenumber" name="L1022" href="#L1022">1022</a> }
-<a class="jxr_linenumber" name="L1023" href="#L1023">1023</a> <strong class="jxr_keyword">int</strong> index2 = normalized.lastIndexOf( '/', index - 1 );
-<a class="jxr_linenumber" name="L1024" href="#L1024">1024</a> normalized = normalized.substring( 0, index2 ) + normalized.substring( index + 3 );
-<a class="jxr_linenumber" name="L1025" href="#L1025">1025</a> }
-<a class="jxr_linenumber" name="L1026" href="#L1026">1026</a>
-<a class="jxr_linenumber" name="L1027" href="#L1027">1027</a> <em class="jxr_comment">// Return the normalized path that we have completed</em>
-<a class="jxr_linenumber" name="L1028" href="#L1028">1028</a> <strong class="jxr_keyword">return</strong> normalized;
-<a class="jxr_linenumber" name="L1029" href="#L1029">1029</a> }
-<a class="jxr_linenumber" name="L1030" href="#L1030">1030</a>
-<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"> * Resolve a file <code>filename</code> to it's canonical form. If <code>filename</code> is</em>
-<a class="jxr_linenumber" name="L1033" href="#L1033">1033</a> <em class="jxr_javadoccomment"> * relative (doesn't start with <code>/</code>), it will be resolved relative to</em>
-<a class="jxr_linenumber" name="L1034" href="#L1034">1034</a> <em class="jxr_javadoccomment"> * <code>baseFile</code>, otherwise it is treated as a normal root-relative path.</em>
-<a class="jxr_linenumber" name="L1035" href="#L1035">1035</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1036" href="#L1036">1036</a> <em class="jxr_javadoccomment"> * @param baseFile Where to resolve <code>filename</code> from, if <code>filename</code> is</em>
-<a class="jxr_linenumber" name="L1037" href="#L1037">1037</a> <em class="jxr_javadoccomment"> * relative.</em>
-<a class="jxr_linenumber" name="L1038" href="#L1038">1038</a> <em class="jxr_javadoccomment"> * @param filename Absolute or relative file path to resolve.</em>
-<a class="jxr_linenumber" name="L1039" href="#L1039">1039</a> <em class="jxr_javadoccomment"> * @return The canonical <code>File</code> of <code>filename</code>.</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> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> File resolveFile( <strong class="jxr_keyword">final</strong> File baseFile, String filename )
-<a class="jxr_linenumber" name="L1042" href="#L1042">1042</a> {
-<a class="jxr_linenumber" name="L1043" href="#L1043">1043</a> String filenm = filename;
-<a class="jxr_linenumber" name="L1044" href="#L1044">1044</a> <strong class="jxr_keyword">if</strong> ( '/' != File.separatorChar )
-<a class="jxr_linenumber" name="L1045" href="#L1045">1045</a> {
-<a class="jxr_linenumber" name="L1046" href="#L1046">1046</a> filenm = filename.replace( '/', File.separatorChar );
-<a class="jxr_linenumber" name="L1047" href="#L1047">1047</a> }
-<a class="jxr_linenumber" name="L1048" href="#L1048">1048</a>
-<a class="jxr_linenumber" name="L1049" href="#L1049">1049</a> <strong class="jxr_keyword">if</strong> ( '\\' != File.separatorChar )
-<a class="jxr_linenumber" name="L1050" href="#L1050">1050</a> {
-<a class="jxr_linenumber" name="L1051" href="#L1051">1051</a> filenm = filename.replace( '\\', File.separatorChar );
-<a class="jxr_linenumber" name="L1052" href="#L1052">1052</a> }
-<a class="jxr_linenumber" name="L1053" href="#L1053">1053</a>
-<a class="jxr_linenumber" name="L1054" href="#L1054">1054</a> <em class="jxr_comment">// deal with absolute files</em>
-<a class="jxr_linenumber" name="L1055" href="#L1055">1055</a> <strong class="jxr_keyword">if</strong> ( filenm.startsWith( File.separator ) || ( Os.isFamily( Os.FAMILY_WINDOWS ) && filenm.indexOf( <span class="jxr_string">":"</span> ) > 0 ) )
-<a class="jxr_linenumber" name="L1056" href="#L1056">1056</a> {
-<a class="jxr_linenumber" name="L1057" href="#L1057">1057</a> File file = <strong class="jxr_keyword">new</strong> File( filenm );
-<a class="jxr_linenumber" name="L1058" href="#L1058">1058</a>
-<a class="jxr_linenumber" name="L1059" href="#L1059">1059</a> <strong class="jxr_keyword">try</strong>
-<a class="jxr_linenumber" name="L1060" href="#L1060">1060</a> {
-<a class="jxr_linenumber" name="L1061" href="#L1061">1061</a> file = file.getCanonicalFile();
-<a class="jxr_linenumber" name="L1062" href="#L1062">1062</a> }
-<a class="jxr_linenumber" name="L1063" href="#L1063">1063</a> <strong class="jxr_keyword">catch</strong> ( <strong class="jxr_keyword">final</strong> IOException ioe )
-<a class="jxr_linenumber" name="L1064" href="#L1064">1064</a> {
-<a class="jxr_linenumber" name="L1065" href="#L1065">1065</a> <em class="jxr_comment">// nop</em>
-<a class="jxr_linenumber" name="L1066" href="#L1066">1066</a> }
-<a class="jxr_linenumber" name="L1067" href="#L1067">1067</a>
-<a class="jxr_linenumber" name="L1068" href="#L1068">1068</a> <strong class="jxr_keyword">return</strong> file;
-<a class="jxr_linenumber" name="L1069" href="#L1069">1069</a> }
-<a class="jxr_linenumber" name="L1070" href="#L1070">1070</a> <em class="jxr_comment">// FIXME: I'm almost certain this // removal is unnecessary, as getAbsoluteFile() strips</em>
-<a class="jxr_linenumber" name="L1071" href="#L1071">1071</a> <em class="jxr_comment">// them. However, I'm not sure about this UNC stuff. (JT)</em>
-<a class="jxr_linenumber" name="L1072" href="#L1072">1072</a> <strong class="jxr_keyword">final</strong> <strong class="jxr_keyword">char</strong>[] chars = filename.toCharArray();
-<a class="jxr_linenumber" name="L1073" href="#L1073">1073</a> <strong class="jxr_keyword">final</strong> StringBuilder sb = <strong class="jxr_keyword">new</strong> StringBuilder();
-<a class="jxr_linenumber" name="L1074" href="#L1074">1074</a>
-<a class="jxr_linenumber" name="L1075" href="#L1075">1075</a> <em class="jxr_comment">//remove duplicate file separators in succession - except</em>
-<a class="jxr_linenumber" name="L1076" href="#L1076">1076</a> <em class="jxr_comment">//on win32 at start of filename as UNC filenames can</em>
-<a class="jxr_linenumber" name="L1077" href="#L1077">1077</a> <em class="jxr_comment">//be \\AComputer\AShare\myfile.txt</em>
-<a class="jxr_linenumber" name="L1078" href="#L1078">1078</a> <strong class="jxr_keyword">int</strong> start = 0;
-<a class="jxr_linenumber" name="L1079" href="#L1079">1079</a> <strong class="jxr_keyword">if</strong> ( '\\' == File.separatorChar )
-<a class="jxr_linenumber" name="L1080" href="#L1080">1080</a> {
-<a class="jxr_linenumber" name="L1081" href="#L1081">1081</a> sb.append( filenm.charAt( 0 ) );
-<a class="jxr_linenumber" name="L1082" href="#L1082">1082</a> start++;
-<a class="jxr_linenumber" name="L1083" href="#L1083">1083</a> }
-<a class="jxr_linenumber" name="L1084" href="#L1084">1084</a>
-<a class="jxr_linenumber" name="L1085" href="#L1085">1085</a> <strong class="jxr_keyword">for</strong> ( <strong class="jxr_keyword">int</strong> i = start; i < chars.length; i++ )
-<a class="jxr_linenumber" name="L1086" href="#L1086">1086</a> {
-<a class="jxr_linenumber" name="L1087" href="#L1087">1087</a> <strong class="jxr_keyword">final</strong> <strong class="jxr_keyword">boolean</strong> doubleSeparator = File.separatorChar == chars[i] && File.separatorChar == chars[i - 1];
-<a class="jxr_linenumber" name="L1088" href="#L1088">1088</a>
-<a class="jxr_linenumber" name="L1089" href="#L1089">1089</a> <strong class="jxr_keyword">if</strong> ( !doubleSeparator )
-<a class="jxr_linenumber" name="L1090" href="#L1090">1090</a> {
-<a class="jxr_linenumber" name="L1091" href="#L1091">1091</a> sb.append( chars[i] );
-<a class="jxr_linenumber" name="L1092" href="#L1092">1092</a> }
-<a class="jxr_linenumber" name="L1093" href="#L1093">1093</a> }
-<a class="jxr_linenumber" name="L1094" href="#L1094">1094</a>
-<a class="jxr_linenumber" name="L1095" href="#L1095">1095</a> filenm = sb.toString();
+<a class="jxr_linenumber" name="L819" href="#L819">819</a> File target = Java7Support.readSymbolicLink( source );
+<a class="jxr_linenumber" name="L820" href="#L820">820</a> Java7Support.createSymbolicLink( destination, target );
+<a class="jxr_linenumber" name="L821" href="#L821">821</a> <strong class="jxr_keyword">return</strong>;
+<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> <em class="jxr_comment">//check source != destination, see PLXUTILS-10</em>
+<a class="jxr_linenumber" name="L825" href="#L825">825</a> <strong class="jxr_keyword">if</strong> ( source.getCanonicalPath().equals( destination.getCanonicalPath() ) )
+<a class="jxr_linenumber" name="L826" href="#L826">826</a> {
+<a class="jxr_linenumber" name="L827" href="#L827">827</a> <em class="jxr_comment">//if they are equal, we can exit the method without doing any work</em>
+<a class="jxr_linenumber" name="L828" href="#L828">828</a> <strong class="jxr_keyword">return</strong>;
+<a class="jxr_linenumber" name="L829" href="#L829">829</a> }
+<a class="jxr_linenumber" name="L830" href="#L830">830</a>
+<a class="jxr_linenumber" name="L831" href="#L831">831</a> mkdirsFor( destination );
+<a class="jxr_linenumber" name="L832" href="#L832">832</a>
+<a class="jxr_linenumber" name="L833" href="#L833">833</a> doCopyFile( source, destination );
+<a class="jxr_linenumber" name="L834" href="#L834">834</a>
+<a class="jxr_linenumber" name="L835" href="#L835">835</a> <strong class="jxr_keyword">if</strong> ( source.length() != destination.length() )
+<a class="jxr_linenumber" name="L836" href="#L836">836</a> {
+<a class="jxr_linenumber" name="L837" href="#L837">837</a> <strong class="jxr_keyword">final</strong> String message = <span class="jxr_string">"Failed to copy full contents from "</span> + source + <span class="jxr_string">" to "</span> + destination;
+<a class="jxr_linenumber" name="L838" href="#L838">838</a> <strong class="jxr_keyword">throw</strong> <strong class="jxr_keyword">new</strong> IOException( message );
+<a class="jxr_linenumber" name="L839" href="#L839">839</a> }
+<a class="jxr_linenumber" name="L840" href="#L840">840</a> }
+<a class="jxr_linenumber" name="L841" href="#L841">841</a>
+<a class="jxr_linenumber" name="L842" href="#L842">842</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">void</strong> mkdirsFor( @Nonnull File destination )
+<a class="jxr_linenumber" name="L843" href="#L843">843</a> {
+<a class="jxr_linenumber" name="L844" href="#L844">844</a> <em class="jxr_comment">//does destination directory exist ?</em>
+<a class="jxr_linenumber" name="L845" href="#L845">845</a> <strong class="jxr_keyword">if</strong> ( destination.getParentFile() != <strong class="jxr_keyword">null</strong> && !destination.getParentFile().exists() )
+<a class="jxr_linenumber" name="L846" href="#L846">846</a> {
+<a class="jxr_linenumber" name="L847" href="#L847">847</a> <em class="jxr_comment">//noinspection ResultOfMethodCallIgnored</em>
+<a class="jxr_linenumber" name="L848" href="#L848">848</a> destination.getParentFile().mkdirs();
+<a class="jxr_linenumber" name="L849" href="#L849">849</a> }
+<a class="jxr_linenumber" name="L850" href="#L850">850</a> }
+<a class="jxr_linenumber" name="L851" href="#L851">851</a>
+<a class="jxr_linenumber" name="L852" href="#L852">852</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">void</strong> doCopyFile( @Nonnull File source, @Nonnull File destination )
+<a class="jxr_linenumber" name="L853" href="#L853">853</a> <strong class="jxr_keyword">throws</strong> IOException
+<a class="jxr_linenumber" name="L854" href="#L854">854</a> {
+<a class="jxr_linenumber" name="L855" href="#L855">855</a> FileInputStream fis = <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L856" href="#L856">856</a> FileOutputStream fos = <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L857" href="#L857">857</a> FileChannel input = <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L858" href="#L858">858</a> FileChannel output = <strong class="jxr_keyword">null</strong>;
+<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> fis = <strong class="jxr_keyword">new</strong> FileInputStream( source );
+<a class="jxr_linenumber" name="L862" href="#L862">862</a> fos = <strong class="jxr_keyword">new</strong> FileOutputStream( destination );
+<a class="jxr_linenumber" name="L863" href="#L863">863</a> input = fis.getChannel();
+<a class="jxr_linenumber" name="L864" href="#L864">864</a> output = fos.getChannel();
+<a class="jxr_linenumber" name="L865" href="#L865">865</a> <strong class="jxr_keyword">long</strong> size = input.size();
+<a class="jxr_linenumber" name="L866" href="#L866">866</a> <strong class="jxr_keyword">long</strong> pos = 0;
+<a class="jxr_linenumber" name="L867" href="#L867">867</a> <strong class="jxr_keyword">long</strong> count;
+<a class="jxr_linenumber" name="L868" href="#L868">868</a> <strong class="jxr_keyword">while</strong> ( pos < size )
+<a class="jxr_linenumber" name="L869" href="#L869">869</a> {
+<a class="jxr_linenumber" name="L870" href="#L870">870</a> count = size - pos > FILE_COPY_BUFFER_SIZE ? FILE_COPY_BUFFER_SIZE : size - pos;
+<a class="jxr_linenumber" name="L871" href="#L871">871</a> pos += output.transferFrom( input, pos, count );
+<a class="jxr_linenumber" name="L872" href="#L872">872</a> }
+<a class="jxr_linenumber" name="L873" href="#L873">873</a> }
+<a class="jxr_linenumber" name="L874" href="#L874">874</a> <strong class="jxr_keyword">finally</strong>
+<a class="jxr_linenumber" name="L875" href="#L875">875</a> {
+<a class="jxr_linenumber" name="L876" href="#L876">876</a> IOUtil.close( output );
+<a class="jxr_linenumber" name="L877" href="#L877">877</a> IOUtil.close( fos );
+<a class="jxr_linenumber" name="L878" href="#L878">878</a> IOUtil.close( input );
+<a class="jxr_linenumber" name="L879" href="#L879">879</a> IOUtil.close( fis );
+<a class="jxr_linenumber" name="L880" href="#L880">880</a> }
+<a class="jxr_linenumber" name="L881" href="#L881">881</a> }
+<a class="jxr_linenumber" name="L882" href="#L882">882</a>
+<a class="jxr_linenumber" name="L883" href="#L883">883</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L884" href="#L884">884</a> <em class="jxr_javadoccomment"> * Copy file from source to destination only if source timestamp is later than the destination timestamp.</em>
+<a class="jxr_linenumber" name="L885" href="#L885">885</a> <em class="jxr_javadoccomment"> * The directories up to <code>destination</code> will be created if they don't already exist.</em>
+<a class="jxr_linenumber" name="L886" href="#L886">886</a> <em class="jxr_javadoccomment"> * <code>destination</code> will be overwritten if it already exists.</em>
+<a class="jxr_linenumber" name="L887" href="#L887">887</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L888" href="#L888">888</a> <em class="jxr_javadoccomment"> * @param source An existing non-directory <code>File</code> to copy bytes from.</em>
+<a class="jxr_linenumber" name="L889" href="#L889">889</a> <em class="jxr_javadoccomment"> * @param destination A non-directory <code>File</code> to write bytes to (possibly</em>
+<a class="jxr_linenumber" name="L890" href="#L890">890</a> <em class="jxr_javadoccomment"> * overwriting).</em>
+<a class="jxr_linenumber" name="L891" href="#L891">891</a> <em class="jxr_javadoccomment"> * @return true if no problem occured</em>
+<a class="jxr_linenumber" name="L892" href="#L892">892</a> <em class="jxr_javadoccomment"> * @throws IOException if <code>source</code> does not exist, <code>destination</code> cannot be</em>
+<a class="jxr_linenumber" name="L893" href="#L893">893</a> <em class="jxr_javadoccomment"> * written to, or an IO error occurs during copying.</em>
+<a class="jxr_linenumber" name="L894" href="#L894">894</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L895" href="#L895">895</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> copyFileIfModified( @Nonnull <strong class="jxr_keyword">final</strong> File source, @Nonnull <strong class="jxr_keyword">final</strong> File destination )
+<a class="jxr_linenumber" name="L896" href="#L896">896</a> <strong class="jxr_keyword">throws</strong> IOException
+<a class="jxr_linenumber" name="L897" href="#L897">897</a> {
+<a class="jxr_linenumber" name="L898" href="#L898">898</a> <strong class="jxr_keyword">if</strong> ( destination.lastModified() < source.lastModified() )
+<a class="jxr_linenumber" name="L899" href="#L899">899</a> {
+<a class="jxr_linenumber" name="L900" href="#L900">900</a> copyFile( source, destination );
+<a class="jxr_linenumber" name="L901" href="#L901">901</a>
+<a class="jxr_linenumber" name="L902" href="#L902">902</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="L903" href="#L903">903</a> }
+<a class="jxr_linenumber" name="L904" href="#L904">904</a>
+<a class="jxr_linenumber" name="L905" href="#L905">905</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L906" href="#L906">906</a> }
+<a class="jxr_linenumber" name="L907" href="#L907">907</a>
+<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"> * Copies bytes from the URL <code>source</code> to a file <code>destination</code>.</em>
+<a class="jxr_linenumber" name="L910" href="#L910">910</a> <em class="jxr_javadoccomment"> * The directories up to <code>destination</code> will be created if they don't already exist.</em>
+<a class="jxr_linenumber" name="L911" href="#L911">911</a> <em class="jxr_javadoccomment"> * <code>destination</code> will be overwritten if it already exists.</em>
+<a class="jxr_linenumber" name="L912" href="#L912">912</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L913" href="#L913">913</a> <em class="jxr_javadoccomment"> * @param source A <code>URL</code> to copy bytes from.</em>
+<a class="jxr_linenumber" name="L914" href="#L914">914</a> <em class="jxr_javadoccomment"> * @param destination A non-directory <code>File</code> to write bytes to (possibly</em>
+<a class="jxr_linenumber" name="L915" href="#L915">915</a> <em class="jxr_javadoccomment"> * overwriting).</em>
+<a class="jxr_linenumber" name="L916" href="#L916">916</a> <em class="jxr_javadoccomment"> * @throws IOException if</em>
+<a class="jxr_linenumber" name="L917" href="#L917">917</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L918" href="#L918">918</a> <em class="jxr_javadoccomment"> * <li><code>source</code> URL cannot be opened</li></em>
+<a class="jxr_linenumber" name="L919" href="#L919">919</a> <em class="jxr_javadoccomment"> * <li><code>destination</code> cannot be written to</li></em>
+<a class="jxr_linenumber" name="L920" href="#L920">920</a> <em class="jxr_javadoccomment"> * <li>an IO error occurs during copying</li></em>
+<a class="jxr_linenumber" name="L921" href="#L921">921</a> <em class="jxr_javadoccomment"> * </ul></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> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">void</strong> copyURLToFile( @Nonnull <strong class="jxr_keyword">final</strong> URL source, @Nonnull <strong class="jxr_keyword">final</strong> File destination )
+<a class="jxr_linenumber" name="L924" href="#L924">924</a> <strong class="jxr_keyword">throws</strong> IOException
+<a class="jxr_linenumber" name="L925" href="#L925">925</a> {
+<a class="jxr_linenumber" name="L926" href="#L926">926</a> copyStreamToFile( source.openStream(), destination );
+<a class="jxr_linenumber" name="L927" href="#L927">927</a> }
+<a class="jxr_linenumber" name="L928" href="#L928">928</a>
+<a class="jxr_linenumber" name="L929" href="#L929">929</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L930" href="#L930">930</a> <em class="jxr_javadoccomment"> * Copies bytes from the {@link InputStream} <code>source</code> to a file <code>destination</code>.</em>
+<a class="jxr_linenumber" name="L931" href="#L931">931</a> <em class="jxr_javadoccomment"> * The directories up to <code>destination</code> will be created if they don't already exist.</em>
+<a class="jxr_linenumber" name="L932" href="#L932">932</a> <em class="jxr_javadoccomment"> * <code>destination</code> will be overwritten if it already exists.</em>
+<a class="jxr_linenumber" name="L933" href="#L933">933</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L934" href="#L934">934</a> <em class="jxr_javadoccomment"> * @param source An {@link InputStream} to copy bytes from. This stream is</em>
+<a class="jxr_linenumber" name="L935" href="#L935">935</a> <em class="jxr_javadoccomment"> * guaranteed to be closed.</em>
+<a class="jxr_linenumber" name="L936" href="#L936">936</a> <em class="jxr_javadoccomment"> * @param destination A non-directory <code>File</code> to write bytes to (possibly</em>
+<a class="jxr_linenumber" name="L937" href="#L937">937</a> <em class="jxr_javadoccomment"> * overwriting).</em>
+<a class="jxr_linenumber" name="L938" href="#L938">938</a> <em class="jxr_javadoccomment"> * @throws IOException if</em>
+<a class="jxr_linenumber" name="L939" href="#L939">939</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L940" href="#L940">940</a> <em class="jxr_javadoccomment"> * <li><code>source</code> URL cannot be opened</li></em>
+<a class="jxr_linenumber" name="L941" href="#L941">941</a> <em class="jxr_javadoccomment"> * <li><code>destination</code> cannot be written to</li></em>
+<a class="jxr_linenumber" name="L942" href="#L942">942</a> <em class="jxr_javadoccomment"> * <li>an IO error occurs during copying</li></em>
+<a class="jxr_linenumber" name="L943" href="#L943">943</a> <em class="jxr_javadoccomment"> * </ul></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> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">void</strong> copyStreamToFile( @Nonnull <strong class="jxr_keyword">final</strong> @WillClose InputStream source,
+<a class="jxr_linenumber" name="L946" href="#L946">946</a> @Nonnull <strong class="jxr_keyword">final</strong> File destination )
+<a class="jxr_linenumber" name="L947" href="#L947">947</a> <strong class="jxr_keyword">throws</strong> IOException
+<a class="jxr_linenumber" name="L948" href="#L948">948</a> {
+<a class="jxr_linenumber" name="L949" href="#L949">949</a> FileOutputStream output = <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L950" href="#L950">950</a> <strong class="jxr_keyword">try</strong>
+<a class="jxr_linenumber" name="L951" href="#L951">951</a> {
+<a class="jxr_linenumber" name="L952" href="#L952">952</a> <em class="jxr_comment">//does destination directory exist ?</em>
+<a class="jxr_linenumber" name="L953" href="#L953">953</a> <strong class="jxr_keyword">if</strong> ( destination.getParentFile() != <strong class="jxr_keyword">null</strong> && !destination.getParentFile().exists() )
+<a class="jxr_linenumber" name="L954" href="#L954">954</a> {
+<a class="jxr_linenumber" name="L955" href="#L955">955</a> <em class="jxr_comment">//noinspection ResultOfMethodCallIgnored</em>
+<a class="jxr_linenumber" name="L956" href="#L956">956</a> destination.getParentFile().mkdirs();
+<a class="jxr_linenumber" name="L957" href="#L957">957</a> }
+<a class="jxr_linenumber" name="L958" href="#L958">958</a>
+<a class="jxr_linenumber" name="L959" href="#L959">959</a> <em class="jxr_comment">//make sure we can write to destination</em>
+<a class="jxr_linenumber" name="L960" href="#L960">960</a> <strong class="jxr_keyword">if</strong> ( destination.exists() && !destination.canWrite() )
+<a class="jxr_linenumber" name="L961" href="#L961">961</a> {
+<a class="jxr_linenumber" name="L962" href="#L962">962</a> <strong class="jxr_keyword">final</strong> String message = <span class="jxr_string">"Unable to open file "</span> + destination + <span class="jxr_string">" for writing."</span>;
+<a class="jxr_linenumber" name="L963" href="#L963">963</a> <strong class="jxr_keyword">throw</strong> <strong class="jxr_keyword">new</strong> IOException( message );
+<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> output = <strong class="jxr_keyword">new</strong> FileOutputStream( destination );
+<a class="jxr_linenumber" name="L967" href="#L967">967</a> IOUtil.copy( source, output );
+<a class="jxr_linenumber" name="L968" href="#L968">968</a> }
+<a class="jxr_linenumber" name="L969" href="#L969">969</a> <strong class="jxr_keyword">finally</strong>
+<a class="jxr_linenumber" name="L970" href="#L970">970</a> {
+<a class="jxr_linenumber" name="L971" href="#L971">971</a> IOUtil.close( source );
+<a class="jxr_linenumber" name="L972" href="#L972">972</a> IOUtil.close( output );
+<a class="jxr_linenumber" name="L973" href="#L973">973</a> }
+<a class="jxr_linenumber" name="L974" href="#L974">974</a> }
+<a class="jxr_linenumber" name="L975" href="#L975">975</a>
+<a class="jxr_linenumber" name="L976" href="#L976">976</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L977" href="#L977">977</a> <em class="jxr_javadoccomment"> * Normalize a path.</em>
+<a class="jxr_linenumber" name="L978" href="#L978">978</a> <em class="jxr_javadoccomment"> * Eliminates "/../" and "/./" in a string. Returns <code>null</code> if the ..'s went past the</em>
+<a class="jxr_linenumber" name="L979" href="#L979">979</a> <em class="jxr_javadoccomment"> * root.</em>
+<a class="jxr_linenumber" name="L980" href="#L980">980</a> <em class="jxr_javadoccomment"> * Eg:</em>
+<a class="jxr_linenumber" name="L981" href="#L981">981</a> <em class="jxr_javadoccomment"> * <pre></em>
+<a class="jxr_linenumber" name="L982" href="#L982">982</a> <em class="jxr_javadoccomment"> * /foo// --> /foo/</em>
+<a class="jxr_linenumber" name="L983" href="#L983">983</a> <em class="jxr_javadoccomment"> * /foo/./ --> /foo/</em>
+<a class="jxr_linenumber" name="L984" href="#L984">984</a> <em class="jxr_javadoccomment"> * /foo/../bar --> /bar</em>
+<a class="jxr_linenumber" name="L985" href="#L985">985</a> <em class="jxr_javadoccomment"> * /foo/../bar/ --> /bar/</em>
+<a class="jxr_linenumber" name="L986" href="#L986">986</a> <em class="jxr_javadoccomment"> * /foo/../bar/../baz --> /baz</em>
+<a class="jxr_linenumber" name="L987" href="#L987">987</a> <em class="jxr_javadoccomment"> * //foo//./bar --> /foo/bar</em>
+<a class="jxr_linenumber" name="L988" href="#L988">988</a> <em class="jxr_javadoccomment"> * /../ --> null</em>
+<a class="jxr_linenumber" name="L989" href="#L989">989</a> <em class="jxr_javadoccomment"> * </pre></em>
+<a class="jxr_linenumber" name="L990" href="#L990">990</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L991" href="#L991">991</a> <em class="jxr_javadoccomment"> * @param path the path to normalize</em>
+<a class="jxr_linenumber" name="L992" href="#L992">992</a> <em class="jxr_javadoccomment"> * @return the normalized String, or <code>null</code> if too many ..'s.</em>
+<a class="jxr_linenumber" name="L993" href="#L993">993</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L994" href="#L994">994</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> @Nonnull String normalize( @Nonnull <strong class="jxr_keyword">final</strong> String path )
+<a class="jxr_linenumber" name="L995" href="#L995">995</a> {
+<a class="jxr_linenumber" name="L996" href="#L996">996</a> String normalized = path;
+<a class="jxr_linenumber" name="L997" href="#L997">997</a> <em class="jxr_comment">// Resolve occurrences of "//" in the normalized path</em>
+<a class="jxr_linenumber" name="L998" href="#L998">998</a> <strong class="jxr_keyword">while</strong> ( <strong class="jxr_keyword">true</strong> )
+<a class="jxr_linenumber" name="L999" href="#L999">999</a> {
+<a class="jxr_linenumber" name="L1000" href="#L1000">1000</a> <strong class="jxr_keyword">int</strong> index = normalized.indexOf( <span class="jxr_string">"//"</span> );
+<a class="jxr_linenumber" name="L1001" href="#L1001">1001</a> <strong class="jxr_keyword">if</strong> ( index < 0 )
+<a class="jxr_linenumber" name="L1002" href="#L1002">1002</a> {
+<a class="jxr_linenumber" name="L1003" href="#L1003">1003</a> <strong class="jxr_keyword">break</strong>;
+<a class="jxr_linenumber" name="L1004" href="#L1004">1004</a> }
+<a class="jxr_linenumber" name="L1005" href="#L1005">1005</a> normalized = normalized.substring( 0, index ) + normalized.substring( index + 1 );
+<a class="jxr_linenumber" name="L1006" href="#L1006">1006</a> }
+<a class="jxr_linenumber" name="L1007" href="#L1007">1007</a>
+<a class="jxr_linenumber" name="L1008" href="#L1008">1008</a> <em class="jxr_comment">// Resolve occurrences of "/./" in the normalized path</em>
+<a class="jxr_linenumber" name="L1009" href="#L1009">1009</a> <strong class="jxr_keyword">while</strong> ( <strong class="jxr_keyword">true</strong> )
+<a class="jxr_linenumber" name="L1010" href="#L1010">1010</a> {
+<a class="jxr_linenumber" name="L1011" href="#L1011">1011</a> <strong class="jxr_keyword">int</strong> index = normalized.indexOf( <span class="jxr_string">"/./"</span> );
+<a class="jxr_linenumber" name="L1012" href="#L1012">1012</a> <strong class="jxr_keyword">if</strong> ( index < 0 )
+<a class="jxr_linenumber" name="L1013" href="#L1013">1013</a> {
+<a class="jxr_linenumber" name="L1014" href="#L1014">1014</a> <strong class="jxr_keyword">break</strong>;
+<a class="jxr_linenumber" name="L1015" href="#L1015">1015</a> }
+<a class="jxr_linenumber" name="L1016" href="#L1016">1016</a> normalized = normalized.substring( 0, index ) + normalized.substring( index + 2 );
+<a class="jxr_linenumber" name="L1017" href="#L1017">1017</a> }
+<a class="jxr_linenumber" name="L1018" href="#L1018">1018</a>
+<a class="jxr_linenumber" name="L1019" href="#L1019">1019</a> <em class="jxr_comment">// Resolve occurrences of "/../" in the normalized path</em>
+<a class="jxr_linenumber" name="L1020" href="#L1020">1020</a> <strong class="jxr_keyword">while</strong> ( <strong class="jxr_keyword">true</strong> )
+<a class="jxr_linenumber" name="L1021" href="#L1021">1021</a> {
+<a class="jxr_linenumber" name="L1022" href="#L1022">1022</a> <strong class="jxr_keyword">int</strong> index = normalized.indexOf( <span class="jxr_string">"/../"</span> );
+<a class="jxr_linenumber" name="L1023" href="#L1023">1023</a> <strong class="jxr_keyword">if</strong> ( index < 0 )
+<a class="jxr_linenumber" name="L1024" href="#L1024">1024</a> {
+<a class="jxr_linenumber" name="L1025" href="#L1025">1025</a> <strong class="jxr_keyword">break</strong>;
+<a class="jxr_linenumber" name="L1026" href="#L1026">1026</a> }
+<a class="jxr_linenumber" name="L1027" href="#L1027">1027</a> <strong class="jxr_keyword">if</strong> ( index == 0 )
+<a class="jxr_linenumber" name="L1028" href="#L1028">1028</a> {
+<a class="jxr_linenumber" name="L1029" href="#L1029">1029</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>; <em class="jxr_comment">// Trying to go outside our context</em>
+<a class="jxr_linenumber" name="L1030" href="#L1030">1030</a> }
+<a class="jxr_linenumber" name="L1031" href="#L1031">1031</a> <strong class="jxr_keyword">int</strong> index2 = normalized.lastIndexOf( '/', index - 1 );
+<a class="jxr_linenumber" name="L1032" href="#L1032">1032</a> normalized = normalized.substring( 0, index2 ) + normalized.substring( index + 3 );
+<a class="jxr_linenumber" name="L1033" href="#L1033">1033</a> }
+<a class="jxr_linenumber" name="L1034" href="#L1034">1034</a>
+<a class="jxr_linenumber" name="L1035" href="#L1035">1035</a> <em class="jxr_comment">// Return the normalized path that we have completed</em>
+<a class="jxr_linenumber" name="L1036" href="#L1036">1036</a> <strong class="jxr_keyword">return</strong> normalized;
+<a class="jxr_linenumber" name="L1037" href="#L1037">1037</a> }
+<a class="jxr_linenumber" name="L1038" href="#L1038">1038</a>
+<a class="jxr_linenumber" name="L1039" href="#L1039">1039</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L1040" href="#L1040">1040</a> <em class="jxr_javadoccomment"> * Resolve a file <code>filename</code> to it's canonical form. If <code>filename</code> is</em>
+<a class="jxr_linenumber" name="L1041" href="#L1041">1041</a> <em class="jxr_javadoccomment"> * relative (doesn't start with <code>/</code>), it will be resolved relative to</em>
+<a class="jxr_linenumber" name="L1042" href="#L1042">1042</a> <em class="jxr_javadoccomment"> * <code>baseFile</code>, otherwise it is treated as a normal root-relative path.</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"> * @param baseFile Where to resolve <code>filename</code> from, if <code>filename</code> is</em>
+<a class="jxr_linenumber" name="L1045" href="#L1045">1045</a> <em class="jxr_javadoccomment"> * relative.</em>
+<a class="jxr_linenumber" name="L1046" href="#L1046">1046</a> <em class="jxr_javadoccomment"> * @param filename Absolute or relative file path to resolve.</em>
+<a class="jxr_linenumber" name="L1047" href="#L1047">1047</a> <em class="jxr_javadoccomment"> * @return The canonical <code>File</code> of <code>filename</code>.</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> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> @Nonnull File resolveFile( <strong class="jxr_keyword">final</strong> File baseFile, @Nonnull String filename )
+<a class="jxr_linenumber" name="L1050" href="#L1050">1050</a> {
+<a class="jxr_linenumber" name="L1051" href="#L1051">1051</a> String filenm = filename;
+<a class="jxr_linenumber" name="L1052" href="#L1052">1052</a> <strong class="jxr_keyword">if</strong> ( '/' != File.separatorChar )
+<a class="jxr_linenumber" name="L1053" href="#L1053">1053</a> {
+<a class="jxr_linenumber" name="L1054" href="#L1054">1054</a> filenm = filename.replace( '/', File.separatorChar );
+<a class="jxr_linenumber" name="L1055" href="#L1055">1055</a> }
+<a class="jxr_linenumber" name="L1056" href="#L1056">1056</a>
+<a class="jxr_linenumber" name="L1057" href="#L1057">1057</a> <strong class="jxr_keyword">if</strong> ( '\\' != File.separatorChar )
+<a class="jxr_linenumber" name="L1058" href="#L1058">1058</a> {
+<a class="jxr_linenumber" name="L1059" href="#L1059">1059</a> filenm = filename.replace( '\\', File.separatorChar );
+<a class="jxr_linenumber" name="L1060" href="#L1060">1060</a> }
+<a class="jxr_linenumber" name="L1061" href="#L1061">1061</a>
+<a class="jxr_linenumber" name="L1062" href="#L1062">1062</a> <em class="jxr_comment">// deal with absolute files</em>
+<a class="jxr_linenumber" name="L1063" href="#L1063">1063</a> <strong class="jxr_keyword">if</strong> ( filenm.startsWith( File.separator ) || ( Os.isFamily( Os.FAMILY_WINDOWS ) && filenm.indexOf( <span class="jxr_string">":"</span> ) > 0 ) )
+<a class="jxr_linenumber" name="L1064" href="#L1064">1064</a> {
+<a class="jxr_linenumber" name="L1065" href="#L1065">1065</a> File file = <strong class="jxr_keyword">new</strong> File( filenm );
+<a class="jxr_linenumber" name="L1066" href="#L1066">1066</a>
+<a class="jxr_linenumber" name="L1067" href="#L1067">1067</a> <strong class="jxr_keyword">try</strong>
+<a class="jxr_linenumber" name="L1068" href="#L1068">1068</a> {
+<a class="jxr_linenumber" name="L1069" href="#L1069">1069</a> file = file.getCanonicalFile();
+<a class="jxr_linenumber" name="L1070" href="#L1070">1070</a> }
+<a class="jxr_linenumber" name="L1071" href="#L1071">1071</a> <strong class="jxr_keyword">catch</strong> ( <strong class="jxr_keyword">final</strong> IOException ioe )
+<a class="jxr_linenumber" name="L1072" href="#L1072">1072</a> {
+<a class="jxr_linenumber" name="L1073" href="#L1073">1073</a> <em class="jxr_comment">// nop</em>
+<a class="jxr_linenumber" name="L1074" href="#L1074">1074</a> }
+<a class="jxr_linenumber" name="L1075" href="#L1075">1075</a>
+<a class="jxr_linenumber" name="L1076" href="#L1076">1076</a> <strong class="jxr_keyword">return</strong> file;
+<a class="jxr_linenumber" name="L1077" href="#L1077">1077</a> }
+<a class="jxr_linenumber" name="L1078" href="#L1078">1078</a> <em class="jxr_comment">// FIXME: I'm almost certain this // removal is unnecessary, as getAbsoluteFile() strips</em>
+<a class="jxr_linenumber" name="L1079" href="#L1079">1079</a> <em class="jxr_comment">// them. However, I'm not sure about this UNC stuff. (JT)</em>
+<a class="jxr_linenumber" name="L1080" href="#L1080">1080</a> <strong class="jxr_keyword">final</strong> <strong class="jxr_keyword">char</strong>[] chars = filename.toCharArray();
+<a class="jxr_linenumber" name="L1081" href="#L1081">1081</a> <strong class="jxr_keyword">final</strong> StringBuilder sb = <strong class="jxr_keyword">new</strong> StringBuilder();
+<a class="jxr_linenumber" name="L1082" href="#L1082">1082</a>
+<a class="jxr_linenumber" name="L1083" href="#L1083">1083</a> <em class="jxr_comment">//remove duplicate file separators in succession - except</em>
+<a class="jxr_linenumber" name="L1084" href="#L1084">1084</a> <em class="jxr_comment">//on win32 at start of filename as UNC filenames can</em>
+<a class="jxr_linenumber" name="L1085" href="#L1085">1085</a> <em class="jxr_comment">//be \\AComputer\AShare\myfile.txt</em>
+<a class="jxr_linenumber" name="L1086" href="#L1086">1086</a> <strong class="jxr_keyword">int</strong> start = 0;
+<a class="jxr_linenumber" name="L1087" href="#L1087">1087</a> <strong class="jxr_keyword">if</strong> ( '\\' == File.separatorChar )
+<a class="jxr_linenumber" name="L1088" href="#L1088">1088</a> {
+<a class="jxr_linenumber" name="L1089" href="#L1089">1089</a> sb.append( filenm.charAt( 0 ) );
+<a class="jxr_linenumber" name="L1090" href="#L1090">1090</a> start++;
+<a class="jxr_linenumber" name="L1091" href="#L1091">1091</a> }
+<a class="jxr_linenumber" name="L1092" href="#L1092">1092</a>
+<a class="jxr_linenumber" name="L1093" href="#L1093">1093</a> <strong class="jxr_keyword">for</strong> ( <strong class="jxr_keyword">int</strong> i = start; i < chars.length; i++ )
+<a class="jxr_linenumber" name="L1094" href="#L1094">1094</a> {
+<a class="jxr_linenumber" name="L1095" href="#L1095">1095</a> <strong class="jxr_keyword">final</strong> <strong class="jxr_keyword">boolean</strong> doubleSeparator = File.separatorChar == chars[i] && File.separatorChar == chars[i - 1];
[... 1912 lines stripped ...]