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.
To fully understand this guide, users should have the following knowledge.
Understanding of servlet development and packaging. For information about them, refer to (http://www.oracle.com/technetwork/java/index.html).
Understanding of the EJB concept
Understanding of the EJB concept
It is recommended to read the following guides in order to understand the basic usage of JEUS.
All examples and environment configurations are written according to the UNIX style. Hence, a few considerations must be given when working in a non-UNIX environment such as Microsoft Windows™ (hereafter Windows).
For example, for path delimiters, the UNIX style "/" must be changed to the Windows style, "\". As well, the environment variables must be changed to the Windows style, (%%). JEUS_HOME, which is specified in this guide, is the directory in which JEUS is installed.
Since this guide does not contain information about Java EE or Java EE EJB specifications, refer to relevant Java documents for more information.
XML files related to the source files can be found in the samples directory after installing JEUS.
This guide consists of 27 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. Implementing JEUS Web Services"
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. Transmitting Messages Using MIME Attachment"
Describes how to handle binary data of web services more effectively through MIME messages.
"Chapter 11. Fast Infoset Web Services"
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. Server-Sent Event"
Describes JAX-RS based Server-Sent Events.
Introduces UDDI and describes how to use and manage UDDI.
"Chapter 20. XML of JEUS Web Services"
Describes various ways to handle XML supported by JEUS web services.
"Chapter 21. Implementing JAX-RPC Web Services"
Describes various ways of implementing JAX-RPC web services.
"Chapter 22. 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 23. Invoking JAX-RPC Web Services"
Describes how to create various clients and invoke JAX-RPC web services.
"Chapter 24. 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 25. 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 26. JAX-RPC Web Service Data Type"
Describes advanced web service programming topics related to data types used according to the JAX-RPC specification.
"Chapter 27. JAX-RPC Web Service Security"
Describes how to configure security for JAX-RPC web services.
Convention | Meaning |
---|---|
<AaBbCc123> | Program source code file name |
<Ctrl>+C | Hold down the Ctrl key and press the C key |
[Button] | Name of a GUI button or menu |
Bold | Emphasis |
Italics | Reference to another guide |
" " (Double quotation marks) | Reference to a chapter or section in this or another guide |
'Input' | User input on the screen |
Hyperlink
| Email account, website, or a reference to other chapters or sections |
> | Proceeding order of menu |
+---- | Files or directories exist in this directory |
|---- | Files or directories do not exist in this directory |
Note | Reference or caution |
[Figure 1.1] | Figure caption |
AaBbCc123 | Commands, screen output after executing command, or sample code |
{ } | Required items |
[ ] | Optional items |
| | Selective items |
Requirements | |
---|---|
Platform | Solaris 9, 10, 11 |
HP-UX 11.x, 11i, 11iV2 | |
IBM AIX 5L, 6L, AIX 7L | |
MS Windows 2008, 2012, Vista, 7, 8 | |
Hardware | 20 GB of hard drive disk storage recommended. At least 2 GB. |
More than 1 GB RAM recommended. | |
JDK | JDK 7, JDK 8 |
Guide | Description |
---|---|
JEUS Introduction Guide | Introduces the JEUS server as well as its architecture and components. |
JEUS Installation and Getting Started | Describes how to install and start JEUS. |
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. |
JEUS WebAdmin Guide | Describes the configuration, management, monitoring, clustering, and resource configuration of JEUS using WebAdmin, the JEUS web management tool. |
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 Feauture
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:
Console tool xjc(JEUS_HOME/docs/reference-book/reference_xjc.html)
Console tool schemagen(JEUS_HOME/docs/reference-book/reference_schemagen.html)
Console tool tcpmon(JEUS_HOME/docs/reference-book/reference_tcpmon.html)
ANT Task(JEUS_HOME/docs/reference-book/webservice_appendix_ant_task.html)
XML Reference(JEUS_HOME/docs/reference/schema/index.html,
JEUS_HOME/docs/reference/schema/jeus-webservices-config.xml,
JEUS_HOME/docs/reference/schema/jeus-webservices-dd.xml,
JEUS_HOME/docs/reference/schema/jeus-webservices-dd-client.xml,
JEUS_HOME/docs/reference-book/reference_wsdl2uddi.html)