iaik.utils

Class Util

java.lang.Object

iaik.utils.Util

public class Util
extends java.lang.Object

This class provides some general useful methods.

Field Summary

Fields

Modifier and Type	Field and Description
static int	INI_CERT_SIZE Limit used for the INI file certificate size
static java.lang.String	ISO8859_1 The ISO8859-1 encoding string used by the platform.

Method Summary

Methods

Modifier and Type	Method and Description
static X509Certificate[]	arrangeCertificateChain(X509Certificate[] certArray, boolean topdown) Tries to construct a certificate chain from an array of certificates.
static byte[]	Base64Decode(byte[] in) Base64 decodes the provided input data (byte representation of a Base64 encoded value).
static byte[]	Base64Decode(byte[] in, boolean setIgnoreInvalidCharacters) Base64 decodes the provided input data (byte representation of a Base64 encoded value).
static byte[]	Base64DecodeFromString(java.lang.String in) Base64 decodes the provided input data (string representation of a Base64 encoded value).
static byte[]	Base64DecodeFromString(java.lang.String in, boolean ignoreInvalidCharacters) Base64 decodes the provided input data (string representation of a Base64 encoded value).
static byte[]	Base64Encode(byte[] in) Base64 encodes (with line breaks) the provided input data and returns the byte representation of the Base64 encoded value.
static byte[]	Base64Encode(byte[] in, boolean includeLineBreaks) Base64 encodes (with or without line breaks) the provided input data and returns the byte representation of the Base64 encoded value.
static java.lang.String	Base64EncodeToString(byte[] in) Base64 encodes (with line breaks) the provided input data and returns the string representation of the Base64 encoded value.
static java.lang.String	Base64EncodeToString(byte[] in, boolean includeLineBreaks) Base64 encodes (with or without line breaks) the provided input data and returns the string representation of the Base64 encoded value.
static int[]	bubbleSort(int[] a) Sort the given array of ints in ascending order and return it.
static long[]	bubbleSort(long[] a) Sort the given array of longs in ascending order and return it.
static int	calculateHashCode(byte[] value) Creates an integer suitable for hash table indexing.
static void	compareTables(java.lang.String text, int[] T0, int[] T1)
static X509Certificate[]	convertCertificateChain(java.security.cert.Certificate[] certificateChain) This method converts an array of Certificates into an array of X509Certificates.
static byte[]	convertEndian32(byte[] in) Convert between little and big endian 32 bit formats.
static byte[]	decodeByteArray(java.lang.String st) Decode base64 encoded data from the given string and return it as a byte array.
static int[]	decodeIntArray(java.lang.String st) Decode base64 encoded data from the given string and return it as an int array.
static java.security.Key	decodeKey(int keyType, java.lang.String keyAlgorithm, byte[] encodedKey) Construct a key object from and encoded key.
static boolean	doCheckWritePermission() This checks the value of the com.entrust.toolkit.NoWritePermissionCheck system property.
static java.lang.String	encodeByteArray(byte[] b) Encodes a byte array in base64 and return it as a string.
static java.lang.String	encodeIntArray(int[] a) Encode an int array in base64 and return it as a string.
static void	fillArray(byte[] array, java.io.InputStream is) This method tries to fill the given array with data read from the InputStream.
static java.lang.String	fromBooleanArray(boolean[] bits) Converts the given array of boolean values into a string of zeros and ones.
static java.lang.String	getASCIIEncoding() Returns the name of the character encoding that should be used for ASCII character/byte conversions.
static java.lang.String	getPath(java.lang.String pathLocation) Get a valid path for writing to a Java properties file.
static RSAPrivateKey	getRSAPrivateKey(java.security.Key key) Convert a key to an IAIK RSAPrivateKey.
static RSAPublicKey	getRSAPublicKey(java.security.Key key) Convert a key to an IAIK RSAPublicKey.
static java.util.Vector	getVector(java.lang.Object[] array) This method converts an array to a Vector.
static boolean	loadClass(java.lang.String name, boolean createInstance) Tries to dynamically load a class.
static void	printTable(java.lang.String text, byte[] table)
static void	printTable(java.lang.String text, int[] table)
static X509Certificate[]	readCertificateChain(java.io.InputStream is) Tries to read a certificate chain from the given input stream.
static X509CRL[]	readCRLChain(java.io.InputStream is) Tries to read a crl list from the given input stream.
static byte[]	readFile(java.lang.String fileName) Reads the content of a file into a byte array.
static X509Certificate[]	readPEMCerts(java.io.InputStream location, int MaxSize) Reads X509Certificates in a PEM format into an array of X509Certificates.
static byte[]	readStream(java.io.InputStream in) Read the contents of the stream into a byte array.
static byte[]	readStream(java.io.InputStream in, int maxsize) Read the contents of the stream into a byte array.
static byte[]	resizeArray(byte[] array, int len) Resizes a byte array to the specified length.
static java.lang.Object[]	resizeArray(java.lang.Object[] array, int len) Resizes a byte array to the specified length.
static void	saveToFile(byte[] array, java.lang.String fileName) Saves the content of the given byte array to a file.
static void	setEncoding(java.lang.String encoding) Deprecated. since 8.0; by default 'US-ASCII' is used which (according to Sun) must be supported by all implementations of the Java 2 platform, Standard Edition, v. 1.3 or higher
static java.lang.Object[]	toArray(java.util.Vector aVector) This method converts a Vector to an array.
static java.lang.Object[]	toArray(java.util.Vector aVector, java.lang.Class cls) This method converts a Vector to an array.
static byte[]	toASCIIBytes(java.lang.String s) Encodes a String to a sequence of bytes using the configured ASCII character encoding.
static java.lang.String	toASCIIString(byte[] bytes) Decodes a String from a sequence of bytes using the configured ASCII character encoding.
static java.lang.String	toASCIIString(byte[] bytes, int offset, int length) Decodes a String from a sequence of bytes using the configured ASCII character encoding.
static boolean[]	toBooleanArray(java.lang.String bits) Transforms the characters of the given bit string into boolean values and returns the given string as an array of boolean values.
static int	toByte(char c, int radix) Convert the given char to an int.
static byte[]	toByteArray(java.lang.String s) Convert the given string with hex values to a byte array.
static java.lang.String	toPemString(java.security.cert.Certificate cert) Convert the given Certificate to a PEM style base64 encoded string.
static java.lang.String	toPemString(java.security.PrivateKey privKey) Convert the given private key to a PEM style base64 encoded string.
static java.lang.String	toString(byte b) Converts a byte into a hexadecimal string.
static java.lang.String	toString(byte[] byteArray) Converts a byte array into a hexadecimal string of the format: 01:23:34:56...
static java.lang.String	toString(byte[] byteArray, int off, int len) Converts the specified subsequence of the given byte array into a hexadecimal string of the format: 01:23:34:56...
static java.lang.String	toString(byte[] byteArray, int off, int len, java.lang.String delimiter) Converts the specified subsequence of the given byte array into a hexadecimal string of the format: 01:23:34:56...
static java.lang.String	toString(byte[] byteArray, java.lang.String delimiter) Converts a byte array into a hexadecimal string of the format: 01:23:34:56...
static java.lang.String	toString(int i) Converts an int into a hexadecimal string of the format: 01:23:34:56...
static java.lang.String	toString(long l) Converts an int into a hexadecimal string of the format: 01:23:34:56...
static byte[]	toUTF8Bytes(java.lang.String s) Encodes a String to a sequence of bytes using the 'UTF-8' character encoding.
static java.lang.String	toUTF8String(byte[] ba) Decodes a String from a sequence of bytes using the 'UTF-8' character encoding.
static void	waitKey() Wait for the user to press the return key on System.in.
static void	writePEMCerts(java.io.OutputStream os, X509Certificate[] x509certs) Write the specifed array of certificates to the specified file location.

