From 794795acf5ed09485a072ee12104c4e7972de19c Mon Sep 17 00:00:00 2001
From: jinishavora <40777762+jinishavora@users.noreply.github.com>
Date: Mon, 22 Mar 2021 02:13:34 -0400
Subject: [PATCH] task: MVVM design pattern using zkoss framework. (#1678)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* MVVM design pattern using zkoss framework.

* MVVM Design pattern updates for issues reported by SonarCloud.

* MVVM Design pattern updates for coverage issues reported by SonarCloud.

* MVVM Design pattern updates for coverage issues (removing lombok @Data)
reported by SonarCloud.

* MVVM Design pattern updates for coverage issues reported by Sonar - TEST
cases added for Equals and ToString

* MVVM Design Pattern - updating missing/todo details.

* MVVM Design Pattern - adding lombok.config

* MVVM Design Pattern - Removing xml, updating pom.xml and README as per
suggested changes in code review

* Update model-view-viewmodel/README.md

* Update model-view-viewmodel/README.md

* Update model-view-viewmodel/README.md

* Update model-view-viewmodel/README.md

* MVVM Design Pattern - Updated pom.xml and Readme based on Suggested
changes

* added type as xml

* MVVM Design Patterm - root pom.xml and module pom.xml updated

* Update pom.xml

Co-authored-by: Subhrodip Mohanta <hello@subho.xyz>
Co-authored-by: Ilkka Seppälä <iluwatar@users.noreply.github.com>
---
 model-view-viewmodel/README.md                | 145 ++++++++++++++++++
 .../etc/model-view-viewmodel.png              | Bin 0 -> 40539 bytes
 .../etc/model-view-viewmodel.urm.puml         |  43 ++++++
 model-view-viewmodel/lombok.config            |   2 +
 model-view-viewmodel/pom.xml                  | 115 ++++++++++++++
 .../src/main/assembly/webapp.xml              |  25 +++
 .../iluwatar/model/view/viewmodel/Book.java   |  37 +++++
 .../model/view/viewmodel/BookService.java     |  10 ++
 .../model/view/viewmodel/BookServiceImpl.java |  38 +++++
 .../model/view/viewmodel/BookViewModel.java   |  43 ++++++
 .../src/main/webapp/META-INF/MANIFEST.MF      |   8 +
 .../src/main/webapp/WEB-INF/web.xml           | 114 ++++++++++++++
 .../src/main/webapp/index.zul                 |  34 ++++
 .../model/view/viewmodel/BookTest.java        | 108 +++++++++++++
 pom.xml                                       |  10 +-
 15 files changed, 730 insertions(+), 2 deletions(-)
 create mode 100644 model-view-viewmodel/README.md
 create mode 100644 model-view-viewmodel/etc/model-view-viewmodel.png
 create mode 100644 model-view-viewmodel/etc/model-view-viewmodel.urm.puml
 create mode 100644 model-view-viewmodel/lombok.config
 create mode 100644 model-view-viewmodel/pom.xml
 create mode 100644 model-view-viewmodel/src/main/assembly/webapp.xml
 create mode 100644 model-view-viewmodel/src/main/java/com/iluwatar/model/view/viewmodel/Book.java
 create mode 100644 model-view-viewmodel/src/main/java/com/iluwatar/model/view/viewmodel/BookService.java
 create mode 100644 model-view-viewmodel/src/main/java/com/iluwatar/model/view/viewmodel/BookServiceImpl.java
 create mode 100644 model-view-viewmodel/src/main/java/com/iluwatar/model/view/viewmodel/BookViewModel.java
 create mode 100644 model-view-viewmodel/src/main/webapp/META-INF/MANIFEST.MF
 create mode 100644 model-view-viewmodel/src/main/webapp/WEB-INF/web.xml
 create mode 100644 model-view-viewmodel/src/main/webapp/index.zul
 create mode 100644 model-view-viewmodel/src/test/java/com/iluwatar/model/view/viewmodel/BookTest.java

diff --git a/model-view-viewmodel/README.md b/model-view-viewmodel/README.md
new file mode 100644
index 000000000..6df1ea5d7
--- /dev/null
+++ b/model-view-viewmodel/README.md
@@ -0,0 +1,145 @@
+---
+layout: pattern
+title: Model-View-ViewModel
+folder: model-view-viewmodel
+permalink: /patterns/model-view-viewmodel/
+categories: Architectural
+tags:
+ - Decoupling
+---
+
+## Also known as
+
+Model–View–Binder
+
+## Intent
+
+To apply "[Separation of Concerns](https://java-design-patterns.com/principles/#separation-of-concerns)" to separate the logic from the UI components and allow developers to work on UI without affecting the logic and vice versa.
+
+## Explanation
+
+Wikipedia says
+
+> Model–view–viewmodel (MVVM) is a software architectural pattern that facilitates the separation of the development of the graphical user interface (the view) – be it via a markup language or GUI code – from the development of the business logic or back-end logic (the model) so that the view is not dependent on any specific model platform. 
+
+**Programmatic Example**
+
+Zkoss implementation:
+
+> ViewModel will hold the business logic and expose the data from model to View
+
+```java
+public class BookViewModel {
+  @WireVariable
+  private List<Book> bookList;
+  private Book selectedBook;
+  private BookService bookService = new BookServiceImpl();
+  
+  public Book getSelectedBook() {
+    return selectedBook;
+  }
+
+  @NotifyChange("selectedBook")
+  public void setSelectedBook(Book selectedBook) {
+    this.selectedBook = selectedBook;
+  }
+
+  public List<Book> getBookList() {
+    return bookService.load();
+  }
+  
+  /** Deleting a book.
+   */
+  @Command
+  @NotifyChange({"selectedBook","bookList"})
+  public void deleteBook() {
+    if (selectedBook != null) {
+      getBookList().remove(selectedBook);
+      selectedBook = null;
+    }
+}
+```
+
+> View will have no logic, only UI elements
+
+```xml
+<zk>
+<window title="List of Books" border="normal" width="600px" apply="org.zkoss.bind.BindComposer" viewModel="@id('vm') @init('com.iluwatar.model.view.viewmodel.BookViewModel')">
+    <vbox hflex="true">
+        <listbox model="@bind(vm.bookList)" selectedItem="@bind(vm.selectedBook)" height="400px" mold="paging">
+            <listhead>
+                <listheader label="Book Name"/>
+                <listheader label="Author"/>               
+            </listhead>
+            <template name="model" var="book">
+                <listitem >
+                    <listcell label="@bind(book.name)"/>
+                    <listcell label="@bind(book.author)"/>
+                </listitem>
+            </template>
+        </listbox>
+    </vbox>
+    <toolbar>
+        <button label="Delete" onClick="@command('deleteBook')" disabled="@load(empty vm.selectedBook)" />
+    </toolbar>
+    <hbox style="margin-top:20px" visible="@bind(not empty vm.selectedBook)">
+		<vbox>
+			<hlayout>
+				Book Name : <label value="@bind(vm.selectedBook.name)" style="font-weight:bold"/>
+			</hlayout>
+			<hlayout>
+				Book Author : <label value="@bind(vm.selectedBook.author)" style="font-weight:bold"/>
+			</hlayout>
+			<hlayout>
+				Book Description : <label value="@bind(vm.selectedBook.description)" style="font-weight:bold"/>
+			</hlayout>
+		</vbox>
+	</hbox>
+</window>
+</zk>
+```
+
+Note: 
+* To deploy this, go to model-view-viewmodel folder and run: 
+* mvn clean install
+* mvn jetty:run -Djetty.http.port=9911
+* In browser, http://localhost:9911/model-view-viewmodel/
+
+## Class diagram
+
+![alt text](./etc/model-view-viewmodel.png "MVVM pattern class diagram")
+
+## Applicability
+
+* When looking for clean architecture, with better reusability, testability and maintainability.
+
+## Tutorials
+
+* [Zkoss Demo](https://www.zkoss.org/zkdemo/getting_started/mvvm)
+* [Learn MVVM](https://www.learnmvvm.com/)
+* [Android Developer CodeLabs](https://codelabs.developers.google.com/codelabs/android-databinding)
+
+## Typical Use Case
+
+* Android apps
+* .NET framework applications
+* JavaScript applications
+
+## Real world examples
+
+* ZK Framework [zkoss.org](https://www.zkoss.org/)
+* KnockoutJS [knockoutjs.com](https://knockoutjs.com/)
+
+## Consequences
+
+* John Gossman has criticized the MVVM pattern and its application in specific uses, stating that MVVM can be "overkill" when creating simple user interfaces. For larger applications, he believes that generalizing the viewmodel upfront can be difficult, and that large-scale data binding can lead to lower performance - Ref: [MVVM-Wiki](https://en.wikipedia.org/wiki/Model%E2%80%93view%E2%80%93viewmodel)
+
+* Can be hard to design ViewModel for larger applications.
+* For complex databinding, debugging can be difficult.
+
+## Credits
+
+* [ZK MVVM](https://www.zkoss.org/wiki/ZK%20Developer's%20Reference/MVVM)
+* [GeeksforGeeks  MVVM Intro](https://www.geeksforgeeks.org/introduction-to-model-view-view-model-mvvm/)
+* [ZK MVVM Book](http://books.zkoss.org/zk-mvvm-book/9.5/)
+* [Microsoft MVVM](https://docs.microsoft.com/en-us/archive/msdn-magazine/2009/february/patterns-wpf-apps-with-the-model-view-viewmodel-design-pattern)
diff --git a/model-view-viewmodel/etc/model-view-viewmodel.png b/model-view-viewmodel/etc/model-view-viewmodel.png
new file mode 100644
index 0000000000000000000000000000000000000000..a775ec49fe5e7be79c931a9cb5845fe2737a6771
GIT binary patch
literal 40539
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
B2zdYi

literal 0
HcmV?d00001

diff --git a/model-view-viewmodel/etc/model-view-viewmodel.urm.puml b/model-view-viewmodel/etc/model-view-viewmodel.urm.puml
new file mode 100644
index 000000000..8cd7cb4b8
--- /dev/null
+++ b/model-view-viewmodel/etc/model-view-viewmodel.urm.puml
@@ -0,0 +1,43 @@
+@startuml
+package com.iluwatar.model.view.viewmodel {
+  class Book {
+    - author : String
+    - description : String
+    - name : String
+    + Book(name : String, author : String, description : String)
+    # canEqual(other : Object) : boolean
+    + equals(o : Object) : boolean
+    + getAuthor() : String
+    + getDescription() : String
+    + getName() : String
+    + hashCode() : int
+    + setAuthor(author : String)
+    + setDescription(description : String)
+    + setName(name : String)
+    + toString() : String
+  }
+  interface BookService {
+    + load() : List<Book> {abstract}
+  }
+  class BookServiceImpl {
+    - designPatternBooks : List<Book>
+    + BookServiceImpl()
+    + load() : List<Book>
+  }
+  class BookViewModel {
+    - bookList : List<Book>
+    - bookService : BookService
+    - selectedBook : Book
+    + BookViewModel()
+    + deleteBook()
+    + getBookList() : List<Book>
+    + getSelectedBook() : Book
+    + setSelectedBook(selectedBook : Book)
+  }
+}
+BookViewModel -->  "-bookService" BookService
+BookServiceImpl -->  "-designPatternBooks" Book
+BookViewModel -->  "-bookList" Book
+BookViewModel -->  "-selectedBook" Book
+BookServiceImpl ..|> BookService 
+@enduml
\ No newline at end of file
diff --git a/model-view-viewmodel/lombok.config b/model-view-viewmodel/lombok.config
new file mode 100644
index 000000000..a23edb413
--- /dev/null
+++ b/model-view-viewmodel/lombok.config
@@ -0,0 +1,2 @@
+config.stopBubbling = true
+lombok.addLombokGeneratedAnnotation = true
\ No newline at end of file
diff --git a/model-view-viewmodel/pom.xml b/model-view-viewmodel/pom.xml
new file mode 100644
index 000000000..971ae59f7
--- /dev/null
+++ b/model-view-viewmodel/pom.xml
@@ -0,0 +1,115 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+	<modelVersion>4.0.0</modelVersion>
+	<parent>
+		<artifactId>java-design-patterns</artifactId>
+		<groupId>com.iluwatar</groupId>
+		<version>1.24.0-SNAPSHOT</version>
+	</parent>
+	<groupId>com.iluwatar</groupId>
+	<artifactId>model-view-viewmodel</artifactId>
+	<version>1.24.0-SNAPSHOT</version>
+	<properties>
+		<zk.version>9.0.0</zk.version>
+		<guava.version>19.0</guava.version>
+		<jetty-maven-plugin.version>9.4.28.v20200408</jetty-maven-plugin.version>
+		<maven-war-plugin.version>2.1.1</maven-war-plugin.version>
+		<maven-assembly-plugin.version>2.2</maven-assembly-plugin.version>
+		<maven.build.timestamp.format>yyyy-MM-dd</maven.build.timestamp.format>
+		<packname>-${project.version}-FL-${maven.build.timestamp}</packname>
+	</properties>
+	<packaging>war</packaging>
+	<name>model-view-viewmodel</name>
+	<description>model-view-viewmodel</description>
+	<licenses>
+		<license>
+			<name>GNU LESSER GENERAL PUBLIC LICENSE, Version 3</name>
+			<url>https://www.gnu.org/licenses/lgpl.html</url>
+			<distribution>repo</distribution>
+		</license>
+	</licenses>
+	<repositories>
+		<repository>
+			<id>ZK CE</id>
+			<name>ZK CE Repository</name>
+			<url>https://mavensync.zkoss.org/maven2</url>
+		</repository>
+		<repository>
+			<id>ZK EVAL</id>
+			<name>ZK Evaluation Repository</name>
+			<url>https://mavensync.zkoss.org/eval</url>
+		</repository>
+	</repositories>
+	<pluginRepositories>
+		<pluginRepository>
+			<id>zkmaven</id>
+			<name>ZK Maven Plugin Repository</name>
+			<url>https://mavensync.zkoss.org/maven2/</url>
+		</pluginRepository>
+	</pluginRepositories>
+	<dependencies>
+		<dependency>
+			<groupId>org.zkoss.zk</groupId>
+			<artifactId>zkbind</artifactId>
+			<version>${zk.version}</version>
+		</dependency>
+		<dependency>
+			<groupId>org.junit.jupiter</groupId>
+			<artifactId>junit-jupiter-engine</artifactId>
+			<scope>test</scope>
+		</dependency>
+		<dependency>
+			<groupId>com.google.guava</groupId>
+			<artifactId>guava-testlib</artifactId>
+			<version>${guava.version}</version>
+			<scope>test</scope>
+		</dependency>
+	</dependencies>
+	<build>
+		<finalName>${project.artifactId}</finalName>
+		<plugins>
+			<!-- Run with Jetty -->
+			<plugin>
+				<groupId>org.eclipse.jetty</groupId>
+				<artifactId>jetty-maven-plugin</artifactId>
+				<version>${jetty-maven-plugin.version}</version>
+				<configuration>
+					<webApp>
+						<contextPath>/${project.artifactId}</contextPath>
+						<allowDuplicateFragmentNames>true</allowDuplicateFragmentNames>
+					</webApp>
+					<scanIntervalSeconds>5</scanIntervalSeconds>
+				</configuration>
+			</plugin>
+			<!-- Build war -->
+			<plugin>
+				<artifactId>maven-war-plugin</artifactId>
+				<groupId>org.apache.maven.plugins</groupId>
+				<version>${maven-war-plugin.version}</version>
+			</plugin>
+			<!-- Pack zips -->
+			<plugin>
+				<artifactId>maven-assembly-plugin</artifactId>
+				<version>${maven-assembly-plugin.version}</version>
+				<executions>
+					<execution>
+						<id>webapp</id>
+						<phase>package</phase>
+						<goals>
+							<goal>single</goal>
+						</goals>
+						<configuration>
+							<finalName>model-view-viewmodel${packname}</finalName>
+							<appendAssemblyId>false</appendAssemblyId>
+							<descriptors>
+								<descriptor>src/main/assembly/webapp.xml</descriptor>
+							</descriptors>
+						</configuration>
+					</execution>
+				</executions>
+			</plugin>
+		</plugins>
+	</build>
+</project>
diff --git a/model-view-viewmodel/src/main/assembly/webapp.xml b/model-view-viewmodel/src/main/assembly/webapp.xml
new file mode 100644
index 000000000..153904efc
--- /dev/null
+++ b/model-view-viewmodel/src/main/assembly/webapp.xml
@@ -0,0 +1,25 @@
+<assembly
+	xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.0"
+	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+	xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.0 http://maven.apache.org/xsd/assembly-1.1.0.xsd">
+	<id>webapp</id>
+	<formats>
+		<format>zip</format>
+	</formats>
+	<fileSets>
+		<fileSet>
+			<directory>${project.basedir}/src/main/java</directory>
+			<outputDirectory>/${project.artifactId}/src</outputDirectory>
+		</fileSet>
+		<fileSet>
+			<directory>${project.basedir}/src/main/webapp</directory>
+			<outputDirectory>/${project.artifactId}/WebContent</outputDirectory>
+		</fileSet>
+	</fileSets>
+	<files>
+		<file>
+			<source>${project.build.directory}/${project.artifactId}.war</source>
+			<outputDirectory>/</outputDirectory>
+		</file>
+	</files>
+</assembly>
diff --git a/model-view-viewmodel/src/main/java/com/iluwatar/model/view/viewmodel/Book.java b/model-view-viewmodel/src/main/java/com/iluwatar/model/view/viewmodel/Book.java
new file mode 100644
index 000000000..b2a924152
--- /dev/null
+++ b/model-view-viewmodel/src/main/java/com/iluwatar/model/view/viewmodel/Book.java
@@ -0,0 +1,37 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2021 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.model.view.viewmodel;
+
+import lombok.AllArgsConstructor;
+import lombok.Data;
+
+@AllArgsConstructor
+@Data
+public class Book {
+
+  private String name;
+  private String author;
+  private String description;
+
+}
diff --git a/model-view-viewmodel/src/main/java/com/iluwatar/model/view/viewmodel/BookService.java b/model-view-viewmodel/src/main/java/com/iluwatar/model/view/viewmodel/BookService.java
new file mode 100644
index 000000000..f01066960
--- /dev/null
+++ b/model-view-viewmodel/src/main/java/com/iluwatar/model/view/viewmodel/BookService.java
@@ -0,0 +1,10 @@
+package com.iluwatar.model.view.viewmodel;
+
+import java.util.List;
+
+public interface BookService {
+  /* List all books
+   * @return all books
+   */
+  public List<Book> load();
+}
diff --git a/model-view-viewmodel/src/main/java/com/iluwatar/model/view/viewmodel/BookServiceImpl.java b/model-view-viewmodel/src/main/java/com/iluwatar/model/view/viewmodel/BookServiceImpl.java
new file mode 100644
index 000000000..e9b440843
--- /dev/null
+++ b/model-view-viewmodel/src/main/java/com/iluwatar/model/view/viewmodel/BookServiceImpl.java
@@ -0,0 +1,38 @@
+package com.iluwatar.model.view.viewmodel;
+
+import java.util.ArrayList;
+import java.util.List;
+
+public class BookServiceImpl implements BookService {
+  private List<Book> designPatternBooks = new ArrayList<>();
+
+  /** Initializes Book Data.
+  * To be used and passed along in load method
+  * In this case, list design pattern books are initialized to be loaded.
+  */
+  public BookServiceImpl() {
+    designPatternBooks.add(new Book(
+        "Head First Design Patterns: A Brain-Friendly Guide",
+        "Eric Freeman, Bert Bates, Kathy Sierra, Elisabeth Robson",
+        "Head First Design Patterns Description"));
+    designPatternBooks.add(new Book(
+        "Design Patterns: Elements of Reusable Object-Oriented Software",
+        "Erich Gamma, Richard Helm, Ralph Johnson, and John Vlissides",
+        "Design Patterns Description"));
+    designPatternBooks.add(new Book(
+        "Patterns of Enterprise Application Architecture", "Martin Fowler",
+        "Patterns of Enterprise Application Architecture Description"));
+    designPatternBooks.add(new Book(
+        "Design Patterns Explained", "Alan Shalloway, James Trott",
+        "Design Patterns Explained Description"));
+    designPatternBooks.add(new Book(
+        "Applying UML and Patterns: An Introduction to "
+         + "Object-Oriented Analysis and Design and Iterative Development",
+        "Craig Larman", "Applying UML and Patterns Description"));
+  }
+
+  public List<Book> load() {
+    return designPatternBooks;
+  }
+
+}
diff --git a/model-view-viewmodel/src/main/java/com/iluwatar/model/view/viewmodel/BookViewModel.java b/model-view-viewmodel/src/main/java/com/iluwatar/model/view/viewmodel/BookViewModel.java
new file mode 100644
index 000000000..6563df723
--- /dev/null
+++ b/model-view-viewmodel/src/main/java/com/iluwatar/model/view/viewmodel/BookViewModel.java
@@ -0,0 +1,43 @@
+package com.iluwatar.model.view.viewmodel;
+
+import java.util.List;
+
+import org.zkoss.bind.annotation.Command;
+import org.zkoss.bind.annotation.NotifyChange;
+import org.zkoss.zk.ui.select.annotation.WireVariable;
+
+public class BookViewModel {
+  
+  @WireVariable
+  private List<Book> bookList;
+  private Book selectedBook;
+  private BookService bookService = new BookServiceImpl();
+  
+  public Book getSelectedBook() {
+    return selectedBook;
+  }
+
+  @NotifyChange("selectedBook")
+  public void setSelectedBook(Book selectedBook) {
+    this.selectedBook = selectedBook;
+  }
+
+  public List<Book> getBookList() {
+    return bookService.load();
+  }
+  
+  /** Deleting a book.
+   * When event is triggered on click of Delete button, 
+   * this method will be notified with the selected entry that will be referenced
+   * and used to delete the selected book from the list of books. 
+   */
+  @Command
+  @NotifyChange({"selectedBook","bookList"})
+  public void deleteBook() {
+    if (selectedBook != null) {
+      getBookList().remove(selectedBook);
+      selectedBook = null;
+    }
+  }
+
+}
diff --git a/model-view-viewmodel/src/main/webapp/META-INF/MANIFEST.MF b/model-view-viewmodel/src/main/webapp/META-INF/MANIFEST.MF
new file mode 100644
index 000000000..4e0a32ad6
--- /dev/null
+++ b/model-view-viewmodel/src/main/webapp/META-INF/MANIFEST.MF
@@ -0,0 +1,8 @@
+Manifest-Version: 1.0
+Specification-Title: ZK Application
+Specification-Version: 1.0
+Specification-Vendor: 
+Implementation-Title: 
+Implementation-URL: http://your-website/
+Implementation-Version: 1.0
+Implementation-Vendor: 
diff --git a/model-view-viewmodel/src/main/webapp/WEB-INF/web.xml b/model-view-viewmodel/src/main/webapp/WEB-INF/web.xml
new file mode 100644
index 000000000..24af77bbb
--- /dev/null
+++ b/model-view-viewmodel/src/main/webapp/WEB-INF/web.xml
@@ -0,0 +1,114 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<web-app version="2.4" xmlns="http://java.sun.com/xml/ns/j2ee"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"> 
+
+	<description><![CDATA[My ZK Application]]></description>
+	<display-name>model-view-viewmodel</display-name>
+
+	<!-- ZK -->
+	<listener>
+		<description>ZK listener for session cleanup</description>
+		<listener-class>org.zkoss.zk.ui.http.HttpSessionListener</listener-class>
+	</listener>
+	<servlet>
+		<description>ZK loader for ZUML pages</description>
+		<servlet-name>zkLoader</servlet-name>
+		<servlet-class>org.zkoss.zk.ui.http.DHtmlLayoutServlet</servlet-class>
+
+		<!-- Must. Specifies URI of the update engine (DHtmlUpdateServlet).
+		It must be the same as <url-pattern> for the update engine.
+		-->
+		<init-param>
+			<param-name>update-uri</param-name>
+			<param-value>/zkau</param-value>
+		</init-param>
+		<load-on-startup>1</load-on-startup><!-- Must -->
+	</servlet>
+	<servlet-mapping>
+		<servlet-name>zkLoader</servlet-name>
+		<url-pattern>*.zul</url-pattern>
+	</servlet-mapping>
+	<servlet-mapping>
+		<servlet-name>zkLoader</servlet-name>
+		<url-pattern>*.zhtml</url-pattern>
+	</servlet-mapping>
+	<servlet>
+		<description>The asynchronous update engine for ZK</description>
+		<servlet-name>auEngine</servlet-name>
+		<servlet-class>org.zkoss.zk.au.http.DHtmlUpdateServlet</servlet-class>
+	</servlet>
+	<servlet-mapping>
+		<servlet-name>auEngine</servlet-name>
+		<url-pattern>/zkau/*</url-pattern>
+	</servlet-mapping>
+	<session-config>
+		<session-timeout>60</session-timeout>
+	</session-config>
+
+	<!-- [Optional] MIME mapping -->
+	<mime-mapping>
+		<extension>doc</extension>
+		<mime-type>application/vnd.ms-word</mime-type>
+	</mime-mapping>
+	<mime-mapping>
+		<extension>gif</extension>
+		<mime-type>image/gif</mime-type>
+	</mime-mapping>
+	<mime-mapping>
+		<extension>htm</extension>
+		<mime-type>text/html</mime-type>
+	</mime-mapping>
+	<mime-mapping>
+		<extension>html</extension>
+		<mime-type>text/html</mime-type>
+	</mime-mapping>
+	<mime-mapping>
+		<extension>jpeg</extension>
+		<mime-type>image/jpeg</mime-type>
+	</mime-mapping>
+	<mime-mapping>
+		<extension>jpg</extension>
+		<mime-type>image/jpeg</mime-type>
+	</mime-mapping>
+	<mime-mapping>
+		<extension>js</extension>
+		<mime-type>text/javascript</mime-type>
+	</mime-mapping>
+	<mime-mapping>
+		<extension>pdf</extension>
+		<mime-type>application/pdf</mime-type>
+	</mime-mapping>
+	<mime-mapping>
+		<extension>png</extension>
+		<mime-type>image/png</mime-type>
+	</mime-mapping>
+	<mime-mapping>
+		<extension>txt</extension>
+		<mime-type>text/plain</mime-type>
+	</mime-mapping>
+	<mime-mapping>
+		<extension>xls</extension>
+		<mime-type>application/vnd.ms-excel</mime-type>
+	</mime-mapping>
+	<mime-mapping>
+		<extension>xml</extension>
+		<mime-type>text/xml</mime-type>
+	</mime-mapping>
+	<mime-mapping>
+		<extension>zhtml</extension>
+		<mime-type>text/html</mime-type>
+	</mime-mapping>
+	<mime-mapping>
+		<extension>zul</extension>
+		<mime-type>text/html</mime-type>
+	</mime-mapping>
+
+	<welcome-file-list>
+		<welcome-file>index.zul</welcome-file>
+		<welcome-file>index.zhtml</welcome-file>
+		<welcome-file>index.html</welcome-file>
+		<welcome-file>index.htm</welcome-file>
+	</welcome-file-list>
+</web-app>
diff --git a/model-view-viewmodel/src/main/webapp/index.zul b/model-view-viewmodel/src/main/webapp/index.zul
new file mode 100644
index 000000000..9cdab7144
--- /dev/null
+++ b/model-view-viewmodel/src/main/webapp/index.zul
@@ -0,0 +1,34 @@
+<zk>
+<window title="List of Books" border="normal" width="600px" apply="org.zkoss.bind.BindComposer" viewModel="@id('vm') @init('com.iluwatar.model.view.viewmodel.BookViewModel')">
+    <vbox hflex="true">
+        <listbox model="@bind(vm.bookList)" selectedItem="@bind(vm.selectedBook)" height="400px" mold="paging">
+            <listhead>
+                <listheader label="Book Name"/>
+                <listheader label="Author"/>               
+            </listhead>
+            <template name="model" var="book">
+                <listitem >
+                    <listcell label="@bind(book.name)"/>
+                    <listcell label="@bind(book.author)"/>
+                </listitem>
+            </template>
+        </listbox>
+    </vbox>
+    <toolbar>
+        <button label="Delete" onClick="@command('deleteBook')" disabled="@load(empty vm.selectedBook)" />
+    </toolbar>
+    <hbox style="margin-top:20px" visible="@bind(not empty vm.selectedBook)">
+		<vbox>
+			<hlayout>
+				Book Name : <label value="@bind(vm.selectedBook.name)" style="font-weight:bold"/>
+			</hlayout>
+			<hlayout>
+				Book Author : <label value="@bind(vm.selectedBook.author)" style="font-weight:bold"/>
+			</hlayout>
+			<hlayout>
+				Book Description : <label value="@bind(vm.selectedBook.description)" style="font-weight:bold"/>
+			</hlayout>
+		</vbox>
+	</hbox>
+</window>
+</zk>
\ No newline at end of file
diff --git a/model-view-viewmodel/src/test/java/com/iluwatar/model/view/viewmodel/BookTest.java b/model-view-viewmodel/src/test/java/com/iluwatar/model/view/viewmodel/BookTest.java
new file mode 100644
index 000000000..40a4d89d0
--- /dev/null
+++ b/model-view-viewmodel/src/test/java/com/iluwatar/model/view/viewmodel/BookTest.java
@@ -0,0 +1,108 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2021 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.model.view.viewmodel;
+
+import static org.hamcrest.CoreMatchers.is;
+import static org.hamcrest.CoreMatchers.not;
+import static org.junit.Assert.assertThat;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+import java.util.List;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import com.google.common.testing.EqualsTester;
+
+class BookTest {
+
+  BookViewModel bvm;
+  Book testBook;
+  List<Book> testBookList;
+  Book testBookTwo;
+  Book testBookThree;
+  
+  @BeforeEach
+  void setUp() {
+    bvm = new BookViewModel();
+    testBook = new Book("Head First Design Patterns: A Brain-Friendly Guide",
+    		"Eric Freeman, Bert Bates, Kathy Sierra, Elisabeth Robson",
+    		"Head First Design Patterns Description");
+    testBookList = bvm.getBookList();
+    testBookTwo = new Book("Head First Design Patterns: A Brain-Friendly Guide",
+	  		"Eric Freeman, Bert Bates, Kathy Sierra, Elisabeth Robson",
+	  		"Head First Design Patterns Description");
+    testBookThree = new Book("Design Patterns: Elements of Reusable Object-Oriented Software",
+            "Erich Gamma, Richard Helm, Ralph Johnson, and John Vlissides",
+            "Design Patterns Description");
+  }
+
+  @Test
+  void testBookModel() {
+	assertNotNull(testBook);
+  }
+  
+  @Test
+  void testEquals() {
+    new EqualsTester().addEqualityGroup(testBook, testBookTwo).testEquals();
+  }
+
+  @Test
+  void testToString() {
+    assertThat(testBook.toString(), is(testBookTwo.toString()));
+    assertThat(testBook.toString(), is(not(testBookThree.toString())));
+  }
+  
+  @Test
+  void testHashCode() {
+    assertTrue(testBook.equals(testBookTwo) && testBookTwo.equals(testBook));
+    assertEquals(testBook.hashCode(), testBookTwo.hashCode());
+  }
+  
+  @Test
+  void testLoadData() {
+    assertNotNull(testBookList);
+    assertTrue(testBookList.get(0).toString().contains("Head First Design Patterns"));
+  }
+
+  @Test
+  void testSelectedData() {
+	bvm.setSelectedBook(testBook);
+    assertNotNull(bvm.getSelectedBook());
+    assertEquals(testBook.toString(), bvm.getSelectedBook().toString());
+    assertTrue(true, bvm.getSelectedBook().toString());
+  }
+
+  @Test
+  void testDeleteData() {
+    bvm.setSelectedBook(testBook);
+    assertNotNull(bvm.getSelectedBook());
+    assertTrue(testBookList.get(0).toString().contains("Head First Design Patterns"));
+    bvm.deleteBook();
+    assertNull(bvm.getSelectedBook());
+    assertFalse(testBookList.get(0).toString().contains("Head First Design Patterns"));
+  }
+
+}
\ No newline at end of file
diff --git a/pom.xml b/pom.xml
index 60dae1679..12a448464 100644
--- a/pom.xml
+++ b/pom.xml
@@ -75,6 +75,7 @@
         <directory-maven-plugin.version>0.3.1</directory-maven-plugin.version>
         <license-maven-plugin.version>3.0</license-maven-plugin.version>
         <urm-maven-plugin.version>1.4.8</urm-maven-plugin.version>
+	<commons-io.version>2.6</commons-io.version>
 
         <!-- SonarCloud -->
         <sonar.host.url>https://sonarcloud.io</sonar.host.url>
@@ -222,6 +223,7 @@
         <module>special-case</module>
         <module>parameter-object</module>
         <module>active-object</module>
+        <module>model-view-viewmodel</module>
     </modules>
 
     <repositories>
@@ -369,9 +371,13 @@
                 <version>${system-lambda.version}</version>
                 <scope>test</scope>
             </dependency>
-        </dependencies>
+		    <dependency>
+			    <groupId>commons-io</groupId>
+			    <artifactId>commons-io</artifactId>
+			    <version>${commons-io.version}</version>
+		        </dependency>
+            </dependencies>
     </dependencyManagement>
-
     <dependencies>
         <dependency>
             <groupId>org.slf4j</groupId>