ej.sni

Class SNI

java.lang.Object

ej.sni.SNI

public class SNI
extends java.lang.Object

Simple Native Interface utility methods.

Constructor Summary

Constructors

Constructor and Description
SNI()

Method Summary

Modifier and Type	Method and Description
static void	toCString(java.lang.String javaString, byte[] cString) Transforms a Java String into a C String. The platform default encoding is used to transform Java characters into C characters. The created C String is a NULL terminated String (ends with '\0').
static java.lang.String	toJavaString(byte[] cString) Transforms a C String into a Java String, using platform default encoding.

Methods inherited from class java.lang.Object

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

Constructor Detail

SNI

public SNI()

Method Detail

toCString

public static void toCString(java.lang.String javaString,
                             byte[] cString)

Transforms a Java String into a C String.
The platform default encoding is used to transform Java characters into C characters.
The created C String is a NULL terminated String (ends with '\0'). The cString array length must be at least javaString.length()+1.
The content of the given cString array is automatically flushed with the method NativeInterface.flushContent(Object, int, int). Only javaString.length() bytes are flushed.

Parameters:

javaString - the Java String

cString - byte array which contains the C String.

Throws:

java.lang.IllegalArgumentException - if javaString or cString is null

java.lang.ArrayIndexOutOfBoundsException - if cString is too small to contain the string

toJavaString

public static java.lang.String toJavaString(byte[] cString)

Transforms a C String into a Java String, using platform default encoding. The C String must be NULL terminated.
The content of the given cString is automatically refreshed with the method NativeInterface.refreshContent(Object).

Parameters:

cString - byte array which contains the C String

Returns:

a new Java String.

Throws:

java.lang.IllegalArgumentException - if cString is null or its length is 1

java.lang.IllegalArgumentException - if cString is not NULL terminated.