Class IOUtils

This class emulates the new Java 7 "Try-With-Resources" statement. Remove once Lucene is on Java 7.

@lucene.internal

Inheritance
System.Object
IOUtils
Assembly: DistributedLucene.Net.dll
Syntax
public sealed class IOUtils : object

Fields

Name Description
CHARSET_UTF_8

UTF-8 instance to prevent repeated lookups

UTF_8

UTF-8 charset string.

Where possible, use instead, as using the constant may slow things down.

Methods

Name Description
Close(IDisposable[])

Disposes all given s. Some of the s may be null; they are ignored. After everything is closed, the method either throws the first exception it hit while closing, or completes normally if there were no exceptions.
Close(IEnumerable<IDisposable>)

Disposes all given s.

CloseWhileHandlingException(Exception, IDisposable[])

Disposes all given IDisposables, suppressing all thrown exceptions. Some of the IDisposables may be null, they are ignored. After everything is disposed, method either throws priorException, if one is supplied, or the first of suppressed exceptions, or completes normally.

Sample usage: 

IDisposable resource1 = null, resource2 = null, resource3 = null;
ExpectedException priorE = null;
try 
{
    resource1 = ...; resource2 = ...; resource3 = ...; // Acquisition may throw ExpectedException
    ..do..stuff.. // May throw ExpectedException
} 
catch (ExpectedException e) 
{
    priorE = e;
} 
finally 
{
    IOUtils.CloseWhileHandlingException(priorE, resource1, resource2, resource3);
}
CloseWhileHandlingException(Exception, IEnumerable<IDisposable>)

Disposes all given s, suppressing all thrown exceptions.

CloseWhileHandlingException(IDisposable[])

Disposes all given s, suppressing all thrown exceptions. Some of the s may be null, they are ignored.
CloseWhileHandlingException(IEnumerable<IDisposable>)

Disposes all given s, suppressing all thrown exceptions.

Copy(FileInfo, FileInfo)

Copy one file's contents to another file. The target will be overwritten if it exists. The source must exist.
DeleteFilesIgnoringExceptions(Directory, String[])

Deletes all given files, suppressing all thrown s.

Note that the files should not be null.
Dispose(IDisposable[])

Disposes all given s. Some of the s may be null; they are ignored. After everything is closed, the method either throws the first exception it hit while closing, or completes normally if there were no exceptions.
Dispose(IEnumerable<IDisposable>)

Disposes all given s.

DisposeWhileHandlingException(Exception, IDisposable[])

Disposes all given IDisposables, suppressing all thrown exceptions. Some of the IDisposables may be null, they are ignored. After everything is disposed, method either throws priorException, if one is supplied, or the first of suppressed exceptions, or completes normally.

Sample usage: 

IDisposable resource1 = null, resource2 = null, resource3 = null;
ExpectedException priorE = null;
try 
{
    resource1 = ...; resource2 = ...; resource3 = ...; // Acquisition may throw ExpectedException
    ..do..stuff.. // May throw ExpectedException
} 
catch (ExpectedException e) 
{
    priorE = e;
} 
finally 
{
    IOUtils.DisposeWhileHandlingException(priorE, resource1, resource2, resource3);
}
DisposeWhileHandlingException(Exception, IEnumerable<IDisposable>)

Disposes all given s, suppressing all thrown exceptions.

DisposeWhileHandlingException(IDisposable[])

Disposes all given s, suppressing all thrown exceptions. Some of the s may be null, they are ignored.
DisposeWhileHandlingException(IEnumerable<IDisposable>)

Disposes all given s, suppressing all thrown exceptions.

GetDecodingReader(FileInfo, Encoding)

Opens a for the given using a . Unlike Java's defaults this reader will throw an exception if your it detects the read charset doesn't match the expected .

Decoding readers are useful to load configuration files, stopword lists or synonym files to detect character set problems. However, its not recommended to use as a common purpose reader.

GetDecodingReader(Stream, Encoding)

Wrapping the given in a reader using a . Unlike Java's defaults this reader will throw an exception if your it detects the read charset doesn't match the expected .

Decoding readers are useful to load configuration files, stopword lists or synonym files to detect character set problems. However, its not recommended to use as a common purpose reader.
GetDecodingReader(Type, String, Encoding)

Opens a for the given resource using a . Unlike Java's defaults this reader will throw an exception if your it detects the read charset doesn't match the expected .

Decoding readers are useful to load configuration files, stopword lists or synonym files to detect character set problems. However, its not recommended to use as a common purpose reader.

ReThrow(Exception)

Simple utilty method that takes a previously caught and rethrows either or an unchecked exception. If the argument is null then this method does nothing.
ReThrowUnchecked(Exception)

Simple utilty method that takes a previously caught and rethrows it as an unchecked exception. If the argument is null then this method does nothing.

Extension Methods