From 083065ba93fd676aff02e1c0b1def10713d31c12 Mon Sep 17 00:00:00 2001
From: JuhoKang <rjduakcjs@gmail.com>
Date: Thu, 28 Jan 2016 23:33:46 +0900
Subject: [PATCH] Added index.md

Added index.md with explanation which seems a little bit short of detail.
Fixed the directory of the files.
---
 front-controller/index.md                     |   4 +--
 value-object/etc/value-object.png             | Bin 0 -> 5025 bytes
 value-object/etc/value-object.ucls            |  19 ++++++++++
 value-object/index.md                         |  34 ++++++++++++++++++
 value-object/{value-object => }/pom.xml       |   0
 .../java/com/iluwatar/value/object/App.java   |   0
 .../com/iluwatar/value/object/HeroStat.java   |   0
 .../iluwatar/value/object/HeroStatTest.java   |   0
 8 files changed, 55 insertions(+), 2 deletions(-)
 create mode 100644 value-object/etc/value-object.png
 create mode 100644 value-object/etc/value-object.ucls
 create mode 100644 value-object/index.md
 rename value-object/{value-object => }/pom.xml (100%)
 rename value-object/{value-object => }/src/main/java/com/iluwatar/value/object/App.java (100%)
 rename value-object/{value-object => }/src/main/java/com/iluwatar/value/object/HeroStat.java (100%)
 rename value-object/{value-object => }/src/test/java/com/iluwatar/value/object/HeroStatTest.java (100%)

diff --git a/front-controller/index.md b/front-controller/index.md
index a462a08e0..bc8f38d9f 100644
--- a/front-controller/index.md
+++ b/front-controller/index.md
@@ -3,14 +3,14 @@ layout: pattern
 title: Front Controller
 folder: front-controller
 permalink: /patterns/front-controller/
-categories: Presentation Tier
+categories: Creational
 tags:
  - Java
  - Difficulty-Intermediate
 ---
 
 ## Intent
-Introduce a common handler for all requests for a web site. This
+Introduce how to create objects which follow value semantics rather than reference semantics.
 way we can encapsulate common functionality such as security,
 internationalization, routing and logging in a single place.
 
diff --git a/value-object/etc/value-object.png b/value-object/etc/value-object.png
new file mode 100644
index 0000000000000000000000000000000000000000..69a244c80691b8ac63ed5b732b8b0828c592a1f8
GIT binary patch
literal 5025
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

literal 0
HcmV?d00001

diff --git a/value-object/etc/value-object.ucls b/value-object/etc/value-object.ucls
new file mode 100644
index 000000000..7bbf5e47c
--- /dev/null
+++ b/value-object/etc/value-object.ucls
@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<class-diagram version="1.1.9" icons="true" automaticImage="PNG" always-add-relationships="false" generalizations="true" 
+  realizations="true" associations="true" dependencies="true" nesting-relationships="true" router="FAN">  
+  <class id="1" language="java" name="com.iluwatar.value.object.HeroStat" project="value-object" 
+    file="/value-object/src/main/java/com/iluwatar/value/object/HeroStat.java" binary="false" corner="BOTTOM_RIGHT">    
+    <position height="-1" width="-1" x="520" y="337"/>    
+    <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>  
+  <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/value-object/index.md b/value-object/index.md
new file mode 100644
index 000000000..8645a2384
--- /dev/null
+++ b/value-object/index.md
@@ -0,0 +1,34 @@
+---
+layout: pattern
+title: Value Object
+folder: value-object
+permalink: /patterns/value-object/
+categories: Creational
+tags:
+ - Java
+ - Difficulty-Beginner
+---
+
+## Intent
+Provide objects which follow value semantics rather than reference semantics.
+This means value objects' equality are not based on identity. Two value objects are
+equal when they have the same value, not necessarily being the same object.
+
+![alt text](./etc/value-object.png "Value Object")
+
+## Applicability
+Use the Value Object when
+
+* you need to measure the objects' equality based on the objects' value
+
+## Real world examples
+
+* [java.util.Date](https://docs.oracle.com/javase/8/docs/api/java/util/Date.html)
+* [joda-time, money, beans](http://www.joda.org/)
+* [JSR-310 / ThreeTen project LocalDate](http://www.threeten.org/articles/local-date.html)
+
+## Credits
+
+* [Patterns of Enterprise Application Architecture](http://www.martinfowler.com/books/eaa.html)
+* [VALJOs - Value Java Objects : Stephen Colebourne's blog](http://blog.joda.org/2014/03/valjos-value-java-objects.html)
+* [Value Object : Wikipedia](https://en.wikipedia.org/wiki/Value_object)
diff --git a/value-object/value-object/pom.xml b/value-object/pom.xml
similarity index 100%
rename from value-object/value-object/pom.xml
rename to value-object/pom.xml
diff --git a/value-object/value-object/src/main/java/com/iluwatar/value/object/App.java b/value-object/src/main/java/com/iluwatar/value/object/App.java
similarity index 100%
rename from value-object/value-object/src/main/java/com/iluwatar/value/object/App.java
rename to value-object/src/main/java/com/iluwatar/value/object/App.java
diff --git a/value-object/value-object/src/main/java/com/iluwatar/value/object/HeroStat.java b/value-object/src/main/java/com/iluwatar/value/object/HeroStat.java
similarity index 100%
rename from value-object/value-object/src/main/java/com/iluwatar/value/object/HeroStat.java
rename to value-object/src/main/java/com/iluwatar/value/object/HeroStat.java
diff --git a/value-object/value-object/src/test/java/com/iluwatar/value/object/HeroStatTest.java b/value-object/src/test/java/com/iluwatar/value/object/HeroStatTest.java
similarity index 100%
rename from value-object/value-object/src/test/java/com/iluwatar/value/object/HeroStatTest.java
rename to value-object/src/test/java/com/iluwatar/value/object/HeroStatTest.java