xref: /aosp_15_r20/external/apache-commons-io/src/site/xdoc/upgradeto1_2.xml (revision 0c4d7b72e49a04598d65c566f44504b95342d75a)
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 1.1 to 1.2</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 1.1 to version 1.2.
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 Ebrahimiand endian transformation classes.
36*0c4d7b72SSadaf Ebrahimi
37*0c4d7b72SSadaf Ebrahimi
38*0c4d7b72SSadaf EbrahimiCompatibility with 1.1
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
46*0c4d7b72SSadaf Ebrahimi
47*0c4d7b72SSadaf EbrahimiDeprecations from 1.1
48*0c4d7b72SSadaf Ebrahimi---------------------
49*0c4d7b72SSadaf Ebrahimi
50*0c4d7b72SSadaf Ebrahimi
51*0c4d7b72SSadaf EbrahimiBug fixes from 1.1
52*0c4d7b72SSadaf Ebrahimi------------------
53*0c4d7b72SSadaf Ebrahimi- FileSystemUtils.freeSpace(drive)
54*0c4d7b72SSadaf Ebrahimi  Fix to allow Windows based command to function in French locale
55*0c4d7b72SSadaf Ebrahimi
56*0c4d7b72SSadaf Ebrahimi- FileUtils.read*
57*0c4d7b72SSadaf Ebrahimi  Increase certainty that files are closed in case of error
58*0c4d7b72SSadaf Ebrahimi
59*0c4d7b72SSadaf Ebrahimi- LockableFileWriter
60*0c4d7b72SSadaf Ebrahimi  Locking mechanism was broken and only provided limited protection [38942]
61*0c4d7b72SSadaf Ebrahimi  File deletion and locking in case of constructor error was broken
62*0c4d7b72SSadaf Ebrahimi
63*0c4d7b72SSadaf Ebrahimi
64*0c4d7b72SSadaf EbrahimiEnhancements from 1.1
65*0c4d7b72SSadaf Ebrahimi---------------------
66*0c4d7b72SSadaf Ebrahimi- AgeFileFilter/SizeFileFilter
67*0c4d7b72SSadaf Ebrahimi  New file filters that compare against the age and size of the file
68*0c4d7b72SSadaf Ebrahimi
69*0c4d7b72SSadaf Ebrahimi- FileSystemUtils.freeSpaceKb(drive)
70*0c4d7b72SSadaf Ebrahimi  New method that unifies result to be in kilobytes [38574]
71*0c4d7b72SSadaf Ebrahimi
72*0c4d7b72SSadaf Ebrahimi- FileUtils.contentEquals(File,File)
73*0c4d7b72SSadaf Ebrahimi  Performance improved by adding length and file location checking
74*0c4d7b72SSadaf Ebrahimi
75*0c4d7b72SSadaf Ebrahimi- FileUtils.iterateFiles
76*0c4d7b72SSadaf Ebrahimi  Two new method to provide direct access to iterators over files
77*0c4d7b72SSadaf Ebrahimi
78*0c4d7b72SSadaf Ebrahimi- FileUtils.lineIterator
79*0c4d7b72SSadaf Ebrahimi  IOUtils.lineIterator
80*0c4d7b72SSadaf Ebrahimi  New methods to provide an iterator over the lines in a file [38083]
81*0c4d7b72SSadaf Ebrahimi
82*0c4d7b72SSadaf Ebrahimi- FileUtils.copyDirectoryToDirectory
83*0c4d7b72SSadaf Ebrahimi  New method to copy a directory to within another directory [36315]
84*0c4d7b72SSadaf Ebrahimi
85*0c4d7b72SSadaf Ebrahimi</source>
86*0c4d7b72SSadaf Ebrahimi</p>
87*0c4d7b72SSadaf Ebrahimi</section>
88*0c4d7b72SSadaf Ebrahimi
89*0c4d7b72SSadaf Ebrahimi</body>
90*0c4d7b72SSadaf Ebrahimi</document>
91