Methods inherited from class java.lang.Object

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

Field Detail

INI_CERT_SIZE

public static final int INI_CERT_SIZE

Limit used for the INI file certificate size

See Also:

Constant Field Values

ISO8859_1

public static java.lang.String ISO8859_1

The ISO8859-1 encoding string used by the platform.

Method Detail

loadClass

public static boolean loadClass(java.lang.String name,
                boolean createInstance)

Tries to dynamically load a class.

The class to be loaded has to be specified by its name (including the whole package hierachy), e.g.:

 Util.loadClass("iaik.test.testdemo.Test1", true);
 

For actually creating a new instance of the requested class - some implementations of the Java-VM only execute the static part of a class if a new instance is created - set the createInstance parameter to true.

Parameters:

name - the name of the class to load (e.g. "iaik.Test")

createInstance - if set to true a new instance of the specified class is created;

Returns:

true, if the class has been loaded successfully and a new instance has been created (if desired); false otherwise

writePEMCerts

public static void writePEMCerts(java.io.OutputStream os,
                 X509Certificate[] x509certs)
                          throws java.io.IOException,
                                 java.security.cert.CertificateEncodingException

Write the specifed array of certificates to the specified file location. The X509Certificates will be base64 encoded and surrounded by -----BEGIN CERTIFICATE----- and -----END CERTIFICATE----- markers. The following is an example of the output.

 -----BEGIN CERTIFICATE-----
 MIIDRzCCArCgAwIBAgIEO5kvRTANBgkqhkiG9w0BAQUFADBQMQswCQYDVQQGEwJV
 UzEQMA4GA1UEChMHRW50cnVzdDEvMC0GA1UECxMmRW50cnVzdCBQS0kgRGVtb25z
 ...
 w4KN8Iz+E5BTly+vJkP7WCOcchXg8aDxI8kCySlkxqJ+hcX7/hdvOzEAPkkJRboz
 VonUPwEk+elHGXQDcr5nXllPwl9UzFkgrxBZ=
 -----END CERTIFICATE-----
 
 -----BEGIN CERTIFICATE-----
 MYICLzCCAiswggGUoAMCAQICBgDu11ycbTANBgkqhkiG9w0BAQUFADA0MRAwDgYD
 VQQKEwdlbnRydXN0MQwwCgYDVQQLEwNlbmcxEjAQBgNVBAMTCWdhTG9jYWxDQTAe
 ...
 yZGEu7pnpwyAmN4IAiz6wPROqPHOgJ65FjTE+OCvtm9qVodrp3CpibG10Q45sVH7
 H5/2RuVOFh8EVZJiF0ACttn95xdW6LRTNiSKzqlyK4+4vNI=
 -----END CERTIFICATE-----

