apache commons io 變更記錄（2016-04-21更新）

發行記錄

發行歷史

版本	日期	描述
2.5	2015-12-DD	新特性以及bug修復。
2.4	2012-06-12	新特性以及bug修復。
2.3	2012-04-10	新特性以及bug修復。
2.2	2012-03-26	新特性以及bug修復。
2.1	2011-09-28	新特性以及bug修復。
2.0.1	2010-12-26
2.0	2010-10-18
1.4	2008-01-21
1.3.2	2007-07-02	Bug修復。

發行版2.5 - 2015-12-DD

類型	變更	貢獻者
	錯別字：在IOUtils.java註釋中用"focused"代替"focussed"。修復IO-492. Thanks to Santiago Castro.	ggregory
	轉換全部測試用例到JUnit 4。修復IO-433。	krosenvold
	增加ValidatingObjectInputStream以控制序列化。修復IO-487。	bdelacretaz
	在TailerListener 中增加endOfFileReached方法。修復IO-446。感謝Jeffrey Barrus。	krosenvold
	FilenameUtils應該處理內嵌null字節數組。修復IO-484。感謝Philippe Arteau。	krosenvold
	變更/糾正waitFor的算法。修復IO-481。	krosenvold
	在ReversedLinesFileReader 中支持其他編碼。修復IO-471。感謝Leandro Reis。	krosenvold
	如果輸入輸出流不包含BOM，BOMInputStream.skip返回錯誤計數。修復IO-428。感謝Stefan Gmeiner。	krosenvold
	ThresholdingOutputStream 中threshold 的Setter方法。修復IO-425。感謝Craig Swank。	krosenvold
	FileUtils.waitFor(...)子線程中斷狀態。修復IO-488。感謝Björn Buchner。	krosenvold
	當出現連接符時增加對JDK7連接符特性的支持以實現缺失目標的連接符。修復IO-452。噶寫David Standish。	krosenvold
	增加測試用例以展示IO-423被解決。修復IO-466。	krosenvold
	糾正FileUtils.getFile(File, String...)中的異常信息。修復IO-479。感謝Zhouce Chen。	sebb
	介紹新類AppendableOutputStream。修復IO-406。感謝Niall Pemberton。	britter
	升級到JUnit 4.12。修復IO-465。感謝based2。	britter
	不再需要IOExceptionWithCause。修復IO-462。	sebb
	增加WindowsLineEndingInputStream以及UnixLineEndingInputStream。修復IO-459。感謝Kristian Rosenvold。	olamy
	增加BoundedReader封裝了有限制地使用底層輸入輸出流的mark和reset方法-以避免重載mark以修改底層緩衝的限制。修復IO-457。感謝Kristian Rosenvold。	olamy
	FileUtils.readFileToString從2.0.1迴歸到從前。修復IO-453。感謝Steven Christou。	sebb
	ant測試失敗-測試類路徑資源缺失。修復IO-451。感謝David Standish。	sebb
	記錄FileUtils.deleteDirectory、directoryContains以及cleanDirectory可能在傳遞不存在的文件夾或不是文件夾時拋出IllegalArgumentException。修復IO-435。感謝Dominik Stadler。	tn
