Changes after review. Added README

mute-idiom/etc/mute-idiom.ucls

@@ -3,7 +3,7 @@
   realizations="true" associations="true" dependencies="true" nesting-relationships="true">  
   <class id="1" language="java" name="com.iluwatar.mute.App" project="mute-idiom" 
     file="/mute-idiom/src/main/java/com/iluwatar/mute/App.java" binary="false" corner="BOTTOM_RIGHT">    
-    <position height="-1" width="-1" x="519" y="122"/>    
+    <position height="-1" width="-1" x="168" y="234"/>    
     <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
       sort-features="false" accessors="true" visibility="true">      
       <attributes public="true" package="true" protected="true" private="false" static="true"/>      
@@ -12,7 +12,7 @@
   </class>  
   <class id="2" language="java" name="com.iluwatar.mute.Mute" project="mute-idiom" 
     file="/mute-idiom/src/main/java/com/iluwatar/mute/Mute.java" binary="false" corner="BOTTOM_RIGHT">    
-    <position height="115" width="203" x="291" y="267"/>    
+    <position height="115" width="203" x="70" y="375"/>    
     <display autosize="false" stereotype="true" package="true" initial-value="false" signature="true" 
       sort-features="false" accessors="true" visibility="true">      
       <attributes public="true" package="true" protected="true" private="true" static="true"/>      
@@ -21,21 +21,47 @@
   </class>  
   <interface id="3" language="java" name="com.iluwatar.mute.CheckedRunnable" project="mute-idiom" 
     file="/mute-idiom/src/main/java/com/iluwatar/mute/CheckedRunnable.java" binary="false" corner="BOTTOM_RIGHT">    
-    <position height="-1" width="-1" x="723" y="322"/>    
+    <position height="-1" width="-1" x="407" y="432"/>    
     <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
       sort-features="false" accessors="true" visibility="true">      
       <attributes public="true" package="true" protected="true" private="true" static="true"/>      
       <operations public="true" package="true" protected="true" private="true" static="true"/>    
     </display>  
   </interface>  
-  <dependency id="4">    
+  <interface id="4" language="java" name="com.iluwatar.mute.Resource" project="mute-idiom" 
+    file="/mute-idiom/src/main/java/com/iluwatar/mute/Resource.java" binary="false" corner="BOTTOM_RIGHT">    
+    <position height="-1" width="-1" x="383" y="235"/>    
+    <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
+      sort-features="false" accessors="true" visibility="true">      
+      <attributes public="true" package="true" protected="true" private="true" static="true"/>      
+      <operations public="true" package="true" protected="true" private="true" static="true"/>    
+    </display>  
+  </interface>  
+  <interface id="5" language="java" name="java.io.Closeable" project="dao" 
+    file="/opt/Softwares/Eclipses/MARS/eclipse/jre/lib/rt.jar" binary="true" corner="BOTTOM_RIGHT">    
+    <position height="-1" width="-1" x="384" y="109"/>    
+    <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
+      sort-features="false" accessors="true" visibility="true">      
+      <attributes public="true" package="true" protected="true" private="true" static="true"/>      
+      <operations public="true" package="true" protected="true" private="true" static="true"/>    
+    </display>  
+  </interface>  
+  <dependency id="6">    
+    <end type="SOURCE" refId="1"/>    
+    <end type="TARGET" refId="4"/>  
+  </dependency>  
+  <dependency id="7">    
     <end type="SOURCE" refId="1"/>    
     <end type="TARGET" refId="2"/>  
   </dependency>  
-  <dependency id="5">    
+  <dependency id="8">    
     <end type="SOURCE" refId="2"/>    
     <end type="TARGET" refId="3"/>  
   </dependency>  
+  <generalization id="9">    
+    <end type="SOURCE" refId="4"/>    
+    <end type="TARGET" refId="5"/>  
+  </generalization>  
   <classifier-display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
     sort-features="false" accessors="true" visibility="true">    
     <attributes public="true" package="true" protected="true" private="true" static="true"/>    

mute-idiom/src/main/java/com/iluwatar/mute/App.java

@@ -23,13 +23,9 @@
 
 package com.iluwatar.mute;
 
-import static org.mockito.Mockito.doThrow;
-import static org.mockito.Mockito.mock;
-
 import java.io.ByteArrayOutputStream;
-import java.sql.Connection;
+import java.io.IOException;
 import java.sql.SQLException;
-import java.sql.Statement;
 
 /**
  * Mute pattern is utilized when we need to suppress an exception due to an API flaw or in 
@@ -75,31 +71,33 @@ public class App {
   }
 
   private static void useOfLoggedMute() throws SQLException {
-    Connection connection = null;
+    Resource resource = null;
     try {
-      connection = openConnection();
+      resource = acquireResource();
-      readStuff(connection);
+      utilizeResource(resource);
     } finally {
-      closeConnection(connection);
+      closeResource(resource);
     }
   }
 
   /*
-   * All we can do while failed close of connection is to log it.
+   * All we can do while failed close of a resource is to log it.
    */
-  private static void closeConnection(Connection connection) {
+  private static void closeResource(Resource resource) {
-    Mute.loggedMute(() -> connection.close());
+    Mute.loggedMute(() -> resource.close());
   }
 
-  private static void readStuff(Connection connection) throws SQLException {
+  private static void utilizeResource(Resource resource) throws SQLException {
-    try (Statement statement = connection.createStatement()) {
+    System.out.println("Utilizing acquired resource: " + resource);
-      System.out.println("Read data from statement");
-    }
   }
 
-  private static Connection openConnection() throws SQLException {
+  private static Resource acquireResource() throws SQLException {
-    Connection mockedConnection = mock(Connection.class);
+    return new Resource() {
-    doThrow(SQLException.class).when(mockedConnection).close();
+      
-    return mockedConnection;
+      @Override
+      public void close() throws IOException {
+        throw new IOException("Error in closing resource: " + this);
+      }
+    };
   }
 }

mute-idiom/src/main/java/com/iluwatar/mute/Resource.java

@@ -0,0 +1,35 @@
+/**
+ * The MIT License
+ * Copyright (c) 2014 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.mute;
+
+import java.io.Closeable;
+
+/**
+ * Represents any resource that the application might acquire and that must be closed
+ * after it is utilized. Example of such resources can be a database connection, open
+ * files, sockets. 
+ */
+public interface Resource extends Closeable {
+
+}