Java: Add 'EnvironmentConfiguredTracer'

Adding 'ppaml_tracer_init_from_env' (commit b9dfb8d0) makes the Java
code substantially more complicated, as it introduces a second mechanism
to construct 'Tracer's.  While I could simply provide two constructors
in the 'Tracer' class, this would make for an ugly and dangerous
implementation; after all, the life cycle of a tracer configured
explicitly is noticeably different from the life cycle of a tracer
configured by sourcing environment variables.  Instead, I’ve changed
'Tracer' to be an interface implemented by 'ExplicitlyConfiguredTracer'
and 'EnvironmentConfiguredTracer'.

This is an API-breaking change.

1 files changed, 86 insertions, 0 deletions

diff --git a/bindings/java/src/c/com_galois_ppaml_tracer_TracerCWrapper.c b/bindings/java/src/c/com_galois_ppaml_tracer_TracerCWrapper.c
new file mode 100644
index 0000000..19a313c
--- /dev/null
+++ b/bindings/java/src/c/com_galois_ppaml_tracer_TracerCWrapper.c
@@ -0,0 +1,86 @@
+/* com_galois_ppaml_tracer_TracerCWrapper.c -- JNI wrapper for
+ *     com.galois.ppaml.tracer.TracerCWrapper
+ * Copyright (C) 2014  Galois, Inc.
+ *
+ * This library is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License as published by the Free
+ * Software Foundation, either version 3 of the License, or (at your option)
+ * any later version.
+ *
+ * This library is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
+ * more details.
+ *
+ * You should have received a copy of the GNU General Public License along with
+ * this library.  If not, see <http://www.gnu.org/licenses/>.
+ *
+ * To contact Galois, complete the Web form at
+ * <http://corp.galois.com/contact/> or write to Galois, Inc., 421 Southwest
+ * 6th Avenue, Suite 300, Portland, Oregon, 97204-1622. */
+
+#include <stdlib.h>
+
+#include <ppaml/tracer.h>
+
+#include <jni.h>
+#include <com_galois_ppaml_tracer_TracerCWrapper.h>
+
+#include "pointer.h"
+
+JNIEXPORT
+jlong JNICALL Java_com_galois_ppaml_tracer_TracerCWrapper_mallocTracer(
+	JNIEnv *const env,
+	jclass Tracer)
+{
+	return jlong_of_pointer(malloc(sizeof(ppaml_tracer_t)));
+}
+
+JNIEXPORT
+jint JNICALL Java_com_galois_ppaml_tracer_TracerCWrapper_ppaml_1tracer_1init(
+	JNIEnv *const env,
+	jclass Tracer,
+	jlong tracer,
+	jstring reportNameBase)
+{
+	jint r;
+	// Allocate memory.
+	const char *const cReportNameBase =
+		(*env)->GetStringUTFChars(env, reportNameBase, NULL);
+	if (cReportNameBase == NULL) {
+		r = -1;
+		goto done;
+	}
+	// Perform the operation.
+	r = ppaml_tracer_init(pointer_of_jlong(tracer), cReportNameBase);
+	// Clean up.
+done:	(*env)->ReleaseStringUTFChars(env, reportNameBase, cReportNameBase);
+	return r;
+}
+
+JNIEXPORT
+jint JNICALL Java_com_galois_ppaml_tracer_TracerCWrapper_ppaml_1tracer_1init_1from_1env(
+	JNIEnv *const env,
+	jclass Tracer,
+	jlong tracer)
+{
+	return ppaml_tracer_init_from_env(pointer_of_jlong(tracer));
+}
+
+JNIEXPORT
+jint JNICALL Java_com_galois_ppaml_tracer_TracerCWrapper_ppaml_1tracer_1done(
+	JNIEnv *const env,
+	jclass Tracer,
+	jlong tracer)
+{
+	return ppaml_tracer_done(pointer_of_jlong(tracer));
+}
+
+JNIEXPORT
+void JNICALL Java_com_galois_ppaml_tracer_TracerCWrapper_freeTracer(
+	JNIEnv *const env,
+	jclass Tracer,
+	jlong tracer)
+{
+	free(pointer_of_jlong(tracer));
+}