freenet.support

Class Fields

java.lang.Object

freenet.support.Fields

public abstract class Fields
extends java.lang.Object

This class contains static methods used for parsing boolean and unsigned long fields in Freenet messages. Also some general utility methods for dealing with string and numeric data.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Fields.ByteArrayComparator Compares byte arrays lexicographically.

Constructor Summary

Constructors

Constructor and Description
Fields()

Method Summary

Modifier and Type	Method and Description
static java.lang.String	boolToString(boolean b) Converts a boolean to a String of either "true" or "false".
static boolean	byteArrayEqual(byte[] a, byte[] b)
static boolean	byteArrayEqual(byte[] a, byte[] b, int aoff, int boff, int len)
static double[]	bytesToDoubles(byte[] data)
static double[]	bytesToDoubles(byte[] data, int offset, int length)
static int	bytesToInt(byte[] buf)
static int	bytesToInt(byte[] buf, int offset) Convert an array of bytes to a single int.
static int[]	bytesToInts(byte[] buf)
static int[]	bytesToInts(byte[] buf, int offset, int length)
static long	bytesToLong(byte[] buf) Convert an array of bytes to a single long.
static long	bytesToLong(byte[] buf, int offset) Convert an array of bytes to a single long.
static long[]	bytesToLongs(byte[] buf) Convert an array of bytes to an array of longs.
static long[]	bytesToLongs(byte[] buf, int offset, int length) Convert an array of bytes to an array of longs.
static short	bytesToShort(byte[] buf, int offset) Convert an array of bytes to a single int.
static java.lang.String	commaList(java.lang.Object[] addr)
static java.lang.String	commaList(java.lang.Object[] addr, char comma)
static java.lang.String[]	commaList(java.lang.String ls)
static java.lang.String	commaList(java.lang.String[] ls)
static int	compare(java.util.Date a, java.util.Date b)
static int	compare(double x, double y) Avoid issues with NaN's.
static int	compare(float x, float y) Avoid issues with NaN's.
static int	compare(int x, int y) Avoid issues with overflow, 2's complement.
static int	compare(long x, long y) Avoid issues with overflow, 2's complement.
static int	compareBytes(byte[] b1, byte[] b2)
static int	compareBytes(byte[] a, byte[] b, int aoff, int boff, int len)
static int	compareObjectID(java.lang.Object o1, java.lang.Object o2)
static int	compareVersion(java.lang.String x, java.lang.String y) Compare two versions.
static byte[]	copyToArray(java.nio.ByteBuffer buf) Copy all of the remaining bytes in the buffer to a byte array.
static long	dateTime(java.lang.String date) Parses a time and date value, using a very strict format.
static byte[]	doublesToBytes(double[] doubles)
static int	hashCode(byte[] b)
static int	hashCode(byte[] b, int ptr, int length) A generic hashcode suited for byte arrays that are more or less random.
static int	hexToInt(java.lang.String hex) Converts a hex string into an int.
static long	hexToLong(java.lang.String hex) Converts a hex string into a long.
static byte[]	intsToBytes(int[] ints)
static byte[]	intsToBytes(int[] ints, int offset, int length)
static byte[]	intToBytes(int x)
static java.lang.String	intToString(int val, boolean isSize)
static java.lang.String	intToString(int val, Dimension dimension)
static long	longHashCode(byte[] b) Long version of above Not believed to be secure in any sense of the word :)
static long	longHashCode(byte[] b, int offset, int length) Long version of above Not believed to be secure in any sense of the word :)
static byte[]	longsToBytes(long[] longs) Convert an array of longs to an array of bytes, using a consistent endianness.
static byte[]	longToBytes(long x)
static java.lang.String	longToString(long val, boolean isSize)
static java.lang.String	numberList(long[] ls)
static long[]	numberList(java.lang.String ls)
static int	parseInt(java.lang.String s) Parse a human-readable string possibly including SI and ICE units into an integer.
static int	parseInt(java.lang.String s, Dimension dimension)
static int	parseInt(java.lang.String s, int defaultValue)
static long	parseLong(java.lang.String s) Parse a human-readable string possibly including SI and ICE units into a long.
static long	parseLong(java.lang.String s, long defaultValue)
static short	parseShort(java.lang.String s) Parse a human-readable string possibly including SI and ICE units into a short.
static long	parseShort(java.lang.String s, short defaultValue)
static java.lang.String	secToDateTime(long time)
static byte[]	shortToBytes(short x)
static java.lang.String	shortToString(short val, boolean isSize)
static boolean	stringToBool(java.lang.String s) Find the boolean value of the field.
static boolean	stringToBool(java.lang.String s, boolean def) Finds the boolean value of the field, by doing a caseless match with the strings "true" and "false".
static java.lang.String	textList(java.lang.String[] ls, char ch)
static java.lang.String	trimLines(java.lang.String str) Remove empty lines and trim head/trailing space
static java.lang.String	trimPerSecond(java.lang.String limit)

