uCosminexus Application Server, Web Service Development Guide

[Contents][Glossary][Index][Back][Next]

16.1.1 Mapping the package name to the name space

This subsection describes the mapping of the Java package name to the WSDL name space (targetNamespace attribute of the wsdl:definitions element).

Organization of this subsection
(1) Mapping
(2) Conditions for the package name
(3) Using the targetNamespace element of the javax.jws.WebService annotation

(1) Mapping

The package name of the SEI and Web Service Implementation Class and the WSDL name space are mapped in accordance with the JAX-WS 2.2 specifications. The following figure shows an example of mapping:

Figure 16-1 Example of mapping the Java package name to the name space

[Figure]

(2) Conditions for the package name

You can code the strings by fulfilling all the conditions described in the following table in the Java package name segments separated by period (.). However, when using targetNamespace element of the javax.jws.WebService annotation, you can code strings complying with the naming rules of the Java identifiers provided in the Java language specifications.

Table 16-2 Conditions for strings that can be coded in the Java package name segments

No. Condition Examples of invalid string Operation when an invalid string is specified
1 Strings using only one-byte alphanumeric characters (0 to 9, A to Z, a to z) package com.Hitachi The operations might not function properly (error message is not displayed).
2 Strings complying with the naming rules of the Java identifiers provided in the Java language specifications package com.abstract; When the apt command is executed, a compilation error occurs and the processing ends. For details, see the JDK documentation.

(3) Using the targetNamespace element of the javax.jws.WebService annotation

If the SEI or Web Services Implementation Class that you enter is the default package, code the name space name in the targetNamespace element of the javax.jws.WebService annotation.

If the name space name is not coded in the targetNamespace element of the javax.jws.WebService annotation, an error message is output to the standard error output and log (KDJW61004-E).

For details about the targetNamespace element of the javax.jws.WebService annotation, see 16.2.9 javax.jws.WebService annotation.