HRWebApp

.gitignore

@@ -2,3 +2,4 @@
 *.class
 *.jar 
 classes/
+.*

java/HRWebApp/Readme.md

@@ -0,0 +1,37 @@
+# Overview of the HR Web Application 
+
+**HR Web Application** is the Java application that uses Oracle Java Database Connectivity (JDBC), Universal Connection Pool (UCP), and Oracle Java in the Database (OJVM) with Oracle Database 12c Release 2. 
+
+It is a light weight web application that uses the MVC (Model, View, Controller) architecture and all the latest tools and technologies.  The presentation layer uses HTML that internally uses JavaScript, JQuery, and CSS to display the results.  The controller will be a servlet that talks to the Oracle Database through the Java Beans.  Maven is used for building the application. 
+
+This Java application leverages HR schema and Employees table of the Oracle Database 12c Release 2.  It is intended to help the HR team of AnyCo Corporation to store the details of all the employees, add any new employee, update the employee details, delete any employee, or provide a salary hike to all employees.  It has two users **HRStaff** and **HRAdmin** who have different roles and access to the application. 
+
+The application has the following functionalities. 
+
+
+* **About** : 
+This page provides an overview of the HR Application and explains the various functionalities it offers.
+
+* **List All Employees** : 
+Use this functionality to retrieve employees information. It lists the employee information such as Employee_ID, First_Name, Last_Name, Email, Phone_Number, Job_Id, and Salary. 
+
+* **Search By Employee ID:** : 
+Use Employee ID that is the primary key of Employees table to search for a particular employee.
+
+* **Update Employee Record:** : 
+Search for a particular employee based on the name of the employee. You can then update employee details in the record, such as first_name, last_name, email, phone_number, job_id and salary using this function.
+
+* **Delete an Employee Record:** : 
+Search for a particular employee record to be deleted using **Search by Employee ID** functionality and then, use the DELETE function to the delete the entire employee record. 
+
+* **Increment Salary:** : 
+Through this functionality, you can alter (increase or decrease) the percentage of the salary hike. A business logic to distribute this salary hike is executed through a stored procedure using Java in the database. 
+
+
+
+
+
+
+
+
+

java/HRWebApp/pom.xml

@@ -0,0 +1,79 @@
+<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/maven-v4_0_0.xsd">
+  <modelVersion>4.0.0</modelVersion>
+  <groupId>com.oracle.jdbc</groupId>
+  <artifactId>JdbcWebSamples</artifactId>
+  <packaging>war</packaging>
+  <version>1.0-SNAPSHOT</version>
+  <name>JdbcWebSamples Maven Webapp</name>
+  <url>http://maven.apache.org</url>
+  <dependencies>
+    <!-- http://mvnrepository.com/artifact/javax.servlet/javax.servlet-api -->
+    <dependency>
+      <groupId>javax.servlet</groupId>
+      <artifactId>javax.servlet-api</artifactId>
+      <version>3.1.0</version>
+    </dependency>
+
+    <!-- http://mvnrepository.com/artifact/com.google.code.gson/gson -->
+    <dependency>
+      <groupId>com.google.code.gson</groupId>
+      <artifactId>gson</artifactId>
+      <version>2.5</version>
+    </dependency>
+
+
+    <dependency>
+      <groupId>junit</groupId>
+      <artifactId>junit</artifactId>
+      <version>3.8.1</version>
+      <scope>test</scope>
+    </dependency>
+    <dependency>
+      <groupId>com.oracle.jdbc</groupId>
+      <artifactId>ojdbc8</artifactId>
+      <version>12.2.0.1</version>
+    </dependency>
+  </dependencies>
+  <build>
+    <finalName>JdbcWebSamples</finalName>
+    <plugins>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-compiler-plugin</artifactId>
+        <version>3.5.1</version>
+        <configuration>
+          <source>1.8</source>
+          <target>1.8</target>
+        </configuration>
+      </plugin>
+    </plugins>
+  </build>
+
+ <repositories>
+    <repository>
+      <id>maven.oracle.com</id>
+      <name>oracle-maven-repo</name>
+      <url>https://maven.oracle.com</url>
+      <layout>default</layout>
+      <releases>
+        <enabled>true</enabled>
+        <updatePolicy>always</updatePolicy>
+      </releases>
+    </repository>
+  </repositories>
+
+ <pluginRepositories>
+    <pluginRepository>
+      <id>maven.oracle.com</id>
+      <name>oracle-maven-repo</name>
+      <url>https://maven.oracle.com</url>
+      <layout>default</layout>
+      <releases>
+        <enabled>true</enabled>
+        <updatePolicy>always</updatePolicy>
+      </releases>
+  </pluginRepository>
+ </pluginRepositories>
+
+</project>

