Modifier and Type	Class and Description
private static class	ProcAddressTable.One2OneResolver

Modifier and Type	Field and Description
protected static boolean	DEBUG
protected static String	DEBUG_PREFIX
protected static int	debugNum
private static final String	PROCADDRESS_VAR_PREFIX
private static final int	PROCADDRESS_VAR_PREFIX_LEN
private final FunctionAddressResolver	resolver

Access	Constructor and Description
public	ProcAddressTable()
public	ProcAddressTable(final FunctionAddressResolver resolver)

Method Summary

Modifier and Type	Method and Description
private final Field	fieldForFunction(final String name)
private final Field	fieldForFunctionInSec(final String name) Warning Returns an accessible probably protected field!
private final String	fieldToFunctionName(final String addressFieldName)
public long	getAddressFor(final String functionName) This is a convenience method to query the native function handle by name.
private static final PrintStream	getDebugOutStream()
public final Set<String>	getNullPointerFunctions() Returns all functions pointing to null.
public void	initEntry(final String name, final DynamicLookupHelper lookup) Initializes the mapping for a single function.
private final boolean	isAddressField(final String fieldName)
public final boolean	isFunctionAvailable(final String functionName) Returns true only if non null function pointer to this function exists.
protected boolean	isFunctionAvailableImpl(final String functionName) This is a convenience method to query the native function existence by name.
public void	reset(final DynamicLookupHelper lookup) Resets the complete table.
private final void	setEntry(final Field addressField, final String funcName, final DynamicLookupHelper lookup)
private final Map<String, Long>	toMap() Returns this table as map with the function name as key and the address as value.
public final String	toString() Overrides java.lang.Object.toString. Returns a string representation of the object.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll wait wait wait

Field Detail

DEBUG	back to summary
protected static boolean DEBUG

DEBUG_PREFIX	back to summary
protected static String DEBUG_PREFIX

debugNum	back to summary
protected static int debugNum

PROCADDRESS_VAR_PREFIX	back to summary
private static final String PROCADDRESS_VAR_PREFIX

PROCADDRESS_VAR_PREFIX_LEN	back to summary
private static final int PROCADDRESS_VAR_PREFIX_LEN

resolver	back to summary
private final FunctionAddressResolver resolver

Constructor Detail

ProcAddressTable	back to summary
public ProcAddressTable()

ProcAddressTable	back to summary
public ProcAddressTable(final FunctionAddressResolver resolver)

Method Detail

fieldForFunction	back to summary
private final Field fieldForFunction(final String name) throws IllegalArgumentException

fieldForFunctionInSec back to summary

fieldForFunctionInSec	back to summary
private final Field fieldForFunctionInSec(final String name) throws IllegalArgumentException Warning Returns an accessible probably protected field! Caller should have checked link permissions for all libraries, i.e. for `new RuntimePermission("loadLibrary.*");` if exposing the field or address!

private final Field fieldForFunctionInSec(final String name) throws IllegalArgumentException

Warning

Returns an accessible probably protected field!

Caller should have checked link permissions for all libraries, i.e. for new RuntimePermission("loadLibrary.*"); if exposing the field or address!

fieldToFunctionName	back to summary
private final String fieldToFunctionName(final String addressFieldName)

getAddressFor back to summary

getAddressFor	back to summary
public long getAddressFor(final String functionName) throws SecurityException, IllegalArgumentException This is a convenience method to query the native function handle by name. It lets you avoid having to manually compute the "`PROCADDRESS_VAR_PREFIX` + <functionName>" member variable name and look it up via reflection. If a `SecurityManager` is installed, user needs link permissions for all libraries, i.e. for `new RuntimePermission("loadLibrary.*");`! Exceptions SecurityException: if user is not granted access for all libraries. IllegalArgumentException: if this function is not in this table.

public long getAddressFor(final String functionName) throws SecurityException, IllegalArgumentException

This is a convenience method to query the native function handle by name.

It lets you avoid having to manually compute the "PROCADDRESS_VAR_PREFIX + <functionName>" member variable name and look it up via reflection.

If a SecurityManager is installed, user needs link permissions for all libraries, i.e. for new RuntimePermission("loadLibrary.*");!

Exceptions

SecurityException:: if user is not granted access for all libraries.
IllegalArgumentException:: if this function is not in this table.

getDebugOutStream	back to summary
private static final PrintStream getDebugOutStream()

