From c8fd9f3a0d6db31743b58d623a78701c9f4ca008 Mon Sep 17 00:00:00 2001
From: amit2103 <amit.pandey2103@gmail.com>
Date: Sun, 4 Oct 2015 03:06:11 +0530
Subject: [PATCH] Monostate pattern #85

---
 monostate/etc/MonoState.ucls                  |  53 ++++++++++++++++++
 monostate/etc/monostate.png                   | Bin 0 -> 16526 bytes
 monostate/index.md                            |  28 +++++++++
 monostate/pom.xml                             |  18 ++++++
 .../main/java/com/iluwatar/monostate/App.java |  11 ++++
 .../com/iluwatar/monostate/LoadBalancer.java  |  39 +++++++++++++
 .../java/com/iluwatar/monostate/Request.java  |  10 ++++
 .../java/com/iluwatar/monostate/Server.java   |  21 +++++++
 8 files changed, 180 insertions(+)
 create mode 100644 monostate/etc/MonoState.ucls
 create mode 100644 monostate/etc/monostate.png
 create mode 100644 monostate/index.md
 create mode 100644 monostate/pom.xml
 create mode 100644 monostate/src/main/java/com/iluwatar/monostate/App.java
 create mode 100644 monostate/src/main/java/com/iluwatar/monostate/LoadBalancer.java
 create mode 100644 monostate/src/main/java/com/iluwatar/monostate/Request.java
 create mode 100644 monostate/src/main/java/com/iluwatar/monostate/Server.java

diff --git a/monostate/etc/MonoState.ucls b/monostate/etc/MonoState.ucls
new file mode 100644
index 000000000..76b48ad0f
--- /dev/null
+++ b/monostate/etc/MonoState.ucls
@@ -0,0 +1,53 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<class-diagram version="1.1.8" icons="true" always-add-relationships="false" generalizations="true" realizations="true" 
+  associations="true" dependencies="false" nesting-relationships="true">  
+  <class id="1" language="java" name="com.iluwatar.monostate.LoadBalancer" project="monostate" 
+    file="/monostate/src/main/java/com/iluwatar/monostate/LoadBalancer.java" binary="false" corner="BOTTOM_RIGHT">    
+    <position height="187" width="158" x="100" y="66"/>    
+    <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>  
+  </class>  
+  <class id="2" language="java" name="com.iluwatar.monostate.Server" project="monostate" 
+    file="/monostate/src/main/java/com/iluwatar/monostate/Server.java" binary="false" corner="BOTTOM_RIGHT">    
+    <position height="-1" width="-1" x="176" y="372"/>    
+    <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>  
+  </class>  
+  <class id="3" language="java" name="com.iluwatar.monostate.Request" project="monostate" 
+    file="/monostate/src/main/java/com/iluwatar/monostate/Request.java" binary="false" corner="BOTTOM_RIGHT">    
+    <position height="-1" width="-1" x="329" y="352"/>    
+    <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>  
+  </class>  
+  <dependency id="4">    
+    <end type="SOURCE" refId="1"/>    
+    <end type="TARGET" refId="3"/>  
+  </dependency>  
+  <dependency id="5">    
+    <end type="SOURCE" refId="2"/>    
+    <end type="TARGET" refId="3"/>  
+  </dependency>  
+  <association id="6">    
+    <end type="SOURCE" refId="1" navigable="false">      
+      <attribute id="7" name="servers"/>      
+      <multiplicity id="8" minimum="0" maximum="2147483647"/>    
+    </end>    
+    <end type="TARGET" refId="2" navigable="true"/>    
+    <display labels="true" multiplicity="true"/>  
+  </association>  
+  <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"/>    
+    <operations public="true" package="true" protected="true" private="true" static="true"/>  
+  </classifier-display>  
+  <association-display labels="true" multiplicity="true"/>
+</class-diagram>
\ No newline at end of file
diff --git a/monostate/etc/monostate.png b/monostate/etc/monostate.png
new file mode 100644
index 0000000000000000000000000000000000000000..273fa95459d4d0853c58bfa25cb6e1117fd48032
GIT binary patch
literal 16526
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

literal 0
HcmV?d00001

