Skip to content

Latest commit

 

History

History
725 lines (594 loc) · 42.6 KB

CHANGES.md

File metadata and controls

725 lines (594 loc) · 42.6 KB

NOTE: as of JNA 4.0, JNA is now dual-licensed under LGPL and ASL (see LICENSE).

NOTE: JNI native support is typically incompatible between minor versions, and almost always incompatible between major versions.

Next Release

Features

  • Updated AIX natives and build - @twall.
  • #290: Improved the stacktrace for the exceptions thrown by com.sun.jna.Structure - @ebourg.
  • #332: Added Win32 Monitor Configuration API in com.sun.jna.platform.win32.Dxva2 - @msteiger.
  • Added Winspool monitor sample and updated Kernel32, WinBase, Winspool - @wolftobias.
  • Added Some minor changes to MS Office samples Test and small changes to the MS Office samples Bug Fixes - @wolftobias.
  • #333: Added CoTaskMemAlloc, CoTaskMemRealloc and CoTaskMemFree to com.sun.jna.platform.win32.Ole32 - @msteiger.
  • #334: Added com.sun.jna.platform.win32.Shell32.SHGetKnownFolderPath and KnownFolders GUID constants - @msteiger.

Bug Fixes

4.1.0-variadic

Release 4.1

Features

  • Added com.sun.jna.platform.win32.Advapi32Util.registryCloseKey - @falldog.
  • Enabled platform tests to be run w/o building native bits - @twall.
  • Added COM/Typelib java code generator com.sun.jna.platform.win32.COM.tlb.TlbImp - @wolftobias.
  • #226: Added OSGI information to jna-platform.jar - @brettwooldridge.
  • #267: Added support for Windows RAS32 API, com.sun.jna.platform.win32.Rasapi32 and Rasapi32Util - @kc7bfi.
  • #101: Modify com.sun.jna.platform.win32.Advapi32Util.registryGet* API to support KEY_WOW64 option - @falldog.
  • #271: Added com.sun.jna.platform.win32.Gdi32.ChoosePixelFormat and SetPixelFormat - @kc7bfi.
  • #271: Added com.sun.jna.platform.win32.OpenGL32, OpenGL32Util and WinOpenGL - @kc7bfi.
  • #250: Added com.sun.jna.platform.win32.Kernel32.GetPrivateProfileSection, GetPrivateProfileSectionNames and WritePrivateProfileSection and corresponding Kernel32Util helpers - @quipsy-karg.
  • #287: Added DBTF_MEDIA and DBTF_NET to com.sun.jna.platform.win32.DBT - @daifei4321.
  • #295: Added com.sun.jna.platform.win32.Kernel32.ResetEvent - @manithree.
  • #301: Added accessCheck to com.sun.jna.platform.win32.Advapi32Util, MapGenericMask and AccessCheck to com.sun.jna.platform.win32.Advapi32, PRIVILEGE_SET and GENERIC_MAPPING to com.sun.jna.platform.win32.WinNT - @BusyByte.

Bug Fixes

  • Fixed inconsistent behavior on Structure.ByValue fields within a Structure - @twall.
  • #279: Accommodate FreeBSD libc loading - @sevan.
  • #287: Fixed contrib win32.Win32WindowDemo, now showing the added/removed drive letter, and whether the event is about media in drive or physical drive - @daifei4321.
  • #300: Fix stdcall argument alignment - @twall.

Release 4.0

