[FAB-15213] Update Commercial Paper for Java

Update with Java Contract

Change-Id: Iced5568a248c1474ae4b6fb0352d23e49ebfc252
Signed-off-by: Matthew B. White <whitemat@uk.ibm.com>
Signed-off-by: James Taylor <jamest@uk.ibm.com>

commercial-paper/README.md

@@ -0,0 +1,156 @@
+# Commercial Paper Tutorial
+
+This folder contains the code for an introductory tutorial to Smart Contract development. It is based around the scenario of Commercial Paper.
+The full tutorial, including full scenario details and line by line code walkthroughs is in the [Hyperledger Fabric documentation](https://hyperledger-fabric.readthedocs.io/en/release-1.4/tutorial/commercial_paper.html).
+
+## Scenario
+
+In this tutorial two organizations, MagnetoCorp and DigiBank, trade commercial paper with each other using PaperNet, a Hyperledger Fabric blockchain network.
+
+Once you’ve set up a basic network, you’ll act as Isabella, an employee of MagnetoCorp, who will issue a commercial paper on its behalf. You’ll then switch hats to take the role of Balaji, an employee of DigiBank, who will buy this commercial paper, hold it for a period of time, and then redeem it with MagnetoCorp for a small profit.
+
+![](https://hyperledger-fabric.readthedocs.io/en/release-1.4/_images/commercial_paper.diagram.1.png)
+
+## Quick Start
+
+You are strongly advised to read the full tutorial to get information about the code and the scenario. Below are the quick start instructions for running the tutorial, but no details on the how or why it works.
+
+### Steps
+
+1) Start the Hyperledger Fabric infrastructure
+
+ _although the scenario has two organizations, the 'basic' or 'developement' Fabric infrastructure will be used_
+
+2) Install and Instantiate the Contracts
+
+3) Run client applications in the roles of MagnetoCorp and Digibank to trade the commecial paper
+
+ - Issue the Paper as Magnetocorp
+ - Buy the paper as DigiBank
+ - Redeem the paper as DigiBank
+
+## Setup
+
+You will need a a machine with the following
+
+- Docker and docker-compose installed
+- Node.js v8 if you want to run Javascript client applications
+- Java v8 if you want to run Java client applications
+- Maven to build the Java applications
+
+It is advised to have 3 console windows open; one to monitor the infrastructure and one each for MagnetoCorp and DigiBank
+
+If you haven't already clone the repository to a directory of your choice, and change to the `commercial-paper` directory
+
+```
+git clone https://github.com/hyperledger/fabric-samples.git
+cd fabric-samples/commercial-paper
+```
+
+This `README.md` file is in the the `commercial-paper` directory, the source code for client applications and the contracts ins in the `ogranization` directory, and some helper scripts are in the `roles` directory.
+
+## Running the Infrastructure
+
+In one console window, run the `./roles/network-starter.sh` script; this will start the basic infrastructure and also start monitoring all the docker containers. 
+
+You can cancel this if you wish to reuse the terminal, but it's best left open. 
+
+### Install and Instantiate the contract
+
+The contract code is available as either JavaScript or Java. You can use either one, and the choice of contract language does not affect the choice of client langauge.
+
+In your 'MagnetoCorp' window run the following command
+
+`./roles/magnetocorp.sh`
+
+This will start a docker container for Fabric CLI commands, and put you in the correct directory for the source code. 
+
+**For a JavaScript Contract:**
+
+```
+docker exec cliMagnetoCorp peer chaincode install -n papercontract -v 0 -p /opt/gopath/src/github.com/contract -l node
+
+docker exec cliMagnetoCorp peer chaincode instantiate -n papercontract -v 0 -l node -c '{"Args":["org.papernet.commercialpaper:instantiate"]}' -C mychannel -P "AND ('Org1MSP.member')"
+```
+
+**For a Java Contract:**
+
+```
+docker exec cliMagnetoCorp peer chaincode install -n papercontract -v 0 -p /opt/gopath/src/github.com/contract-java -l java
+
+docker exec cliMagnetoCorp peer chaincode instantiate -n papercontract -v 0 -l java -c '{"Args":["org.papernet.commercialpaper:instantiate"]}' -C mychannel -P "AND ('Org1MSP.member')"
+```
+
+> If you want to try both a Java and JavaScript Contract, then you will need to restart the infrastructure and deploy the other contract. 
+
+## Client Applications
+
+Note for Java applications you will need to compile the Java Code using maven. Use this command in each application-java directory
+
+```
+mvn clean package
+```
+
+Note for JavaScript applications you will need to install the dependencies first. Use this command in each application directory
+
+```
+npm install
+```
+
+
+>  Note that there is NO dependency between the langauge of any one client application and any contract. Mix and match as you wish!
+
+### Issue the paper 
+
+This is running as *MagnetoCorp* so you can stay in the same window. These commands are to be run in the 
+`commercial-paper/organization/magnetocorp/application` directory or the `commercial-paper/organization/magnetocorp/application-java`
+
+*Add the Identity to be used*
+
+```
+node addToWallet.js
+# or 
+java -cp target/commercial-paper-0.0.1-SNAPSHOT.jar org.magnetocorp.AddToWallet
+```
+
+*Issue the Commercial Paper*
+
+```
+node issue.js
+# or 
+java -cp target/commercial-paper-0.0.1-SNAPSHOT.jar org.magnetocorp.Issue
+```
+
+### Buy and Redeem the paper
+
+This is running as *Digibank*; you've not acted as this organization before so in your 'Digibank' window run the following command in the 
+`fabric-samples/commercial-paper/` directory
+
+`./roles/digibank.sh` 
+
+You can now run the applications to buy and redeem the paper. Change to either the 
+`commercial-paper/organization/digibank/application` directory or `commercial-paper/organization/digibank/application-java`
+
+*Add the Identity to be used*
+
+```
+node addToWallet.js
+# or 
+java -cp target/commercial-paper-0.0.1-SNAPSHOT.jar org.digibank.AddToWallet
+```
+
+*Buy the paper*
+
+```
+node buy.js
+# or
+java -cp target/commercial-paper-0.0.1-SNAPSHOT.jar org.digibank.Buy
+```
+
+*Redeem*
+
+```
+node redeem.js
+# or 
+java -cp target/commercial-paper-0.0.1-SNAPSHOT.jar org.digibank.Redeem
+```

