UNDER CONSTRUCTION

This document only addresses how to configure pom.xml for generating java code based on a published web service wsdl during maven build. This is not a tutorial on how to use Maven.

PREREQUISITES

Before you begin, you must have the following:

* an application certificate Java keystore.
If you do not have an application certificate Java keystore, here are {color:blue}[instructions | How to create an Application Certificate Java keystore]{color} on how to create an application certificate Java keystore.
* a trusted server Java keystore.
If you do not have a Trusted Server Java keystore, here are {color:blue}[instrucitons | How to create a Trusted Server Java keystore]{color} on how to create a trusted server Java keystore.

1. The pom.xml configuration

To generate java code using the moiraws web service WSDL, use the Maven maven-antrun-plugin and place following xml statements within the <plugins> element of the Maven project's pom.xml:

    <properties>
        <service.wsdl>https://ws-dev.mit.edu/moiraws/services/moira?wsdl</service.wsdl>
        <server.truststore>${env.JAVA_KEYSTORE_PATH}/myServerTrustStore.jks</server.truststore>
        <server.truststore.password>truststorePassword</server.truststore.password>
        <server.truststore.type>jks</server.truststore.type>
        <client.keystore>${env.JAVA_KEYSTORE_PATH}/myApplicationCertificateKeystore.jks</client.keystore>
        <client.keystore.password>keystorePassword</client.keystore.password>
        <client.keystore.type>jks</client.keystore.type>
    </properties>
       .
       .
       .
    <build>
       .
       .
       .
       <plugins>
           <plugin>
               <groupId>org.apache.maven.plugins</groupId>
               <artifactId>maven-antrun-plugin</artifactId>
               <executions>
                   <execution>
                       <id>generate java code for moira wsdl</id>
                       <phase>generate-sources</phase>
                       <configuration>
                           <tasks>
                               <property name="compile_classpath" refid="maven.compile.classpath" />
                               <echo message="service.wsdl ${service.wsdl}" />
                               <echo message="compile classpath: ${compile_classpath}" />
                               <java classname="org.apache.axis.wsdl.WSDL2Java" fork="true" classpathref="maven.compile.classpath" dir="src/main/java">
                                    <sysproperty key="javax.net.ssl.keyStore" value="${client.keystore}" />
                                    <sysproperty key="javax.net.ssl.keyStorePassword" value="${client.keystore.password}" />
                                    <sysproperty key="javax.net.ssl.keyStoreType" value="${client.keystore.type}" />
                                    <sysproperty key="javax.net.ssl.trustStore" value="${server.truststore}" />
                                    <sysproperty key="javax.net.ssl.trustStorePassword" value="${server.truststore.password}" />
                                    <sysproperty key="javax.net.ssl.trustStoreType" value="${server.truststore.type}" />
                                    <arg value="-v" />
                                    <arg value="-o${basedir}/src/main/java" />
                                    <arg value="${service.wsdl}" />
                               </java>
                           </tasks>
                       </configuration>
                       <goals>
                           <goal>run</goal>
                       </goals>
                   </execution>
               <executions>
           </plugin>
       </plugins>
       .
       .
       .
    <build>

In the above:

Replace {color:green}myServerTrustStore.jks{color} with the name of your Trusted Servers keystore.
Replace {color:green}myApplicationCertificateKeystore.jks{color} with the name of your Applicaiton Certificate keystore.
Replace {color:green}truststorePassword{color} with the password for your Trusted Servers keystore jks.
Replace {color:green}keystorePassword{color} with the password for your Application Certificate keystore jks.
{indent:0}
The above plug-in can be used to build the Java code for any of the DSPS supported web services.  You only have to replace the property value of *service.wsdl* with any of the URL's shown below.\\
\\
For example, if you wish to build the Java code for the uaws web service from the DSPS Production servers, change the line:\\
{indent:1}\\
<property name="service.wsdl" value="https://mapws.mit.edu/moiraws/services/moira?wsdl"/>\\

to:
\\
<property name="service.wsdl" value="https://mapws.mit.edu/uaws/services/ua?wsdl"/>\\

Note: with the above plug-in configuration, maven will generate java code during generate-source phase.

The following are the web service wsdl's that are currently available from DSPS:

DSPS Staging Servers:

* https://mapws-stage.mit.edu/geows/services/geo?wsdl
* https://mapws-stage.mit.edu/mitidws/services/mitid?wsdl
* https://mapws-stage.mit.edu/moiraws/services/moira?wsdl
* https://mapws-stage.mit.edu/uaws/services/ua?wsdl

DSPS Production servers:

* https://mapws.mit.edu/geows/services/geo?wsdl
* https://mapws.mit.edu/mitidws/services/mitid?wsdl
* https://mapws.mit.edu/moiraws/services/moira?wsdl
* https://mapws.mit.edu/uaws/services/ua?wsdl