1*0c4d7b72SSadaf Ebrahimi<?xml version="1.0"?> 2*0c4d7b72SSadaf Ebrahimi<!-- 3*0c4d7b72SSadaf EbrahimiLicensed to the Apache Software Foundation (ASF) under one or more 4*0c4d7b72SSadaf Ebrahimicontributor license agreements. See the NOTICE file distributed with 5*0c4d7b72SSadaf Ebrahimithis work for additional information regarding copyright ownership. 6*0c4d7b72SSadaf EbrahimiThe ASF licenses this file to You under the Apache License, Version 2.0 7*0c4d7b72SSadaf Ebrahimi(the "License"); you may not use this file except in compliance with 8*0c4d7b72SSadaf Ebrahimithe License. You may obtain a copy of the License at 9*0c4d7b72SSadaf Ebrahimi 10*0c4d7b72SSadaf Ebrahimi http://www.apache.org/licenses/LICENSE-2.0 11*0c4d7b72SSadaf Ebrahimi 12*0c4d7b72SSadaf EbrahimiUnless required by applicable law or agreed to in writing, software 13*0c4d7b72SSadaf Ebrahimidistributed under the License is distributed on an "AS IS" BASIS, 14*0c4d7b72SSadaf EbrahimiWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 15*0c4d7b72SSadaf EbrahimiSee the License for the specific language governing permissions and 16*0c4d7b72SSadaf Ebrahimilimitations under the License. 17*0c4d7b72SSadaf Ebrahimi--> 18*0c4d7b72SSadaf Ebrahimi<document> 19*0c4d7b72SSadaf Ebrahimi <properties> 20*0c4d7b72SSadaf Ebrahimi <title>Upgrade from 2.0.1 to 2.1</title> 21*0c4d7b72SSadaf Ebrahimi <author email="[email protected]">Commons Documentation Team</author> 22*0c4d7b72SSadaf Ebrahimi </properties> 23*0c4d7b72SSadaf Ebrahimi<body> 24*0c4d7b72SSadaf Ebrahimi 25*0c4d7b72SSadaf Ebrahimi<section name="Upgrade"> 26*0c4d7b72SSadaf Ebrahimi<p> 27*0c4d7b72SSadaf EbrahimiThese are the release notes and advice for upgrading Commons-IO from 28*0c4d7b72SSadaf Ebrahimiversion 2.0.1 to version 2.1 29*0c4d7b72SSadaf Ebrahimi<source> 30*0c4d7b72SSadaf EbrahimiCommons IO is a package of Java utility classes for java.io's hierarchy. 31*0c4d7b72SSadaf EbrahimiClasses in this package are considered to be so standard and of such high 32*0c4d7b72SSadaf Ebrahimireuse as to justify existence in java.io. 33*0c4d7b72SSadaf Ebrahimi 34*0c4d7b72SSadaf EbrahimiCommons IO contains utility classes, stream implementations, file filters, 35*0c4d7b72SSadaf Ebrahimifile comparators and endian transformation classes. 36*0c4d7b72SSadaf Ebrahimi 37*0c4d7b72SSadaf EbrahimiCompatibility with 2.0.1 and 1.4 38*0c4d7b72SSadaf Ebrahimi-------------------------------- 39*0c4d7b72SSadaf Ebrahimi 40*0c4d7b72SSadaf EbrahimiBinary compatible - Yes 41*0c4d7b72SSadaf Ebrahimi 42*0c4d7b72SSadaf EbrahimiSource compatible - Yes 43*0c4d7b72SSadaf Ebrahimi 44*0c4d7b72SSadaf EbrahimiSemantic compatible - Yes 45*0c4d7b72SSadaf Ebrahimi Check the bug fixes section for semantic bug fixes 46*0c4d7b72SSadaf Ebrahimi 47*0c4d7b72SSadaf EbrahimiCommons IO 2.1 requires a minimum of JDK 1.5 48*0c4d7b72SSadaf Ebrahimi (Commons IO 1.4 had a minimum of JDK 1.3) 49*0c4d7b72SSadaf Ebrahimi 50*0c4d7b72SSadaf Ebrahimi 51*0c4d7b72SSadaf EbrahimiNew features since 2.0.1 52*0c4d7b72SSadaf Ebrahimi------------------------ 53*0c4d7b72SSadaf Ebrahimi 54*0c4d7b72SSadaf Ebrahimio Use standard Maven directory layout Issue: IO-285. Thanks to ggregory. 55*0c4d7b72SSadaf Ebrahimio Add IOUtils API toString for URL and URI to get contents Issue: IO-284. Thanks to ggregory. 56*0c4d7b72SSadaf Ebrahimio Add API FileUtils.copyFile(File input, OutputStream output) Issue: IO-282. Thanks to ggregory. 57*0c4d7b72SSadaf Ebrahimio FileAlterationObserver has no getter for FileFilter Issue: IO-262. 58*0c4d7b72SSadaf Ebrahimio Add FileUtils.getFile API with varargs parameter Issue: IO-261. 59*0c4d7b72SSadaf Ebrahimio Add new APPEND parameter for writing string into files Issue: IO-182. 60*0c4d7b72SSadaf Ebrahimio Add new read method "toByteArray" to handle InputStream with known size. Issue: IO-251. Thanks to Marco Albini. 61*0c4d7b72SSadaf Ebrahimi 62*0c4d7b72SSadaf EbrahimiFixed Bugs since 2.0.1 63*0c4d7b72SSadaf Ebrahimi---------------------- 64*0c4d7b72SSadaf Ebrahimi 65*0c4d7b72SSadaf Ebrahimio Dubious use of mkdirs() return code Issue: IO-280. Thanks to sebb. 66*0c4d7b72SSadaf Ebrahimio ReaderInputStream enters infinite loop when it encounters an unmappable character Issue: IO-277. 67*0c4d7b72SSadaf Ebrahimio FileUtils.moveFile() Javadoc should specify FileExistsException thrown Issue: IO-264. 68*0c4d7b72SSadaf Ebrahimio ClassLoaderObjectInputStream does not handle Proxy classes Issue: IO-260. 69*0c4d7b72SSadaf Ebrahimio Tailer returning partial lines when reaching EOF before EOL Issue: IO-274. Thanks to Frank Grimes. 70*0c4d7b72SSadaf Ebrahimio FileUtils.copyFile() throws IOException when copying large files to a shared directory (on Windows) Issue: IO-266. Thanks to Igor Smereka. 71*0c4d7b72SSadaf Ebrahimio FileSystemUtils.freeSpaceKb throws exception for Windows volumes with no visible files. 72*0c4d7b72SSadaf Ebrahimi Improve coverage by also looking for hidden files. Issue: IO-263. Thanks to Gil Adam. 73*0c4d7b72SSadaf Ebrahimi 74*0c4d7b72SSadaf EbrahimiChanges since 2.0.1 75*0c4d7b72SSadaf Ebrahimi------------------- 76*0c4d7b72SSadaf Ebrahimio FileAlterationMonitor.stop(boolean allowIntervalToFinish) Issue: IO-259. 77*0c4d7b72SSadaf Ebrahimi</source> 78*0c4d7b72SSadaf Ebrahimi</p> 79*0c4d7b72SSadaf Ebrahimi</section> 80*0c4d7b72SSadaf Ebrahimi 81*0c4d7b72SSadaf Ebrahimi</body> 82*0c4d7b72SSadaf Ebrahimi</document> 83