com.goldencode.p2j.util.osresource

Class LibraryDaemon

java.lang.Object

com.goldencode.p2j.util.osresource.LibraryDaemon

All Implemented Interfaces:

NativeAPICaller

class LibraryDaemon
extends java.lang.Object
implements NativeAPICaller

Provides remote access to the client-side LibraryManager API.

Field Summary

Fields

Modifier and Type	Field and Description
private static java.lang.Object	modToken Token used to authenticate with the dispatcher when registering APIs.

Constructor Summary

Constructors

Constructor and Description
LibraryDaemon(boolean single) Create an instance and export its API to the network.

Method Summary

Modifier and Type	Method and Description
Signature	invoke(java.lang.String libname, java.lang.String funcname, int ordinal, boolean persistent, CallingConvention conv, Signature signature) Invoke the defined native API call, loading (and optionally unloading) the library as needed.
void	release(java.lang.String libname) Attempts to unload the library identified by the given name.

Methods inherited from class java.lang.Object

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

Field Detail

modToken

private static java.lang.Object modToken

Token used to authenticate with the dispatcher when registering APIs.

Constructor Detail

LibraryDaemon

LibraryDaemon(boolean single)

Create an instance and export its API to the network.

Parameters:

single - true to startup within the server process which must bypass the shared infrastructure initialization. Use false for the normal client JVM startup.

Method Detail

invoke

public Signature invoke(java.lang.String libname,
                        java.lang.String funcname,
                        int ordinal,
                        boolean persistent,
                        CallingConvention conv,
                        Signature signature)

Invoke the defined native API call, loading (and optionally unloading) the library as needed.

All exceptions will be raised on the server-side (not here). Instead of throwing an exception, this code will set an error code and return.

Specified by:

invoke in interface NativeAPICaller

Parameters:

libname - The library name where this native procedure should be found.

funcname - The function name being called in the library (except where an ordinal is being used).

ordinal - The entry point's ordinal or -1 if the entry point should be found by name.

persistent - true to leave the library loaded when the native call is complete.

conv - The calling convention to be used in this native call.

signature - Contains the return value and argument descriptors. In the case of the arguments there will be 1 descriptor for each argument to the call (where the 0 index is the leftmost argument and the numargs - 1 index is the rightmost). Each descriptor defines the type and will contain any input value in the case of an argument. If the return value descriptor is null, the call should be treated as a void return.

Returns:

The same signature instance will be updated with output (and/or return data) upon a successful call or with an error code on any failure.

release

public void release(java.lang.String libname)

Attempts to unload the library identified by the given name.

Specified by:

release in interface NativeAPICaller

Parameters:

libname - The name of the library to attempt to unload.