Add option to attach a context to refer.

Introduce a lightweight debug mode.

1 files changed, 22 insertions, 0 deletions

diff --git a/jdisc_core/src/main/java/com/yahoo/jdisc/refcount/References.java b/jdisc_core/src/main/java/com/yahoo/jdisc/refcount/References.java
new file mode 100644
index 00000000000..35b4e7c759e
--- /dev/null
+++ b/jdisc_core/src/main/java/com/yahoo/jdisc/refcount/References.java
@@ -0,0 +1,22 @@
+// Copyright Yahoo. Licensed under the terms of the Apache 2.0 license. See LICENSE in the project root.
+package com.yahoo.jdisc.refcount;
+
+import com.yahoo.jdisc.ResourceReference;
+
+/**
+ * Interface for implementations of reference counting
+ * @author baldersheim
+ */
+public interface References {
+    /** Release the initial reference */
+    void release();
+    /** Returns number of held references */
+    int referenceCount();
+    /**
+     *  Adds a reference and return an objects that when closed will return the reference.
+     *  Supply a context that can provide link to the one holding the link. Useful for debugging
+     */
+    ResourceReference refer(Object context);
+
+    String currentState();
+}