From 81088757230d885be7d13cc5376120eb7c7730be Mon Sep 17 00:00:00 2001
From: Jonathan <jonathan.ihm@gmail.com>
Date: Sat, 6 Jan 2018 11:01:49 -0600
Subject: [PATCH] BAEL-1068 (#3070)

* BAEL-1068 - Javadoc example classes

* BAEL-1068 - Formatting change for pom.xml

* Updated javadoc comments to reflect article example
---
 core-java/pom.xml                             | 10 +++
 .../java/com/baeldung/javadoc/Person.java     | 22 +++++++
 .../java/com/baeldung/javadoc/SuperHero.java  | 64 +++++++++++++++++++
 3 files changed, 96 insertions(+)
 create mode 100644 core-java/src/main/java/com/baeldung/javadoc/Person.java
 create mode 100644 core-java/src/main/java/com/baeldung/javadoc/SuperHero.java

diff --git a/core-java/pom.xml b/core-java/pom.xml
index f99e4d68cf..5c1e9fcad0 100644
--- a/core-java/pom.xml
+++ b/core-java/pom.xml
@@ -389,6 +389,16 @@
                     </arguments>
                 </configuration>
             </plugin>
+            
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-javadoc-plugin</artifactId>
+                <version>3.0.0-M1</version>
+                <configuration>
+                    <source>1.8</source>
+	                <target>1.8</target>
+                </configuration>
+            </plugin>
 
 
         </plugins>
diff --git a/core-java/src/main/java/com/baeldung/javadoc/Person.java b/core-java/src/main/java/com/baeldung/javadoc/Person.java
new file mode 100644
index 0000000000..5efb410de4
--- /dev/null
+++ b/core-java/src/main/java/com/baeldung/javadoc/Person.java
@@ -0,0 +1,22 @@
+package com.baeldung.javadoc;
+
+public class Person {
+	/**
+	 * This is a first name
+	 */
+	private String firstName;
+	private String lastName;
+	
+	public String getFirstName() {
+		return firstName;
+	}
+	public void setFirstName(String firstName) {
+		this.firstName = firstName;
+	}
+	public String getLastName() {
+		return lastName;
+	}
+	public void setLastName(String lastName) {
+		this.lastName = lastName;
+	}
+}
diff --git a/core-java/src/main/java/com/baeldung/javadoc/SuperHero.java b/core-java/src/main/java/com/baeldung/javadoc/SuperHero.java
new file mode 100644
index 0000000000..029a779cdb
--- /dev/null
+++ b/core-java/src/main/java/com/baeldung/javadoc/SuperHero.java
@@ -0,0 +1,64 @@
+package com.baeldung.javadoc;
+
+/**
+ * Hero is the main entity we will be using to . . .
+ * @author Captain America
+ * 
+ */
+public class SuperHero extends Person {
+
+    /**
+     * The public name of a hero that is common knowledge
+     */
+    private String heroName;
+    private String uniquePower;
+    private int health;
+    private int defense;
+	
+    /**
+     * <p>This is a simple description of the method. . .
+     * <a href="http://www.supermanisthegreatest.com">Superman!</a>
+     * </p>
+     * @param incomingDamage the amount of incoming damage
+     * @return the amount of health hero has after attack
+     * @see <a href="http://www.link_to_jira/HERO-402">HERO-402</a>
+     * @since 1.0
+     */
+    public int successfullyAttacked(int incomingDamage, String damageType) {
+    	// do things
+        return 0;
+    }
+
+	public String getHeroName() {
+		return heroName;
+	}
+
+	public void setHeroName(String heroName) {
+		this.heroName = heroName;
+	}
+
+	public String getUniquePower() {
+		return uniquePower;
+	}
+
+	public void setUniquePower(String uniquePower) {
+		this.uniquePower = uniquePower;
+	}
+
+	public int getHealth() {
+		return health;
+	}
+
+	public void setHealth(int health) {
+		this.health = health;
+	}
+
+	public int getDefense() {
+		return defense;
+	}
+
+	public void setDefense(int defense) {
+		this.defense = defense;
+	}
+	
+}