commercial-paper/organization/digibank/.gitignore

@@ -0,0 +1 @@
+identity

commercial-paper/organization/digibank/application-java/.classpath

@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<classpath>
+ <classpathentry kind="src" output="target/classes" path="src">
+ <attributes>
+ <attribute name="optional" value="true"/>
+ <attribute name="maven.pomderived" value="true"/>
+ </attributes>
+ </classpathentry>
+ <classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER/org.eclipse.jdt.internal.debug.ui.launcher.StandardVMType/JavaSE-1.8">
+ <attributes>
+ <attribute name="maven.pomderived" value="true"/>
+ </attributes>
+ </classpathentry>
+ <classpathentry kind="con" path="org.eclipse.m2e.MAVEN2_CLASSPATH_CONTAINER">
+ <attributes>
+ <attribute name="maven.pomderived" value="true"/>
+ </attributes>
+ </classpathentry>
+ <classpathentry kind="output" path="target/classes"/>
+</classpath>

commercial-paper/organization/digibank/application-java/.gitignore

@@ -0,0 +1 @@
+target/

commercial-paper/organization/digibank/application-java/.settings/org.eclipse.jdt.core.prefs

@@ -0,0 +1,6 @@
+eclipse.preferences.version=1
+org.eclipse.jdt.core.compiler.codegen.targetPlatform=1.8
+org.eclipse.jdt.core.compiler.compliance=1.8
+org.eclipse.jdt.core.compiler.problem.forbiddenReference=warning
+org.eclipse.jdt.core.compiler.release=disabled
+org.eclipse.jdt.core.compiler.source=1.8

commercial-paper/organization/digibank/application-java/.settings/org.eclipse.m2e.core.prefs

@@ -0,0 +1,4 @@
+activeProfiles=
+eclipse.preferences.version=1
+resolveWorkspaceProjects=true
+version=1

commercial-paper/organization/digibank/application-java/dependency-reduced-pom.xml