Methods inherited from class java.lang.Object

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

Constructor Detail

Fields

public Fields()

Method Detail

hexToLong

public static long hexToLong(java.lang.String hex)
                      throws java.lang.NumberFormatException

Converts a hex string into a long. Long.parseLong(hex, 16) assumes the input is nonnegative unless there is a preceding minus sign. This method reads the input as twos complement instead, so if the input is 8 bytes long, it will correctly restore a negative long produced by Long.toHexString() but not necessarily one produced by Long.toString(x,16) since that method will produce a string like '-FF' for negative longs values.

Parameters:

hex - A string in capital or lower case hex, of no more then 16 characters.

Throws:

java.lang.NumberFormatException - if the string is more than 16 characters long, or if any character is not in the set [0-9a-fA-f]

hexToInt

public static int hexToInt(java.lang.String hex)
                    throws java.lang.NumberFormatException

Converts a hex string into an int. Integer.parseInt(hex, 16) assumes the input is nonnegative unless there is a preceding minus sign. This method reads the input as twos complement instead, so if the input is 8 bytes long, it will correctly restore a negative int produced by Integer.toHexString() but not necessarily one produced by Integer.toString(x,16) since that method will produce a string like '-FF' for negative integer values.

Parameters:

hex - A string in capital or lower case hex, of no more then 16 characters.

Throws:

java.lang.NumberFormatException - if the string is more than 16 characters long, or if any character is not in the set [0-9a-fA-f]

stringToBool

public static boolean stringToBool(java.lang.String s,
                                   boolean def)

Finds the boolean value of the field, by doing a caseless match with the strings "true" and "false".

Parameters:

s - The string

def - The default value if the string can't be parsed. If the default is true, it checks that the string is not "false"; if it is false, it checks whether the string is "true".

Returns:

the boolean field value or the default value if the field value couldn't be parsed.

stringToBool

public static boolean stringToBool(java.lang.String s)
                            throws java.lang.NumberFormatException

Find the boolean value of the field. Throw if the string is neither "yes"/"true" nor "no"/"false".

Parameters:

s -

Returns:

Throws:

java.lang.NumberFormatException

boolToString

public static java.lang.String boolToString(boolean b)

Converts a boolean to a String of either "true" or "false".

Parameters:

b - the boolean value to convert.

Returns:

A "true" or "false" String.

commaList

public static java.lang.String[] commaList(java.lang.String ls)

commaList

public static java.lang.String commaList(java.lang.String[] ls)

textList

public static java.lang.String textList(java.lang.String[] ls,
                                        char ch)

numberList

public static long[] numberList(java.lang.String ls)
                         throws java.lang.NumberFormatException

Throws:

java.lang.NumberFormatException

numberList

public static java.lang.String numberList(long[] ls)

dateTime

public static long dateTime(java.lang.String date)
                     throws java.lang.NumberFormatException

Parses a time and date value, using a very strict format. The value has to be of the form YYYYMMDD-HH:MM:SS (where seconds may include a decimal) or YYYYMMDD (in which case 00:00:00 is assumed for time). Another accepted format is +/-{integer}{day|month|year|minute|second}

Returns:

millis of the epoch of at the time described.

Throws:

java.lang.NumberFormatException

secToDateTime

public static java.lang.String secToDateTime(long time)

compareBytes

public static int compareBytes(byte[] b1,
                               byte[] b2)

compareBytes

public static int compareBytes(byte[] a,
                               byte[] b,
                               int aoff,
                               int boff,
                               int len)

byteArrayEqual

public static boolean byteArrayEqual(byte[] a,
                                     byte[] b)

byteArrayEqual

public static boolean byteArrayEqual(byte[] a,
                                     byte[] b,
                                     int aoff,
                                     int boff,
                                     int len)

hashCode

public static int hashCode(byte[] b)

hashCode

public static int hashCode(byte[] b,
                           int ptr,
                           int length)

A generic hashcode suited for byte arrays that are more or less random.

longHashCode

public static long longHashCode(byte[] b)

Long version of above Not believed to be secure in any sense of the word :)

longHashCode

public static long longHashCode(byte[] b,
                                int offset,
                                int length)

Long version of above Not believed to be secure in any sense of the word :)

