IO (cdm-core 6.0.0-beta1 API)

java.lang.Object
- ucar.nc2.util.IO

```
public class IO
extends Object
```
Input/Output static utilities.

See Also:

"http://stackoverflow.com/questions/12552863/correct-idiom-for-managing-multiple-chained-resources-in-try-with-resources-bloc"

Field Summary

Fields
Modifier and Type Field and Description

static int default_file_buffersize

static int default_socket_buffersize

Fields
Modifier and Type	Field and Description
`static int`	`default_file_buffersize`
`static int`	`default_socket_buffersize`

Constructor Summary

Constructors
Constructor and Description

IO()

Constructors
Constructor and Description
`IO()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static long`	`appendToFile(InputStream in, String fileOutName)`
`static long`	`copy(InputStream in, OutputStream out)` Copy all bytes from in to out.
`static void`	`copy2File(byte[] src, String fileOut)` copy bytes to File
`static long`	`copy2null(FileChannel in, int buffersize)` copy all bytes from in and throw them away.
`static long`	`copy2null(InputStream in, int buffersize)` copy all bytes from in and throw them away.
`static long`	`copyB(InputStream in, OutputStream out, int bufferSize)` copy all bytes from in to out, specify buffer size
`static long`	`copyBuffered(InputStream in, OutputStream out, int buffer_size)` Copy all bytes from in to out, setting buffer size.
`static void`	`copyDirTree(String fromDirName, String toDirName)` Copy an entire directory tree.
`static void`	`copyFile(File fileIn, File fileOut)` copy one file to another.
`static void`	`copyFile(String fileInName, OutputStream out)` copy file to output stream
`static void`	`copyFile(String fileInName, String fileOutName)` copy one file to another.
`static void`	`copyFileB(File fileIn, OutputStream out, int bufferSize)` copy file to output stream, specify internal buffer size
`static void`	`copyMaxBytes(InputStream in, OutputStream out, int maxBytes)` Copy up to maxBytes bytes from in to out.
`static long`	`copyRafB(RandomAccessFile raf, long offset, long length, OutputStream out, byte[] buffer)` Copy part of a RandomAccessFile to output stream, specify internal buffer size
`static InputStream`	`getFileResource(String resourcePath)` Open a resource as a Stream.
`static String`	`readContents(InputStream is)` Read the contents from the inputStream and place into a String, with any error messages put in the return String.
`static String`	`readContents(InputStream is, String charset)` Read the contents from the inputStream and place into a String, with any error messages put in the return String.
`static byte[]`	`readContentsToByteArray(InputStream is)` Read the contents from the inputStream and place into a byte array, with any error messages put in the return String.
`static String`	`readFile(String filename)` Read the contents from the named file and place into a String, assuming UTF-8 encoding.
`static byte[]`	`readFileToByteArray(String filename)` Read the file and place contents into a byte array, with any error messages put in the return String.
`static void`	`writeContents(String contents, OutputStream os)` Wite the contents from the String to a Stream,
`static void`	`writeToFile(byte[] contents, File file)` Write byte[] contents to a file.
`static long`	`writeToFile(InputStream in, String fileOutName)` copy input stream to file.
`static void`	`writeToFile(String contents, File file)` Write String contents to a file, using UTF-8 encoding.
`static void`	`writeToFile(String contents, String fileOutName)` Write contents to a file, using UTF-8 encoding.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - default_file_buffersize
```
public static final int default_file_buffersize
```
    See Also:
    
    Constant Field Values
  - default_socket_buffersize
```
public static final int default_socket_buffersize
```
    See Also:
    
    Constant Field Values
- Constructor Detail
  - IO
```
public IO()
```
- Method Detail
  - getFileResource
```
@Nullable
public static InputStream getFileResource(String resourcePath)
```
    Open a resource as a Stream. First try ClassLoader.getResourceAsStream(). If that fails, try a plain old FileInputStream().
    
    Parameters:
    
    resourcePath - name of file path (use forward slashes!)
    
    Returns:
    
    InputStream or null on failure
  - copy
