add the PathConstraintPathRef class

src/main/java/com/github/stephengold/joltjni/PathConstraintPathRef.java

@@ -0,0 +1,96 @@
+/*
+Copyright (c) 2024 Stephen Gold
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+ */
+package com.github.stephengold.joltjni;
+
+import com.github.stephengold.joltjni.template.Ref;
+
+/**
+ * A counted reference to a {@code PathConstraintPath}. (native type:
+ * {@code Ref<PathConstraintPath>})
+ *
+ * @author Stephen Gold [email protected]
+ */
+final public class PathConstraintPathRef extends Ref {
+    // *************************************************************************
+    // constructors
+
+    /**
+     * Instantiate an empty reference.
+     */
+    public PathConstraintPathRef() {
+        long refVa = createEmpty();
+        setVirtualAddress(refVa, () -> free(refVa));
+    }
+
+    /**
+     * Instantiate a reference with the specified native object assigned.
+     *
+     * @param refVa the virtual address of the native object to assign (not
+     * zero)
+     * @param owner {@code true} &rarr; make the JVM object the owner,
+     * {@code false} &rarr; it isn't the owner
+     */
+    PathConstraintPathRef(long refVa, boolean owner) {
+        Runnable freeingAction = owner ? () -> free(refVa) : null;
+        setVirtualAddress(refVa, freeingAction);
+    }
+    // *************************************************************************
+    // Ref methods
+
+    /**
+     * Temporarily access the referenced {@code PathConstraintPath}.
+     *
+     * @return a new JVM object with the pre-existing native object assigned
+     */
+    @Override
+    public PathConstraintPath getPtr() {
+        long refVa = va();
+        long pathVa = getPtr(refVa);
+        PathConstraintPath result = new PathConstraintPath(pathVa);
+
+        return result;
+    }
+
+    /**
+     * Create a counted reference to the native {@code PathConstraintPath}.
+     *
+     * @return a new JVM object with a new native object assigned
+     */
+    @Override
+    public PathConstraintPathRef toRef() {
+        long refVa = va();
+        long copyVa = copy(refVa);
+        PathConstraintPathRef result = new PathConstraintPathRef(copyVa, true);
+
+        return result;
+    }
+    // *************************************************************************
+    // native private methods
+
+    native private static long copy(long refVa);
+
+    native private static long createEmpty();
+
+    native private static void free(long refVa);
+
+    native private static long getPtr(long refVa);
+}