Java {#rn-announce}
===================

Prerequisites
-------------

You must create a P12 certificate. See the *[Getting Started with REST Developer Guide](https://developer.cybersource.com/docs/cybs/en-us/platform/developer/all/rest/rest-getting-started/restgs-jwt-message-intro/restgs-security-p12-intro.md "")*.  
With this change to use a P12 certificate in your Java SOAP toolkit configuration, your application must meet these new requirements:
* Java 9 or higher
* Jakarta XML Web Services API
* JAX-WS Runtime
* Jakarta XML Web Services Distribution
* Bouncy Castle Cryptography APIs for JDK 1.5 to JDK 1.8
* Apache XML Security
* WSDL 1.219 or earlier

Java Migration Steps
--------------------

Follow these steps to upgrade your Java code:

1. Add these dependencies to the *pom.xml* file:

   ```
   <dependencies>
     <dependency>
       <groupId>jakarta.xml.ws</groupId>
       <artifactId>jakarta.xml.ws-api</artifactId>
       <version>4.0.2</version>
     </dependency>
     <dependency>
       <groupId>com.sun.xml.ws</groupId>
       <artifactId>jaxws-rt</artifactId>
       <version>4.0.3</version>
       <scope>runtime</scope>
     </dependency>
     <dependency>
       <groupId>com.sun.xml.ws</groupId>
       <artifactId>jaxws-ri</artifactId>
       <version>4.0.3</version>
       <type>pom</type>
     </dependency>
     <dependency>
       <groupId>org.bouncycastle</groupId>
       <artifactId>bcprov-jdk15to18</artifactId>
       <version>1.78</version>
     </dependency>
     <dependency>
       <groupId>org.apache.santuario</groupId>
       <artifactId>xmlsec</artifactId>
       <version>4.0.3</version>
     </dependency>
   </dependencies>
   ```
2. Add this plugin to the *pom.xml* file:

   ```
   <build>
     <plugins>
       <plugin>
         <groupId>com.sun.xml.ws</groupId>
         <artifactId>jaxws-maven-plugin</artifactId>
         <version>4.0.3</version>
         <configuration>
   	  <wsdlUrls>
              <wsdlUrl>https://ics2wstest.ic3.com/commerce/1.x/transactionProcessor/CyberSourceTransaction_1.219.wsdl</wsdlUrl>
           </wsdlUrls>
           <keep>true</keep>
           <packageName>com.cybersource.stub</packageName>
           <sourceDestDir>src/main/java</sourceDestDir>
         </configuration>
       </plugin>
     </plugins>
   </build>
   ```
3. Check the value that is set in the *wsdlUrl* tag, and update the version if necessary. The latest version of the WSDL that can be supported is 1.219.

4. Run this command in your terminal:

   ```
   mvn clean jaxws:wsimport
   ```
5. Find these lines in your existing code:

   ```
   TransactionProcessorLocator service = new 
       TransactionProcessorLocator();

   URL endpoint = new URL(SERVER_URL);

   ITransactionProcessorStub stub = 
       (ITransactionProcessorStub) service.getportXML
       (endpoint);

   stub._setProperty(WSHandlerConstants.USER, request
       .getMerchantID());
   ```

   Replace them with these lines:

   ```
   TransactionProcessor service = new TransactionProcessor();

   service.setHandlerResolver(portInfo - >{
     List < Handler > handlerList = new ArrayList < >();
     handlerList.add(new BinarySecurityTokenHandler());
     return handlerList;
   });

   ITransactionProcessor stub = service.getPortXML();
   ```
6. Copy these files to your project directory:

   * BinarySecurityTokenHandler.java
   * PropertiesUtil.java
   * SecurityUtil.java
7. Add a *toolkit.properties* file in the *src/main/resources* folder in your project. The *toolkit.properties* file must contain this content:

   ```
   MERCHANT_ID = <your_merchant_id>
   LIB_VERSION = 4.0.3
   KEY_ALIAS = <your_certificate_key_alias>
   KEY_FILE = <your_certificate_file>
   KEY_PASS = <your_certificate_password>
   KEY_DIRECTORY = src/main/resources
   ```

   If you want to use your own properties file, you can make these changes in the *PropertiesUtil.java* file.

8. Add your P12 certificate to your key directory.

9. Run these commands in your terminal:

   ```
   mvn clean install
   ```

   ```
   java -jar target\JavaSoapToolkit.jar
   ```
10. (Optional) You can confirm that your configuration is updated successfully by checking that your request was authenticated using a Bearer token. To confirm, add this command after line 54 in the *src\\main\\java\\com\\cybersource\\BinarySecurityTokenHandler.java* file:

    ```
    System.out.println( soapMessageContext ); 
    ```