Parameters:

fileName - The filename and location of the file that will be written

x509cert - An array of X509Certificate objects

Throws:

java.io.IOException

java.security.cert.CertificateEncodingException

readPEMCerts

public static X509Certificate[] readPEMCerts(java.io.InputStream location,
                             int MaxSize)
                                      throws java.io.IOException,
                                             java.security.cert.CertificateException,
                                             Base64Exception

Reads X509Certificates in a PEM format into an array of X509Certificates. The following is the expected format of the file.

 -----BEGIN CERTIFICATE-----
 MIIDRzCCArCgAwIBAgIEO5kvRTANBgkqhkiG9w0BAQUFADBQMQswCQYDVQQGEwJV
 UzEQMA4GA1UEChMHRW50cnVzdDEvMC0GA1UECxMmRW50cnVzdCBQS0kgRGVtb25z
 ...
 w4KN8Iz+E5BTly+vJkP7WCOcchXg8aDxI8kCySlkxqJ+hcX7/hdvOzEAPkkJRboz
 VonUPwEk+elHGXQDcr5nXllPwl9UzFkgrxBZ
 -----END CERTIFICATE-----
 
 -----BEGIN CERTIFICATE-----
 MYICLzCCAiswggGUoAMCAQICBgDu11ycbTANBgkqhkiG9w0BAQUFADA0MRAwDgYD
 VQQKEwdlbnRydXN0MQwwCgYDVQQLEwNlbmcxEjAQBgNVBAMTCWdhTG9jYWxDQTAe
 ...
 yZGEu7pnpwyAmN4IAiz6wPROqPHOgJ65FjTE+OCvtm9qVodrp3CpibG10Q45sVH7
 H5/2RuVOFh8EVZJiF0ACttn95xdW6LRTNiSKzqlyK4+4vNI=
 -----END CERTIFICATE-----

Parameters:

location - The inputstream that contains the PEM encoded certificates

