initial commit

.gitignore

@@ -0,0 +1,115 @@
+# Created by .ignore support plugin (hsz.mobi)
+### Java template
+# Compiled class file
+*.class
+
+# Log file
+*.log
+
+# BlueJ files
+*.ctxt
+
+# Mobile Tools for Java (J2ME)
+.mtj.tmp/
+
+# Package Files #
+*.jar
+*.war
+*.ear
+*.zip
+*.tar.gz
+*.rar
+
+# virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
+hs_err_pid*
+### Eclipse template
+
+.metadata
+bin/
+tmp/
+*.tmp
+*.bak
+*.swp
+*~.nib
+local.properties
+.settings/
+.loadpath
+.recommenders
+
+# Eclipse Core
+.project
+
+# External tool builders
+.externalToolBuilders/
+
+# Locally stored "Eclipse launch configurations"
+*.launch
+
+# PyDev specific (Python IDE for Eclipse)
+*.pydevproject
+
+# CDT-specific (C/C++ Development Tooling)
+.cproject
+
+# JDT-specific (Eclipse Java Development Tools)
+.classpath
+
+# Java annotation processor (APT)
+.factorypath
+
+# PDT-specific (PHP Development Tools)
+.buildpath
+
+# sbteclipse plugin
+.target
+
+# Tern plugin
+.tern-project
+
+# TeXlipse plugin
+.texlipse
+
+# STS (Spring Tool Suite)
+.springBeans
+
+# Code Recommenders
+.recommenders/
+
+# Scala IDE specific (Scala & Java development for Eclipse)
+.cache-main
+.scala_dependencies
+.worksheet
+### macOS template
+*.DS_Store
+.AppleDouble
+.LSOverride
+
+# Icon must end with two \r
+Icon
+
+
+# Thumbnails
+._*
+
+# Files that might appear in the root of a volume
+.DocumentRevisions-V100
+.fseventsd
+.Spotlight-V100
+.TemporaryItems
+.Trashes
+.VolumeIcon.icns
+.com.apple.timemachine.donotpresent
+
+# Directories potentially created on remote AFP share
+.AppleDB
+.AppleDesktop
+Network Trash Folder
+Temporary Items
+.apdisk
+
+#Intellij files
+.idea
+*.iml
+
+#maven build target
+target/

Person.java

@@ -0,0 +1,30 @@
+ 
+
+/**
+ * Created by leon on 1/24/18.
+ */
+public class Person {
+    private final String firstName;
+    private final String lastName;
+
+    public Person(String firstName, String lastName) {
+        this.firstName = firstName;
+        this.lastName = lastName;
+    }
+
+    public String getFirstName() {
+        return firstName;
+    }
+
+    public String getLastName() {
+        return lastName;
+    }
+
+    @Override
+    public String toString() {
+        return new StringBuilder()
+                .append("\nMy first name is " + firstName)
+                .append("\nMy last name is " + lastName)
+                .toString();
+    }
+}

PersonHandler.java

@@ -0,0 +1,65 @@
+ 
+
+/**
+ * Created by leon on 1/24/18.
+ */
+public class PersonHandler {
+    private final Person[] personArray;
+
+    public PersonHandler(Person[] personArray) {
+        this.personArray = personArray;
+    }
+
+    public String whileLoop() {
+        String result = "";
+        // assume there is a `counter`
+        // while `counter` is less than length of array
+            // begin loop
+
+                // use `counter` to identify the `current Person` in the array
+                // get `string Representation` of `currentPerson`
+                // append `stringRepresentation` to `result` variable
+
+            // end loop
+        return result;
+    }
+
+
+
+    public String forLoop() {
+        String result = "";
+        // identify initial value
+        // identify terminal condition
+        // identify increment
+
+        // use the above clauses to declare for-loop signature
+            // begin loop
+                // use `counter` to identify the `current Person` in the array
+                // get `string Representation` of `currentPerson`
+                // append `stringRepresentation` to `result` variable
+            // end loop
+
+        return result;
+    }
+
+
+
+    public String forEachLoop() {
+        String result = "";
+        // identify array's type
+        // identify array's variable-name
+
+        // use the above discoveries to declare for-each-loop signature
+            // begin loop
+                // get `string Representation` of `currentPerson`
+                // append `stringRepresentation` to `result` variable
+            // end loop
+
+        return result;
+    }
+
+
+    public Person[] getPersonArray() {
+        return personArray;
+    }
+}

PersonHandlerTest.java

@@ -0,0 +1,61 @@
+ 
+
+import org.junit.Assert;
+import org.junit.Before;
+import org.junit.Test;
+
+/**
+ * Created by leon on 1/24/18.
+ */
+public class PersonHandlerTest {
+    PersonHandler personHandler;
+    private String expected;
+
+    @Before
+    public void setup() {
+        // : Given
+        Person person1 = new Person("Leon", "Hunter");
+        Person person2 = new Person("Tariq", "Hook");
+        Person person3 = new Person("Dolio", "Durant");
+        Person[] personArray = {person1, person2, person3};
+
+        this.personHandler = new PersonHandler(personArray);
+        this.expected = "\nMy first name is Leon\n" +
+                "My last name is Hunter\n" +
+                "My first name is Tariq\n" +
+                "My last name is Hook\n" +
+                "My first name is Dolio\n" +
+                "My last name is Durant";
+    }
+
+    @Test
+    public void testWhileLoop() {
+        // : When
+        String actual = personHandler.whileLoop();
+
+        // : Then
+        Assert.assertEquals(expected, actual);
+    }
+
+
+    @Test
+    public void testForLoop() {
+        // : When
+        String actual = personHandler.forLoop();
+
+        // : Then
+        Assert.assertEquals(expected, actual);
+    }
+
+
+    @Test
+    public void testForEachLoop() {
+        // : When
+        String actual = personHandler.forEachLoop();
+
+        // : Then
+        Assert.assertEquals(expected, actual);
+    }
+
+
+}

README.md

@@ -0,0 +1,11 @@
+# Iterating an array of `Person` objects
+* **Objective:**
+    * To concatenate the details of `Person` objects by iterating an array  
+
+* **Purpose:**
+    * To demonstrate practical understanding of `while`, `for`, and `for each` loops.
+
+* **Getting started:**
+    * The [PersonHandler](https://github.com/Zipcoder/CR-MesoLabs-Loops-PersonDetails/blob/master/src/main/java/com/zipcodewilmington/PersonHandler.java) class has 3 [method stubs](https://en.wikipedia.org/wiki/Method_stub) to be completed.
+        * The methods contain line-by-line comments to guide you through the process.
+    * Ensure all tests cases pass successfully.