uCosminexus Application Server, Web Service Development Guide

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

16.1.4 Mapping the name of method of SEI to an operation

This subsection describes the mapping the name of method of SEI and WSDL operation (name attribute of the wsdl:operation element).

Organization of this subsection
(1) Mapping
(2) Conditions for method name
(3) Name conflict due to overloading

(1) Mapping

The name of the method of SEI and the WSDL operation are mapped in accordance with the JAX-WS 2.2 specifications. The following figure shows an example of mapping:

Figure 16-3 Example of mapping the name of method of SEI to an operation

[Figure]

The following conditions must be fulfilled to make the SEI method public:

The following are the rules for mapping the name of method of SEI to the operation:

(2) Conditions for method name

In the method name, you can code strings that fulfill all the conditions described in the following table:

Table 16-4 Conditions for strings that can be coded in the method name

No. Condition Example 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) and underscore (_) Hitachi_sei 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 Abstract When the apt command is executed, a compilation error occurs and the processing ends. For details, see the JDK documentation.

However, when all the following annotations are used, you can code strings complying with the naming rules of the Java identifiers provided in the Java language specifications:

(3) Name conflict due to overloading

When using the method overloading, a name conflict occurs in the default mapping; therefore, you must customize the name using annotation so that the name is unique.

The following table describes the locations where the name conflict occurs due to overloading and their references:

Table 16-5 Location where the name conflict occurs due to overloading and references

No. Location where the name conflict occur Annotation reference
Wrapper style Non-wrapper style
1 Operation name 16.2.6(2)
2 Global element of input# 16.2.16(1), 16.2.16(2) 16.2.7(2), 16.2.7(5)
3 Global element of output# 16.2.17(1), 16.2.17(2) 16.2.8(2), 16.2.8(4)
4 Request bean class name 16.2.16(3)
5 Response bean class name 16.2.17(3)

#
If you customize either the local name or name space, the name conflict will not occur.