MaxSize - The approximate number of bytes which should be read from the file. A very large file could cause an OutOfMemoryException.

Returns:

an array of X509Certificate

Throws:

java.security.cert.CertificateException - if the was a problem reading the certificate

Base64Exception - if there was a problem decoding the Base64 encoded certificate data

java.io.IOException - if an I/O error occured when reading the certificates from the file

getPath

public static java.lang.String getPath(java.lang.String pathLocation)

Get a valid path for writing to a Java properties file. The path must be in the form

dir/sub1/sub2/sub3/

The String returned should be separated by the '/' character as this can be used across all platforms. The end of the directory should end with a '/'.

Parameters:

pathLocation - The path to be converted to proper format

Returns:

readFile

public static byte[] readFile(java.lang.String fileName)
                       throws java.io.IOException

Reads the content of a file into a byte array.

Parameters:

fileName - the name of the file to read

Returns:

the content of the file in a byte array

Throws:

java.io.IOException - if an IO error occurs

readStream

public static byte[] readStream(java.io.InputStream in)
                         throws java.io.IOException

Read the contents of the stream into a byte array. The stream is read until it returns EOF.

Throws:

java.io.IOException

readStream

public static byte[] readStream(java.io.InputStream in,
                int maxsize)
                         throws java.io.IOException

Read the contents of the stream into a byte array. The stream is read until it returns EOF or the maxsize is reached.

Throws:

java.io.IOException

saveToFile

public static void saveToFile(byte[] array,
              java.lang.String fileName)
                       throws java.io.IOException

Saves the content of the given byte array to a file.

Parameters:

array - the byte array supplying the data to be written to the file

fileName - the name of the file to which the data shall be written

Throws:

java.io.IOException - if an I/O error occurs

toString

public static java.lang.String toString(byte b)

Converts a byte into a hexadecimal string.

For instance:

 byte b = ...;
 System.out.println(Util.toString(b));
 

Parameters:

b - the byte to convert

Returns:

the byte as hex value

toString

public static java.lang.String toString(byte[] byteArray,
                        int off,
                        int len)

Converts the specified subsequence of the given byte array into a hexadecimal string of the format: 01:23:34:56... .

Starting at off, len bytes will be converted and returned as hexadecimal string, e.g.:

 byte[] arr = ...;
 System.out.println(Util.toString(arr, 0, 3));
 

Parameters:

byteArray - the byte array containing the data

off - the offset indicating the start position within the given byte array; the following len bytes will be converted into a hexadecimal string

len - how many bytes shall be written

Returns:

the string representation

toString

public static java.lang.String toString(byte[] byteArray,
                        int off,
                        int len,
                        java.lang.String delimiter)

Converts the specified subsequence of the given byte array into a hexadecimal string of the format: 01:23:34:56... .

Starting at off, len bytes will be converted and returned as hexadecimal string, e.g.:

 byte[] arr = ...;
 System.out.println(Util.toString(arr, 0, 3));
 

Parameters:

byteArray - the byte array containing the data

off - the offset indicating the start position within the given byte array; the following len bytes will be converted into a hexadecimal string

len - how many bytes shall be written

delimiter - the delimiter to be used for separating the hex values, e.g. ":" (specify "" for not using a delimiter)

Returns:

the string representation

toString

public static java.lang.String toString(byte[] byteArray)

Converts a byte array into a hexadecimal string of the format: 01:23:34:56... .

For instance:

 byte[] arr = ...;
 System.out.println(Util.toString(arr));
 

Parameters:

byteArray - the byte array containing the data

Returns:

the string representation

toString

public static java.lang.String toString(byte[] byteArray,
                        java.lang.String delimiter)

Converts a byte array into a hexadecimal string of the format: 01:23:34:56... .

For instance:

 byte[] arr = ...;
 System.out.println(Util.toString(arr));
 

Parameters:

byteArray - the byte array containing the data

delimiter - the delimiter to be used for separating the hex values, e.g. ":" (specify "" for not using a delimiter)

Returns:

the string representation

toString

public static java.lang.String toString(int i)

Converts an int into a hexadecimal string of the format: 01:23:34:56... .

