Merge branch 'master' of https://github.com/oracle/oracle-db-examples

Author: nigelbayliss

java/HRWebApp/tomcat-users.xml

@@ -0,0 +1,48 @@
+<?xml version='1.0' encoding='utf-8'?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<tomcat-users xmlns="http://tomcat.apache.org/xml"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://tomcat.apache.org/xml tomcat-users.xsd"
+ version="1.0">
+<!--
+ NOTE: By default, no user is included in the "manager-gui" role required
+ to operate the "/manager/html" web application. If you wish to use this app,
+ you must define such a user - the username and password are arbitrary. It is
+ strongly recommended that you do NOT use one of the users in the commented out
+ section below since they are intended for use with the examples web
+ application.
+-->
+<!--
+ NOTE: The sample user and role entries below are intended for use with the
+ examples web application. They are wrapped in a comment and thus are ignored
+ when reading this file. If you wish to configure these users for use with the
+ examples web application, do not forget to remove the <!.. ..> that surrounds
+ them. You will also need to set the passwords to something appropriate.
+-->
+<!--
+-->
+ <role rolename="manager"/>
+ <role rolename="staff"/>
+ <user username="hradmin" password="welcome" roles="manager,staff"/>
+ <user username="hrstaff" password="welcome" roles="staff"/>
+
+
+ <role rolename="manager-gui"/>
+ <user username="admin" password="welcome" roles="manager-gui"/>
+
+</tomcat-users>

java/README.md

@@ -1,17 +1,14 @@
-# Java based examples
-This repository stores examples that demonstrate various concepts to assist Java and JavaScript developers in designing database applications (i.e., accessing the Oracle Database and peocessing data), leveraging the Java Database Connectivity (JDBC) API, the Univeral Java Connection Pool (UCP), the embedded Java VM (OJVM), Java 8 Nashorn, and JAX-WS (the Web Services Callout utility). 
-
-The examples let you run client-side Java or JavaScript code either on HotSpot JDK/JRE (or other JVMs) or server-side Java or JavaScript directly in the database leveraging the embedded JVM (a.k.a. OJVM and Java 8 Nashorn engine). In addition, OJVM allows invoking remote SOAP or REST Web Services from within your database session (using SQL, PL/SQL or Java). 
-
-## What's in Oracle database 12c Release 2 for Java Developers? 
-* **Java 8**: Java 8 in JDBC/UCP and OJVM; JDBC 4.2
-* **JavaScript with Nashorn**: JDBC/UCP, OJVM
-* **Performance**: JIT (OJVM), Network Compression over WAN (JDBC), Configurable connection health check frequency (UCP), PL/SQL Callbace interface (JDBC)
-* **Scalability**: Shared Pool for Multi-Tenant Database (UCP), Shared Pool for Sharded database (UCP), Sharding Key APIs (JDBC, UCP), DRCP Proxy session sharing, DRCP support for multiple labels
-* **High-Availability**: Java APIs for FAN events (SimpleFan.jar), Planned Maintenance in the driver (JDBC), Application Continuity for XA Datasources, Transaction Guard for XA Datasource
-* **Security**: SSL v1.2 / TLS v 1.2 (JDBC)
-* **Manageability**: XMLconfiguration (UCP), Enable/disable/suspend/resume feature level logging (JDBC), MAX_THINK_TIME for Transactions in progress (DRCP), new statistics view and AWR reports 
-* **Ease of Use** : Web Services Callout (OJVMWCU), Long Identifiers (OJVM), PL/SQL Boolean (JDBC), Debugger for OJVM (Java Debug Wire Protocol)
-
-## [White paper](http://bit.ly/2orH5jf)
-## [See our OTN landing page for more information and resources](http://www.oracle.com/technetwork/database/application-development/java/overview/index.html) 
+# Java based examples
+This is a repository of sample code that will demonstrate various concepts to assist Java developers in designing applications for accessing and processing data from the Oracle Database, leveraging Java Database Connectivity (JDBC), Univeral Connection Pool (UCP); or running Java code directly in the database leveraging the embedded JVM (a.k.a. OJVM).
+
+# What's in Oracle database 12c Release 2 for Java Developers? 
+* **Java 8**: Java 8 in JDBC/UCP and OJVM; JDBC 4.2
+* **Performance**: JIT (OJVM), Network Compression over WAN (JDBC), Configurable connection health check frequency (UCP), PL/SQL Callbace interface (JDBC)
+* **Scalability**: Shared Pool for Multi-Tenant Database (UCP), Shared Pool for Sharded database (UCP), Sharding Key APIs (JDBC, UCP), DRCP Proxy session sharing, DRCP support for multiple labels
+* **High-Availability**: Java APIs for FAN events (SimpleFan.jar), Planned Maintenance in the driver (JDBC), Application Continuity for XA Datasources, Transaction Guard for XA Datasource
+* **Security**: SSL v1.2 / TLS v 1.2 (JDBC)
+* **Manageability**: XMLconfiguration (UCP), Enable/disable/suspend/resume feature level logging (JDBC), MAX_THINK_TIME for Transactions in progress (DRCP), new statistics view and AWR reports 
+* **Ease of Use** : Web Services Callout (OJCM), Long Identifiers (OJVM), PL/SQL Boolean (JDBC), Debugger for OJVM (Java Debug Wire Protocol)
+
+# [White paper](http://bit.ly/2orH5jf)
+# [See our OTN landing page for more information and resources](http://www.oracle.com/technetwork/database/application-development/java/overview/index.html) 

