Removed the "jdbc-ucp" folder

Author: Nirmala Sundarappa

java/jdbc-ucp

@@ -0,0 +1,154 @@
+/* Copyright (c) 2015, Oracle and/or its affiliates. All rights reserved.*/
+
+/*
+ DESCRIPTION
+ The code sample demonstrates how to connect to the Oracle Database using 
+ Proxy authentication or N-tier authentication. Proxy authentication is the
+ process of using a middle tier for user authentication. Proxy connections
+ can be created using any one of the following options. 
+ (a) USER NAME: Done by supplying the user name or the password or both.
+ (b) DISTINGUISHED NAME: This is a global name in lieu of the password of
+ the user being proxied for.
+ (c) CERTIFICATE:More encrypted way of passing the credentials of the user,
+ who is to be proxied, to the database.
+ 
+ Step 1: Connect to SQLPLUS using the database USER/PASSWORD. 
+ Make sure to have ProxySessionSample.sql accessible to 
+ execute from sqlplus. Update ProxySessionSample.sql with correct
+ SYSTEM username and password. 
+ Step 2: Run the SQL file after connecting to DB "@ProxySessionSample.sql" 
+ Step 3: Enter the Database details in this file. DB_URL is required. 
+ Step 4: Run the sample with "ant ProxySessionSample" 
+
+ NOTES
+ Use JDK 1.7 and above
+
+ MODIFIED (MM/DD/YY)
+ nbsundar 04/10/15 - creation
+ */
+ 
+import java.sql.Connection;
+import java.sql.ResultSet;
+import java.sql.SQLException;
+import java.sql.Statement;
+import java.util.Properties;
+
+import oracle.jdbc.OracleConnection;
+import oracle.jdbc.pool.OracleDataSource;
+
+class ProxySessionSample {
+ final static String DB_URL= "jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS=(HOST=myhost)(PORT=1521)(PROTOCOL=tcp))(CONNECT_DATA=(SERVICE_NAME=myorcldbservicename)))"; 
+ 
+ /*
+ * The code sample shows how to connect to an Oracle Database 
+ * using Proxy Session. The sample has the following: 
+ * (a) A shared table, PROXY_ACCOUNT owned by user PROXY.
+ * (b) Users JEFF and SMITH have necessary roles for performing a SELECT, 
+ * INSERT and DELETE on table PROXY_ACCOUNT owned by PROXY user, 
+ * through the roles select_role, insert_role and delete_role. 
+ * Note that select_role has SELECT, insert_role has INSERT and delete_role
+ * has DELETE privileges granted. 
+ *
+ * The control flow in the sample is as follows:
+ * (1) Obtain a database connection of user PROXY.
+ * (2) Provide required privileges to users JEFF and SMITH to connect to the
+ * database through user PROXY.
+ * (3) Open a proxy session for users JEFF and SMITH. This does not open a
+ * new connection to the database instead uses the pre-existing connection
+ *(as user PROXY). The proxy session is established with the roles specified
+ * while opening the connection. 
+ */ 
+ public static void main(String args[]) throws SQLException { 
+ OracleDataSource ods = new OracleDataSource(); 
+ 
+ // retrieve a database connection of user "proxy"
+ OracleConnection proxyConn = getConnection("proxy", "proxy", DB_URL, ods); 
+
+ // isProxySession is false before opening a proxy session
+ System.out.println("Before a proxy session is open, isProxySession: "
+ + proxyConn.isProxySession());
+ // check if the user is "proxy"
+ checkUser(proxyConn);
+ 
+ // open a proxy session for the user "jeff".
+ // This session reuses existing proxy session to connect as user, "jeff". 
+ // There is no need to authenticate the user "jeff". 
+ demoProxySession(proxyConn, "jeff"); 
+ 
+ // open a proxy session for the user "smith".
+ // This session reuses existing proxy session to connect as user "smith" 
+ // There is no need to authenticate the user "smith". 
+ demoProxySession(proxyConn, "smith");
+ 
+ // Close the proxy connection
+ proxyConn.close(); 
+ }
+ /*
+ * Demonstrates the following: 
+ * (1) Start a Proxy Session: Starts the proxy Session with corresponding
+ * roles and authenticates the users "jeff" or "smith". 
+ * (2) Access Proxy user's table: The users "jeff" or "smith" can access 
+ * the "proxy" user table, 'proxy_account' through the proxy session. 
+ * (3) Close the Proxy Session: Close the proxy session for the user "jeff" 
+ * or "smith".
+ */
+ private static void demoProxySession(OracleConnection conn, String proxyUser)
+ throws SQLException {
+ Properties prop = new Properties();
+ prop.put(OracleConnection.PROXY_USER_NAME, proxyUser); 
+ // corresponds to the alter sql statement (select, insert roles)
+ String[] roles = { "select_role", "insert_role" };
+ prop.put(OracleConnection.PROXY_ROLES, roles);
+ conn.openProxySession(OracleConnection.PROXYTYPE_USER_NAME, prop);
+ System.out.println("======= demoProxySession BEGIN =======");
+ System.out.println("After the proxy session is open, isProxySession: "
+ + conn.isProxySession());
+ // proxy session can act as users "jeff" & "smith" to access the 
+ // user "proxy" tables 
+ try (Statement stmt = conn.createStatement()) {
+ // Check who is the database user
+ checkUser(conn);
+ // play insert_role into proxy.proxy_account, go through
+ stmt.execute("insert into proxy.proxy_account values (1)");
+ System.out.println("insert into proxy.proxy_account, allowed");
+ // play select_role from proxy.proxy_account, go through 
+ try (ResultSet rset = stmt.executeQuery("select * from " 
+ + " proxy.proxy_account")) {
+ while (rset.next()) {
+ // display the execution results of a select query. 
+ System.out.println(rset.getString(1));
+ }
+ System.out.println("select * from proxy.proxy_account, allowed");
+ // play delete_role from proxy.proxy_account, SQLException
+ stmt.execute("delete from proxy.proxy_account where purchase=1"); 
+ } catch(Exception e) {
+ System.out.println("delete from proxy.proxy_account, not allowed");
+ }
+ System.out.println("======= demoProxySession END =======");
+ // Close the proxy session of user "jeff" 
+ conn.close(OracleConnection.PROXY_SESSION);
+ }
+ }
+ /*
+ * Gets a database connection using a proxy user.
+ */
+ private static OracleConnection getConnection(String user, String password,
+ String url, OracleDataSource ods) throws SQLException {
+ ods.setUser(user);
+ ods.setPassword(password);
+ ods.setURL(url);
+ return ((OracleConnection) ods.getConnection());
+ }
+ /*
+ * Checks the database user. Note that the user will be proxy.
+ */
+ private static void checkUser(Connection conn) throws SQLException {
+ try (Statement stmt = conn.createStatement()) {
+ try (ResultSet rset = stmt.executeQuery("select user from dual")) {
+ while (rset.next()) {
+ System.out.println("User is: " + rset.getString(1));
+ }
+ }
+ } 
+ }
+} 