diff --git a/monostate/index.md b/monostate/index.md
new file mode 100644
index 000000000..369d24ff8
--- /dev/null
+++ b/monostate/index.md
@@ -0,0 +1,28 @@
+---
+layout: pattern
+title: MonoState
+folder: monostate
+permalink: /patterns/monostate/
+categories: Creational
+tags: Java
+---
+
+**Intent:** Enforces a behaviour like sharing the same state amongst all instances.
+
+![alt text](./etc/monostate.png "MonoState")
+
+**Applicability:** Use the Monostate pattern when
+
+* The same state must be shared across all instances of a class.
+* Typically this pattern might be used everywhere a SingleTon might be used. Singleton usage however is not transparent, Monostate usage is.
+* Monostate has one major advantage over singleton. The subclasses might decorate the shared state as they wish and hence can provide dynamically different behaviour than the base class.
+
+**Typical Use Case:**
+
+* the logging class
+* managing a connection to a database
+* file manager
+
+**Real world examples:**
+
+Yet to see this.
diff --git a/monostate/pom.xml b/monostate/pom.xml
new file mode 100644
index 000000000..fb40432da
--- /dev/null
+++ b/monostate/pom.xml
@@ -0,0 +1,18 @@
+<?xml version="1.0"?>
+<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+  <modelVersion>4.0.0</modelVersion>
+  <parent>
+    <groupId>com.iluwatar</groupId>
+    <artifactId>java-design-patterns</artifactId>
+    <version>1.6.0</version>
+  </parent>
+  <artifactId>monostate</artifactId>
+  <dependencies>
+    <dependency>
+      <groupId>junit</groupId>
+      <artifactId>junit</artifactId>
+      <scope>test</scope>
+    </dependency>
+  </dependencies>
+</project>
diff --git a/monostate/src/main/java/com/iluwatar/monostate/App.java b/monostate/src/main/java/com/iluwatar/monostate/App.java
new file mode 100644
index 000000000..a96895126
--- /dev/null
+++ b/monostate/src/main/java/com/iluwatar/monostate/App.java
@@ -0,0 +1,11 @@
+package com.iluwatar.monostate;
+
+public class App {
+	public static void main(String[] args) {
+		LoadBalancer loadBalancer1 = new LoadBalancer();
+		LoadBalancer loadBalancer2 = new LoadBalancer();
+		loadBalancer1.serverequest(new Request("Hello"));
+		loadBalancer2.serverequest(new Request("Hello World"));
+	}
+
+}
diff --git a/monostate/src/main/java/com/iluwatar/monostate/LoadBalancer.java b/monostate/src/main/java/com/iluwatar/monostate/LoadBalancer.java
new file mode 100644
index 000000000..29a101b81
--- /dev/null
+++ b/monostate/src/main/java/com/iluwatar/monostate/LoadBalancer.java
@@ -0,0 +1,39 @@
+package com.iluwatar.monostate;
+
+import java.util.ArrayList;
+import java.util.List;
+
+public class LoadBalancer {
+  private static List<Server> servers = new ArrayList<>();
+  private static int id = 0;
+  private static int lastServedId = 0;
+
+  static {
+    servers.add(new Server("localhost", 8081, ++id));
+    servers.add(new Server("localhost", 8080, ++id));
+    servers.add(new Server("localhost", 8082, ++id));
+    servers.add(new Server("localhost", 8083, ++id));
+    servers.add(new Server("localhost", 8084, ++id));
+  }
+
+  public final void addServer(Server server) {
+    synchronized (servers) {
+      servers.add(server);
+    }
+
+  }
+
+  public final int getNoOfServers() {
+    return servers.size();
+  }
+
+  public void serverequest(Request request) {
+    if (lastServedId >= servers.size()) {
+      lastServedId = 0;
+    }
+    Server server = servers.get(lastServedId++);
+    server.serve(request);
+  }
+
+
+}
diff --git a/monostate/src/main/java/com/iluwatar/monostate/Request.java b/monostate/src/main/java/com/iluwatar/monostate/Request.java
new file mode 100644
index 000000000..c57072a21
--- /dev/null
+++ b/monostate/src/main/java/com/iluwatar/monostate/Request.java
@@ -0,0 +1,10 @@
+package com.iluwatar.monostate;
+
+public class Request {
+  public final String value;
+
+  public Request(String value) {
+    super();
+    this.value = value;
+  }
+}
diff --git a/monostate/src/main/java/com/iluwatar/monostate/Server.java b/monostate/src/main/java/com/iluwatar/monostate/Server.java
new file mode 100644
index 000000000..43be5300b
--- /dev/null
+++ b/monostate/src/main/java/com/iluwatar/monostate/Server.java
@@ -0,0 +1,21 @@
+package com.iluwatar.monostate;
+
+public class Server {
+  public final String host;
+  public final int port;
+  public final int id;
+  public Server(String host, int port, int id) {
+    this.host = host;
+    this.port = port;
+    this.id = id;
+  }
+  public String getHost() {
+    return host;
+  }
+  public int getPort() {
+    return port;
+  }
+  public final void serve(Request request) {
+    System.out.println("Server ID "+id + "  processed request with value  "+request.value);
+  }
+}