commaList

public static java.lang.String commaList(java.lang.Object[] addr)

commaList

public static java.lang.String commaList(java.lang.Object[] addr,
                                         char comma)

Parameters:

addr -

Returns:

longsToBytes

public static byte[] longsToBytes(long[] longs)

Convert an array of longs to an array of bytes, using a consistent endianness.

bytesToLongs

public static long[] bytesToLongs(byte[] buf)

Convert an array of bytes to an array of longs.

bytesToLongs

public static long[] bytesToLongs(byte[] buf,
                                  int offset,
                                  int length)

Convert an array of bytes to an array of longs.

Parameters:

buf -

length -

offset -

Returns:

bytesToLong

public static long bytesToLong(byte[] buf)

Convert an array of bytes to a single long.

bytesToLong

public static long bytesToLong(byte[] buf,
                               int offset)

Convert an array of bytes to a single long.

bytesToInt

public static int bytesToInt(byte[] buf)

bytesToInt

public static int bytesToInt(byte[] buf,
                             int offset)

Convert an array of bytes to a single int.

bytesToShort

public static short bytesToShort(byte[] buf,
                                 int offset)

Convert an array of bytes to a single int.

bytesToInts

public static int[] bytesToInts(byte[] buf,
                                int offset,
                                int length)

bytesToInts

public static int[] bytesToInts(byte[] buf)

longToBytes

public static byte[] longToBytes(long x)

intsToBytes

public static byte[] intsToBytes(int[] ints)

intsToBytes

public static byte[] intsToBytes(int[] ints,
                                 int offset,
                                 int length)

intToBytes

public static byte[] intToBytes(int x)

shortToBytes

public static byte[] shortToBytes(short x)

parseLong

public static long parseLong(java.lang.String s,
                             long defaultValue)

parseInt

public static int parseInt(java.lang.String s,
                           int defaultValue)

parseShort

public static long parseShort(java.lang.String s,
                              short defaultValue)

parseShort

public static short parseShort(java.lang.String s)
                        throws java.lang.NumberFormatException

Parse a human-readable string possibly including SI and ICE units into a short.

Throws:

java.lang.NumberFormatException - if the string is not parseable

trimPerSecond

public static java.lang.String trimPerSecond(java.lang.String limit)

parseInt

public static int parseInt(java.lang.String s,
                           Dimension dimension)
                    throws java.lang.NumberFormatException

Throws:

java.lang.NumberFormatException

parseInt

public static int parseInt(java.lang.String s)
                    throws java.lang.NumberFormatException

Parse a human-readable string possibly including SI and ICE units into an integer.

Throws:

java.lang.NumberFormatException - if the string is not parseable

parseLong

public static long parseLong(java.lang.String s)
                      throws java.lang.NumberFormatException

Parse a human-readable string possibly including SI and ICE units into a long.

Throws:

java.lang.NumberFormatException - if the string is not parseable

longToString

public static java.lang.String longToString(long val,
                                            boolean isSize)

intToString

public static java.lang.String intToString(int val,
                                           Dimension dimension)

intToString

public static java.lang.String intToString(int val,
                                           boolean isSize)

shortToString

public static java.lang.String shortToString(short val,
                                             boolean isSize)

bytesToDoubles

public static double[] bytesToDoubles(byte[] data,
                                      int offset,
                                      int length)

doublesToBytes

public static byte[] doublesToBytes(double[] doubles)

bytesToDoubles

public static double[] bytesToDoubles(byte[] data)

trimLines

public static java.lang.String trimLines(java.lang.String str)

Remove empty lines and trim head/trailing space

Parameters:

str - string to be trimmed

Returns:

result string

compareVersion

public static int compareVersion(java.lang.String x,
                                 java.lang.String y)

Compare two versions.

compareObjectID

public static int compareObjectID(java.lang.Object o1,
                                  java.lang.Object o2)

compare

public static final int compare(int x,
                                int y)

Avoid issues with overflow, 2's complement. E.g. 0-Integer.MIN_VALUE = Integer.MIN_VALUE-0.

compare

public static final int compare(long x,
                                long y)

Avoid issues with overflow, 2's complement.

compare

public static final int compare(double x,
                                double y)

Avoid issues with NaN's.

compare

public static final int compare(float x,
                                float y)

Avoid issues with NaN's.

compare

public static final int compare(java.util.Date a,
                                java.util.Date b)

copyToArray

public static byte[] copyToArray(java.nio.ByteBuffer buf)

Copy all of the remaining bytes in the buffer to a byte array.

Parameters:

buf - The input buffer. Position will be at the limit when returning.