getNullPointerFunctions	back to summary
public final Set<String> getNullPointerFunctions() Returns all functions pointing to null.

initEntry back to summary

initEntry	back to summary
public void initEntry(final String name, final DynamicLookupHelper lookup) throws SecurityException, IllegalArgumentException Initializes the mapping for a single function. If a `SecurityManager` is installed, user needs link permissions for all libraries, i.e. for `new RuntimePermission("loadLibrary.*");`! Exceptions SecurityException: if user is not granted access for all libraries. IllegalArgumentException: if this function is not in this table.

public void initEntry(final String name, final DynamicLookupHelper lookup) throws SecurityException, IllegalArgumentException

Initializes the mapping for a single function.

If a SecurityManager is installed, user needs link permissions for all libraries, i.e. for new RuntimePermission("loadLibrary.*");!

Exceptions

SecurityException:: if user is not granted access for all libraries.
IllegalArgumentException:: if this function is not in this table.

isAddressField	back to summary
private final boolean isAddressField(final String fieldName)

isFunctionAvailable	back to summary
public final boolean isFunctionAvailable(final String functionName) Returns true only if non null function pointer to this function exists.

isFunctionAvailableImpl back to summary

isFunctionAvailableImpl	back to summary
protected boolean isFunctionAvailableImpl(final String functionName) throws IllegalArgumentException This is a convenience method to query the native function existence by name. It lets you avoid having to manually compute the "`PROCADDRESS_VAR_PREFIX` + <functionName>" member variable name and look it up via reflection. Exceptions IllegalArgumentException: if this function is not in this table.

protected boolean isFunctionAvailableImpl(final String functionName) throws IllegalArgumentException

This is a convenience method to query the native function existence by name.

It lets you avoid having to manually compute the "PROCADDRESS_VAR_PREFIX + <functionName>" member variable name and look it up via reflection.

Exceptions

IllegalArgumentException:: if this function is not in this table.

reset back to summary

reset	back to summary
public void reset(final DynamicLookupHelper lookup) throws SecurityException, RuntimeException Resets the complete table. If a `SecurityManager` is installed, user needs link permissions for all libraries, i.e. for `new RuntimePermission("loadLibrary.*");`! Exceptions SecurityException: if user is not granted access for all libraries.

public void reset(final DynamicLookupHelper lookup) throws SecurityException, RuntimeException

Resets the complete table.

If a SecurityManager is installed, user needs link permissions for all libraries, i.e. for new RuntimePermission("loadLibrary.*");!

Exceptions

SecurityException:: if user is not granted access for all libraries.

setEntry	back to summary
private final void setEntry(final Field addressField, final String funcName, final DynamicLookupHelper lookup) throws SecurityException

toMap	back to summary
private final Map<String, Long> toMap() Returns this table as map with the function name as key and the address as value.

toString	back to summary
public final String toString() Overrides java.lang.Object.toString. Doc from java.lang.Object.toString. Returns a string representation of the object. Returns:String a string representation of the object Annotations @Override

toString

back to summary

public final String toString()

Overrides java.lang.Object.toString.

Doc from java.lang.Object.toString.

Returns a string representation of the object.

Returns:String

a string representation of the object

Annotations

@Override

com.jogamp.gluegen.runtime back to summary

private Class ProcAddressTable.One2OneResolver

Class Inheritance

extends Object
implements FunctionAddressResolver

java.lang.Object
com.jogamp.gluegen.runtime.ProcAddressTable.One2OneResolver

All Implemented Interfaces

com.jogamp.gluegen.runtime.FunctionAddressResolver

Constructor Summary

Access	Constructor and Description
private	One2OneResolver()

Method Summary

Modifier and Type	Method and Description
public long	resolve(final String name, final DynamicLookupHelper lookup) Implements com.jogamp.gluegen.runtime.FunctionAddressResolver.resolve. Resolves the name of the function bound to the method and returns the address.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Constructor Detail

One2OneResolver	back to summary
private One2OneResolver()

Method Detail

resolve back to summary

resolve	back to summary
public long resolve(final String name, final DynamicLookupHelper lookup) throws SecurityException Implements com.jogamp.gluegen.runtime.FunctionAddressResolver.resolve. Doc from com.jogamp.gluegen.runtime.FunctionAddressResolver.resolve. Resolves the name of the function bound to the method and returns the address. Implementation shall ensure `SecurityUtil#checkLinkPermission(String)` is performed. Annotations @Override Exceptions SecurityException: if user is not granted access for the library set.