Features

  • Added ASL licensing to facilitate distribution - @twall.
  • #109: Set default Java compatibility level to 1.6 - @twall.
  • #209: Improved default performance saving last error results - @twall.
  • Use predictable names for CPU architecture prefix (namely x86, x86-64); names correspond to OSGI processor values - @twall.
  • Avoid superfluous Structure memory allocation from native - @twall.
  • Added Library.OPTION_CLASSLOADER, which enables loading native libraries from any class loader (including JNA's native library). This enables parallel dependencies on JNA (e.g. within a tomcat deployment without having to include JNA in the app server environment) - @twall.
  • Use per-library String encoding settings (see Native.getDefaultStringEncoding() and Structure.getStringEncoding()) - @twall.
  • Added memory dump for debugging (see com.sun.jna.Memory) - @twall.
  • Improved caching of Structure alignment, type mapping, and encoding information - @twall.
  • #225: Added platform.win32.Kernel32.GetLogicalProcessorInformation and platform.win32.Kernel32Util.getLogicalProcessorInformation - @trejkaz.
  • #236: Auto-strip profiler native method prefix specified by jna.profiler.prefix, which defaults to $$YJP$$ - @twall.
  • Added jna.debug_load property to diagnose library loading issues - @twall.
  • Throw explicit IllegalArgumentException when Structure.ByReference is used where it shouldn't be (can result in multiply freed memory or other unexpected behavior) - @twall.
  • #243: Automatically accommodate long library paths on Windows which would otherwise fail - @twall.
  • #241 - Added com.sun.jna.platform.win32.Shell32.SHAppBarMessage - @bsorrentino.
  • Make Structure.read/writeField() protected to facilitate per-field overrides - @twall.
  • Speed up callback lookup where large numbers of native function pointers are in use - @twall.

Bug Fixes

  • #213: Fixed Structure.toString() not to dump memory when jna.dump_memory is false - @tomohiron.
  • Use dedicated TLS to indicate callback detach state, to avoid any potential conflicts with last error storage - @twall.
  • #173: Fixed OSX 10.8/Xcode 4+ builds, web start path with Oracle 1.7 JDK - @mkjellman.
  • #215: Forced use of XSI strerror_r on linux - LionelCons.
  • #214: Don't map library names when an absolute path is provided - @twall.
  • #218: Explicitly handled broken Android SecurityManager implementation - @twall.
  • #223: Fixed layout/size derivation for unions - @twall.
  • #229: Added CreateProcessW (Unicode version) - @twall.
  • Avoid solaris/x86 JVM bug w/library open flags - @twall.
  • Fixed NPE returning wide string from a direct-mapped function - @twall.
  • #237: Fix LastErrorException/getLastError on AIX - @skissane.
  • #228: Fix win32/win64 crashes due to LastErrorException buffer overruns (snprintf on windows is broken) - @davidhoyt.

Release 3.5.2

Features

  • Basic COM support for w32 - @wolftobias.
  • Avoid superfluous Structure memory allocation by using Structure(Pointer) ctors if available - @twall.
  • PR#120: Provide methods for extracting native libraries from the class path for use by JNA - @Zlika.
  • PR#163: The Java GUID structure can be used directly as alternative to Ole32Util.getGUIDFromString() - @wolftobias.
  • PR#163: Ported Win32 dbt.h - @wolftobias.
  • PR#163: Added Win32 WTSRegisterSessionNotification() and WTSUnRegisterSessionNotification() from Wtsapi32.dll - @wolftobias.
  • PR#163: Added Win32 native_window_msg that creates windows, registers for USB device and logon/logoff notifications - @wolftobias.
  • PR#178: Added Win32 USER_INFO_10 structure from LMAccess.h - @davidmc24.
  • PR#192: Added Win32 SHGetSpecialFolderPath() and initialization file (.ini) API functions from kernel32.dll - @headcrashing.
  • PR#194: Added Unit Test for CLSIDFromProgID() - @headcrashing.
  • PR#196: Added Win32 RegisterWindowMessage() and new wrapper User32Util for convenient use of RegisterWindowMessage, CreateWindow and CreateWindowEx - @headcrashing.
  • PR#187: Allow StructureFieldOrderTest unit test in platform project to run on Linux. - @bhamail.

Bug Fixes

  • PR#180: Fix: added missing fields in XEvents.getFieldOrder() - @xwizard.
  • PR#183: Fix LMAccess.GROUP_INFO_3.getFieldOrder() to return correct fields names - @bhamail.
  • PR#187: Fix getFieldOrder() to return correct field names for some X11 structures - @bhamail.
  • Remove deprecated methods on Memory (getSize,isValid) and Structure (getSize) - @twall.
  • Remove problematic AWT check via Class.forName("java.awt.Component") (see here) - @twall.
  • PR#210 Add OSGI processor specs for Mac OS X - @bertfrees.
  • PR#174: Recompile linux-amd64 natives to remove glibc-2.11 dependencies, now requires only 2.2.5 or better - @twall.
  • PR#183: Added StructureFieldOrderInspector unit test utility to scan for Structure field issues; see: com.sun.jna.platform.StructureFieldOrderTest.testMethodGetFieldOrder - @bhamail.
  • PR#187: Allow StructureFieldOrderTest unit test in platform project to run on Linux - @bhamail.
  • #206: Fix moveToTrash() on OSX to work with symlinks - @twall.
  • Fix NPE if Thread.getContextClassLoader() returns null - @twall.

Release 3.5.1

Bug Fixes

  • Fix bug where string fields sometimes failed to be writtern - @twall (roman kisluhin).
  • PR#145: Fix Netapi32Util.getDomainTrusts() returns "empty" domain object - @aikidojohn.
  • PR#145: Fix Netapi32.getDC() - added missing fields in DOMAIN_CONTROLLER_INFO - @aikidojohn.
  • PR#151: 'platform.jar' in the dist directory was not updated for release 3.5.0. (The 'platform.jar' published to maven central was correct.)

Release 3.5.0

Features

  • #62 If a callback is required to reside in a DLL, use DLLCallback to tag your Callback object - @twall.
  • Structure.getFieldOrder() supersedes Structure.setFieldOrder() and is now required - @twall.
  • Search ~/Library/Frameworks and /Library/Frameworks on OSX - @shaneholloway.
  • Automatic cleanup of native threads (based on suggestions from neil smith) - @twall.
  • Add android-arm target - @ochafik, @twall.
  • Add jna.tmpdir to override temporary JNA storage location - @twall.
  • Add EXTRA_MAKE_OPTS ant property to override make variables - @twall.
  • Add Library.OPTION_OPEN_FLAGS to customize dlopen behavior - @twall.
  • #113, #114: Add support for GNU/kFreeBSD and debian multi-arch distros - @twall.

Bug Fixes

  • Fix Advapi32Util.registryGetValues() tried to allocate memory for a zero-length REG_BINARY value - @phailwhale22.
  • Fix crash in direct mode callbacks with certain type conversions - @twall.
  • More thoroughly propagate unexpected exceptions generated in jnidispatch - @twall.
  • Cleanup maven poms and publishing to central repo - @bhamail.
  • #129: Allow Memory field in structure - @twall.
  • Preserve PointerType fields on Structure.read() if unchanged - @twall.
  • #128: Fix masking extracting DWORD upper and lower WORD values - @twall.
  • #135: Fix for Advapi32Util.registryGetValues() when reading zero length values - @danwi.

Release 3.4.2

Features

  • Add platform.win32.Kernel32.GetEnvironmentVariable and platform.win32.Kernel32Util.getEnvironmentVariable - @dblock.
  • Moved Kernel32.dll function definitions from WinNT.java into Kernel32.java - @dblock.
  • Provide toPointer() methods on all _PTR types (platform win32) - @twall.
  • Provide ant -Dskip-native to skip platform native build - @twall.
  • Provide ant -Dheadless=true to run unit tests headless - @twall.
  • Added Windows dev environment instructions - @twall.

Bug Fixes

  • Ensure platform win32 classes use unsigned where appropriate (ULONG_PTR, UINT_PTR, ULONGLONG, WORD, DWORDLONG) - @twall.
  • #71, #73: Fix OSGI entries in manifest - @twall.
  • #78: Fix NPE in platform.win32.Netapi32Util.getDomainTrusts - @dblock.
  • Fix: auto-sync memory for struct** arguments (array of struct pointers) - @twall.
  • Fix: platform.win32.Secur32.AcquireCredentialsHandle, InitializeSecurityContext and AcceptSecurityContext on Win32 64-bit - @dblock.
  • Fix: avoid overwriting native char * or wchar_t * fields within structures when unmodified (similar to current operation with pointers) - @twall.
  • Fix: platform.win32.DsGetDC.DS_DOMAIN_TRUSTS and DsEnumerateDomainTrusts on Win32 64-bit - @trejkaz.
  • Fix: Crash freeing the wrong pointer in Netapi32Util.getDomainTrusts - @trejkaz.
  • #100: Fix platform.win32.W32FileMonitor - @dblock.
  • Return INT_PTR from platform.win32.Shell32.ShellExecute, since returning HINSTANCE is useless.
  • Fix runtime error in some instances where Structure.setFieldOrder is used (never return self when sharing AutoAllocated memory).
  • #107: Structure.clear() always calls ensureAllocated() to avoid NPE.
  • Ensure internal memory pointer is always allocated when calling Structure.useMemory(), even if layout is not yet determined.

Release 3.4.1

Features

  • Add 'unsigned' modifier to IntegerType.
  • Add to platform.win32.User32: GetLastInputInfo.
  • Add platform.win32.WinNT.GetFileType and platform.win32.Kernel32Util.getFileType.
  • Add to platform.win32.Kernel32Util: getFileType.

Bug Fixes

  • Re-build linux-amd and linux-i386 against older versions of glibc (2.2.5 and 2.1.3 respectively).
  • Properly initialize first printer info struct in winspool library.
  • Properly support getting and setting zero-array-length REG_MULTI_SZ values on Win32.
  • Fixed SID in Win32 USER_INFO_23 and GROUP_INFO_3.
  • Fixed passing domain name into Win32 Netapi32Util.getUserInfo.

Release 3.4.0

Features

  • Provide jna.nosys=true to avoid loading any system-provided JNA (useful for local build/development).
  • Allow override of default jnidispatch library name with jna.boot.library.name system property.
  • Throw an Error if a system install of JNA is incompatible or if JNA's JNI library does not match.
  • Disable automatic jnidispatch unpacking with jna.nounpack=true.
  • Automatically look up system error messages for LastErrorException.
  • Improved callback thread-mapping support; re-use, rename, and group callback threads.
  • Cache structure layout results, improving performance of structure creation.
  • linux/arm 32-bit support (hardware provided by Alex Lam).
  • linux/ppc 32-bit support (hardware provided by Fritiof Hedman).
  • Preliminary linux/ia64, linux/ppc64 support (thanks to Laurent Guerby and the GCC compile farm).
  • Windows CE/Mobile support (w32ce-arm) (resources provided by andrea antonello and Hydrologis SRL).
  • linux multi-arch support (kohsuke).
  • Added REG_QWORD registry type support
  • Add to platform.unix.x11: XGrabKey, XUngrabKey, XSetErrorHandler.
  • Add to platform.mac.Carbon: GetEventDispatcherTarget, InstallEventHandler, RegisterEventHotKey, GetEventParameter, RemoveEventHandler, UnregisterEventHotKey.
  • Add to platform.win32.Kernel32: CopyFile, MoveFile, MoveFileEx, CreateProcess, SetEnvironmentVariables, GetFileTime, SetFileTime, SetFileAttributes, DeviceIoControl, GetDiskFreeSpaceEx, CreateToolhelp32Snapshot, Process32First, Process32Next.
  • Add to platform.win32.Msi: MsiGetComponentPath, MsiLocateComponent, MsiGetProductCode, MsiEnumComponents.
  • Add to platform.win32.User32: RegisterHotKey, UnregisterHotKey
  • Add to platform.win32.SetupApi: SetupDiGetClassDevs, SetupDiDestroyDeviceInfoList, SetupDiEnumDeviceInterfaces, SetupDiGetDeviceInterfaceDetail, SetupDiGetDeviceRegistryProperty.
  • Add platform.win32.Shell32.ShellExecute.
  • Add to platform.win32.User32: SetParent, IsWindowVisible, MoveWindow, SetWindowPos, AttachInputThread, SetForegroundWindow, GetForegroundWindow, SetFocus, SendInput, WaitForInputIdle, InvalidateRect, RedrawWindow, GetWindow, UpdateWindow, ShowWindow, CloseWindow.
  • Add to platform.win32.Version: GetFileVersionInfoSize, GetFileVersionInfo, VerQueryValue.
  • Add to platform.win32.Advapi32: GetFileSecurity, RegQueryValueEx(...Long...).
  • Add to platform.win32.Netapi32: NetUserGetInfo.

Bug Fixes

  • Revise cleanup of in-use temporary files on win32 (issue 6).
  • Fix structure alignment issues on linux/ppc.
  • Fix structure alignment issues on linux/arm.
  • Account for NIO Buffer position (JIRA issue 185).
  • Avoid crash with very long Strings (> 150k in length).
  • Fix bug tracking Memory with an associated direct ByteBuffer.
  • Fix bug handling structs by value when type mappers are in effect (JIRA issue 188).

Release 3.3.0

Features

  • Facilitate Memory subclasses (jbellis).
  • Allow multiple fields of the same type in Unions (Francis Barber).
  • Add platform.win32.Advapi32.AdjustTokenPrivileges, platform.win32.Advapi32.LookupPrivilegeName, platform.win32.Advapi32.LookupPrivilegeValue, platform.win32.Advapi32.ImpersonateSelf.
  • Add platform.win32.Advapi32.DuplicateTokenEx, platform.win32.Advapi32.CreateProcessAsUser, platform.win32.Kernel32.GetExitCodeProcess, platform.win32.Kernel32.TerminateProcess, platform.win32.Kernel32.ReadFile, platform.win32.Kernel32.CreatePipe, platform.win32.Kernel32.SetHandleInformation and related constants / structures in platform.win32.WinBase and platform.win32.WinNT. Please note that the SECURITY_ATTRIBUTES structure has been moved from platform.win32.WinNT to platform.win32.WinBase.
  • Add platform.win32.Kernel32.DeleteFile and platform.win32.Kernel32Util.deleteFile.
  • Add platform.win32.Kernel32.GetFileAttributes and platform.win32.Kernel32Util.getFileAttributes.
  • Add platform.win32.Kernel32.GetTickCount.
  • Add Win32 Service functions to platform.win32.Advapi32.
  • Add platform.win32.W32ServiceManager and W32Service.
  • Add Win32 Event Logging functions to platform.win32.Advapi32 and platform.win32.Advapi32Util.EventLogIterator.
  • platform.win32.Advapi32Util.registryCreateKey returns true if key was created, false if it already exists.
  • Add REG_BINARY, REG_EXPAND_SZ and REG_MULTI_SZ support to platform.win32.Advapi32Util registry functions.
  • Reduce JNI crossings in a number of native methods, moving object creation out into pure Java code.

Bug Fixes

  • Move all native functions into com.sun.jna.Native, to ensure that all dependent classes must be disposed before the Native class is unloaded. Note that this change is incompatible with all previous JNA native libraries.
  • Fix platform.win32.Kernel32.GetNativeSystemInfo and GetSystemInfo AV on Win64.
  • Fix several potential minor bugs as reported by TvT.
  • Fix bug in Structure.StructureSet.toString (Blair Zajac), exposed by Tomcat ThreadLocal cleanup.
  • Fix several bugs when using Structure(Pointer) ctor and array fields (Samuel Audet).

Release 3.2.7

Features

  • Add native peer value accessors for Pointer
  • The jna.library.path property is now re-evaluated whenever a native library is loaded. Previously this value was cached when the JNA classes loaded.
  • Native.loadLibrary can now load .drv files.
  • Refactor com.sun.jna.platform.win32.WINBASE into WinDef, WinNT and BaseTSD, matching Windows SDK headers.
  • Refactor constants from com.sun.jna.platform.win32.GDI32 into WinGDI, matching Windows SDK headers.
  • Refactor constants from com.sun.jna.platform.win32.User32 into WinUser, matching Windows SDK headers.
  • Refactor platform.win32.WinNT.LARGE_INTEGER into a union.
  • Add platform.win32.ObjBase, com.sun.jna.platform.win32.Ole32.CoInitializeEx, CoUninitialize, and CoCreateInstance.
  • Add platform.win32.Oleaut32.SysAllocString and SysFreeString.
  • Add platform.win32.Secur32.ImpersonateSecurityContext and RevertSecurityContext.
  • Add platform.win32.WinNT.WELL_KNOWN_SID_TYPE, SECURITY_MAX_SID_SIZE and other related SID-related constants.
  • Add platform.win32.Advapi32.CreateWellKnownSid and IsWellKnownSid and com.sun.jna.platform.win32.Advapi32Util.isWellKnownSid.
  • Add platform.win32.Kernel32.GetVersion, GetVersionEx, GetSystemInfo, GetNativeSystemInfo, GlobalMemoryStatusEx, GetLogicalDriveStrings and IsWow64Process.
  • Add platform.win32.Kernel32Util.getLogicalDriveStrings.
  • Add platform.win32.User32.GetSystemMetrics.
  • Add platform.win32.BaseTSD.DWORD_PTR.
  • Add platform.win32.WinBase.SYSTEM_INFO and MEMORYSTATUSEX.
  • Add platform.win32.WinNT.OSVERSIONINFOEX, VER constants.
  • Add platform.win32.WinDef.ULONGLONG and DWORDLONG.
  • Add platform.win32.Shell32.SHGetDesktopFolder (prep work for Com4JNA).
  • Add platform.win32.Winspool.GetPrinterInfo.
  • Add platform.win32.WinspoolUtil.getPrinterInfo1.
  • Add platform.win32.GDI32.GetDeviceCaps.
  • Add platform.win32.GDI32.GetDIBits.

Bug Fixes

  • Fix ClassCastException in Structure.equals (issue 152).
  • Fix bug initializing a structure object from existing memory when the structure has initialized fields (issue 133).
  • Fix NPE reading an array of string from a pointer when an element of the array is NULL (issue 151).
  • Avoid calling UnregisterNatives in native code (issue 154).
  • Compare unpacked library path against canonical (long) filename (issue 156).
  • Fix read() of uninitialized memory in platform.win32.Advapi32Util.getTokenGroups and getTokenAccount.
  • Fix com.sun.jna.platform.win32.Secur32.QuerySecurityContextToken to take a CtxtHandle instead of PSecHandle.
  • Fix definition of BITMAPINFO (platform/win32).

Release 3.2.5

Features

  • Split code in examples.jar into a contrib platform.jar package and individual packages for demos.
  • Fix Eclipse build and added Eclipse projects for all contrib samples, import projects from jnalib and contrib.
  • Ensure Structure fields correctly ordered when inherited.
  • Use explicit Structure field whenever provided, regardless of whether the VM requires it.
  • Add Win32 mappings for two dozen functions from Kernel32.dll, Advapi32.dll, Netapi32.dll, Secur32.dll, NtDll.dll, Ole32.dll, Shell32.dll and Crypt32.dll to com.sun.jna.platform.win32.
  • Port parts of WinError.h, WinNT.h, LMAccess.h, LMCons.h, LMErr.h, LMJoin.h, NTStatus.h, ShlObj.h, WinDef.h, ShellApi.h, Wdm.h, WinReg.h, WinCrypt.h, Sspi.h, Guid.h, NtSecApi.h and DsGetDc.h.
  • Add Win32 simplified utility interfaces Kernel32Util, Advapi32Util, Netapi32Util, Crypt32Util, NtDllUtil, Shell32Util, Ole32Util and Secur32Util to com.sun.jna.platform.win32.
  • Support unicode paths in W32FileUtils.
  • Fix exception during dispose in W32FileMonitor.

Bug Fixes

  • Provide String.replace for 1.4 compatibility.
  • Avoid allocating memory when Structure is provided a pointer in the ctor.
  • Ensure proper value returned in Pointer.getValue() for non-null, unchanged NIO Buffer values.
  • Use 1.4-compatible URI generation (issue 149).

Release 3.2.4

Features

  • Make Pointer ctor public.
  • Provide access to Function objects for arbitrary Pointer values.
  • Add linux/ia64 binaries (bpiwowar). See issue 134 patch.

Bug Fixes

  • Use a more robust method to decode a file-based URL (issue 135).

Release 3.2.3

Features

  • Include version information in code in case package information lost.

Bug Fixes

  • Fix WindowUtils exception on mouse over TrayIcon.
  • Fix bug toggling windows transparent/opaque (win32/OSX).
  • Avoid overwriting unchanged Pointer values in arrays (function calls with Pointer[] and Structure.read).
  • Ensure Structure fields marked final are never written.
  • Fix bug preventing proper population Structure.ByReference fields on Structure read.
  • Ensure double buffering is disabled in components added to a transparent window.
  • Fix UnsatisfiedLinkError attempting to load system libraries under Web Start.
  • Fix loading Web Start-provided libraries on OSX (libraries must have a .jnilib suffix under Web Start).
  • Properly include sources in Maven zip file (Issue 129).

Release 3.2.2

Features

  • Provide length-specified Pointer.getStringArray()

Bug Fixes

  • Fix crash with direct mapping if NULL struct* used (Issue 125).
  • Fix case where null-valued Structure fields would get non-null values on write.
  • Synch callback Structure/Structure[] arguments on callback return.
  • Fix NPE when mapping an interface to the current process.
  • Automatically load proper C library version from current process on Linux (avoids crashing bug on Ubuntu with libc-i686 packages active).
  • Avoid scanning structure contents in Structure.toString if contents aren't actually used.

Release 3.2.1

Features

  • Add HRESULT, LONG mapping to W32API (marc strapetz).

Bug Fixes

  • Fix definition of HWND_BROADCAST in W32API.
  • Fix memory alignment checking (Issue 121).
  • Fix Structure equals/hashCode implementation, based on current Java fields rather than strictly native memory contents. Avoid using equals/hashCode when avoiding recursive reads/writes.

Release 3.2.0

Features

  • Handle String, Structure, Callback, Buffer, and primitive arrays in direct mappings. Handle NativeMapped and TypeMapper, with optimized paths for IntegerType and PointerType.
  • Optionally throw errno/GetLastError as an exception. This is preferred to (and more efficient than) calling Native.getLastError().
  • Unload/delete native library unpacked from jna.jar if Native class is garbage collected. Only install shutdown hook if using the system class loader.
  • Auto-write contiguous Structure arrays when first element is written.
  • Support NativeMapped[] as function arguments for interface-mapped libraries (Issue 90).
  • Enable function lookup within current process on Windows.

Bug Fixes

  • Restrict recursive structure reads/writes by thread instead of globally. This avoids potentially missed reads/writes with concurrent access (Issue 120).
  • Ensure Memory is not GC'd and freed if direct NIO buffers mapped to it are extant.
  • Allow types derived from java.nio.Buffer as Structure fields.

Release 3.1.0

Features

  • Add raw JNI mapping of static Java methods. Performance is about 10X that of traditional JNA interface mapping, although with less type conversion functionality.
  • Add library option to allow passing/return of Java Objects.
  • Allow handling of uncaught callback exceptions (Issue 63).
  • Object oriented interface to X server (see contrib/x11)
  • Make Memory class more accessible.
  • Provide Structure ctor with Pointer argument (issue 102).
  • Allow implicit library access to current process on linux (issue 98).
  • Open all shared libraries with RTLD_GLOBAL, if applicable. This was the default behavior on OSX and changes the default behavior on linux.
  • Allow NIO Buffer as Structure field (with limitations) (Issue 57)
  • Add size_t size.

Bug Fixes

  • Run tests with libjsig.so, if available, which fixes some crashes when running tests on 64-bit platforms.
  • Fix Issue 104.
  • Fix Issue 94 (Java 1.6 update 10 regression).
  • Fix Issue 51 (Java 1.6 update 10 regression).
  • Fix Issue 95.
  • Fix Issue 101.
  • Fix Issue 111, memory leak with String-returning Callback.
  • Fix missing storage of union type information (affects usage of struct/union by value as argument and return type).
  • Remove non-functional Structure ctors requiring explicit size.

Release 3.0.9

Bug Fixes

  • Fix issue 93 by only manually searching jna.library.path, then falling back to passing the mapped library name to dlopen/LoadLibrary. This fixes an issue in JRUBY where the incorrect libc.so.6 was being loaded.

Release 3.0.8

Features

  • Auto-map Pointer[]/String[]/WString[] return values.
  • Provide utility functions to convert String to primitive array.
  • Add jna.library.boot.path property to define the directory that the native stub library is loaded from

Release 3.0.7

Features

  • Improve Win32 loading of libraries with dependencies.

Bug Fixes

  • Fix bug reading structures with PointerType fields, introduced with Pointer field preservation fix.

Release 3.0.6

Features

  • Allow arbitrary callback method names if only one method is defined in the class which implements Callback (colinwalters).
  • Allow specification of callback type mappers by using a TYPE_MAPPER field (colinwalters).
  • Allow uninitialized (null-valued) boxed primitives in Structures (colinwalters).
  • Add convenience methods to set active Union field and value simultaneously (xylo).
  • Augment Union read/writeField to set the active field.
  • Allow Structure auto-synch across native calls to be disabled.
  • Win64 support.

Bug Fixes

  • Avoid overwriting unchanged Structure fields of type Pointer.
  • Avoid more content dragging on OSX or warn if it's too late.
  • Fix UnsatisfiedLinkError using transparent window on Win2K.
  • Fix memory leak with callbacks called from native threads with no Java context (johnwallace).
  • Defer structure size calculation if type mapper not yet set, allowing type mapper to be set in derived constructors (colinwalters).
  • Ensure structure memory is allocated in Structure.read/writeField.

Release 3.0.5

Features

  • Allow explicit declaration of field order for VMs which have an unpredictable field order.
  • Check for w32 libraries with a "lib" prefix in addition to normal lookup.
  • Allow String[]/WString[] as callback argument/return value (assume NULL-terminated array).
  • Add Solaris8 compatibility to sunos-sparc build (Corey Puffalt).
  • Look up libraries using web start library path, if appropriate (Corey Puffalt).
  • Use constants to return integer boolean values.

Bug Fixes

  • Properly track cursor on alpha-masked windows.
  • Avoid searching /lib or /usr/lib on 64-bit Linux.
  • Avoid using incorrect version of a library when both 32- and 64-bit versions are found.
  • Avoid transparent window events always dragging window bug on OSX.
  • Fix division by zero error calculating structure size on OSX/ppc.
  • Avoid overwriting initialized NativeMapped Structure fields when calculating structure size.
  • Fix NPE reading back into StringArray.

Release 3.0.4

Features

  • Automatically write contents of Structure.ByReference fields on Structure.write().
  • Use the actual parameter type in Function invocations if no parameter type information is available (whether method is missing or untyped varargs).
  • Augmented X11 library mappings (xylo).
  • Support read/write of NativeMapped arrays within Structure (notably NativeLong).

Bug Fixes

  • Fix library load error when /usr/lib32 and /usr/lib both exist (linux) (Marek Slama).
  • Avoid incorrect matches against libraries named with the same prefix (e.g. libc-client.so vs libc.so) (xylo).
  • Properly handle arrays of NativeMapped (e.g. NativeLong) as a Structure field (stefan endrullis).
  • Ensure structure size calculated prior to setting union active type.
  • XID is 64-bits on 64-bit X clients (xylo).
  • Ensure proper arch name is used on Debian (amd64 instead of x86_64).

Release 3.0.3

Features

  • Enable build/run using IBM's J9 VM (leonardo).
  • Make StdCallFunctionMapper attempt a leading underscore if the simpler mapping doesn't work.
  • Allow Structure.read to overwrite final fields (may not work on some 1.4 VMs).

Bug Fixes

  • Fix NPE when passing an array of Structure.ByReference.
  • Compare entire linux library version when finding a match.
  • Don't pass struct by value unless the method signature declares it.
  • Restrict custom first element structure alignment to OSX/ppc.
  • Improve performance and reduce memory footprint for window masks. Optimize polygon-based masks on w32. Use XFillRectangles on X11.
  • Fix linkage settings on sunos-amd64 to avoid relocation errors.
  • Fix callback allocation code on w32, solaris, freebsd, darwin (libffi was misconfigured).
  • Fix bug when NativeMapped fields are used in a Structure.ByValue instance.
  • Fix NPE calling Structure.read() before memory is initialized.
  • Fix NPE calling Structure.read/write with uninitialized NativeMapped fields.

Release 3.0.2

Features

  • Attempt to force unload of jnidispatch library prior to deleting it (w32).
  • Added amd64 targets for OSX, FreeBSD, and Solaris.

Bug Fixes

  • Reduce space allocated for invocation arguments.
  • Fix NPE when NativeMapped type is used in a Structure.
  • Fix some X11 type mappings for 64-bit.
  • Fix OSX Leopard/JRE1.5+ window transparency.
  • Fix window alpha compositing on X11.
  • Fix loading of libraries with unicode names on OSX.

Release 3.0.1

Features

  • Improve transparent window drawing performance on w32
  • Use closure allocation from libffi

Bug Fixes

  • Ensure nested structure arrays initialized with Structure.toArray use the appropriate native memory.
  • Ensure structure size is calculated prior to converting to array
  • Avoid creating new windows when setting a window mask
  • Fix bug in Pointer.setChar.

Release 3.0

Features

  • More supported platforms, via GCC's libffi (wmeissner)
  • Support struct by value as parameter and return value (duncan)
  • Support struct by reference within structures
  • Provide access to native peer for java.awt.Component
  • Provide access to native peer on OS X.
  • Support MINGW32 builds (fullung)
  • Allow per-field Structure read/write by field name
  • Avoid writing Structure fields marked 'volatile'
  • Read and wrap function pointers in Structure fields when read with a Java proxy to allow easy Java-side invocation (Ken Larson)
  • Support array-backed Buffers as arguments (wmeissner)
  • Auto-conversion of custom types (wmeissner)
  • Allow pointer type-safety
  • Optional VM crash protection, via Native.setProtected(boolean)
  • Auto-convert WString[]
  • Provide library synchronization wrapper similar to Collections.synchronizedX
  • Support lookup of OSX framework libraries by name
  • Explicit access to shared library global data
  • Invocation interception to facilitate translation of C preprocessor macros and inline functions
  • Provide utility to determine Web Start native library cache location; auto-include this path if jnidispatch is included as a <nativelib> (robertengels)
  • Provide access to aligned memory
  • Versioning information embedded in jna.jar and native library

Bug Fixes

  • Avoid attempts to free native library if it failed to load (wmeissner)
  • Explicitly check method signatures for varargs instead of heuristically guessing (wmeissner)
  • Disallow declaring Pointer-derived fields in Structures (Function, Memory)
  • Ensure Object.toString/hashCode/equals methods are intercepted on proxyied interfaces
  • Update X11 library for 64-bit use (wmeissner)
  • Properly map arrays of char*/wchar_t* under w32
  • Allow Pointer[] as a Structure field and Function argument
  • Fix some misleading Structure error messages
  • Properly preserve/return GetLastError/errno after native calls
  • Allocate executable memory on w32 to avoid errors with hardware-enforced data execution protection (DEP)
  • Fix VM crash on w32 stdcall callbacks
  • Use long offsets and sizes rather than ints (64-bit safe)
  • Properly clean up references and release closure memory on JNI_Unload
  • Use simpler AWT/JAWT library loading workaround
  • Avoid changing array references within a Structure on read

Release 2.5

Features

  • Unions
  • Optimized shaped windows (chris deckers & olivier chafik); instantiation time improved by about 2-3 orders of magnitude for large, mostly contiguous shapes
  • Provide type mapping in callback arguments/results
  • Provide access to ByteBuffer direct address as a Pointer
  • Provide customization of native string encoding with jna.encoding system property

Bug Fixes

  • Properly handle VMs with reversed Structure member storage
  • Avoid making window undecorated when clearing window mask on X11
  • Fix structure alignment bug on OSX/PPC when first element is > 4 bytes in size
  • Clearing OSX window mask by setting to MASK_NONE now works properly
  • Avoid index exceptions if native buffers are not NUL-terminated on string conversions
  • Write initialized Structure[] argument memory prior to function calls
  • Fix IllegalArgumentException reading WString into a Structure
  • Clear memory when allocating a structure block (fixes VM crash)
  • Remove versioned JAWT dependency on OSX, allowing use on 10.3/JRE1.4.

Release 2.4

Features

  • Explicitly support unaligned structures
  • Auto-reallocate structure arrays
  • Automatic handling of w32 UNICODE/ASCII variants
  • Automatic mapping of decorated w32 stdcall function names
  • Customizable, automatic type conversion of arguments and results (wmeissner)
  • Support char*[] arguments as Java String[]
  • Structure supports Callback members (wmeissner)
  • getByteBuffer from Pointer/Memory (wmeissner)
  • Allow GC of native libraries
  • Facilitate use from non-Java contexts (JRuby et al.) (wmeissner)
  • Improve library path searching (wmeissner)
  • Handle Structure[] arguments
  • Handle native long arguments and return values
  • Handle direct and array-based ByteBuffer arguments (wmeissner)
  • Change default w32 build to use GCC (it's free, yo)

Bug Fixes

  • Structure.toArray failed to initialize members
  • Disallow explicit free of Structure/Memory
  • Ensure native libraries are only loaded once until released
  • Properly handle NULL when the return value is a Structure
  • Proper conversion to wchar_t on linux
  • Copy full length of Java strings to C strings instead of stopping when a NUL character is encountered