net.freeutils.scrollphat

Class Utils

java.lang.Object

net.freeutils.scrollphat.Utils

public class Utils
extends Object

Provides General-purpose utility methods.

Method Summary

Modifier and Type	Method and Description
static StringBuilder	append(StringBuilder sb, byte b) Appends the hex string representing the given byte value to a StringBuffer.
static StringBuilder	append(StringBuilder sb, byte[] bytes, int offset, int length) Appends the hex string representing the given byte values to a StringBuffer.
static InputStream	getInputStream(String filename) Returns an input stream for reading the content of a file or resource.
static byte[]	readBytes(InputStream in) Reads the entire contents of the given stream into a byte array.
static String[]	readLines(File file) Reads an entire text file into an array of lines.
static String[]	readLines(InputStream in) Reads an entire text stream into an array of lines.
static long	readVarint(InputStream in) Reads a varint (variable-length integer) from a stream.
static void	writeVarint(OutputStream out, long val) Writes a varint (variable-length integer) to a stream.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getInputStream

public static InputStream getInputStream(String filename)
                                  throws FileNotFoundException

Returns an input stream for reading the content of a file or resource.

First an attempt is made to read from a file with the given name (full path). If such a file does not exist, an attempt is made to load a resource with the same name preceded by a slash using Class.getResourceAsStream(java.lang.String).

Parameters:

filename - the file (or resource) name.

Returns:

the input stream

Throws:

FileNotFoundException - if a file or resource with the given name is not found

readBytes

public static byte[] readBytes(InputStream in)
                        throws IOException

Reads the entire contents of the given stream into a byte array. The stream is closed by this method.

Parameters:

in - an input stream

Returns:

a byte array containing the full contents of the stream

Throws:

IOException - if an error occurs

readLines

public static String[] readLines(File file)
                          throws IOException

Reads an entire text file into an array of lines.

Parameters:

file - the file to read

Returns:

the text lines

Throws:

IOException - if an error occurs

readLines

public static String[] readLines(InputStream in)
                          throws IOException

Reads an entire text stream into an array of lines. The stream is closed by this method.

Parameters:

in - the steam to read from

Returns:

the text lines

Throws:

IOException - if an error occurs

readVarint

public static long readVarint(InputStream in)
                       throws IOException

Reads a varint (variable-length integer) from a stream.

Parameters:

in - the stream to read from

Returns:

the integer value

Throws:

IOException - if an error occurs

writeVarint

public static void writeVarint(OutputStream out,
                               long val)
                        throws IOException

Writes a varint (variable-length integer) to a stream.

Parameters:

out - the stream to write to

val - the value to write

Throws:

IOException - if an error occurs

append

public static StringBuilder append(StringBuilder sb,
                                   byte b)

Appends the hex string representing the given byte value to a StringBuffer.

Parameters:

sb - the StringBuffer to append to

b - the byte value whose hex string representation is to be appended

Returns:

the StringBuffer

append

public static StringBuilder append(StringBuilder sb,
                                   byte[] bytes,
                                   int offset,
                                   int length)

Appends the hex string representing the given byte values to a StringBuffer.

Parameters:

sb - the StringBuffer to append to

bytes - the byte values whose hex string representation is to be appended

offset - the offset within the byte array where the values start

length - the number of values

Returns:

the StringBuffer