com.embeddedunveiled.serial.internal

Class SerialComPortMapperJNIBridge

java.lang.Object

com.embeddedunveiled.serial.internal.SerialComPortMapperJNIBridge

public final class SerialComPortMapperJNIBridge
extends Object

This class is an interface between java and native shared library. The native library is found in 'lib-mapper' folder in 'scm-x.x.x.jar' file.

Author:

Rishi Gupta

Constructor Summary

Constructors

Constructor and Description
SerialComPortMapperJNIBridge() Allocates a new SerialComPortMapperJNIBridge object.

Method Summary

Methods

Modifier and Type	Method and Description
static boolean	loadNativeLibrary(String directoryPath, String loadedLibName, SerialComSystemProperty serialComSystemProperty, int osType, int cpuArch, int javaABIType) Extract native library from jar in a working directory, load and link it.
int	mapAliasToExistingComPort(String alias, String comPort)
int	startMappingService()
int	stopMappingService()
int	unmapAliasToExistingComPort(String alias)

Methods inherited from class java.lang.Object

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

Constructor Detail

SerialComPortMapperJNIBridge

public SerialComPortMapperJNIBridge()

Allocates a new SerialComPortMapperJNIBridge object.

Method Detail

loadNativeLibrary

public static boolean loadNativeLibrary(String directoryPath,
                        String loadedLibName,
                        SerialComSystemProperty serialComSystemProperty,
                        int osType,
                        int cpuArch,
                        int javaABIType)
                                 throws SecurityException,
                                        SerialComUnexpectedException,
                                        SerialComLoadException,
                                        UnsatisfiedLinkError

Extract native library from jar in a working directory, load and link it. The 'lib-mapper' folder in 'scm-x.x.x.jar'.

Parameters:

directoryPath - null for default directory or user supplied directory path.

loadedLibName - null for default name or user supplied name of loaded library.

serialComSystemProperty - instance of SerialComSystemProperty to get required java properties.

cpuArch - architecture of CPU this library is running on.

osType - operating system this library is running on.

javaABIType - binary application interface type to correctly link.

Throws:

SecurityException - if java system properties can not be accessed.

SerialComUnexpectedException - if java system property is null.

SerialComLoadException - if any file system related issue occurs.

UnsatisfiedLinkError - if loading/linking shared library fails.

startMappingService

public int startMappingService()

stopMappingService

public int stopMappingService()

mapAliasToExistingComPort

public int mapAliasToExistingComPort(String alias,
                            String comPort)

unmapAliasToExistingComPort

public int unmapAliasToExistingComPort(String alias)