java/jdbc/ConnectionManagementSamples/DRCPSample.java

@@ -14,7 +14,7 @@ or clients. DRCP pools database server processes and sessions (the
  client releases it. 
  
  DRCP can be used with any third party client-side connection pool such as 
- DBCP, C3PO etc.,  Third party client side connection pools must attach and
+ DBCP, C3PO, etc. Third party client side connection pools must attach and
  detach connections explicitly to the connection broker through 
  attachServerConnection() and detachServerConnection(). They should also 
  set Connection Class as shown in the sample. 

java/jdbc/ConnectionManagementSamples/InternalT4Driver.java

@@ -67,7 +67,7 @@ static public void printEmployees(Connection connection) throws SQLException {
  Statement statement = null;
  try {
  statement = connection.createStatement();
- resultSet = statement.executeQuery("SELECT employee_id, first_name FROM"+ 
+ resultSet = statement.executeQuery("SELECT employee_id, first_name FROM "+ 
  "employees order by employee_id");
  while (resultSet.next()) {
  System.out.println("Emp no: " + resultSet.getInt(1) + " Emp name: "

java/ojvm/JSON-Tables.sql

@@ -0,0 +1,12 @@
+REM
+REM DDL for creating a table for the JSON Collection (and documents)
+REM for use by testSODA.java and testSODA.js
+REM
+CREATE TABLE MyFirstJSONCollection (
+ID varchar2(255) not null,
+CREATED_ON timestamp,
+LAST_MODIFIED timestamp,
+VERSION varchar2)255) not null,
+JSON_DOCUMENT BLOB
+)
+;

java/ojvm/README.md

@@ -1,21 +1,21 @@
-# OJVM based examples
-This folder stores Java based examples for the embedded JVM of the Oracle Database (a.k.a. OJVM). We are referring to plain Java code
-with embedded SQL statements, similar to client JDBC code. 
-
-The motivations for running Java code directly in the database include: 
-* reusing Java code, Java libraries, and Java skills (developers) for database modules written in Java thereby allowing the same
- language across the mid-tier and the database-tier. The embedded JVM (a.k.a. OJVM also allows JavaScript (see our examples), Scala
- (see [Igor Racic's examples](http://www.igorandsons.com/)). I also described in [chapter 5 of my book](https://www.amazon.com/dp/1555583296), how to run run Jython, Jacl, Scheme, and Groovy in the database 
-* the other key reason for running Java directly in the database is performance; really? Yes, even if HotSpot or external JVMs run
- pure Java sligthly faster than OJVM (but no one runs pure Java code i.e., Fibonnaci computation in the database), running Java in
- the database cuts the network traffic incurred by the steps involved in processing SQL statements (i.e., parse, and/or bind, and/or
- execute, and fetches).
- You can see for yourself with the Trimlob and Workers examples (running both inside and outside the database).
- 
- * OJVM allows calling out external SOAP and REST Web Services. [See the landing page for more details](http://www.oracle.com/technetwork/database/database-083829.html) 
-
-## [Documentation](http://docs.oracle.com/database/122/JJDEV/toc.htm)
-
-## [What's in Oracle database 12c Release 2 for Java & JavaScript Developers?](http://bit.ly/2orH5jf)
-## [OTN Landing page](http://www.oracle.com/technetwork/database/application-development/java-db/overview/index.html)
-## [Community Forum](https://community.oracle.com/community/database/developer-tools/jvm)
+# Java in the Database (OJVM) examples
+This folder stores Java based examples for the embedded JVM of the Oracle Database (a.k.a. OJVM). We are referring to plain Java code
+with embedded SQL statements, similar to client JDBC code. 
+
+The motivations for running Java code directly in the database include: 
+* reusing Java code, Java libraries, and Java skills (developers) for database modules written in Java thereby allowing the same
+ language across the mid-tier and the database-tier. The embedded JVM (a.k.a. OJVM also allows JavaScript (see our examples), Scala
+ (see [Igor Racic's examples](http://www.igorandsons.com/)). I also described in [chapter 5 of my book](https://www.amazon.com/dp/1555583296), how to run run Jython, Jacl, Scheme, and Groovy in the database 
+* the other key reason for running Java directly in the database is performance; really? Yes, even if HotSpot or external JVMs run
+ pure Java sligthly faster than OJVM (but no one runs pure Java code i.e., Fibonnaci computation in the database), running Java in
+ the database cuts the network traffic incurred by the steps involved in processing SQL statements (i.e., parse, and/or bind, and/or
+ execute, and fetches).
+ You can see for yourself with the TrimBlog and Workers examples (running both inside and outside the database).
+ 
+  In addition, for JSON collections and documents, you can also use the fluent Java API using SODA for Java. See SODA.md and testSODA.java for a complete example.
+
+[Documentation](http://docs.oracle.com/database/122/JJDEV/toc.htm)
+
+[What's in Oracle database 12c Release 2 for Java & JavaScript Developers?](http://bit.ly/2orH5jf)
+
+[Community Forum](https://community.oracle.com/community/database/developer-tools/jvm)

java/ojvm/SODA.md

@@ -0,0 +1,61 @@
+# SODA for Java in the Database (OJVM)
+
+[SODA for Java](https://github.com/oracle/soda-for-java) is Oracle's fluent Java API for accessing JSON collections and documents without any knowledge of SQL.
+See [Getting started with SODA for Java](https://github.com/oracle/soda-for-java/blob/master/doc/Getting-started-example.md) for more details on running testSODA.java with a client JVM (JDK or JRE).
+The goal of this write up is to furnish the steps for running testSODA.java in OJVM and manipulate the JSON collection directly in the database session without moving data around.
+
+**Requirements to run SODA with Java in the database**
+
+(i) Download the [latest orajsoda.jar](https://github.com/oracle/soda-for-java/releases) currently orajsoda-1.0.4.jar 
+
+(ii) Upload orasoda.jar in your database schema
+
+  loadjava -r -v -u hr/hr orajsoda-1.0.4.jar
+
+(iii) Load the [latest javax.json-1.0.4.jar](https://mvnrepository.com/artifact/org.glassfish/javax.json/1.0.4) 
+
+  loadjava -r -v -u hr/hr javax.json-1.0.4.jar
+
+**Prep testSODA.java for OJVM**
+
+(i) Get (copy/paste) testSODA.java from [Getting started with SODA for Java](https://github.com/oracle/soda-for-java/blob/master/doc/Getting-started-example.md)
+
+(ii) Replace the URL in the connect string with the OJVM server-side connect URL
+
+ Replace "jdbc:oracle:thin:@//hostName:port/serviceName"
+ With "jdbc:default:connection"
+ 
+The furnished testSODA.java on this page already has the change 
+
+(iii) load the updated testSODA.java in your schema using
+
+  loadjava -r -v -user hr/hr testSODA.java
+
+(iv) Create a SQL wrapper for invoking the main method
+
+  create or replace procedure testSODA as
+  language java name 'testSODA.main(java.lang.String[])'; 
+
+(v) Invoke the wrapper of the main method and display the output
+
+  set serveroutput on
+  call dbms_java.set_output(2000);
+  call testSODA();
+
+The furnished testSODA.sql performs the steps (v) and (vi). 
+
+From a database SQLPLUS session, issue the following call
+
+ sqlplus hr/hr @testSODA.sql
+ 
+ You should see the following output
+ 
+  * Retrieving the first document by its key *
+
+ { "name" : "Alex", "friends" : "50" }
+
+ * Retrieving documents representing users with at least 300 friends *
+
+ { "name" : "Mia", "friends" : "300" }
+ { "name" : "Gloria", "friends" : "399" }
+

java/ojvm/InternalT2Driver.java renamed to java/ojvm/ServersideConnect.java

@@ -9,9 +9,9 @@
  database.
  
  Step 1: Connect to SQLPLUS using the database USER/PASSWORD. 
- Make sure to have InternalT2Driver.sql accessible on the 
+ Make sure to have ServersideConnect.sql accessible on the 
  client side to execute. 
- Step 2: Run the SQL file after connecting to DB "@InternalT2Driver.sql" 
+ Step 2: Run the SQL file after connecting to DB "@ServersideConnect.sql" 
 
  NOTES
  Use JDK 1.6 and above
@@ -28,17 +28,18 @@
 import oracle.jdbc.pool.OracleDataSource;
 
 
-public class InternalT2Driver {
+public class ServersideConnect {
 
  static public void jrun() throws SQLException {
- // For testing InternalT2Driver
+ // For testing ServersideConnect
  // test("jdbc:oracle:kprb:@");
- test("jdbc:default:connection");
- } 
- /*
+ method1("jdbc:default:connection");
+ method2(); 
+ } 
+ /*
  * Shows using the server side Type 2 driver a.k.a KPRB driver 
  */ 
- static public void test(String url) throws SQLException {
+ static public void method1(String url) throws SQLException {
  Connection connection = null; 
  try {
  System.out.println("Connecting to URL " + url);
@@ -51,18 +52,28 @@ static public void test(String url) throws SQLException {
  // Perform database operation
  printEmployees(connection);
 
+ } catch (SQLException e) {
+ e.printStackTrace();
+ }
+ }
+
+
+ /*
+ * Method to show that a connection is obtained without specifying the URL. 
+ * This method uses the default connection to establish the connection. 
+ */ 
+
+ static public void method2() throws SQLException {
+ Connection connection = null; 
  // Method 2: Using defaultConnection() method
  OracleDriver ora = new OracleDriver();
  connection = ora.defaultConnection();
  System.out.println("Method 2: Getting Default Connection "
  + "using OracleDriver");
  // Perform database operation
  printEmployees(connection);
- }
- finally {
- if (connection != null) connection.close();
- }
- }
+} 
+ /*
 
  /*
  * Displays employee_id and first_name from the employees table.

java/ojvm/InternalT2Driver.sql renamed to java/ojvm/ServersideConnect.sql

@@ -1,9 +1,9 @@
-Rem InternalT2Driver.sql
+Rem ServersideConnect.sql
 Rem
-Rem Copyright (c) 2015, Oracle and/or its affiliates. All rights reserved.
+Rem Copyright (c) 2017, Oracle and/or its affiliates. All rights reserved.
 Rem
 Rem NAME
-Rem InternalT2Driver.sql 
+Rem ServersideConnect.sql 
 Rem
 Rem DESCRIPTION
 Rem SQL for invoking the method which gets a server side connection to
@@ -13,25 +13,25 @@ Rem MODIFIED (MM/DD/YY)
 Rem nbsundar 03/23/15 - Created
 Rem kmensah 03/23/15 - Contributor
 
-rem Reads the content of the Java source from InternalT2Driver.java 
+rem Reads the content of the Java source from ServersideConnect.java 
 rem then compiles it 
 connect hr/hr
-CREATE OR REPLACE AND COMPILE JAVA SOURCE NAMED InternalT2Driver_src AS
-@ InternalT2Driver.java
+CREATE OR REPLACE AND COMPILE JAVA SOURCE NAMED ServersideConnect_src AS
+@ ServersideConnect.java
 /
 
 show error
 
 rem A wrapper (a.k.a. Call Spec), to invoke Java
 rem function in the database from SQL, PL/SQL, and client applications
-CREATE OR REPLACE PROCEDURE InternalT2Driver_proc AS 
-LANGUAGE JAVA NAME 'InternalT2Driver.jrun ()';
+CREATE OR REPLACE PROCEDURE ServersideConnect_proc AS 
+LANGUAGE JAVA NAME 'ServersideConnect.jrun ()';
 /
 
 rem Running the sample
 connect hr/hr
 SET SERVEROUTPUT ON SIZE 10000 
 CALL dbms_java.set_output (10000);
 
-execute InternalT2Driver_proc;
+execute ServersideConnect_proc;