增加API IOUtils.closeQuietly(Closeable...)修復IO-426。	ggregory
Javadoc修復, 大部分兼容1.8.0修復IO-424。感謝Ville Skyttä.	ggregory
以Java7的 java.nio.charset.StandardCharsets取代Charsets類的字符集編碼常量。修復IO-422。	ggregory
Readfully()返回一個字母數組修復IO-410。感謝BELUGA BEHR.	sebb
多態（overload）IOUtils的緩衝方法以接收緩衝大小參數修復IO-395。感謝BELUGA BEHR.	brentworden
FileUtils.sizeOfDirectory可以報出IllegalArgumentException了修復IO-389。感謝Austin Doupnik.	sebb
FileUtils.sizeOfDirectoryAsBigInteger會溢出。確保遞歸調用全部使用BigInteger類修復IO-390。	sebb
對大數組進行塊輸入輸出。增加writeChunked(byte[], OutputStream)以及writeChunked(char[] Writer)還增加了ChunkedOutputStream, ChunkedWriter修復IO-382。	sebb
FileUtils.doCopyFile如果沒有數據複製時，可能在退出循環時出現死循環修復IO-385。	sebb
FileUtils.doCopyFile緩存文件大小；需要被記錄到javadoc中；並在異常信息中顯示文件長度修復IO-383。	sebb
轉換IOCase類型爲Java 1.5 Enumeration類[注.這是編譯後可兼容的]修復IO-239。	sebb
爲IOUtils增加緩衝輸入輸出流、字符輸出流的方法，通過多態buffer()方法實現-還可以查看IO-330修復IO-233。	sebb
IOUtils#toBufferedOutputStream/toBufferedWriter增加buffer()的多態方法來有條件的封裝output。-還可以查看IO-233修復IO-330。	sebb
增加FileUtils.copyInputStreamToFile API通過參數來返回文件源碼。查看copyInputStreamToFile(final InputStream source, final File destination, boolean closeSource)修復IO-381。	ggregory
FileUtils.copyInputStreamToFile應該修改代碼以關閉輸入流修復IO-380。感謝claudio_ch.	sebb
Tailer錯誤地處理了新建文件。通過使用file.lastModified()而不是System.currentTimeMillis()來進行修復。修復IO-279。	sebb
CharSequenceInputStream#reset()當緩衝大小不能被數據大小整除的情況下就出現錯誤。爲了修復代碼跳過相關的編碼字節；現在重置將對數據重新編碼直到標記位置修復IO-356。	sebb
CharSequenceInputStream-增加available()的測試。以修復測試能完全反映最小值。修復IO-379。	sebb
如果filename是斜線開頭的getPrefixLength返回null。Javadoc: 增加例子來展現正確行爲;增加單元測試修復IO-328。	sebb
FileUtils.listFilesAndDirs當dir不匹配過濾器時記錄原始的dir在結果中Javadoc: 說明原始dir會被包含在結果中。修復IO-299。	sebb
增加ByteArrayOutputStream.toInputStream()修復IO-346。	sebb
ClassLoaderObjectInputStream不處理基本數據類型，修復IO-368。	sebb
一個記錄BOM字符(Uᑁ)的常量，修復IO-341。	sebb
反對所有使用默認編碼的方法，修復IO-314。	sebb
當一個文件被反轉時，完成讀取這一個文件再開始新的文件。修復IO-338。	sebb
Commons IO Tailer不支持UTF-8字符。修復IO-354。	sebb
當發生溢出FileUtils.sizeOf[Directory]將發生什麼、增加Javadoc。修復IO-323。	sebb
FileUtils.moveDirectory當出現失敗時會產生誤導性的錯誤信息，修復IO-372。	sebb
FilenameUtils.splitOnTokens(String text)可以簡化'**'的檢查，修復IO-375。	sebb
WildcardFileFilter 當代理其他ctors時，ctors不應該使用null來表示IOCase.SENSITIVE，修復IO-374。	sebb
IOUtils.contentEquals* 方法如果input1 == input2時返回false，應該返回true，修復IO-362。感謝mmadson, ggregory.	ggregory
增加API FileUtils.forceMkdirsParent()。修復IO-361。	ggregory
增加API Charsets.requiredCharsets()。修復IO-360。	ggregory
增加IOUtils.skip以及skipFully(ReadableByteChannel, long)。修復IO-359。感謝yukoba.	ggregory
增加IOUtils.read以及readFully(ReadableByteChannel, ByteBuffer buffer)。修復IO-358。感謝yukoba.	ggregory
[Tailer] InterruptedException如果線程是休眠的將被忽略，修復IO-357。感謝mortenh.	ggregory
增加API IOUtils.copy(InputStream, OutputStream, int)修復IO-353。感謝ggregory.	ggregory
增加API可傳遞數組offset以及length參數給FileUtils.writeByteArrayToFile方法。修復IO-349。感謝scop.	ggregory
修復拼寫錯誤。修復IO-352。感謝scop。	ggregory
在調用org.apache.commons.io.FileUtils#validateListFilesParameters拋出IllegalArgumentException時缺失信息。修復IO-348。感謝plcstpierre.	ggregory
提供一個勾方法來允許Tailer主動確定停止條件。修復IO-345。感謝mkresse.	ggregory