```
public static long copy(InputStream in,
                        OutputStream out)
                 throws IOException
```
    Copy all bytes from in to out.
    
    Parameters:
    
    in - InputStream
    
    out - OutputStream
    
    Returns:
    
    number of bytes copied
    
    Throws:
    
    IOException
  - copyBuffered
```
public static long copyBuffered(InputStream in,
                                OutputStream out,
                                int buffer_size)
                         throws IOException
```
    Copy all bytes from in to out, setting buffer size.
    
    Parameters:
    
    in - InputStream
    
    out - OutputStream
    
    buffer_size - size of buffer to read through.
    
    Returns:
    
    number of bytes copied
    
    Throws:
    
    IOException
  - copy2null
```
public static long copy2null(InputStream in,
                             int buffersize)
                      throws IOException
```
    copy all bytes from in and throw them away.
    
    Parameters:
    
    in - InputStream
    
    buffersize - size of buffer to use, if -1 uses default value (9200)
    
    Returns:
    
    number of bytes copied
    
    Throws:
    
    IOException
  - copy2null
```
public static long copy2null(FileChannel in,
                             int buffersize)
                      throws IOException
```
    copy all bytes from in and throw them away.
    
    Parameters:
    
    in - FileChannel
    
    buffersize - size of buffer to use, if -1 uses default value (9200)
    
    Returns:
    
    number of bytes copied
    
    Throws:
    
    IOException
  - copyB
```
public static long copyB(InputStream in,
                         OutputStream out,
                         int bufferSize)
                  throws IOException
```
    copy all bytes from in to out, specify buffer size
    
    Parameters:
    
    in - InputStream
    
    out - OutputStream
    
    bufferSize - : internal buffer size.
    
    Returns:
    
    number of bytes copied
    
    Throws:
    
    IOException - on io error
  - copyMaxBytes
```
public static void copyMaxBytes(InputStream in,
                                OutputStream out,
                                int maxBytes)
                         throws IOException
```
    Copy up to maxBytes bytes from in to out.
    
    Parameters:
    
    in - InputStream
    
    out - OutputStream
    
    maxBytes - number of bytes to copy
    
    Throws:
    
    IOException - on io error
  - readContents
```
public static String readContents(InputStream is)
                           throws IOException
```
    Read the contents from the inputStream and place into a String, with any error messages put in the return String. Assume UTF-8 encoding.
    
    Parameters:
    
    is - the inputStream to read from.
    
    Returns:
    
    String holding the contents, or an error message.
    
    Throws:
    
    IOException - on io error
  - readContents
```
public static String readContents(InputStream is,
                                  String charset)
                           throws IOException
```
    Read the contents from the inputStream and place into a String, with any error messages put in the return String.
    
    Parameters:
    
    is - the inputStream to read from.
    
    Returns:
    
    String holding the contents, or an error message.
    
    Throws:
    
    IOException - on io error
  - readContentsToByteArray
```
public static byte[] readContentsToByteArray(InputStream is)
                                      throws IOException
```
    Read the contents from the inputStream and place into a byte array, with any error messages put in the return String.
    
    Parameters:
    
    is - the inputStream to read from.
    
    Returns:
    
    byte[] holding the contents, or an error message.
    
    Throws:
    
    IOException - on io error
  - writeContents
```
public static void writeContents(String contents,
                                 OutputStream os)
                          throws IOException
```
    Wite the contents from the String to a Stream,
    
    Parameters:
    
    contents - String holding the contents.
    
    os - write to this OutputStream
    
    Throws:
    
    IOException - on io error
  - copyFile
```
public static void copyFile(String fileInName,
                            String fileOutName)
                     throws IOException
```
    copy one file to another.
    
    Parameters:
    
    fileInName - copy from this file, which must exist.
    
    fileOutName - copy to this file, which is overrwritten if already exists.
    
    Throws:
    
    IOException - on io error
  - copyFile
```
public static void copyFile(File fileIn,
                            File fileOut)
                     throws IOException
```
    copy one file to another.
    
    Parameters:
    
    fileIn - copy from this file, which must exist.
    
    fileOut - copy to this file, which is overrwritten if already exists.
    
    Throws:
    
    IOException - on io error
  - copy2File
