Sterling Warehouse Management System provides a client generator for use with JAX-WS web services on UNIX and Linux (the client generator is not supported on Windows).
If you are modifying the XSD for any API or service which has been exposed as a web service, you must rebuild the web services client. Additionally, each time you extend the database through customization or upgrade, you must run the xsdgenerator, and then rebuild the ear and client.
To generate a client against an HTTPS url, include the trustStore and keyStore system properties when you run the script.
javax.xml.stream.XMLInputFactory=com.sun.xml.internal.stream.XMLInputFactoryImpl
Otherwise, you may see client build failures.
Property | Description |
---|---|
BEAN_NAME | Required. Matches the beanname on the server. The service name may differ, depending on the application server. |
APPSERVER | Required. Valid values are websphere, weblogic, or jboss. |
SERVER_URL | Required. The HTTP URL of the server up to, but not including, the bean name. |
trustStore | Full path to your client truststore (required when generating client from the https url). |
trustStorePassword | Password for your client truststore. |
keyStore | Full path to your client keystore ( required to achieve two-way ssl connection when generating a client from the https url). |
keyStorePassword | Password for your client keystore. |
The following code samples are examples of how the script might be set up in different scenarios.
bin/buildjaxclient.sh -DBEAN_NAME=ParticipantBeanService -DAPPSERVER=websphere -DSERVER_URL=http://00.00.00.00:/SIXBeanXapiJaxWS
bin/buildjaxclient.sh -DBEAN_NAME=ParticipantBeanService -DAPPSERVER=websphere -DSERVER_URL=http://00.00.00.00:/SIXBeanXapiJaxWS -DtrustStore=/home/joe_user/resources/ssl/jaxwsclienttrust.jks -DtrustStorePassword=changeit
bin/buildjaxclient.sh -DBEAN_NAME=ParticipantBeanService -DAPPSERVER=websphere -DSERVER_URL=http://00.00.00.00:/SIXBeanXapiJaxWS -DtrustStore=/home/joe_user/resources/ssl/jaxwsclienttrust.jks -DtrustStorePassword=changeit -DkeyStore=/home/joe_user/resources/ssl/jaxwsclientkey.jks -DkeyStorePassword=changeit