iaik.pkcs.pkcs11

Class Util

java.lang.Object

iaik.pkcs.pkcs11.Util

public class Util
extends Object

A class consisting of static methods only which provide certain static pieces of code that are used frequently in this project.

Version:

1.0

Author:

Karl Scheibelhofer, Lijun Liao

Constructor Summary

Constructors

Constructor and Description
Util()

Method Summary

Modifier and Type	Method and Description
static String	concat(String s1, String... strs)
static String	concatObjects(Object o1, Object... objs)
static String	concatObjectsCap(int cap, Object o1, Object... objs)
static sun.security.pkcs11.wrapper.CK_ATTRIBUTE[]	convertAttributesVectorToArray(Vector<sun.security.pkcs11.wrapper.CK_ATTRIBUTE> attributes) Converts the given vector into an array of CK_ATTRIBUTE elements.
static sun.security.pkcs11.wrapper.CK_DATE	convertToCkDate(Date date) Convert the given Date object to a CK_DATE object.
static Date	convertToDate(sun.security.pkcs11.wrapper.CK_DATE ckDate) Convert the given CK_DATE object to a Date object.
static Constructor<?>	getConstructor(Class<?> clazz, Class<?>... parameterTypes)
static Constructor<?>	getConstructor(String className, Class<?>... parameterTypes)
static Field	getField(Class<?> clazz, String fieldName)
static Method	getMethod(Class<?> clazz, String name, Class<?>... parameterTypes)
static int	hashCode(byte[] array) Calculate a hash code for the given byte array.
static int	hashCode(char[] array) Calculate a hash code for the given char array.
static int	hashCode(long[] array) Calculate a hash code for the given long array.
static boolean	objEquals(Object obj1, Object obj2)
static Date	parseTime(char[] timeChars) Parse a time character array as defined in PKCS#11 and return is as a Date object.
static <T> T	requireNonNull(String paramName, T param)
static char[]	toCharArray(int number, int exactArrayLength) Converts the given number into a char-array.
static String	toHex(byte[] value) Converts a byte array to a hexadecimal String.
static char[]	toPaddedCharArray(String string, int exactArrayLength, char paddingChar) Converts the given string to a char-array of exactly the given length.
static byte[]	unsignedBigIntergerToByteArray(BigInteger bigInteger) Convert a BigInteger to a byte-array, but treat the byte-array given from the BigInteger as unsigned and removing any leading zero bytes; e.g.

Methods inherited from class java.lang.Object

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

Constructor Detail

Util

public Util()

Method Detail

requireNonNull

public static <T> T requireNonNull(String paramName,
                                   T param)

parseTime

public static Date parseTime(char[] timeChars)

Parse a time character array as defined in PKCS#11 and return is as a Date object.

Parameters:

timeChars - A time encoded as character array as specified in PKCS#11.

Returns:

A Date object set to the time indicated in the given char-array. null, if the given char array is null or the format is wrong.

convertToDate

public static Date convertToDate(sun.security.pkcs11.wrapper.CK_DATE ckDate)

Convert the given CK_DATE object to a Date object.

Parameters:

ckDate - The object providing the date information.

Returns:

The new Date object or null, if the given ckDate is null.

convertToCkDate

public static sun.security.pkcs11.wrapper.CK_DATE convertToCkDate(Date date)

Convert the given Date object to a CK_DATE object.

Parameters:

date - The object providing the date information.

Returns:

The new CK_DATE object or null, if the given date is null.

toCharArray

public static char[] toCharArray(int number,
                                 int exactArrayLength)

Converts the given number into a char-array. If the length of the array is shorter than the required exact length, the array is padded with leading '0' chars. If the array is longer than the wanted length the most significant digits are cut off until the array has the exact length.

Parameters:

number - The number to convert to a char array.

exactArrayLength - The exact length of the returned array.

Returns:

The number as char array, one char for each decimal digit.

toPaddedCharArray

public static char[] toPaddedCharArray(String string,
                                       int exactArrayLength,
                                       char paddingChar)

Converts the given string to a char-array of exactly the given length. If the given string is short than the wanted length, then the array is padded with trailing padding chars. If the string is longer, the last character are cut off that the string has the wanted size.

Parameters:

string - The string to convert.

exactArrayLength - The length of the returned char-array.

paddingChar - The character to use for padding, if necessary.

Returns:

The string as char array, padded or cut off, if necessary. The array will have length exactArrayLength. null, if the given string is null.

unsignedBigIntergerToByteArray

public static byte[] unsignedBigIntergerToByteArray(BigInteger bigInteger)

Convert a BigInteger to a byte-array, but treat the byte-array given from the BigInteger as unsigned and removing any leading zero bytes; e.g. a 1024 bit integer with its highest bit set will result in an 128 byte array.

Parameters:

bigInteger - The BigInteger to convert.

Returns:

The byte-array representation of the BigInterger without signum-bit. null, if the BigInteger is null.

convertAttributesVectorToArray

public static sun.security.pkcs11.wrapper.CK_ATTRIBUTE[] convertAttributesVectorToArray(Vector<sun.security.pkcs11.wrapper.CK_ATTRIBUTE> attributes)

Converts the given vector into an array of CK_ATTRIBUTE elements. Elements not of type CK_ATTRIBUTE will not be present in the resulting array and be set to null.

Parameters:

attributes - The vector which contains the attributes.

Returns:

The array of the attributes.

objEquals

public static boolean objEquals(Object obj1,
                                Object obj2)

toHex

public static String toHex(byte[] value)

Converts a byte array to a hexadecimal String. Each byte is presented by its two digit hex-code; 0x0A to "0a", 0x00 to "00". No leading "0x" is included in the result.

Parameters:

value - The byte array to be converted

Returns:

the hexadecimal string representation of the byte array

concat

public static String concat(String s1,
                            String... strs)

concatObjects

public static String concatObjects(Object o1,
                                   Object... objs)

concatObjectsCap

public static String concatObjectsCap(int cap,
                                      Object o1,
                                      Object... objs)

hashCode

public static int hashCode(byte[] array)

Calculate a hash code for the given byte array.

Parameters:

array - The byte array.

Returns:

A hash code for the given array.

hashCode

public static int hashCode(char[] array)

Calculate a hash code for the given char array.

Parameters:

array - The char array.

Returns:

A hash code for the given array.

hashCode

public static int hashCode(long[] array)

Calculate a hash code for the given long array.

Parameters:

array - The long array.

Returns:

A hash code for the given array.

getField

public static Field getField(Class<?> clazz,
                             String fieldName)

getMethod

public static Method getMethod(Class<?> clazz,
                               String name,
                               Class<?>... parameterTypes)

getConstructor

public static Constructor<?> getConstructor(String className,
                                            Class<?>... parameterTypes)

getConstructor

public static Constructor<?> getConstructor(Class<?> clazz,
                                            Class<?>... parameterTypes)