About This Document

Intended Audience

This guide describes the basic concept of a web service, and enables a developer, who programs for the Java EE platform, to create web services without prior knowledge. The document is intended for developers who are developing, deploying, and maintaining web service applications in a JEUS web or JEUS EJB container.

Required Knowledge

Users should have the following knowledge to fully understand this guide.

Understanding of servlet development and packaging

Refer to related specifications (http://www.oracle.com/technetwork/java/index.html) or read an appropriate introductory book about the Servlet technology.

Understanding of the EJB concept

Understanding of XML, SOAP protocol, and WSDL

Document Scope

Since this guide does not contain information about Java EE or Java EE EJB specifications, refer to relevant Java documents for more information.

Note

XML files related to the source files can be found in the samples directory after installing JEUS.

Document Organization

This guide consists of 26 chapters.

"Chapter 1. Introduction to Web Services"

Describes the basic web service concepts and standards.
"Chapter 2. JEUS Web Services"

Describes the concepts of JEUS web services and supported specifications.
"Chapter 3. JEUS Web Service Implementation"

Describes different methods for implementing web services in JEUS.
"Chapter 4. Creating and Deploying Web Services"

Describes how to create and deploy web services with Java class and EJB as service endpoint interfaces.
"Chapter 5. Invoking Web Services"

Describes how to invoke web services with implementation examples.
"Chapter 6. Standardized Binding Declaration and Customization"

Describes how to declare and customize standardized binding.
"Chapter 7. Handler Framework"

Describes the handler framework for web services.
"Chapter 8. Provider and Dispatch Interfaces"

Describes the Provider service endpoint interface and client dispatch interface.
"Chapter 9. Asynchronous Web Services"

Describes how to configure asynchronous client operations and asynchronous web services that use an asynchronous provider.
"Chapter 10. Message Transmission Using MIME Attachment"

Describes how to handle binary data of web services more effectively through MIME messages.
"Chapter 11. Web Services Using Fast Infoset"

Describes web services that use Fast Infoset.
"Chapter 12. JAX-WS JMS Transport"

Describes JAX-WS JMS transport in web services.
"Chapter 13. Web Service Policy"

Describes how to configure and manage the policy function of a web service.
"Chapter 14. Web Services Addressing"

Describes how to configure and manage the addressing function of a web service.
"Chapter 15. Reliable Messaging"

Describes the concept of reliable messaging and how to configure it.
"Chapter 16. Web Service Transactions"

Describes the concept of a web service transaction and how to configure it.
"Chapter 17. Web Service Security"

Describes how to configure JAX-WS web service security.
"Chapter 18. UDDI"

Introduces UDDI and describes how to use and manage UDDI.
"Chapter 19. XML of JEUS Web Services"

Describes various ways to handle XML supported by JEUS web services.
"Chapter 20. Implementing JAX-RPC Web Services"

Describes various ways of implementing JAX-RPC web services.
"Chapter 21. Creating and Deploying JAX-RPC Web Services"

Describes how to create and deploy JAX-RPC web services from Java class and EJB as service endpoint interfaces.
"Chapter 22. Invoking JAX-RPC Web Services"

Describes how to create various clients and invoke JAX-RPC web services.
"Chapter 23. Creating SOAP Message Handler of JAX-RPC Web Service"

Describes the JAX-RPC web service message handler and how to process SOAP messages using SAAJ.
"Chapter 24. Creating JAX-RPC Web Service Configuration File"

Describes how to create the standard web service deployment descriptor for JAX-RPC web services and the JAX-RPC mapping file.
"Chapter 25. JAX-RPC Web Service Data Type"

Describes advanced web service programming topics related to data types used according to the JAX-RPC specification.
"Chapter 26. JAX-RPC Web Service Security"

Describes how to configure security for JAX-RPC web services.

Conventions

Convention	Meaning
<<AaBbCc123>>	Filename of a program source code
<Ctrl>+C	Hold the Control key and press C
[Button]	Button or Menu name
Boldface	Emphasis
" "(double quotes)	Reference to chapters or sections in the manual, or to other related documentation
'Input item'	Description for an input item on the screen
`Hyperlink`	Mail account, website, link to other chapters or sections
>	Progress order of menus
+----	Files or directories exist below
\|----	Files or directories do not exist below
Note	Reference or note
Caution	Caution message
[Figure 1.1]	Figure name
[Table 1.1]	Table name
AaBbCc123	Java codes or XML documents
`[ command argument ]`	Option parameter
< xyz >	The contents between '<' and '>' will be changed to the actual value.
\|	Selective argument. e.g., A\|B: either A or B
…	Repetitive parameters, etc.

System Requirements

This guide follows the UNIX style for all examples and screen configurations.

Users of other environments, such as Windows, can use this with a few considerations. For example, use the Windows style "\" as the directory delimiter instead of the UNIX style "/". Environment variables should also be changed to Windows style variables.

This guide primarily discusses Java, so most of the content should apply to all systems.

Guide	Description
JEUS Server Guide	Describes overview of the JEUS system and server, and system management.
JEUS Web Engine Guide	Describes how to manage JEUS web engine, and how to manage and deploy Java EE WAR Archive and servlet/JSP.
JEUS EJB Guide	Describes JEUS EJB engine and how to deploy EJB modules.

References

SOAP 1.1 Specification (http://www.w3.org/TR/soap11)
SOAP 1.2 Specification (http://www.w3.org/TR/soap12)
WSDL 1.1 Specification (http://www.w3.org/TR/wsdl)
UDDI 2.0 Specification (http://uddi.org/pubs/ProgrammersAPI_v2.htm, http://www.oasis-open.org/committees/uddi-spec/doc/tcspecs.htm#uddiv2)
UDDI 3.0 Specification (http://uddi.org/pubs/uddi_v3.htm)
JAX-WS 2.2 Specification (http://jcp.org/en/jsr/detail?id=224)
JAX-RPC 1.1 Specification (http://jcp.org/en/jsr/detail?id=101)
SAAJ 1.2 Specification (http://jcp.org/en/jsr/detail?id=67)
SAAJ 1.3 Specification (http://jcp.org/en/jsr/detail?id=67)
JAXR 1.0 Specification (http://jcp.org/en/jsr/detail?id=93)
WS-I Basic Profile 1.0 (http://www.ws-i.org/Profiles/BasicProfile-1.0.html)
Servlet 2.4 Specification (http://jcp.org/en/jsr/detail?id=154)
Servlet 2.5 Specification (http://jcp.org/en/jsr/detail?id=154)
EJB 2.1 Specification (http://jcp.org/en/jsr/detail?id=153)
EJB 3.0 Specification (http://jcp.org/en/jsr/detail?id=220)

JEUS Web Service Annotations and Features

JEUS web service annotations that can be used by web service endpoints:
- Service Scope
  - @jeus.webservices.jaxws.api.ApplicationScope
    
    A deployed web service endpoint uses a single instance. This is the default setting.
  - @jeus.webservices.jaxws.api.SessionScope
    
    Each HTTPSession creates a single web service endpoint instance. Each HTTPSession uses a different instance, which can only be used for HTTP transmissions.
  - @jeus.webservices.jaxws.api.RequestScope
    
    Creates a new web service endpoint instance whenever a request is issued.
- Transport
  - @jeus.webservices.jaxws.api.JMSWebService
    
    Web service endpoint for which JMS based transmission is available.
JEUS web service features that can be used by web service clients:
- jeus.webservices.jaxws.api.LocalTransportFeature
  
  A web service port of a client communicates with the web service endpoint through local transmission. This is only available when the web service client and the endpoint exist in the same JVM.
For information about other configurations and APIs, refer to the following documents:
- Location: JEUS_HOME/docs/reference-book/reference_wsdl2uddi.html
- Console tool xjc
  
  Location: JEUS_HOME/docs/reference-book/reference_xjc.html
- Console tool schemagen
  
  Location: JEUS_HOME/docs/reference-book/reference_schemagen.html
- Console tool tcpmon
  
  Location: JEUS_HOME/docs/reference-book/reference_tcpmon.html
- ANT Task
  
  Location: JEUS_HOME/docs/reference-book/webservice_appendix_ant_task.html
- XML Reference - jeus-webservices-config.xml
  
  XML Reference - jeus-webservices-dd.xml
  
  XML Reference - jeus-webservices-dd-client.xml
  
  Location: JEUS_HOME/docs/reference/schema/index.html