uCosminexus Application Server, Web Service Development Guide
When starting a Web Services client, you can use the catalog functionality just by storing the catalog file. You need not change the WSDL, specify the -catalog option by using the cjwsimport command, and recreate a developed Web Services client. For details on allocating the catalog file, see 27.6.2 Storing the catalog file.
As per the information on mapping the catalog file, map the WSDL location from the service class of WSDL and the WSDL location specified in the argument of the constructor of the service class to different WSDL locations and generate a service class.
Table 27-3 lists the mapping targets of the catalog functionality when starting a Web Services client and Table 27-4lists the mapping targets in a WSDL code to be used when starting a Web Services client.
Table 27-3 Mapping targets of the catalog functionality when executing a Web Services client
| No. | Mapping target | Supported |
|---|---|---|
| 1 | Default WSDL location of a service class#1 | Y |
| 2 | The WSDL location specified in the arguments of the constructor of a service class#1 | Y |
| 3 | The WSDL location specified in the arguments of the API of the javax.xml.ws.Service class#2 | Y |
| 4 | The WSDL location specified in the wsdlLocation element of the javax.xml.ws.WebServiceRef annotation#3 | Y |
Table 27-4 4Mapping targets in a WSDL code to be used when executing a Web Services client
| No. | Element | Attribute | Supported |
|---|---|---|---|
| 1 | wsdl:import | namespace | N |
| 2 | location | Y |
The catalog functionality, when starting the Web Services client, does not execute the following mappings because the functionality does not need XML schemas when generating a service class.
In the catalog file, therefore, describe the mapping information of the WSDL location only.
The following figure shows an example of mapping a WSDL location by using the catalog functionality, when generating a service class in a Web Services client.
Figure 27-2 Example of mapping a WSDL location
In the example in this figure, a remote WSDL location is specified in the argument of the constructor of the service class. The figure also shows the processes when the catalog functionality is disabled and enabled.
All Rights Reserved. Copyright (C) 2013, Hitachi, Ltd.