From 2d678d6b3255ad9ff9c7fa013ba39f5124ff5279 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christian=20R=C3=A4del?= <ducks.2788@gmail.com>
Date: Sun, 2 Oct 2016 10:53:24 +0200
Subject: [PATCH] BAEL-325: Added UML sources. Applied some small improvements.

---
 .../filters/AuthenticationFilter.java         |  15 +++++---
 .../patterns/filters/EncodingFilter.java      |   6 ++-
 .../patterns/filters/FilterChainImpl.java     |   7 +---
 .../patterns/filters/TemplateFilter.java      |  35 ++++++++++++++++++
 .../filters/VisitorCounterFilter.java         |  19 ++++++----
 ...nt controller.png => front_controller.png} | Bin
 ... controller.puml => front_controller.puml} |   0
 .../main/resources/intercepting_filter.png    | Bin 0 -> 17297 bytes
 .../main/resources/intercepting_filter.puml   |  17 +++++++++
 9 files changed, 80 insertions(+), 19 deletions(-)
 create mode 100644 patterns/src/main/java/com/baeldung/patterns/filters/TemplateFilter.java
 rename patterns/src/main/resources/{front controller.png => front_controller.png} (100%)
 rename patterns/src/main/resources/{front controller.puml => front_controller.puml} (100%)
 create mode 100644 patterns/src/main/resources/intercepting_filter.png
 create mode 100644 patterns/src/main/resources/intercepting_filter.puml

diff --git a/patterns/src/main/java/com/baeldung/patterns/filters/AuthenticationFilter.java b/patterns/src/main/java/com/baeldung/patterns/filters/AuthenticationFilter.java
index fa7655434e..f5e03878ca 100644
--- a/patterns/src/main/java/com/baeldung/patterns/filters/AuthenticationFilter.java
+++ b/patterns/src/main/java/com/baeldung/patterns/filters/AuthenticationFilter.java
@@ -3,22 +3,23 @@ package com.baeldung.patterns.filters;
 import com.baeldung.patterns.commands.FrontCommand;
 import com.baeldung.patterns.commands.LoginCommand;
 
-import javax.servlet.FilterChain;
-import javax.servlet.ServletException;
-import javax.servlet.ServletRequest;
-import javax.servlet.ServletResponse;
+import javax.servlet.*;
 import javax.servlet.http.HttpServletRequest;
 import javax.servlet.http.HttpServletResponse;
 import javax.servlet.http.HttpSession;
 import java.io.IOException;
 
