com.izforge.izpack.util

Interface NativeLibraryClient

public interface NativeLibraryClient

Any class in IzPack that uses native libraries must implement this interface. See the package documentation for more details on requirements relating to the use of native libraries within IzPack.

Version:

0.0.1 / 2/6/2002

Author:

Elmar Grom

Method Summary

Modifier and Type	Method and Description
void	freeLibrary(String name) This method is used to free the library at the end of progam execution.

Method Detail

freeLibrary

void freeLibrary(String name)

This method is used to free the library at the end of progam execution. After this call, any instance of this calss will not be usable any more! This method is very likely NOT to return!

DO NOT CALL THIS METHOD DIRECTLY!
It is used by the librarian to free a native library before physically deleting it from its temporary loaction. A call to this method is likely to irrecoverably freeze the application!

The contract for this method implementation is that a call will bring the native library into a state where it can be deleted. This translates into an operation to free the library. Since no libraries should be left behind when the installer shuts down, it is necessary that each library provides the means to free itself. For instance in a MS-Windows environment the library must call FreeLibraryAndExitThread(). This will result in a native fuction call that does not return.

Parameters:

name - the name of the library, without path but with extension