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 XML, SOAP protocol, and WSDL.
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. 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. 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>> | 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, note, or attention |
[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. |
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 Guide | 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 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, jeus-webservices-dd.xml, jeus-webservices-dd-client.xml)
Location: JEUS_HOME/docs/reference/schema/index.html
TmaxSoft Co., Ltd.
45, Jeongjail-ro, Bundang-gu,
Seongnam-si, Gyeonggi-do, 13613
South Korea
Tel: +82-31-8018-1000
Fax: +82-31-8018-1115
Email: info@tmax.com
Web (Korean): http://www.tmaxsoft.com
TechNet: http://technet.tmaxsoft.com
TmaxSoft Inc.
230 West Monroe Street Suite 1950
Chicago, IL 60606
U.S.A
Tel: +1-312-525-8330
Fax: +1-312-525-8340
Email: info@tmaxsoft.com
Web (English): http://www.tmaxsoft.com/us_en/home
TmaxSoft Japan Co., Ltd.
5F Sanko Bldg, 3-12-16 Mita, Minato-Ku, Tokyo, 108-0073
Japan
Tel: +81-3-5765-2550
Fax: +81-3-5765-2567
Email: info@tmaxsoft.co.jp
Web (Japanese): http://www.tmaxsoft.co.jp
Beijing TmaxSoft System Software Co., Ltd.
Room103, No.2 Huizhong Building, Seven Street Shangdi,
Haidian District, Beijing, 100085
P.R.China
Tel: +86-10-6298-8827
Email: info@tmaxsoft.com.cn
Web (Chinese): http://www.tmaxsoft.com/cn_en/home_cn_en
Tmax Brasil Sistemas E Serviços Ltda.
Av. Copacabana, 177, sala 32~35 Empresarial 18 do Forte
Alphaville Barueri, Sao Paulo, 06472-001
Brazil
Tel: +55-11-4191-3100
Fax: +55(11) 4191-3705 (extension#112)
Email: info.bra@tmaxsoft.com
Web (Portuguese): http://www.tmaxsoft.com/br_en/home_br_en
Tmax Rus L.L.C.
Leninsky prospekt, 113/1 (Park Place Moscow),
Office 318e, Moscow, 117198
Russia
Tel: +7(495)970-0135
Email: info.rus@tmaxsoft.com
Web (Russian): http://www.tmaxsoft.com/ru_ru/home_ru_ru
Tmax Singapore Pte. Ltd.
430 Lorong 6, Toa Payoh #10-02,
OrangeTee Building, 319402
Singapore
Tel: +65-6259-7223
Fax: +65-6258-7112
Email: info.sg@tmaxsoft.com
Web (English): http://www.tmaxsoft.com/sg_en/home_sg_en
TmaxSoft UK Ltd.
215 Knyvett House, Watermans Business Park,
The Causeway, Staines TW18 3BA
United Kingdom
Tel: +44-1784-895005
Email: info.uk@tmaxsoft.com
Web (English): http://www.tmaxsoft.com/gb_en/home_gb_en
TmaxSoft Canada, Inc.
2425 Matheson Blvd East, 8th floor,
Unit 824 Mississauga, ON, L4W 5K4
Canada
Tel: +1-905-361-2888
Email: info.canada@tmaxsoft.com
Web (English): http://www.tmaxsoft.com/ca_en/home_ca_en
TmaxSoft Proprietary Limited
L32, 101 Miller Street, North Sydney 2060
Australia
Tel: +61-2-8019-7054
Email: info.aus@tmaxsoft.com
Web (English): http://www.tmaxsoft.com/au_en/home_au_en
TmaxSoft Technologies Private Limited
Sobha Alexander Plaza, 3rd Floor,
16/2 Commissariat Road, Bangalore-560025
India
Tel: +91-7619-482-582
Email: info.india@tmaxsoft.com
Web (English): http://www.tmaxsoft.com/in_en/home_in_en
TmaxSoft Co., Ltd. Turkey Liaison Office
Windowist Tower. Eski Buyukdere Cad. No:26,
Maslak 34467 Istanbul
Turkey
Tel: +90-212-214-7345
Email:info.tr@tmaxsoft.com
Web (English): http://www.tmaxsoft.com/tr_en/home_tr_en