java/jdbc/ConnectionManagementSamples/ProxySessionSample.java

@@ -0,0 +1,68 @@
+Rem ProxySessionSample.sql
+Rem
+Rem Copyright (c) 2015, Oracle and/or its affiliates. All rights reserved.
+Rem
+Rem NAME
+Rem ProxySessionSample.sql - Complimentory SQL file for ProxySessionSample.java
+Rem
+Rem DESCRIPTION
+Rem The sample shows connecting to the Oracle Database using Proxy authentication
+Rem or N-tier authentication.
+Rem
+Rem MODIFIED (MM/DD/YY)
+Rem nbsundar 04/10/15 - Created
+Rem
+
+Rem This sample requires connecting as a system user that has the ability to
+Rem create user and grant necessary privileges
+connect system/manager
+
+Rem Clean up before creating necesary schema
+drop role select_role;
+drop role insert_role;
+drop role delete_role;
+
+drop user jeff cascade;
+drop user smith cascade;
+drop user proxy cascade;
+
+Rem Create new database users "jeff", "smith" and "proxy" 
+create user proxy identified by proxy;
+create user jeff identified by jeffpasswd;
+create user smith identified by smithpasswd;
+
+Rem Grant necessary privileges to DB users "proxy", "jeff" and "smith" 
+grant create session, connect, resource, unlimited tablespace to proxy;
+grant create session, connect, resource, unlimited tablespace to jeff;
+grant create session, connect, resource, unlimited tablespace to smith;
+
+Rem Create roles and grant necessary roles to users "jeff" and "smith"
+create role select_role;
+create role insert_role;
+create role delete_role;
+
+Rem Connect as a proxy user 
+connect proxy/proxy
+
+Rem Create the table which will be shared with the users "jeff" and "smith"
+create table proxy_account (purchase number);
+insert into proxy_account values(11);
+insert into proxy_account values(13);
+
+Rem Grant the required privileges
+grant select on proxy_account to select_role;
+grant insert on proxy_account to insert_role;
+grant delete on proxy_account to delete_role;
+
+Rem Connect as system user to grant necessary roles to the DB users "jeff" and "smith"
+connect system/manager
+grant select_role, insert_role, delete_role to jeff;
+grant select_role, insert_role, delete_role to smith;
+
+Rem grant the users "jeff" and "smith" to connect through proxy with specified roles
+alter user jeff grant connect through proxy with role select_role, insert_role;
+alter user smith grant connect through proxy with role select_role, insert_role;
+
+commit;
+exit
+