Class NativeLibrary

src/com/sun/jna/NativeLibrary.java:87–1073

Provides management of native library resources. One instance of this class corresponds to a single loaded native library. May also be used to map to the current process (see NativeLibrary#getProcess()). Library Search Paths A search for a given

 * @author twall
 */
public class NativeLibrary implements Closeable {

    private static final Logger LOG = Logger.getLogger(NativeLibrary.class.getName());
    private static final Level DEBUG_LOAD_LEVEL = DEBUG_LOAD ? Level.INFO : Level.FINE;
    private static final SymbolProvider NATIVE_SYMBOL_PROVIDER = new SymbolProvider() {
        @Override
        public long getSymbolAddress(long handle, String name, SymbolProvider parent) {
            return Native.findSymbol(handle, name);
        }
    };

    private final Cleaner.Cleanable cleanable;
    private volatile long handle;
    private final String libraryName;
    private final String libraryPath;
    private final Map<String, Function> functions = new HashMap<>();
    private final SymbolProvider symbolProvider;
    private final int callFlags;
    private final String encoding;
    private final Map<String, ?> options;

    private static final Map<String, Reference<NativeLibrary>> libraries = new HashMap<>();

    private static final Map<String, List<String>> searchPaths = new ConcurrentHashMap<>();
    private static final LinkedHashSet<String> librarySearchPath = new LinkedHashSet<>();

    static {
        // Force initialization of native library
        if (Native.POINTER_SIZE == 0)
            throw new Error("Native library not initialized");
    }

    private static String functionKey(String name, int flags, String encoding) {
        return name + "|" + flags + "|" + encoding;
    }

    @SuppressWarnings("LeakingThisInConstructor")
    private NativeLibrary(String libraryName, String libraryPath, long handle, Map<String, ?> options) {
        this.libraryName = getLibraryName(libraryName);
        this.libraryPath = libraryPath;
        this.handle = handle;
        this.cleanable = Cleaner.getCleaner().register(this, new NativeLibraryDisposer(handle));
        Object option = options.get(Library.OPTION_CALLING_CONVENTION);
        int callingConvention = option instanceof Number ? ((Number)option).intValue() : Function.C_CONVENTION;
        this.callFlags = callingConvention;
        this.options = options;
        SymbolProvider optionSymbolProvider = (SymbolProvider)options.get(Library.OPTION_SYMBOL_PROVIDER);
        if (optionSymbolProvider == null) {
            this.symbolProvider = NATIVE_SYMBOL_PROVIDER;
        } else {
            this.symbolProvider = optionSymbolProvider;
        }

        String encodingValue = (String) options.get(Library.OPTION_STRING_ENCODING);
        if (encodingValue == null) {
            encodingValue = Native.getDefaultStringEncoding();
        }
        this.encoding = encodingValue;