#22 Lock.label()

Author: Yegor Bugayenko

src/main/java/co/stateful/Lock.java

@@ -49,6 +49,14 @@ public interface Lock {
      */
     String name();
 
+    /**
+     * Read label (or empty text if lock doesn't exist).
+     * @return Label of this lock (if the lock exists), or empty string
+     * @throws IOException If any problem inside
+     * @since 0.15
+     */
+    String label() throws IOException;
+
     /**
      * Lock with label.
      * @param label Label to attach

src/main/java/co/stateful/RtLock.java

@@ -80,6 +80,23 @@ public String name() {
         return this.lck;
     }
 
+    @Override
+    public String label() throws IOException {
+        final long start = System.currentTimeMillis();
+        final String label = this.front("label")
+            .uri().queryParam("name", this.lck).back()
+            .method(Request.GET)
+            .fetch()
+            .body();
+        Logger.info(
+            this, "label of \"%s\" retrieved in %[ms]s: \"%s\"",
+            this.lck,
+            System.currentTimeMillis() - start,
+            label
+        );
+        return label;
+    }
+
     @Override
     public boolean lock(final String label) throws IOException {
         final long start = System.currentTimeMillis();

src/main/java/co/stateful/mock/MkLock.java

@@ -53,6 +53,11 @@ public String name() {
         return this.getClass().getName();
     }
 
+    @Override
+    public String label() {
+        return "label";
+    }
+
     @Override
     public boolean lock(final String label) {
         return true;

src/main/java/co/stateful/retry/ReLock.java

@@ -75,6 +75,16 @@ public String name() {
         return this.origin.name();
     }
 
+    @Override
+    @RetryOnFailure
+        (
+            verbose = false, attempts = Tv.TWENTY,
+            delay = Tv.TWENTY, unit = TimeUnit.SECONDS
+        )
+    public String label() throws IOException {
+        return this.origin.label();
+    }
+
     @Override
     @RetryOnFailure
         (