Running the JAX-WS client generator on WebSphere®
About this task
Sterling Call Center 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.
Procedure
| 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 or weblogic. Note: For more information on JBoss deprecation, see Deprecated components in Sterling Order Management System Software.
|
| 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.
- Without ssl:
bin/buildjaxclient.sh -DBEAN_NAME=ParticipantBeanService -DAPPSERVER=websphere -DSERVER_URL=http://00.00.00.00:/SIXBeanXapiJaxWS - For one way ssl:
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 - For two way ssl:
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