發行版 2.4 - 2012-06-12

類型	變更	貢獻者
org.apache.commons.io.comparator Javadoc與真實代碼不一致。修復IO-343。感謝igorlash.	ggregory
在FileUtils中Yottabyte (YB)的定義值不正確。修復IO-336。感謝rleavelle.	ggregory
在Windows中，Tailer對文件刪除及重命名時上鎖。修復IO-269。感謝sebb.	ggregory
Tailer錯誤地判斷文件爲新文件。修復IO-279。感謝Sergio Bossa, Chris Baron.	sebb
Tailer#readLines-對回車符處理錯誤。修復IO-335。	sebb
FileUtils.toURLs對null參數拋出NullPointerException；記錄該行爲。修復IO-334。	sebb
在1.x版本中導出OSGi包以兼容2.x。修復IO-333。感謝fmeschbe.	ggregory
增加XmlStreamReader支持UTF-32。修復IO-320。感謝ggregory.	ggregory
BOMInputStream在getBOM()方法中錯誤地將UTF-32LE_BOM文件判斷爲UTF-16LE_BOM文件。修復IO-331。感謝ggregory.	ggregory
增強tailer的讀取能力。修復IO-332。感謝liangly.	ggregory
增強Tailer的緩衝讀取能力。(查看IO-332)。修復IO-279.	ggregory
FileUtils.writeLines使用不緩衝的輸入輸出流。修復IO-329。感謝tivv.	ggregory
增加byteCountToDisplaySize(BigInteger)。修復IO-327。感謝ggregory.	ggregory
增加新的FileUtils.sizeOf[Directory] API集合來返回BigInteger類型。修復IO-326。感謝ggregory, kinow.	ggregory
增加IOUtils.toByteArray方法來處理URL以及URI。修復IO-325。感謝raviprak.	ggregory
增加缺失的字符集編碼對應的API集合以保存字符串類型的字符集編碼。修復IO-324。感謝raviprak.	ggregory
FileUtils.sizeOfDirectory允許同步連接。修復IO-319。感謝raviprak.	ggregory

發行版 2.3 - 2012-04-10

類型	變更	貢獻者
增加並使用Charsets類。修復IO-322.感謝ggregory.	ggregory
ByteOrderMark UTF_32LE的值不正確。修復IO-321。 感謝ggregory.	ggregory
增加字符集編碼對應的API集合以保存字符串類型的字符集編碼。修復IO-318。感謝ggregory.	ggregory

發行版 2.2 - 2012-03-26

類型	變更	貢獻者
增加IOUTils.toBufferedReader(Reader)修復IO-313。感謝ggregory.	ggregory
允許應用提供緩衝(或大小)作爲參數給copyLarge方法。修復IO-308。感謝Manoj Mokashi.	sebb
IOUtils.read(InputStream/Reader)缺少offset參數，修復IO-311。感謝Robert Muir.	sebb
CharSequenceInputStream(CharSequence s, Charset charset, int bufferSize)缺少bufferSize參數，修復IO-312。	sebb
在IOUtils中新增copyLarge()方法以兼容offset,length參數，修復IO-305。感謝Manoj Mokashi.	sebb
如果目標是自己的子文件夾FileUtils.moveDirectoryToDirectory將刪除原文件夾，修復IO-300。	sebb
ReaderInputStream#read(byte[] b, int off, int len)應該檢查參數有效性，修復IO-307。	sebb
在FileUtils.byteCountToDisplaySize(long size)中使用terabyte (TB), petabyte (PB) 以及 exabyte (EB)，修復IO-287。感謝Ron Kuris, Gary Gregory.	bayard
ReaderInputStream#read(byte[] b, int off, int len)當leng==0時應該返回0，修復IO-306。	sebb
FileUtils.listFiles()沒有返回目標文件，修復IO-173。感謝Marcos Vinícius da Silva.	sebb
"FileUtils#deleteDirectoryOnExit(File)"執行不正確，修復IO-276。感謝nkami.	sebb
BoundedInputStream.read()將從BoundedInputStream.read(byte[]...)處理最大差異，修復IO-273。感謝sebb.	sebb
CharSequenceInputStream將有效處理CharSequence 類型內容的輸入輸出流，修復IO-297。感謝Oleg Kalnichevski.	sebb
優化ReaderInputStream:讀取小數據塊將更有效率，修復IO-296。感謝Oleg Kalnichevski.	sebb
各種各樣'org.apache.commons.io.FileUtils'的方法不正確地未拋出'java.io.IOException'，修復IO-298。感謝Christian Schulte.	sebb
Tailer類的第二個構造器未傳遞'delay'到第三個構造器，修復IO-304。感謝liangly.	ggregory
當main.close()拋出異常時TeeOutputStream沒有調用branch.close()，修復IO-303。感謝fabian.barney.	ggregory
在BOMInputStream 類中當讀取一個文件多次沒有使用BOM時拋出ArrayIndexOutOfBoundsException，修復IO-302。感謝jsteuerwald, detinho.	ggregory
必要時增加IOUtils.closeQuietly(Selector)，修復IO-301。感謝kaykay.unique.	ggregory
IOUtils.closeQuietly()應該將ServerSocket作爲參數，修復IO-292。感謝sebb.	sebb
在IOUtils中增加read/readFully方法，修復IO-290。感謝sebb.	sebb
提供一個ReversedLinesFileReader，修復IO-288。感謝Georg Henzler.	sebb
增加一個新方法FileUtils.directoryContains。修復IO-291。感謝ggregory.	ggregory
FileUtils.contentEquals 以及 IOUtils.contentEquals - 在每個類增加操作來忽略"line endings"，增加contentEqualsIgnoreEOL方法，修復IO-275。感謝CJ Aspromgos.	sebb

