cryptix.util.core

Interface LinkStatus

Known Implementing Classes:
NativeLink, NativeLink

public interface LinkStatus

A class providing information about the linking status of a native library (whether it was loaded successfully, its required and actual version numbers, etc.)

The status of a library used by a particular Cryptix class can be found by calling the static method getLinkStatus() on that class.

Copyright © 1997 Systemics Ltd on behalf of the Cryptix Development Team.
All rights reserved.

Version:
1.0.1, 1997/07/21
Author:
David Hopwood
Since:
Cryptix 2.2.0a, 2.2.2

Method Summary

void
checkNative()
Checks that the native library is being used (i.e.
String
getLibraryName()
Returns the library name.
String
getLinkErrorString()
Returns an error string describing why the library failed to load, or null if there was no error.
int
getMajorVersion()
Returns the actual major version number.
int
getMinorVersion()
Returns the actual minor version number.
int
getRequiredMajorVersion()
Returns the required major version number.
int
getRequiredMinorVersion()
Returns the required minor version number.
boolean
isLibraryCorrect()
Returns true if the library was loaded successfully.
boolean
isLibraryLoaded()
Returns true if the library was loaded.
void
setNative(boolean enable)
Enables or disables the native code.
boolean
useNative()
Returns true if native code is being used.

Method Details

checkNative

public void checkNative()
            throws UnsatisfiedLinkError
Checks that the native library is being used (i.e. it loaded successfully, has valid version numbers, and has not been disabled).

getLibraryName

public String getLibraryName()
Returns the library name.

getLinkErrorString

public String getLinkErrorString()
Returns an error string describing why the library failed to load, or null if there was no error.
Returns:
the error string, or null if no error occured

getMajorVersion

public int getMajorVersion()
Returns the actual major version number.

getMinorVersion

public int getMinorVersion()
Returns the actual minor version number.

getRequiredMajorVersion

public int getRequiredMajorVersion()
Returns the required major version number.

getRequiredMinorVersion

public int getRequiredMinorVersion()
Returns the required minor version number.

isLibraryCorrect

public boolean isLibraryCorrect()
Returns true if the library was loaded successfully.

isLibraryLoaded

public boolean isLibraryLoaded()
Returns true if the library was loaded. It may or may not be the correct version.

setNative

public void setNative(boolean enable)
Enables or disables the native code. By default, native code is used whenever its library can be loaded correctly. This method can be used to disable native linking (and re-enable it) for a specific class.
Parameters:
enable - true if native code should be used.

useNative

public boolean useNative()
Returns true if native code is being used.