com.linuxense.javadbf

Class DBFUtils

java.lang.Object

com.linuxense.javadbf.DBFUtils

public final class DBFUtils
extends Object

Miscelaneous functions required by the JavaDBF package. This class is for internal usage for JavaDBF and you should not use it.

Method Summary

Modifier and Type	Method and Description
static void	close(Closeable closeable) Closes silently a #Closeable.
static boolean	contains(byte[] array, byte value) Checks that a byte array contains some specific byte
static byte[]	doubleFormating(Number num, Charset charset, int fieldLength, int sizeDecimalPart) Format a double number to write to a dbf file
static boolean	isPureAscii(byte[] data) Test if the data in the array is pure ASCII
static boolean	isPureAscii(String stringToCheck) Checks if a string is pure Ascii
static int	littleEndian(int value) Convert an int value to littleEndian
static short	littleEndian(short value) Convert a short value to littleEndian
static int	readLittleEndianInt(DataInput in) Read a littleEndian integer(32b its) from DataInput
static short	readLittleEndianShort(DataInput in) Read a littleEndian short(16 bits) from DataInput
static Number	readNumericStoredAsText(DataInputStream dataInput, int length) Reads a number from a stream,
static byte[]	removeNullBytes(byte[] array) Remove all nulls (0) found in the data.
static byte[]	removeSpaces(byte[] array) Remove all spaces (32) found in the data.
static void	skip(InputStream inputStream, long bytesToSkip) Safely skip bytesToSkip bytes (in some bufferd scenarios skip doesn't really skip all requested bytes)
static byte[]	textPadding(String text, Charset charset, int length) pad a string and convert it to byte[] to write to a dbf file (by default, add whitespaces to the end of the string)
static byte[]	textPadding(String text, Charset charset, int length, DBFAlignment alignment, byte paddingByte) pad a string and convert it to byte[] to write to a dbf file
static Object	toBoolean(byte t_logical) Convert LOGICAL (L) byte to boolean value
static byte[]	trimRightSpaces(byte[] b_array) Trims right spaces from string

Methods inherited from class java.lang.Object

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

Method Detail

readNumericStoredAsText

public static Number readNumericStoredAsText(DataInputStream dataInput,
                                             int length)
                                      throws IOException

Reads a number from a stream,

Parameters:

dataInput - the stream data

length - the legth of the number

Returns:

The number as a Number (BigDecimal)

Throws:

IOException - if an IO error happens

EOFException - if reached end of file before length bytes

readLittleEndianInt

public static int readLittleEndianInt(DataInput in)
                               throws IOException

Read a littleEndian integer(32b its) from DataInput

Parameters:

in - DataInput to read from

Returns:

int value of next 32 bits as littleEndian

Throws:

IOException - if an IO error happens

EOFException - if reached end of file before 4 bytes are readed

readLittleEndianShort

public static short readLittleEndianShort(DataInput in)
                                   throws IOException

Read a littleEndian short(16 bits) from DataInput

Parameters:

in - DataInput to read from

Returns:

short value of next 16 bits as littleEndian

Throws:

IOException - if an IO error happens

removeSpaces

public static byte[] removeSpaces(byte[] array)

Remove all spaces (32) found in the data.

Parameters:

array - the data

Returns:

the data cleared of whitespaces

removeNullBytes

public static byte[] removeNullBytes(byte[] array)

Remove all nulls (0) found in the data.

Parameters:

array - the data

Returns:

the data cleared of whitespaces

littleEndian

public static short littleEndian(short value)

Convert a short value to littleEndian

Parameters:

value - value to be converted

Returns:

littleEndian short

littleEndian

public static int littleEndian(int value)

Convert an int value to littleEndian

Parameters:

value - value to be converted

Returns:

littleEndian int

textPadding

public static byte[] textPadding(String text,
                                 Charset charset,
                                 int length)

pad a string and convert it to byte[] to write to a dbf file (by default, add whitespaces to the end of the string)

Parameters:

text - The text to be padded

charset - Charset to use to encode the string

length - Size of the padded string

Returns:

bytes to write to the dbf file

textPadding

public static byte[] textPadding(String text,
                                 Charset charset,
                                 int length,
                                 DBFAlignment alignment,
                                 byte paddingByte)

pad a string and convert it to byte[] to write to a dbf file

Parameters:

text - The text to be padded

charset - Charset to use to encode the string

length - Size of the padded string

alignment - alignment to use to padd

paddingByte - the byte used to pad the string

Returns:

bytes to write to the dbf file

doubleFormating

public static byte[] doubleFormating(Number num,
                                     Charset charset,
                                     int fieldLength,
                                     int sizeDecimalPart)

Format a double number to write to a dbf file

Parameters:

num - number to format

charset - charset to use

fieldLength - field length

sizeDecimalPart - decimal part size

Returns:

bytes to write to the dbf file

contains

public static boolean contains(byte[] array,
                               byte value)

Checks that a byte array contains some specific byte

Parameters:

array - The array to search in

value - The byte to search for

Returns:

true if the array contains spcified value

isPureAscii

public static boolean isPureAscii(String stringToCheck)

Checks if a string is pure Ascii

Parameters:

stringToCheck - the string

Returns:

true if is ascci

isPureAscii

public static boolean isPureAscii(byte[] data)

Test if the data in the array is pure ASCII

Parameters:

data - data to check

Returns:

true if there are only ASCII characters

toBoolean

public static Object toBoolean(byte t_logical)

Convert LOGICAL (L) byte to boolean value

Parameters:

t_logical - The byte value as stored in the file

Returns:

The boolean value

trimRightSpaces

public static byte[] trimRightSpaces(byte[] b_array)

Trims right spaces from string

Parameters:

b_array - the string

Returns:

the string without right spaces

close

public static void close(Closeable closeable)

Closes silently a #Closeable. it can be null or throws an exception, will be ignored.

Parameters:

closeable - The item to close

skip

public static void skip(InputStream inputStream,
                        long bytesToSkip)
                 throws IOException

Safely skip bytesToSkip bytes (in some bufferd scenarios skip doesn't really skip all requested bytes)

Parameters:

inputStream - the inputstream

bytesToSkip - number of bytes to skip

Throws:

IOException - if some IO error happens