java/HRWebApp/settings-security.xml

@@ -0,0 +1,3 @@
+<settingsSecurity>
+  <master>{generate_master_password_and_add_here}</master>
+</settingsSecurity>

java/HRWebApp/settings.xml

@@ -0,0 +1,42 @@
+<settings
+  xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.1.0 http://maven.apache.org/xsd/settings-1.1.0.xsd"
+  xmlns="http://maven.apache.org/SETTINGS/1.1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+
+<!--
+<proxies> 
+  <proxy>
+    <active>true</active>
+    <protocol>http</protocol>
+     <host>adc-proxy.oracle.com</host>
+     <port>80</port>
+<nonProxyHosts>maven-stage.oracle.com|www-portal-stage.oracle.com|login-stage.oracle.com|*.oraclecorp.com</nonProxyHosts> 
+ </proxy> 
+</proxies>
+ -->
+
+  <servers>
+    <server>
+      <id>maven.oracle.com</id>
+      <username>{Username registered on maven.oracle.com}</username>
+      <password>{Add_registered_password_here}</password>
+      <configuration>
+        <basicAuthScope>
+          <host>ANY</host>
+          <port>ANY</port>
+          <realm>OAM 11g</realm>
+        </basicAuthScope>
+	<httpConfiguration>
+	  <all>
+            <params>
+              <property>
+		<name>http.protocol.allow-circular-redirects</name>
+		<value>%b,true</value>
+	      </property>
+	    </params>
+	  </all>
+	</httpConfiguration>
+      </configuration>
+    </server>
+  </servers>
+
+</settings>

java/HRWebApp/src/conf/MANIFEST.MF

@@ -0,0 +1,2 @@
+Manifest-Version: 1.0
+

java/HRWebApp/src/main/java/com/oracle/jdbc/samples/bean/JdbcBean.java

@@ -0,0 +1,50 @@
+/*
+ * To change this license header, choose License Headers in Project Properties.
+ * To change this template file, choose Tools | Templates
+ * and open the template in the editor.
+ */
+package com.oracle.jdbc.samples.bean;
+
+import java.util.List;
+import com.oracle.jdbc.samples.entity.Employee;
+
+/**
+ *
+ * @author nirmala.sundarappa@oracle.com
+ */
+public interface JdbcBean {
+  /**
+   * Get a list of Employees
+   * @return List of employees
+   */
+  public List<Employee> getEmployees();
+
+  /**
+   * Get List of employee based on empId.   This will always return one row
+   * but returning a List to be make signatures consistent.
+   * @param empId
+   * @return
+   */
+  public List<Employee> getEmployee(int empId);
+
+  /**
+   * Update employee based on employee-id.   Returns the updated record.
+   * @param empId
+   * @return updated record.
+   */
+  public Employee updateEmployee(int empId);
+
+  /**
+   * Get List of employees by First Name pattern
+   * @param fn
+   * @return List of employees with given beginning pattern
+   */
+  public List<Employee>  getEmployeeByFn(String fn);
+
+  /**
+   * Increment salary by a percentage
+   * @param incrementPct percent increase
+   * @return List of employees with incremented salary
+   */
+  public List<Employee> incrementSalary(int incrementPct);
+}

java/HRWebApp/src/main/java/com/oracle/jdbc/samples/bean/JdbcBeanImpl.java

