Release 2.2.0

Release Notes: Version 2.2.0

We are excited to announce the release of version 2.2.0 of the jNetPcap Wrapper! This release includes several significant updates and enhancements:

Key Updates

• JDK 22 Support: This version now fully supports JDK 22, allowing you to leverage the latest features and improvements of the Java platform.
• Foreign Function API Updates: The Foreign Function (FF) API has been updated to the final version in JDK 22. This includes numerous improvements and optimizations for better performance and usability.
  • Special thanks to @hamid-nazari for your invaluable contributions and updates to the FF API integration.

Detailed Changes

JDK 22 Integration:

• Updated the project to support JDK 22, ensuring compatibility and allowing users to take advantage of the latest Java enhancements.
• Final FF API Implementation:
  • Integrated the final version of the Foreign Function API from JDK 22, enhancing the way native functions are accessed and utilized within the application.

Acknowledgments

We would like to extend our gratitude to all contributors and users who provided feedback and suggestions. Special thanks to @hamid-nazari for your contributions to the FF API updates.

v2.0.0

Production release version 2.0.0

Full production release of jNetPcap v2 API with up to native libpcap 1.10 API compatibility.

JDK Compatibility

jNetPcap library relies on Panama Foreign Function and Memory (JEP 442) feature which has been released but as a JDK preview feature, the release provides binary files for multiple JDKs to enable its usage.

Provides binary jar file support for the following JDKs with Foreign Function support:

• JDK19 (preview feature 1)
• JDK20 (preview feature 2)
• JDK21 LTS (preview feature 3)
• JDK22 FFM fully incorporated as part JDK public API, no --enable-preview command line options required

Note: JDK 22 as of this release is an "early-access" JDK.
Note: when using JDK 19, 20 or 21, the --enable-preview command line option is required to enable JDK feature preview of Panama FFM (JEP 442) feature.
Note: the command line option --enable-native-access=org.jnetpcap is required to allow jNetPcap access to native functions and memory.

All future releases (2.1.0 +) will only provide JDK 21 LTS and JDK 22 binary support going forward. JDK 19 and 20 binaries will not be provided in future releases.

What's Changed

• Initial public jNetPcap API release for up to libpcap 1.10 API

v2.0.0-alpha.2

jNetPcap v2.X relies exclusively on Foreign Function feature currently in JDK preview which allows binding to native libraries without the need of use of JNI or any other external modules such as JNA.

• This release updated the public API by merging PcapHandler types for use in main Pcap class, from what used to be a separate PcapReceiver class. This simplifies the usage of the library.
• A better implementation of PcapHeader has been provided, while reducing the number of implementing classes to a single class.
• A internal implementation hook has been provided to allow the module jnetpcap-pro to extend and provide protocol level features
• Issue #28 was fixed which prevented proper usage in Windows based systems due to incorrect ABI being selected on x64 bit systems
• Several system properties which override certain behaviors were added, including manual ABI selection

Note: JDK 20 has been released and work has begun to make the neccessary changes to the FF dependent parts of jNetPcap code. This means that current implementation of this release which is dependent on "exact" JDK 19 Foreign Function feature API and is incompatible with JDK 20 and beyond. However the public API will be identical in future jNetPcap releases making this release the only backward compatible to be used with JDK19.

Note: The next release "alpha.3" will provide compatibility with the JDK 20 Foreign Function feature.

v2.0.0-alpha.1

This release is a preview release that requires JDK 19 specifically.

jNetPcap v2.X relies exclusively on Foreign Function feature currently in JDK preview which allows binding to native libraries without the need of use of JNI or any other external modules such as JNA.

It has been announced by the JDK developers that Foreign Function feature will go further refinement in next release of JDK 20. This means that current implementation of this release which is dependent on "exact" JDK 19 Foreign Function feature API and will be incompatible with future JDK 20.
A new release "alpha.2" will be provided at the time with updated usage of the JDK 20 Foreign Function feature.

What's Changed

• importing from private repo by @slytechs-repos in #1
• Removed bin and target folders by @slytechs-repos in #2
• Added NetIp4Address class to to simplify return value of Pcap.lookupNet by @slytechs-repos in #4
• fixed up invalid javadoc tag by @slytechs-repos in #5
• fixed up all javadoc errors and warnings by @slytechs-repos in #6
• Changed from plural form of time units to singular, which was a typo by @slytechs-repos in #7
• Added platform depedent Profiles to pom.xml. Added 'osx-homebrew' and… by @slytechs-repos in #10
• Working on standalone javadoc in pom.xml file by @slytechs-repos in #11
• Cleaned up Foreign Function upcall implementation by @slytechs-repos in #12
• Cleanup of javadoc comments by @slytechs-repos in #14

New Contributors

• @slytechs-repos made their first contribution in #1

Full Changelog: https://github.com/slytechs-repos/jnetpcap/commits/v2.0.0-alpha.1