@@ -0,0 +1,61 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<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>commercial-paper</groupId>
+ <artifactId>commercial-paper</artifactId>
+ <version>0.0.1-SNAPSHOT</version>
+ <build>
+ <sourceDirectory>src</sourceDirectory>
+ <plugins>
+ <plugin>
+ <artifactId>maven-compiler-plugin</artifactId>
+ <version>3.8.0</version>
+ <configuration>
+ <source>1.8</source>
+ <target>1.8</target>
+ </configuration>
+ </plugin>
+ <plugin>
+ <artifactId>maven-shade-plugin</artifactId>
+ <version>3.2.0</version>
+ <executions>
+ <execution>
+ <phase>package</phase>
+ <goals>
+ <goal>shade</goal>
+ </goals>
+ </execution>
+ </executions>
+ <configuration>
+ <filters>
+ <filter>
+ <artifact>*:*</artifact>
+ <excludes>
+ <exclude>META-INF/*.SF</exclude>
+ <exclude>META-INF/*.DSA</exclude>
+ <exclude>META-INF/*.RSA</exclude>
+ </excludes>
+ </filter>
+ </filters>
+ </configuration>
+ </plugin>
+ </plugins>
+ </build>
+ <repositories>
+ <repository>
+ <id>hyperledger</id>
+ <name>Hyperledger Nexus</name>
+ <url>https://nexus.hyperledger.org/content/repositories/snapshots</url>
+ </repository>
+ <repository>
+ <id>jitpack.io</id>
+ <url>https://jitpack.io</url>
+ </repository>
+ </repositories>
+ <properties>
+ <fabric-chaincode-java.version>1.4.2</fabric-chaincode-java.version>
+ <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
+ <java.version>1.8</java.version>
+ <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+ </properties>
+</project>

commercial-paper/organization/digibank/application-java/pom.xml

@@ -0,0 +1,99 @@
+<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/xsd/maven-4.0.0.xsd">
+ <modelVersion>4.0.0</modelVersion>
+ <groupId>commercial-paper</groupId>
+ <artifactId>commercial-paper</artifactId>
+ <version>0.0.1-SNAPSHOT</version>
+
+ <properties>
+
+ <!-- Generic properties -->
+ <java.version>1.8</java.version>
+ <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+ <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
+
+ <!-- fabric-chaincode-java -->
+ <fabric-chaincode-java.version>1.4.2</fabric-chaincode-java.version>
+
+ </properties>
+
+ <build>
+ <sourceDirectory>src</sourceDirectory>
+ <plugins>
+ <plugin>
+ <artifactId>maven-compiler-plugin</artifactId>
+ <version>3.8.0</version>
+ <configuration>
+ <source>1.8</source>
+ <target>1.8</target>
+ </configuration>
+ </plugin>
+
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-shade-plugin</artifactId>
+ <version>3.2.0</version>
+ <executions>
+ <!-- Attach the shade goal into the package phase -->
+ <execution>
+ <phase>package</phase>
+ <goals>
+ <goal>shade</goal>
+ </goals>
+ </execution>
+ </executions>
+ <configuration>
+ <filters>
+ <filter>
+ <artifact>*:*</artifact>
+ <excludes>
+ <exclude>META-INF/*.SF</exclude>
+ <exclude>META-INF/*.DSA</exclude>
+ <exclude>META-INF/*.RSA</exclude>
+ </excludes>
+ </filter>
+ </filters>
+ </configuration>
+ </plugin>
+
+ </plugins>
+ </build>
+
+ <repositories>
+ <repository>
+ <id>hyperledger</id>
+ <name>Hyperledger Nexus</name>
+ <url>https://nexus.hyperledger.org/content/repositories/snapshots</url>
+ </repository>
+
+ <repository>
+ <id>jitpack.io</id>
+ <url>https://jitpack.io</url>
+ </repository>
+ </repositories>
+
+ <dependencies>
+ <dependency>
+ <groupId>org.hyperledger.fabric-gateway-java</groupId>
+ <artifactId>fabric-gateway-java</artifactId>
+ <version>1.4.0-SNAPSHOT</version>
+ </dependency>
+
+ <!-- Used for datatype annotations only -->
+ <dependency>
+ <groupId>org.hyperledger.fabric-chaincode-java</groupId>
+ <artifactId>fabric-chaincode-shim</artifactId>
+ <version>${fabric-chaincode-java.version}</version>
+ <scope>compile</scope>
+ </dependency>
+
+ <!-- https://mvnrepository.com/artifact/org.json/json -->
+ <dependency>
+ <groupId>org.json</groupId>
+ <artifactId>json</artifactId>
+ <version>20180813</version>
+ </dependency>
+
+ </dependencies>
+</project>