1<?xml version="1.0"?> 2<!-- 3Licensed to the Apache Software Foundation (ASF) under one or more 4contributor license agreements. See the NOTICE file distributed with 5this work for additional information regarding copyright ownership. 6The ASF licenses this file to You under the Apache License, Version 2.0 7(the "License"); you may not use this file except in compliance with 8the License. You may obtain a copy of the License at 9 10 http://www.apache.org/licenses/LICENSE-2.0 11 12Unless required by applicable law or agreed to in writing, software 13distributed under the License is distributed on an "AS IS" BASIS, 14WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 15See the License for the specific language governing permissions and 16limitations under the License. 17--> 18<document> 19 <properties> 20 <title>Upgrade from 1.1 to 1.2</title> 21 <author email="[email protected]">Commons Documentation Team</author> 22 </properties> 23<body> 24 25<section name="Upgrade"> 26<p> 27These are the release notes and advice for upgrading Commons-IO from 28version 1.1 to version 1.2. 29<source> 30Commons IO is a package of Java utility classes for java.io's hierarchy. 31Classes in this package are considered to be so standard and of such high 32reuse as to justify existence in java.io. 33 34Commons IO contains utility classes, stream implementations, file filters, 35and endian transformation classes. 36 37 38Compatibility with 1.1 39---------------------- 40Binary compatible - Yes 41 42Source compatible - Yes 43 44Semantic compatible - Yes 45 46 47Deprecations from 1.1 48--------------------- 49 50 51Bug fixes from 1.1 52------------------ 53- FileSystemUtils.freeSpace(drive) 54 Fix to allow Windows based command to function in French locale 55 56- FileUtils.read* 57 Increase certainty that files are closed in case of error 58 59- LockableFileWriter 60 Locking mechanism was broken and only provided limited protection [38942] 61 File deletion and locking in case of constructor error was broken 62 63 64Enhancements from 1.1 65--------------------- 66- AgeFileFilter/SizeFileFilter 67 New file filters that compare against the age and size of the file 68 69- FileSystemUtils.freeSpaceKb(drive) 70 New method that unifies result to be in kilobytes [38574] 71 72- FileUtils.contentEquals(File,File) 73 Performance improved by adding length and file location checking 74 75- FileUtils.iterateFiles 76 Two new method to provide direct access to iterators over files 77 78- FileUtils.lineIterator 79 IOUtils.lineIterator 80 New methods to provide an iterator over the lines in a file [38083] 81 82- FileUtils.copyDirectoryToDirectory 83 New method to copy a directory to within another directory [36315] 84 85</source> 86</p> 87</section> 88 89</body> 90</document> 91