Added static helper method to Library interface for getting the wrapped NativeLibrary instance + added static helper method to Native class for getting the NativeLibrary that a "registered" class is bound to.

Author: serinana47

CHANGES.md

@@ -11,6 +11,7 @@ Features
 * [#1593](https://github.com/java-native-access/jna/pull/1593): Add support for DragonFly BSD x86-64 - [@liweitianux](https://github.com/liweitianux).
 * [#1595](https://github.com/java-native-access/jna/pull/1595): Add `IsProcessorFeaturePresent` to `c.s.j.p.win32.Kernel32` - [@dbwiddis](https://github.com/dbwiddis).
 * [#1602](https://github.com/java-native-access/jna/pull/1602): Add `XMoveWindow`, `XResizeWindow`, `XMoveResizeWindow`, `XRaiseWindow`, `XLowerWindow` X11 calls to `c.s.j.p.unix.X11` - [@vinceh121](https://github.com/vinceh121).
+* [#1612](https://github.com/java-native-access/jna/pull/1612): Added static helper methods for getting the underlying NativeLibrary instance from a Library interface instance or from a "registered" class.
 
 Bug Fixes
 ---------

src/com/sun/jna/Library.java

@@ -271,4 +271,17 @@ public Object invoke(Object proxy, Method method, Object[] inArgs)
             }
         }
     }
+
+    /**
+     * Get the <tt>NativeLibrary</tt> instance that is wrapped by the given <tt>Library</tt> interface instance
+     * @param library the <tt>Library</tt> interface instance, usually this was obtained via the <tt>Native.load()</tt> method
+     * @return the wrapped <tt>NativeLibrary</tt> instance
+     */
+    static NativeLibrary getNativeLibrary(final Library library) {
+        final InvocationHandler handler = Proxy.getInvocationHandler(library);
+        if (!(handler instanceof Handler))
+            throw new IllegalArgumentException("Object is not a properly loaded Library instance")
+        }
+        return ((Handler)handler).getNativeLibrary();
+    }
 }

src/com/sun/jna/Native.java

@@ -1918,6 +1918,17 @@ public static void register(Class<?> cls, NativeLibrary lib) {
         }
     }
 
+    /**
+     * Get the <tt>NativeLibrary</tt> instance to which the native methods of the given "registered" class are bound
+     * @param cls the "registered" class, usually this class was previously registered via the <tt>Native.register()</tt> method
+     * @return if the given class is registered, the <tt>NativeLibrary</tt> instance to which the class' native methods are bound; otherwise <tt>null</tt>
+     */
+    public static NativeLibrary getNativeLibrary(final Class<?> cls) {
+        synchronized(registeredClasses) {
+            return registeredLibraries.get(findDirectMappedClass(cls));
+        }
+    }
+
     /* Take note of options used for a given library mapping, to facilitate
      * looking them up later.
      */