For instance:

 int i = ...;
 System.out.println(Util.toString(i));
 

Parameters:

i - the int to convert

Returns:

the int as hexadecimal string representation

toString

public static java.lang.String toString(long l)

Converts an int into a hexadecimal string of the format: 01:23:34:56... . Uses big endian byte order.

Base64Encode

public static byte[] Base64Encode(byte[] in)

Base64 encodes (with line breaks) the provided input data and returns the byte representation of the Base64 encoded value.

A line break (CRLF) is inserted after every 64th character; this style of Base64 encoding is used in Privacy Enhanced Mail (PEM).

Parameters:

in - input data (data to be encoded)

Returns:

the byte representation of the Base64 encoded value

See Also:

Base64 - RFC 4648, PEM - RFC 1421

Base64Encode

public static byte[] Base64Encode(byte[] in,
                  boolean includeLineBreaks)

Base64 encodes (with or without line breaks) the provided input data and returns the byte representation of the Base64 encoded value.

If configured to do so via includeLineBreaks, a line break (CRLF) is inserted after every 64th character; this style of Base64 encoding is used in Privacy Enhanced Mail (PEM).

Parameters:

in - input data (data to be encoded)

includeLineBreaks - indicates whether or not line breaks should be included in the Base64 encoded value

Returns:

the byte representation of the Base64 encoded value

Since:

8.0

See Also:

Base64 - RFC 4648, PEM - RFC 1421

Base64EncodeToString

public static java.lang.String Base64EncodeToString(byte[] in)

Base64 encodes (with line breaks) the provided input data and returns the string representation of the Base64 encoded value.

A line break (CRLF) is inserted after every 64th character; this style of Base64 encoding is used in Privacy Enhanced Mail (PEM).

Parameters:

in - input data (data to be encoded)

Returns:

the string representation of the Base64 encoded value

Since:

8.0

See Also:

Base64 - RFC 4648, PEM - RFC 1421

Base64EncodeToString

public static java.lang.String Base64EncodeToString(byte[] in,
                                    boolean includeLineBreaks)

Base64 encodes (with or without line breaks) the provided input data and returns the string representation of the Base64 encoded value.

If configured to do so via includeLineBreaks, a line break (CRLF) is inserted after every 64th character; this style of Base64 encoding is used in Privacy Enhanced Mail (PEM).

Parameters:

in - input data (data to be encoded)

includeLineBreaks - indicates whether or not line breaks should be included in the Base64 encoded value

Returns:

the string representation of the Base64 encoded value

Since:

8.0

See Also:

Base64 - RFC 4648, PEM - RFC 1421

Base64Decode

public static byte[] Base64Decode(byte[] in,
                  boolean setIgnoreInvalidCharacters)
                           throws Base64Exception

Base64 decodes the provided input data (byte representation of a Base64 encoded value).

Line breaks (CRLF) are always ignored (skipped). If configured to do so via ignoreInvalidCharacters, invalid characters are also ignored.

Parameters:

in - Base64 encoded data in byte representation

ignoreInvalidCharacters - indicates whether or not invalid characters should be ignored in the Base64 encoded value

Returns:

the Base64 decoded value

Throws:

Base64Exception - if an error occurs while Bas64 decoding; indicates invalid Bas64 encoded input data

Since:

8.0

See Also:

Base64 - RFC 4648

Base64Decode

public static byte[] Base64Decode(byte[] in)
                           throws Base64Exception

Base64 decodes the provided input data (byte representation of a Base64 encoded value).

Line breaks (CRLF) are always ignored (skipped); invalid characters are also ignored.

Parameters:

in - Base64 encoded data in byte representation

Returns:

the Base64 decoded value

Throws:

Base64Exception - if an error occurs while Bas64 decoding; indicates invalid Bas64 encoded input data

Since:

8.0

See Also:

Base64 - RFC 4648

Base64DecodeFromString

public static byte[] Base64DecodeFromString(java.lang.String in)
                                     throws Base64Exception

Base64 decodes the provided input data (string representation of a Base64 encoded value).

Line breaks (CRLF) are always ignored (skipped); invalid characters are also ignored.

Parameters:

in - Base64 encoded data in string representation

Returns:

the Base64 decoded value