```
public static void copy2File(byte[] src,
                             String fileOut)
                      throws IOException
```
    copy bytes to File
    
    Parameters:
    
    src - source
    
    fileOut - copy to this file
    
    Throws:
    
    IOException - on io error
  - copyFile
```
public static void copyFile(String fileInName,
                            OutputStream out)
                     throws IOException
```
    copy file to output stream
    
    Parameters:
    
    fileInName - open this file
    
    out - copy here
    
    Throws:
    
    IOException - on io error
  - copyFileB
```
public static void copyFileB(File fileIn,
                             OutputStream out,
                             int bufferSize)
                      throws IOException
```
    copy file to output stream, specify internal buffer size
    
    Parameters:
    
    fileIn - copy this file
    
    out - copy to this stream
    
    bufferSize - internal buffer size.
    
    Throws:
    
    IOException - on io error
  - copyRafB
```
public static long copyRafB(RandomAccessFile raf,
                            long offset,
                            long length,
                            OutputStream out,
                            byte[] buffer)
                     throws IOException
```
    Copy part of a RandomAccessFile to output stream, specify internal buffer size
    
    Parameters:
    
    raf - copy this file
    
    offset - start here (byte offset)
    
    length - number of bytes to copy
    
    out - copy to this stream
    
    buffer - use this buffer.
    
    Returns:
    
    number of bytes copied
    
    Throws:
    
    IOException - on io error
  - copyDirTree
```
public static void copyDirTree(String fromDirName,
                               String toDirName)
                        throws IOException
```
    Copy an entire directory tree.
    
    Parameters:
    
    fromDirName - from this directory (do nothing if not exist)
    
    toDirName - to this directory (will create if not exist)
    
    Throws:
    
    IOException - on io error
  - readFileToByteArray
```
public static byte[] readFileToByteArray(String filename)
                                  throws IOException
```
    Read the file and place contents into a byte array, with any error messages put in the return String.
    
    Parameters:
    
    filename - the file to read from.
    
    Returns:
    
    byte[] holding the contents, or an error message.
    
    Throws:
    
    IOException - on io error
  - readFile
```
public static String readFile(String filename)
                       throws IOException
```
    Read the contents from the named file and place into a String, assuming UTF-8 encoding.
    
    Parameters:
    
    filename - the URL to read from.
    
    Returns:
    
    String holding the file contents
    
    Throws:
    
    IOException - on io error
  - writeToFile
```
public static void writeToFile(String contents,
                               File file)
                        throws IOException
```
    Write String contents to a file, using UTF-8 encoding.
    
    Parameters:
    
    contents - String holding the contents
    
    file - write to this file (overwrite if exists)
    
    Throws:
    
    IOException - on io error
  - writeToFile
```
public static void writeToFile(byte[] contents,
                               File file)
                        throws IOException
```
    Write byte[] contents to a file.
    
    Parameters:
    
    contents - String holding the contents
    
    file - write to this file (overwrite if exists)
    
    Throws:
    
    IOException - on io error
  - writeToFile
```
public static void writeToFile(String contents,
                               String fileOutName)
                        throws IOException
```
    Write contents to a file, using UTF-8 encoding.
    
    Parameters:
    
    contents - String holding the contents
    
    fileOutName - write to this file (overwrite if exists)
    
    Throws:
    
    IOException - on io error
  - writeToFile
```
public static long writeToFile(InputStream in,
                               String fileOutName)
                        throws IOException
```
    copy input stream to file. close input stream when done.
    
    Parameters:
    
    in - copy from here
    
    fileOutName - open this file (overwrite) and copy to it.
    
    Returns:
    
    number of bytes copied
    
    Throws:
    
    IOException - on io error
  - appendToFile
```
public static long appendToFile(InputStream in,
                                String fileOutName)
                         throws IOException
```
    Throws:
    
    IOException

Class IO

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

default_file_buffersize

default_socket_buffersize

Constructor Detail

IO

Method Detail

getFileResource

copy

copyBuffered

copy2null

copy2null

copyB

copyMaxBytes

readContents

readContents

readContentsToByteArray

writeContents

copyFile

copyFile

copy2File

copyFile

copyFileB

copyRafB

copyDirTree

readFileToByteArray

readFile

writeToFile

writeToFile

writeToFile

writeToFile

appendToFile