-public class AuthenticationFilter extends BaseFilter {
+public class AuthenticationFilter implements Filter {
     private OnIntercept callback;
 
     public AuthenticationFilter(OnIntercept callback) {
         this.callback = callback;
     }
 
+    @Override
+    public void init(FilterConfig filterConfig) throws ServletException {
+    }
+
     @Override
     public void doFilter(
       ServletRequest request,
@@ -37,4 +38,8 @@ public class AuthenticationFilter extends BaseFilter {
             chain.doFilter(request, response);
         }
     }
+
+    @Override
+    public void destroy() {
+    }
 }
diff --git a/patterns/src/main/java/com/baeldung/patterns/filters/EncodingFilter.java b/patterns/src/main/java/com/baeldung/patterns/filters/EncodingFilter.java
index 1277ca726d..2856bb1112 100644
--- a/patterns/src/main/java/com/baeldung/patterns/filters/EncodingFilter.java
+++ b/patterns/src/main/java/com/baeldung/patterns/filters/EncodingFilter.java
@@ -2,9 +2,13 @@ package com.baeldung.patterns.filters;
 
 import javax.servlet.*;
 import javax.servlet.annotation.WebFilter;
+import javax.servlet.annotation.WebInitParam;
 import java.io.IOException;
 
-@WebFilter(servletNames = "front-controller")
+@WebFilter(
+  servletNames = {"front-controller"},
+  initParams = {@WebInitParam(name = "encoding", value = "UTF-8")}
+)
 public class EncodingFilter extends BaseFilter {
     private String encoding;
 
diff --git a/patterns/src/main/java/com/baeldung/patterns/filters/FilterChainImpl.java b/patterns/src/main/java/com/baeldung/patterns/filters/FilterChainImpl.java
index d2b64c7d06..789fc003a0 100644
--- a/patterns/src/main/java/com/baeldung/patterns/filters/FilterChainImpl.java
+++ b/patterns/src/main/java/com/baeldung/patterns/filters/FilterChainImpl.java
@@ -1,14 +1,11 @@
 package com.baeldung.patterns.filters;
 
-import javax.servlet.Filter;
-import javax.servlet.ServletException;
-import javax.servlet.ServletRequest;
-import javax.servlet.ServletResponse;
+import javax.servlet.*;
 import java.io.IOException;
 import java.util.Arrays;
 import java.util.Iterator;
 
-public class FilterChainImpl implements javax.servlet.FilterChain {
+public class FilterChainImpl implements FilterChain {
     private Iterator<Filter> filters;
 
     public FilterChainImpl(Filter... filters) {
diff --git a/patterns/src/main/java/com/baeldung/patterns/filters/TemplateFilter.java b/patterns/src/main/java/com/baeldung/patterns/filters/TemplateFilter.java
new file mode 100644
index 0000000000..939d9ad84d
--- /dev/null
+++ b/patterns/src/main/java/com/baeldung/patterns/filters/TemplateFilter.java
@@ -0,0 +1,35 @@
+package com.baeldung.patterns.filters;
+
+import javax.servlet.FilterChain;
+import javax.servlet.ServletException;
+import javax.servlet.ServletRequest;
+import javax.servlet.ServletResponse;
+import javax.servlet.http.HttpServletRequest;
+import javax.servlet.http.HttpServletResponse;
+import java.io.IOException;
+
+public abstract class TemplateFilter extends BaseFilter {
+
+    protected abstract void preFilter(
+      HttpServletRequest request,
+      HttpServletResponse response
+    ) throws IOException, ServletException;
+
+    protected abstract void postFilter(
+      HttpServletRequest request,
+      HttpServletResponse response
+    ) throws IOException, ServletException;
+
+    @Override
+    public void doFilter(
+      ServletRequest request,
+      ServletResponse response,
+      FilterChain chain
+    ) throws IOException, ServletException {
+        HttpServletRequest httpServletRequest = (HttpServletRequest) request;
+        HttpServletResponse httpServletResponse = (HttpServletResponse) response;
+        preFilter(httpServletRequest, httpServletResponse);
+        chain.doFilter(request, response);
+        postFilter(httpServletRequest, httpServletResponse);
+    }
+}
diff --git a/patterns/src/main/java/com/baeldung/patterns/filters/VisitorCounterFilter.java b/patterns/src/main/java/com/baeldung/patterns/filters/VisitorCounterFilter.java
index 0abfac7cd6..5c2358686b 100644
--- a/patterns/src/main/java/com/baeldung/patterns/filters/VisitorCounterFilter.java
+++ b/patterns/src/main/java/com/baeldung/patterns/filters/VisitorCounterFilter.java
@@ -1,18 +1,19 @@
 package com.baeldung.patterns.filters;
 
-import javax.servlet.FilterChain;
-import javax.servlet.ServletException;
-import javax.servlet.ServletRequest;
-import javax.servlet.ServletResponse;
+import javax.servlet.*;
 import javax.servlet.http.HttpServletRequest;
 import javax.servlet.http.HttpSession;
 import java.io.IOException;
 import java.util.HashSet;
 import java.util.Set;
 
-public class VisitorCounterFilter extends BaseFilter {
+public class VisitorCounterFilter implements Filter {
     private static Set<String> users = new HashSet<>();
 
+    @Override
+    public void init(FilterConfig filterConfig) throws ServletException {
+    }
+
     @Override
     public void doFilter(
       ServletRequest request,
@@ -21,10 +22,12 @@ public class VisitorCounterFilter extends BaseFilter {
     ) throws IOException, ServletException {
         HttpSession session = ((HttpServletRequest) request).getSession(false);
         String username = (String) session.getAttribute("username");
-        if (!users.contains(username)) {
-            users.add(username);
-        }
+        users.add(username);
         request.setAttribute("counter", users.size());
         chain.doFilter(request, response);
     }
+
+    @Override
+    public void destroy() {
+    }
 }
diff --git a/patterns/src/main/resources/front controller.png b/patterns/src/main/resources/front_controller.png
similarity index 100%
rename from patterns/src/main/resources/front controller.png
rename to patterns/src/main/resources/front_controller.png
diff --git a/patterns/src/main/resources/front controller.puml b/patterns/src/main/resources/front_controller.puml
similarity index 100%
rename from patterns/src/main/resources/front controller.puml
rename to patterns/src/main/resources/front_controller.puml
diff --git a/patterns/src/main/resources/intercepting_filter.png b/patterns/src/main/resources/intercepting_filter.png
new file mode 100644
index 0000000000000000000000000000000000000000..9ccacc80812c9d857475472fbf82751aafc6b01e
GIT binary patch
literal 17297
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
Q5c-Ckw6YXj!r1@+04S5*(*OVf

literal 0
HcmV?d00001

diff --git a/patterns/src/main/resources/intercepting_filter.puml b/patterns/src/main/resources/intercepting_filter.puml
new file mode 100644
index 0000000000..b06b822323
--- /dev/null
+++ b/patterns/src/main/resources/intercepting_filter.puml
@@ -0,0 +1,17 @@
+@startuml
+scale 1.5
+
+class Client
+class FilterManager
+interface FilterChain
+interface "Filter 1"
+interface "Filter 2"
+interface "Filter 3"
+
+Client .right.-- FilterManager
+FilterManager .right.-- Target
+FilterManager -- FilterChain
+FilterChain .right.-- "Filter 3"
+FilterChain .right.-- "Filter 2"
+FilterChain .right.-- "Filter 1"
+@enduml