發行版 2.1 - 2011-09-28

類型	變更	貢獻者
使用標準Maven目錄檢出，修復IO-285。感謝ggregory.	ggregory
增加IOUtils API toString來通過URL 以及 URI獲取內容，修復IO-284。感謝ggregory.	ggregory
增加API FileUtils.copyFile(File input, OutputStream output)，修復IO-282。感謝ggregory.	ggregory
使用mkdirs()方法返回的編碼令人疑惑，修復IO-280。感謝sebb.	sebb
當ReaderInputStream遇到一個未映射的字符時將進入死循環，修復IO-277。
FileUtils.moveFile() JavaDoc應該指出拋出FileExistsException的情況，修復IO-264。
FileAlterationObserver沒有FileFilter的getter方法，修復IO-262。
增加FileUtils.getFile API可傳可變參數，修復IO-261。
ClassLoaderObjectInputStream未處理代理類，修復IO-260。
FileAlterationMonitor.stop(boolean allowIntervalToFinish)修復 IO-259.
增加一個新的附加參數來寫入字符串到文件，修復IO-182。
當達到EOF而在EOL之前。Tailer返回部分行，修復IO-274。感謝Frank Grimes.	sebb
當FileUtils.copyFile()複製大文件到一個共享文件夾時（在Windows中）拋出IOException，修復IO-266。感謝Igor Smereka.	sebb
在Windows存儲卷中沒有可訪問文件時FileSystemUtils.freeSpaceKb拋出異常。增強覆蓋到隱藏文件。修復IO-263。感謝Gil Adam.	sebb
增加一個新的讀取方法"toByteArray"來處理一個知道大小的InputStream。修復IO-251。感謝Marco Albini.	sebb

發行版2.0.1 - 2010-12-26

類型	變更	貢獻者
TODO: 跳轉到 RELEASE-NOTES.txt from 2.0.1?

發行版 2.0 - 2010-10-18

類型	變更	貢獻者
TODO: 跳轉到 RELEASE-NOTES.txt from 2.0?

發行版 1.4 - 2008-01-21

類型	變更	貢獻者
TODO: 跳轉到 RELEASE-NOTES.txt from 1.4?

發行版 1.3.2 - 2007-07-02

類型	變更	貢獻者
一些測試，假設是一個Unix文件系統，現在跳過Windows。修復IO-115。	jochen
創建FileCleaningTracker，基於一個FileCleaner的非靜態版本，這可以通過用戶來控制。修復IO-116。	jochen
EndianUtils - 全部readSwappedUnsignedInteger(...)方法可以返回負數來處理int/long轉換。修復IO-117。感謝Hiroshi Ikeda.	bayard