cryptix.util.core

Interface LinkStatus

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.

Since: Cryptix 2.2.0a, 2.2.2

Version: 1.0.1, 1997/07/21

Author: David Hopwood

Method Summary
voidcheckNative()
Checks that the native library is being used (i.e. it loaded successfully, has valid version numbers, and has not been disabled).
StringgetLibraryName()
Returns the library name.
StringgetLinkErrorString()
Returns an error string describing why the library failed to load, or null if there was no error.
intgetMajorVersion()
Returns the actual major version number.
intgetMinorVersion()
Returns the actual minor version number.
intgetRequiredMajorVersion()
Returns the required major version number.
intgetRequiredMinorVersion()
Returns the required minor version number.
booleanisLibraryCorrect()
Returns true if the library was loaded successfully.
booleanisLibraryLoaded()
Returns true if the library was loaded.
voidsetNative(boolean enable)
Enables or disables the native code.
booleanuseNative()
Returns true if native code is being used.

Method Detail

checkNative

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

Throws: UnsatisfiedLinkError if the library is not being used

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.