@@ -0,0 +1,128 @@
+package com.oracle.jdbc.samples.bean;
+
+import java.sql.*;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.logging.Level;
+import java.util.logging.Logger;
+import com.oracle.jdbc.samples.entity.Employee;
+import oracle.jdbc.OracleTypes;
+
+
+import java.sql.PreparedStatement;
+import oracle.jdbc.OracleStatement;
+import oracle.jdbc.OracleConnection;
+
+import oracle.jdbc.driver.OracleDriver;
+
+/**
+ *
+ * @author nirmala.sundarappa@oracle.com
+ */
+public class JdbcBeanImpl implements JdbcBean {
+
+  public static Connection getConnection() throws SQLException {
+    DriverManager.registerDriver(new oracle.jdbc.OracleDriver());
+    Connection connection = DriverManager.getConnection("jdbc:oracle:thin:@//myorclhost:1521/myorcldbservice", "hr", "hr");
+
+    return connection;
+  }
+
+  @Override
+  public List<Employee> getEmployees() {
+    List<Employee> returnValue = new ArrayList<>();
+    try (Connection connection = getConnection()) {
+      try (Statement statement = connection.createStatement()) {
+        try (ResultSet resultSet = statement.executeQuery("SELECT Employee_Id, First_Name, Last_Name, Email, Phone_Number, Job_Id, Salary FROM EMPLOYEES")) {
+          while(resultSet.next()) {
+            returnValue.add(new Employee(resultSet));
+          }
+        }
+      }
+    } catch (SQLException ex) {
+      logger.log(Level.SEVERE, null, ex);
+      ex.printStackTrace();
+    }
+
+    return returnValue;
+  }
+
+  /**
+   * Returns the employee object for the given empId.   Returns
+   * @param empId
+   * @return
+   */
+  @Override
+  public List<Employee> getEmployee(int empId) {
+    List<Employee> returnValue = new ArrayList<>();
+
+    try (Connection connection = getConnection()) {
+      try (PreparedStatement preparedStatement = connection.prepareStatement(
+          "SELECT Employee_Id, First_Name, Last_Name, Email, Phone_Number, Job_Id, Salary FROM EMPLOYEES WHERE Employee_Id = ?")) {
+        preparedStatement.setInt(1, empId);
+        try (ResultSet resultSet = preparedStatement.executeQuery()) {
+          if(resultSet.next()) {
+            returnValue.add(new Employee(resultSet));
+          }
+        }
+      }
+    } catch (SQLException ex) {
+      logger.log(Level.SEVERE, null, ex);
+      ex.printStackTrace();
+    }
+
+    return returnValue;
+  }
+
+  @Override
+  public Employee updateEmployee(int empId) {
+    throw new UnsupportedOperationException("Not supported yet."); //To change body of generated methods, choose Tools | Templates.
+  }
+
+  @Override
+  public List<Employee> getEmployeeByFn(String fn) {
+    List<Employee> returnValue = new ArrayList<>();
+
+    try (Connection connection = getConnection()) {
+      try (PreparedStatement preparedStatement = connection.prepareStatement(
+          "SELECT Employee_Id, First_Name, Last_Name, Email, Phone_Number, Job_Id, Salary FROM EMPLOYEES WHERE First_Name LIKE ?")) {
+        preparedStatement.setString(1, fn + '%');
+        try (ResultSet resultSet = preparedStatement.executeQuery()) {
+          while(resultSet.next()) {
+            returnValue.add(new Employee(resultSet));
+          }
+        }
+      }
+    } catch (SQLException ex) {
+      logger.log(Level.SEVERE, null, ex);
+      ex.printStackTrace();
+    }
+
+    return returnValue;
+  }
+
+   @Override
+   public List<Employee> incrementSalary (int incrementPct) {
+     List<Employee> returnValue = new ArrayList<>();
+
+     try (Connection connection = getConnection()) {
+       try (CallableStatement callableStatement = connection.prepareCall("begin ? :=  refcur_pkg.incrementsalary(?); end;")) {
+         callableStatement.registerOutParameter(1, OracleTypes.CURSOR);
+         callableStatement.setInt(2, incrementPct);
+         callableStatement.execute();
+         try (ResultSet resultSet = (ResultSet) callableStatement.getObject(1)) {
+           while (resultSet.next()) {
+             returnValue.add(new Employee(resultSet));
+           }
+         }
+       }
+     } catch (SQLException ex) {
+       logger.log(Level.SEVERE, null, ex);
+       ex.printStackTrace();
+     }
+
+     return returnValue;
+   }
+
+  static final Logger logger = Logger.getLogger("com.oracle.jdbc.samples.bean.JdbcBeanImpl");
+}