Throws:

Base64Exception - if an error occurs while Bas64 decoding; indicates invalid Bas64 encoded input data

Since:

8.0

See Also:

Base64 - RFC 4648

Base64DecodeFromString

public static byte[] Base64DecodeFromString(java.lang.String in,
                            boolean ignoreInvalidCharacters)
                                     throws Base64Exception

Base64 decodes the provided input data (string representation of a Base64 encoded value).

Line breaks (CRLF) are always ignored (skipped). If configured to do so via ignoreInvalidCharacters, invalid characters are also ignored.

Parameters:

in - Base64 encoded data in string representation

ignoreInvalidCharacters - indicates whether or not invalid characters should be ignored in the Base64 encoded value

Returns:

the Base64 decoded value

Throws:

Base64Exception - if an error occurs while Bas64 decoding; indicates invalid Bas64 encoded input data

Since:

8.0

See Also:

Base64 - RFC 4648

resizeArray

public static byte[] resizeArray(byte[] array,
                 int len)

Resizes a byte array to the specified length.

If len is smaller than the array size some bytes are lost.

Parameters:

array - the array to resize

len - the new length of the array

Returns:

the resized array

resizeArray

public static java.lang.Object[] resizeArray(java.lang.Object[] array,
                             int len)

Resizes a byte array to the specified length.

If len is smaller than the array size some bytes are lost.

Parameters:

array - the array to resize

len - the new length of the array

Returns:

the resized array

fillArray

public static void fillArray(byte[] array,
             java.io.InputStream is)
                      throws java.io.IOException

This method tries to fill the given array with data read from the InputStream. This method will not return until the array is full or an exception occurs.

Parameters:

array - the array to fill

is - the InputStream to read from

Throws:

java.io.IOException

getVector

public static java.util.Vector getVector(java.lang.Object[] array)

This method converts an array to a Vector.

Parameters:

array - the array to convert

Returns:

the created Vector

toArray

public static java.lang.Object[] toArray(java.util.Vector aVector)

This method converts a Vector to an array. ATTENTION: It is not possible to cast the returned array to an type other than (Object[]). To enable casting use the method: @see toArray(Vector, Class);

Parameters:

aVector - the Vector to convert

Returns:

the created array

toArray

public static java.lang.Object[] toArray(java.util.Vector aVector,
                         java.lang.Class cls)

This method converts a Vector to an array. This method must be used to get an array of a special type. You need this special type for casting an array.

 AType[] test = (AType[])Util.toArray(aVector, AType.class);
 

Without using the specified class a ClassCastException would occur.

Parameters:

aVector - the Vector to convert

cls - specifies the type of the elements

Returns:

the created array

waitKey

public static void waitKey()

Wait for the user to press the return key on System.in.

toByte

public static int toByte(char c,
         int radix)

Convert the given char to an int. '0' maps to 0, 'a' and 'A' to 10, 'z' and 'Z' to 36, and so on. For all other characters and for resulting values equal to or larger than radix -1 is returned.

toByteArray

public static byte[] toByteArray(java.lang.String s)

Convert the given string with hex values to a byte array. For example "001122" is turned into {0, 0x11, 0x22}. All characters outside the range of '0'-'9', 'a'-'z', and 'A'-'Z' or simply ignored.

decodeByteArray

public static byte[] decodeByteArray(java.lang.String st)
                              throws java.lang.RuntimeException

Decode base64 encoded data from the given string and return it as a byte array. Base64Exceptions cause a RuntimeException.

Throws:

java.lang.RuntimeException

encodeByteArray

public static java.lang.String encodeByteArray(byte[] b)

Encodes a byte array in base64 and return it as a string. It can be decoded again using decodeByteArray.
This method formats a base64 encoded byte array so that the string it represents can be inserted in a Java source code. Use method Base64Encode for getting the raw base64 encoded byte array.

Parameters:

b - the byte array to be encoded

decodeIntArray

public static int[] decodeIntArray(java.lang.String st)
                            throws java.lang.RuntimeException

Decode base64 encoded data from the given string and return it as an int array. It must have been encoded MSB first (big endian). Base64Exceptions cause a RuntimeException.

Throws:

java.lang.RuntimeException

encodeIntArray

public static java.lang.String encodeIntArray(int[] a)

Encode an int array in base64 and return it as a string. It can be decoded again using decodeIntArray.

fromBooleanArray

public static java.lang.String fromBooleanArray(boolean[] bits)

Converts the given array of boolean values into a string of zeros and ones.

Parameters:

bits - the array of boolean values to be converted

Returns:

the String representation of the given boolen array

toBooleanArray

public static boolean[] toBooleanArray(java.lang.String bits)

Transforms the characters of the given bit string into boolean values and returns the given string as an array of boolean values.

Parameters:

bits - the string of bits to be transformed into booleans

Returns:

an array of boolean values representing the characters of the given string of bits

toPemString

public static java.lang.String toPemString(java.security.cert.Certificate cert)

Convert the given Certificate to a PEM style base64 encoded string. The returned string will look something like:

 -----BEGIN CERTIFICATE-----
 BASE64DATA
 -----END CERTIFICATE-----
 

All lines will be terminated by '\n'. In case of a CertificateEncodingException null will be returned (should never occur with the IAIK JCE).

toPemString

public static java.lang.String toPemString(java.security.PrivateKey privKey)

Convert the given private key to a PEM style base64 encoded string. The returned string will look something like:

 -----BEGIN RSA PRIVATE KEY-----
 BASE64DATA
 -----END RSA PRIVATE KEY-----
 

All lines will be terminated by '\n'.

bubbleSort

public static long[] bubbleSort(long[] a)

Sort the given array of longs in ascending order and return it. This method uses bubble sort which is on average very slow on large array (complexity O(n*n)). However, it is ok to be used on small array, especially if they are 'almost' sorted.

bubbleSort

public static int[] bubbleSort(int[] a)

Sort the given array of ints in ascending order and return it. This method uses bubble sort which is on average very slow on large array (complexity O(n*n)). However, it is ok to be used on small array, especially if they are 'almost' sorted.

doCheckWritePermission

public static boolean doCheckWritePermission()

This checks the value of the com.entrust.toolkit.NoWritePermissionCheck system property. If the value is not set, or is equal to anything other than case insensitive "true" then this method will return true. If the value of the system property is case insensitive "true" then the method will return false.

Returns:

true if write permissions should be checked, false if write permissions should be skipped.

convertCertificateChain

public static X509Certificate[] convertCertificateChain(java.security.cert.Certificate[] certificateChain)
                                                 throws java.security.cert.CertificateException

This method converts an array of Certificates into an array of X509Certificates.

Parameters:

certificateChain - the array of certificates to convert

Returns:

the new certificate chain

Throws:

java.security.cert.CertificateException - if there occurs an error while parsing the certificate chain

arrangeCertificateChain

public static X509Certificate[] arrangeCertificateChain(X509Certificate[] certArray,
                                        boolean topdown)

Tries to construct a certificate chain from an array of certificates. If a certificate chain that contains all certificates from the array can be build the new certificate chain is returned. Otherwise null is returned. This method builds the chain by checking issuer and subject and testing the signatures.

Parameters:

certArray - an array of certificates

topdown - if true the certificate chain will be returned with the top-CA-certificate at index 0, otherwise with the top-CA-certificate at the array's last index.

Returns:

the rearranged certificate chain or null if the array did not contain a certificate chain.

readCertificateChain

public static X509Certificate[] readCertificateChain(java.io.InputStream is)
                                              throws java.io.IOException

Tries to read a certificate chain from the given input stream. The input stream is expected to supply a chain of DER encoded X.509 certificates.

Parameters:

is - the inputstream supplying the certificates

Returns:

the certificate chain parsed from the stream

Throws:

java.io.IOException - if an error occurs while reading/parsing the chain

readCRLChain

public static X509CRL[] readCRLChain(java.io.InputStream is)
                              throws java.io.IOException

Tries to read a crl list from the given input stream. The input stream is expected to supply a list of DER encoded X.509 crls.

Parameters:

is - the inputstream supplying the crls

Returns:

the crl list parsed from the stream

Throws:

java.io.IOException - if an error occurs while reading/parsing the chain

convertEndian32

