allow library users to get the value of characteristics themselves

so they can also generically get the value, regardless of how they
decided to fulfill it, without having to also keep track themselves

Author: ccutrer

src/main/java/io/github/hapjava/characteristics/impl/base/BaseCharacteristic.java

@@ -190,7 +190,7 @@ public void unsubscribe() {
    *
    * @return a future that will complete with the current value.
    */
-  protected abstract CompletableFuture<T> getValue();
+  public abstract CompletableFuture<T> getValue();
 
   /**
    * Supplies a default value for the characteristic to send to connected clients when the real

src/main/java/io/github/hapjava/characteristics/impl/base/BooleanCharacteristic.java

@@ -60,7 +60,7 @@ protected Boolean convert(JsonValue jsonValue) {
   }
 
   @Override
-  protected CompletableFuture<Boolean> getValue() {
+  public CompletableFuture<Boolean> getValue() {
     return getter.isPresent() ? getter.map(booleanGetter -> booleanGetter.get()).get() : null;
   }
 

src/main/java/io/github/hapjava/characteristics/impl/base/EnumCharacteristic.java

@@ -84,8 +84,19 @@ protected Integer convert(JsonValue jsonValue) {
     }
   }
 
+  /**
+   * @return the current value of this characteristic, or null if it has no value or can't be
+   *     fetched
+   */
+  public CompletableFuture<T> getEnumValue() {
+    if (!getter.isPresent()) {
+      return null;
+    }
+    return getter.get().get();
+  }
+
   @Override
-  protected CompletableFuture<Integer> getValue() {
+  public CompletableFuture<Integer> getValue() {
     if (!getter.isPresent()) {
       return null;
     }

src/main/java/io/github/hapjava/characteristics/impl/base/FloatCharacteristic.java

@@ -94,7 +94,7 @@ protected Double convert(JsonValue jsonValue) {
    * the constructor.
    */
   @Override
-  protected final CompletableFuture<Double> getValue() {
+  public final CompletableFuture<Double> getValue() {
     if (!getter.isPresent()) {
       return null;
     }

src/main/java/io/github/hapjava/characteristics/impl/base/IntegerCharacteristic.java

@@ -71,7 +71,7 @@ protected CompletableFuture<JsonObjectBuilder> makeBuilder(int iid) {
   }
 
   @Override
-  protected CompletableFuture<Integer> getValue() {
+  public CompletableFuture<Integer> getValue() {
     return getter.map(integerGetter -> integerGetter.get()).orElse(null);
   }
 

src/main/java/io/github/hapjava/characteristics/impl/base/StaticStringCharacteristic.java

@@ -59,7 +59,7 @@ public void setValue(String value) throws Exception {
 
   /** {@inheritDoc} */
   @Override
-  protected CompletableFuture<String> getValue() {
+  public CompletableFuture<String> getValue() {
     return getter.map(stringGetter -> stringGetter.get()).orElse(null);
   }
 

src/main/java/io/github/hapjava/characteristics/impl/base/StringCharacteristic.java

@@ -68,7 +68,7 @@ public void setValue(String value) throws Exception {
 
   /** {@inheritDoc} */
   @Override
-  protected CompletableFuture<String> getValue() {
+  public CompletableFuture<String> getValue() {
     return getter.map(stringGetter -> stringGetter.get()).orElse(null);
   }