Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin

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

PREREQUISITES

...

    Before you begin, you must have the following:

Panel
indent
1
1

* 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

Panel

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 your Maven project's pom.xml:.

You must also create the system environment variable JAVA_KEYSTORE_PATH and have it point to the directory that contains your application certificate keystore and your trusted server keystore.

Code Block

    <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>
               
Code Block

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
               <artifactId>maven-antrun-plugin</artifactId>
               <executions>
                   <execution>
                       <id>generate java code for frommoira wsdl</id>
                       <phase>generate-sources</phase>
                       <configuration>
                <tasks>
           <tasks>
         <property name="service.wsdl" value="https://mapws.mit.edu/moiraws/services/moira?wsdl"/>
                    <property name="server.truststorecompile_classpath" valuerefid="/path/to/keystore/<the name of your Trused Servers keystore>.jks" />
maven.compile.classpath" />
                               <property<echo namemessage="client.keystore" value="/path/to/keystore/<the name of your application certificate keystore>.jks." />
service.wsdl ${service.wsdl}" />
                               <property<echo namemessage="compile_ classpath" refid="maven.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="<clientKeystorePassword>${client.keystore.password}" />
                                    <sysproperty key="javax.net.ssl.keyStoreType" value="jks"${client.keystore.type}" />
                                    <sysproperty key="javax.net.ssl.trustStore" value="${server.truststore}" />
                                    <sysproperty key="javax.net.ssl.trustStorePassword" value="<trustStorePassword>${server.truststore.password}" />
                                    <sysproperty key="javax.net.ssl.trustStoreType" value="jks${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>
           </executions>
</plugin>

  Where in the above:

plugin>
       </plugins>
       .
       .
       .
    <build>
        

In the above:

    Replace myServerTrustStore.jks with the name of your Trusted Servers keystore.
    Replace myApplicationCertificateKeystore.jks with the name of your Applicaiton Certificate keystore.
    Replace truststorePassword with the password for your Trusted Servers keystore jks.
    Replace keystorePassword with the password for your Application Certificate keystore      Replace /path/to/keystore/<the name of your Trused Servers keystore>.jks with the path to and name of the Trusted Servers keystore.
     Replace /path/to/keystore/<the name of your Trused Servers keystore>.jks with the path to and name of the Applicaiton Certificate keystore.
     Replace <trustStorePassword> with the password for your <the name of your Trusted Servers keystore>.jks.
     Replace <clientKeystorePassword> with the password for your <the name of your Application Certificate keystore>. jks.

The above plug-in can be used to build the Java code for any of the ISDA 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:
   <property
    <property name="service.wsdl" value="https://mapwsws.mit.edu/moiraws/services/moira?wsdl"/>

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

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

Panel

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

   DSPS Staging Servers:

https://mapws

:

indent

*Testing Servers:*\\
indent
2
2

* https://ws-test.mit.edu/geows/services/geo?wsdl
* https://ws-test.mit.edu/mitidws/services/mitid?wsdl
* https://ws-test.mit.edu/moiraws/services/moira?wsdl
* https://ws-test.mit.edu/uaws/services/ua?wsdl
indent

*Staging Servers:*\\
indent
2
2

* https://ws-stage.mit.edu/geows/services/geo?wsdl
Image Removed

* https://
mapws
ws-stage.mit.edu/mitidws/services/mitid?wsdl
Image Removed

* https://
mapws
ws-stage.mit.edu/moiraws/services/moira?wsdl
Image Removed

* https://
mapws
ws-stage.mit.edu/uaws/services/ua?wsdl
Image Removed

indent

*Production servers:*
indent
2
2

* 

   DSPS Production servers:

https://
mapws
geows.mit.edu/geows/services/geo?wsdl
Image Removed

* https://
mapws
mitidws.mit.edu/mitidws/services/mitid?wsdl
Image Removed

* https://
mapws
moiraws.mit.edu/moiraws/services/moira?wsdl
Image Removed

* https://
mapws
uaws.mit.edu/uaws/services/ua?wsdl
Image Removed