public static byte[] convertEndian32(byte[] in)

Convert between little and big endian 32 bit formats.

setEncoding

public static void setEncoding(java.lang.String encoding)

Deprecated. since 8.0; by default 'US-ASCII' is used which (according to Sun) must be supported by all implementations of the Java 2 platform, Standard Edition, v. 1.3 or higher

Sets the encoding to be used by ASN.1 String types for String - byte conversion. This method may be used to direct the ASN.1 String types (except BMPString, T61String, UNIString, UTF8String, which are handled differently) to use another encoding scheme than "ASCII", "Cp1252", "ISO8859_1" or "Default".

Parameters:

encoding - the encoding to be used

getASCIIEncoding

public static java.lang.String getASCIIEncoding()

Returns the name of the character encoding that should be used for ASCII character/byte conversions.

Returns:

String the name of the ASCII character encoding

Since:

Entrust 7.0

toASCIIString

public static java.lang.String toASCIIString(byte[] bytes,
                             int offset,
                             int length)

Decodes a String from a sequence of bytes using the configured ASCII character encoding.

Refer to #setEncoding() for details on how to configure the ASCII character encoding.

Parameters:

bytes - the bytes to be decoded into characters

offset - the index of the first byte to decode

length - the number of bytes to decode

Returns:

the resultant string

toASCIIString

public static java.lang.String toASCIIString(byte[] bytes)

Decodes a String from a sequence of bytes using the configured ASCII character encoding.

Refer to #setEncoding() for details on how to configure the ASCII character encoding.

Parameters:

ba - a byte array (representing encoded characters)

Returns:

the resultant string

toASCIIBytes

public static byte[] toASCIIBytes(java.lang.String s)

Encodes a String to a sequence of bytes using the configured ASCII character encoding.

Refer to #setEncoding() for details on how to configure the ASCII character encoding.

Parameters:

s - a string

Returns:

the resultant byte array (representing encoded characters)

toUTF8String

public static java.lang.String toUTF8String(byte[] ba)

Decodes a String from a sequence of bytes using the 'UTF-8' character encoding.

Parameters:

ba - a byte array (representing encoded characters)

Returns:

the resultant string

toUTF8Bytes

public static byte[] toUTF8Bytes(java.lang.String s)

Encodes a String to a sequence of bytes using the 'UTF-8' character encoding.

Parameters:

s - a string

Returns:

the resultant byte array (representing encoded characters)

compareTables

public static void compareTables(java.lang.String text,
                 int[] T0,
                 int[] T1)

printTable

public static void printTable(java.lang.String text,
              byte[] table)

printTable

public static void printTable(java.lang.String text,
              int[] table)

calculateHashCode

public static int calculateHashCode(byte[] value)

Creates an integer suitable for hash table indexing.

Parameters:

value - the byte array for which a hash code shall be computed

Returns:

a hash code for the given byte array

decodeKey

public static java.security.Key decodeKey(int keyType,
                          java.lang.String keyAlgorithm,
                          byte[] encodedKey)
                                   throws java.security.NoSuchAlgorithmException,
                                          java.security.InvalidKeyException

Construct a key object from and encoded key. This method in used internally in the Cipher.unwrap() key method but could also be used by applications. keyType must be one of the key types defined in the Cipher class (private, public, or secret key) and key algorithm the name of the algorithm.

Throws:

java.security.NoSuchAlgorithmException

java.security.InvalidKeyException

getRSAPublicKey

public static RSAPublicKey getRSAPublicKey(java.security.Key key)
                                    throws java.security.InvalidKeyException

Convert a key to an IAIK RSAPublicKey. Key must be either an instance of either iaik.security.rsa.RSAPublicKey, java.security.interfaces.RSAPublicKey, or java.security.PublicKey.

Throws:

java.security.InvalidKeyException

getRSAPrivateKey

public static RSAPrivateKey getRSAPrivateKey(java.security.Key key)
                                      throws java.security.InvalidKeyException

Convert a key to an IAIK RSAPrivateKey. Key must be either an instance of either iaik.security.rsa.RSAPrivateKey, java.security.interfaces.RSAPrivateKey, or java.security.PrivateKey.

Throws:

java.security.InvalidKeyException