Add JBuffer, JByteBuffer to enable fast copying to and from `Uint…

…8List` (#390) `JBuffer` is now the default binding for `java.nio.Buffer` and `JByteBuffer` for `java.nio.ByteBuffer`.
dart-archive · Sep 13, 2023 · 4443ceb · 4443ceb
1 parent 7c83776
commit 4443ceb
Show file tree

Hide file tree

Showing 45 changed files with 1,071 additions and 175 deletions.
diff --git a/jni/CHANGELOG.md b/jni/CHANGELOG.md
@@ -1,33 +1,57 @@
+## 0.7.0
+
+- **Breaking Change** ([#387](https://github.com/dart-lang/jnigen/issues/387)):
+  Added `JBuffer` and `JByteBuffer` classes as default classes for
+  `java.nio.Buffer` and `java.nio.ByteBuffer` respectively.
+- **Breaking Change**: Made the type classes `final`.
+- Fixed a bug where `addAll`, `removeAll` and `retainAll` in `JSet` would run
+  their respective operation twice.
+- Fixed a bug where `JList.insertAll` would not throw the potentially thrown
+  Java exception.
+
 ## 0.6.1
-* Depend on the stable version of Dart 3.1.
+
+- Depend on the stable version of Dart 3.1.
 
 ## 0.6.0
-* **Breaking Change** ([#131](https://github.com/dart-lang/jnigen/issues/131)): Renamed `delete*` to `release*`.
-* Added `PortProxy` and related methods used for interface implementation.
-* Added the missing binding for `java.lang.Character`.
+
+- **Breaking Change** ([#131](https://github.com/dart-lang/jnigen/issues/131)):
+  Renamed `delete*` to `release*`.
+- Added `PortProxy` and related methods used for interface implementation.
+- Added the missing binding for `java.lang.Character`.
 
 ## 0.5.0
-* **Breaking Change** ([#137](https://github.com/dart-lang/jnigen/issues/137)): Java primitive types are now all lowercase like `jint`, `jshort`, ...
-* The bindings for `java.util.Set`, `java.util.Map`, `java.util.List` and the numeric types like `java.lang.Integer`, `java.lang.Boolean`, ... are now included in `package:jni`.
+
+- **Breaking Change** ([#137](https://github.com/dart-lang/jnigen/issues/137)):
+  Java primitive types are now all lowercase like `jint`, `jshort`, ...
+- The bindings for `java.util.Set`, `java.util.Map`, `java.util.List` and the
+  numeric types like `java.lang.Integer`, `java.lang.Boolean`, ... are now
+  included in `package:jni`.
 
 ## 0.4.0
-* Type classes now have `superCount` and `superType` getters used for type inference.
+
+- Type classes now have `superCount` and `superType` getters used for type
+  inference.
 
 ## 0.3.0
-* Added `PortContinuation` used for `suspend fun` in Kotlin.
-* `dartjni` now depends on `dart_api_dl.h`.
+
+- Added `PortContinuation` used for `suspend fun` in Kotlin.
+- `dartjni` now depends on `dart_api_dl.h`.
 
 ## 0.2.1
-* Added `.clang-format` to pub.
+
+- Added `.clang-format` to pub.
 
 ## 0.2.0
-* Added array support
-* Added generic support
-* `JniX` turned into `JX` for a more terse code.
+
+- Added array support
+- Added generic support
+- `JniX` turned into `JX` for a more terse code.
 
 ## 0.1.1
-* Windows support for running tests and examples on development machines.
+
+- Windows support for running tests and examples on development machines.
 
 ## 0.1.0
-* Initial version: Android and Linux support, JObject API
 
+- Initial version: Android and Linux support, JObject API
diff --git a/jni/lib/jni.dart b/jni/lib/jni.dart
@@ -71,6 +71,7 @@ export 'src/jobject.dart';
 export 'src/jprimitives.dart';
 export 'src/jreference.dart' show JReferenceUseExtension;
 export 'src/lang/lang.dart';
+export 'src/nio/nio.dart';
 export 'src/util/util.dart';
 
 export 'package:ffi/ffi.dart' show using, Arena;

diff --git a/jni/lib/jni_symbols.yaml b/jni/lib/jni_symbols.yaml
@@ -75,3 +75,11 @@ files:
           'java.lang.Object': DECLARED
         V:
           'java.lang.Object': DECLARED
+    'java.nio.Buffer':
+      name: JBuffer
+      type_class: JBufferType
+      super_count: 1
+    'java.nio.ByteBuffer':
+      name: JByteBuffer
+      type_class: JByteBufferType
+      super_count: 2
diff --git a/jni/lib/src/jarray.dart b/jni/lib/src/jarray.dart
@@ -16,7 +16,7 @@ import 'jobject.dart';
 import 'jprimitives.dart';
 import 'types.dart';
 
-class JArrayType<T> extends JObjType<JArray<T>> {
+final class JArrayType<T> extends JObjType<JArray<T>> {
   final JType<T> elementType;
 
   const JArrayType(this.elementType);

diff --git a/jni/lib/src/jobject.dart b/jni/lib/src/jobject.dart
@@ -19,7 +19,7 @@ import 'types.dart';
 // type switch like a regular type.
 typedef _VoidType = void;
 
-class JObjectType extends JObjType<JObject> {
+final class JObjectType extends JObjType<JObject> {
   const JObjectType();
 
   @override

diff --git a/jni/lib/src/lang/jboolean.dart b/jni/lib/src/lang/jboolean.dart
@@ -9,7 +9,7 @@ import '../jni.dart';
 import '../third_party/generated_bindings.dart';
 import '../types.dart';
 
-class JBooleanType extends JObjType<JBoolean> {
+final class JBooleanType extends JObjType<JBoolean> {
   const JBooleanType();
 
   @override

diff --git a/jni/lib/src/lang/jbyte.dart b/jni/lib/src/lang/jbyte.dart
@@ -9,7 +9,7 @@ import '../third_party/generated_bindings.dart';
 import '../types.dart';
 import 'jnumber.dart';
 
-class JByteType extends JObjType<JByte> {
+final class JByteType extends JObjType<JByte> {
   const JByteType();
 
   @override

diff --git a/jni/lib/src/lang/jcharacter.dart b/jni/lib/src/lang/jcharacter.dart
@@ -6,7 +6,7 @@ import '../jvalues.dart';
 import '../third_party/generated_bindings.dart';
 import '../types.dart';
 
-class JCharacterType extends JObjType<JCharacter> {
+final class JCharacterType extends JObjType<JCharacter> {
   const JCharacterType();
 
   @override

diff --git a/jni/lib/src/lang/jdouble.dart b/jni/lib/src/lang/jdouble.dart
@@ -8,7 +8,7 @@ import '../third_party/generated_bindings.dart';
 import '../types.dart';
 import 'jnumber.dart';
 
-class JDoubleType extends JObjType<JDouble> {
+final class JDoubleType extends JObjType<JDouble> {
   const JDoubleType();
 
   @override

diff --git a/jni/lib/src/lang/jfloat.dart b/jni/lib/src/lang/jfloat.dart
@@ -9,7 +9,7 @@ import '../third_party/generated_bindings.dart';
 import '../types.dart';
 import 'jnumber.dart';
 
-class JFloatType extends JObjType<JFloat> {
+final class JFloatType extends JObjType<JFloat> {
   const JFloatType();
 
   @override

diff --git a/jni/lib/src/lang/jinteger.dart b/jni/lib/src/lang/jinteger.dart
@@ -9,7 +9,7 @@ import '../third_party/generated_bindings.dart';
 import '../types.dart';
 import 'jnumber.dart';
 
-class JIntegerType extends JObjType<JInteger> {
+final class JIntegerType extends JObjType<JInteger> {
   const JIntegerType();
 
   @override

diff --git a/jni/lib/src/lang/jlong.dart b/jni/lib/src/lang/jlong.dart
@@ -8,7 +8,7 @@ import '../third_party/generated_bindings.dart';
 import '../types.dart';
 import 'jnumber.dart';
 
-class JLongType extends JObjType<JLong> {
+final class JLongType extends JObjType<JLong> {
   const JLongType();
 
   @override

diff --git a/jni/lib/src/lang/jnumber.dart b/jni/lib/src/lang/jnumber.dart
@@ -17,7 +17,7 @@ import 'jinteger.dart';
 import 'jlong.dart';
 import 'jshort.dart';
 
-class JNumberType extends JObjType<JNumber> {
+final class JNumberType extends JObjType<JNumber> {
   const JNumberType();
 
   @override

diff --git a/jni/lib/src/lang/jshort.dart b/jni/lib/src/lang/jshort.dart
@@ -9,7 +9,7 @@ import '../third_party/generated_bindings.dart';
 import '../types.dart';
 import 'jnumber.dart';
 
-class JShortType extends JObjType<JShort> {
+final class JShortType extends JObjType<JShort> {
   const JShortType();
 
   @override

diff --git a/jni/lib/src/lang/jstring.dart b/jni/lib/src/lang/jstring.dart
@@ -12,7 +12,7 @@ import '../jobject.dart';
 import '../third_party/generated_bindings.dart';
 import '../types.dart';
 
-class JStringType extends JObjType<JString> {
+final class JStringType extends JObjType<JString> {
   const JStringType();
 
   @override