The WSDL service and port and the service class are mapped in accordance with the JAX-WS 2.2 specifications. The following figure shows an example of mapping:

Figure 15-12 Example of mapping the service and port to the service class

The WSDL service and port are also mapped to the skeleton class. The following figure shows an example of mapping:

Figure 15-13 Example of mapping the service and port to the skeleton class

• Generated service class
  The generated service class inherits the javax.xml.ws.Service class and has the javax.xml.ws.WebServiceClient annotation. The generated service class also has the following methods.
  

  Table 15-17 The methods included in a service class

  No.	Type of the return value	Method Name or Description		Support
  1	--	ServiceName()#1		Y
  		Description	A constructor of the parent class javax.xml.ws.Service#2 (java.net.URL wsdlDocumentLocation, javax.xml.namespace.QName serviceName) is called in this constructor. For wsdlDocumentLocation and serviceName, use the definitions mapped from a WSDL. When the catalog functionality is enabled, map the definition to a different URI specified in the catalog file and then use the definition mapped from the WSDL as wsdlDocumentLocation. For details on the catalog functionality, see 27. Catalog Functionality.
  		Exception	javax.xml.ws.WebServiceException
  2	--	ServiceName(javax.xml.ws.WebServiceFeature... features)#1		N
  3	--	ServiceName(java.net.URL wsdlLocation)#1		Y
  		Description	A constructor of the parent class javax.xml.ws.Service#2 (java.net.URL wsdlDocumentLocation, javax.xml.namespace.QName serviceName) is called in this constructor. For ServiceName, use a definition mapped from a WSDL. If the catalog functionality is enabled, map the URL pointing to the WSDL location specified in this argument to the URI pointing to a different WSDL location. For details on the catalog functionality, see 27. Catalog Functionality.
  		Argument	wsdlLocation: A URL indicating the WSDL Location.
  		Exception	javax.xml.ws.WebServiceException
  4	--	ServiceName(java.net.URL wsdlLocation, javax.xml.ws.WebServiceFeature... features)#1		N
  5	--	ServiceName(java.net.URL wsdlLocation, javax.xml.namespace.QName serviceName)#1		Y
  		Description	A constructor of the parent class javax.xml.ws.Service#2 (java.net.URL wsdlDocumentLocation, javax.xml.namespace.QName serviceName) is called in this constructor.
  		Argument	wsdlLocation: A URL indicating the WSDL Location. If the catalog functionality is enabled, map the URL pointing to the WSDL location specified in this argument to the URI pointing to a different WSDL location. For details on the catalog functionality, see 27.Catalog Functionality. serviceName: QName of the service.
  		Exception	javax.xml.ws.WebServiceException
  6	--	ServiceName(java.net.URL wsdlLocation, javax.xml.namespace.QName serviceName, javax.xml.ws.WebServiceFeature... features)		N
  7	Proxy that implements the SEI	getPortName()#3		Y
  		Description	The getPort#2 (javax.xml.namespace.QName portName, java.lang.Class<T> serviceEndpointInterface) method of the parent class javax.xml.ws.Service is called. For portName and serviceEndpointInterface, use the definitions mapped from a WSDL. This method is annotated by javax.xml.ws.WebEndpoint.
  		Exception	javax.xml.ws.WebServiceException
  8	Proxy that implements the SEI	getPortName(javax.xml.ws.WebServiceFeature... features)#3		Y
  		Explanation	The getPort#2 (javax.xml.namespace.QName portName, java.lang.Class<T> serviceEndpointInterface, WebServiceFeature... features) method of the parent class javax.xml.ws.Service is called. For portName and serviceEndpointInterface, use the definitions mapped from a WSDL. This method is annotated by javax.xml.ws.WebEndpoint.
  		Argument	Features: The javax.xml.ws.WebServiceFeature type of variable length.
  		Exception	javax.xml.ws.WebServiceException

  Legend:

  --: Indicates that the type of return value is not available.

  Y: Supported by the JAX-WS functionality of Cosminexus.

  N: Not supported by the JAX-WS functionality of Cosminexus.

  #1

  ServiceName represents the service class name (the name attribute of the wsdl:service element).

  #2

  For details on the parent class javax.xml.ws.Service, see 19.2.2(4) javax.xml.ws.Service class.

  #3

  PortName represents a name with the first letter of the port name in uppercase (the name attribute of the wsdl: port element).

  
  

In the service name and port name, you can code a string that fulfills all the conditions described in the following table. However, when customizing with the binding declaration, you can code the strings that can be used as xsd:NCName type of the XML Schema specification.

Table 15-18 Conditions for strings that can be coded in the service name and port name

No.	Conditions	Examples of invalid strings	Operations when invalid strings are specified
1	Strings using only one-byte alphanumeric characters (0 to 9, A to Z, a to z) and underscore (_)	Hitachi_service Hitachi_port	The operation might not function properly (error message is not displayed).
2	Strings that do not begin with numeric characters	1User_service 1User_port	An error message is output in the standard error output and log and the processing ends (KDJW51029-E).