#567 fix version and javadoc

marker/README.md

@@ -10,20 +10,20 @@ tags:
 ---
 
 ## Intent
-Using empy interfaces as markers to distinguish special treated objects.
+Using empty interfaces as markers to distinguish special treated objects.
 
 ![alt text](./etc/MarkerDiagram.png "Marker Interface")
 
 ## Applicability
 Use the Marker Interface pattern when
 
-* you want to identify the special objects from normal objects
+* you want to identify the special objects from normal objects (to treat them differently)
-* define a type that is implemented by instances of the marked class, marker annotations can not do that
+* you want to mark that some object is available for certain sort of operations
 
 ## Real world examples
 
-* [javase.7.docs.api.java.io.Serializable](https://docs.oracle.com/javase/7/docs/api/java/io/Serializable.html)
+* [javase.8.docs.api.java.io.Serializable](https://docs.oracle.com/javase/8/docs/api/java/io/Serializable.html)
-* [javase.7.docs.api.java.lang.Cloneable](https://docs.oracle.com/javase/7/docs/api/java/lang/Cloneable.html)
+* [javase.8.docs.api.java.lang.Cloneable](https://docs.oracle.com/javase/8/docs/api/java/lang/Cloneable.html)
 
 ## Credits
 

marker/pom.xml

@@ -30,18 +30,10 @@
 
   <artifactId>marker</artifactId>
   <dependencies>
-    <dependency>
-      <groupId>org.junit.jupiter</groupId>
-      <artifactId>junit-jupiter-api</artifactId>
-      <version>RELEASE</version>
-    </dependency>
-    <dependency>
-      <groupId>junit</groupId>
-      <artifactId>junit</artifactId>
-    </dependency>
     <dependency>
       <groupId>junit</groupId>
       <artifactId>junit</artifactId>
+      <scope>test</scope>
     </dependency>
   </dependencies>
 

marker/src/main/java/App.java

@@ -1,3 +1,6 @@
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
 /**
  * Created by Alexis on 28-Apr-17.
  * With Marker interface idea is to make empty interface and extend it.
@@ -25,13 +28,14 @@ public class App {
    */
   public static void main(String[] args) {
 
+    final Logger logger = LoggerFactory.getLogger(App.class);
     Guard guard = new Guard();
     Thief thief = new Thief();
 
     if (guard instanceof Permission) {
       guard.enter();
     } else {
-      System.out.println("You have no permission to enter, please leave this area");
+      logger.info("You have no permission to enter, please leave this area");
     }
 
     if (thief instanceof Permission) {

marker/src/main/java/Guard.java

@@ -1,10 +1,15 @@
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
 /**
- * Created by Alexis on 29-Apr-17.
+ * Class defining Guard
  */
 public class Guard implements Permission {
 
-  protected static void enter() {
+  private static final Logger LOGGER = LoggerFactory.getLogger(Guard.class);
-    System.out.println("You can enter");
-  }
 
+  protected static void enter() {
+
+    LOGGER.info("You can enter");
+  }
 }

marker/src/main/java/Permission.java

@@ -1,5 +1,4 @@
 /**
- * Created by Alexis on 29-Apr-17.
  * Interface without any methods
  * Marker interface is based on that assumption
  */

marker/src/main/java/Thief.java

@@ -1,12 +1,18 @@
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
 /**
- * Created by Alexis on 02-May-17.
+ * Class defining Thief
  */
 public class Thief {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(Thief.class);
+
   protected static void steal() {
-    System.out.println("Steal valuable items");
+    LOGGER.info("Steal valuable items");
   }
 
   protected static void doNothing() {
-    System.out.println("Pretend nothing happened and just leave");
+    LOGGER.info("Pretend nothing happened and just leave");
   }
 }

marker/src/test/java/AppTest.java

@@ -1,7 +1,3 @@
-/**
- * Created by Alexis on 01-May-17.
- */
-
 import org.junit.Test;
 
 /**

marker/src/test/java/GuardTest.java

@@ -4,7 +4,7 @@ import static org.hamcrest.CoreMatchers.instanceOf;
 import static org.junit.Assert.assertThat;
 
 /**
- * Created by Alexis on 02-May-17.
+ * Guard test
  */
 public class GuardTest {
 
@@ -13,4 +13,4 @@ public class GuardTest {
     Guard guard = new Guard();
     assertThat(guard, instanceOf(Permission.class));
   }
-}
+}

marker/src/test/java/ThiefTest.java

@@ -3,12 +3,12 @@ import org.junit.Test;
 import static org.junit.Assert.assertFalse;
 
 /**
- * Created by Alexis on 02-May-17.
+ * Thief test
  */
 public class ThiefTest {
   @Test
-  public void testGuard() {
+  public void testThief() {
     Thief thief = new Thief();
     assertFalse(thief instanceof Permission);
   }
-}
+}