jaulib v1.3.0
Jau Support Library (C++, Java, ..)
DynamicLookupHelper.java
Go to the documentation of this file.
1/**
2 * Author: Sven Gothel <sgothel@jausoft.com>
3 * Author: Kenneth Bradley Russell
4 * Copyright (c) 2020 Gothel Software e.K.
5 * Copyright (c) 2011 Gothel Software e.K.
6 * Copyright (c) 2011 JogAmp Community.
7 * Copyright (c) 2003-2005 Sun Microsystems, Inc.
8 *
9 * Permission is hereby granted, free of charge, to any person obtaining
10 * a copy of this software and associated documentation files (the
11 * "Software"), to deal in the Software without restriction, including
12 * without limitation the rights to use, copy, modify, merge, publish,
13 * distribute, sublicense, and/or sell copies of the Software, and to
14 * permit persons to whom the Software is furnished to do so, subject to
15 * the following conditions:
16 *
17 * The above copyright notice and this permission notice shall be
18 * included in all copies or substantial portions of the Software.
19 *
20 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
21 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
22 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
23 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
24 * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
25 * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
26 * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
27 */
28
29package org.jau.sys.dl;
30
31import org.jau.sys.Debug;
32
33public interface DynamicLookupHelper {
34 public static final boolean DEBUG = Debug.debug("NativeLibrary");
35 public static final boolean DEBUG_LOOKUP = Debug.debug("NativeLibrary.Lookup");
36
37 /**
38 * @throws SecurityException if user is not granted access for the library set.
39 */
40 public void claimAllLinkPermission() throws SecurityException;
41 /**
42 * @throws SecurityException if user is not granted access for the library set.
43 */
44 public void releaseAllLinkPermission() throws SecurityException;
45
46 /**
47 * Returns the function handle for function 'funcName'.
48 * @throws SecurityException if user is not granted access for the library set.
49 */
50 public long dynamicLookupFunction(String funcName) throws SecurityException;
51
52 /**
53 * Queries whether function 'funcName' is available.
54 * @throws SecurityException if user is not granted access for the library set.
55 */
56 public boolean isFunctionAvailable(String funcName) throws SecurityException;
57}
Helper routines for logging and debugging.
Definition: Debug.java:35
static final boolean debug(final String subcomponent)
Definition: Debug.java:63
long dynamicLookupFunction(String funcName)
Returns the function handle for function 'funcName'.
boolean isFunctionAvailable(String funcName)
Queries whether function 'funcName' is available.