Table Of Contents<\/h3>\n\n- 1. Introduction<\/a><\/dt>\n
- 2. A Brief History of Web Services<\/a><\/dt>\n
- 3. Technologies Used<\/a><\/dt>\n
- 4. Maven Project<\/a><\/dt>\n
- \n
\n- 4.1. Parent Project<\/a><\/dt>\n<\/dl>\n<\/dd>\n
- 5. Generated Stubs from Employee WSDL<\/a><\/dt>\n
- 6. Bottom-Up<\/a><\/dt>\n
- \n
\n- 6.1 Pom.xml<\/a><\/dt>\n
- 6.2 HelloWorldService<\/a><\/dt>\n
- 6.3 Publish Web Services<\/a><\/dt>\n
- 6.4\u00a0<\/a>Demo with SoapUI<\/a><\/dt>\n<\/dl>\n<\/dd>\n
- 7. Top-Down<\/a><\/dt>\n
- \n
\n- 7.1 Pom.xml<\/a><\/dt>\n
- 7.2 EmployeeLookupService<\/a><\/dt>\n
- 7.3 Publish Web Service<\/a><\/dt>\n
- 7.4 <\/a>Demo with SoapUI<\/a><\/dt>\n<\/dl>\n<\/dd>\n
- 8. Tomcat Server<\/a><\/dt>\n
- \n
\n- 8.1 Pom.xml<\/a><\/dt>\n
- 8.2 EmployeeService<\/a><\/dt>\n
- 8.3 Web Configuration<\/a><\/dt>\n
- 8.4 Start the Web Services<\/a><\/dt>\n<\/dl>\n<\/dd>\n
- 9. SOAP Client<\/a><\/dt>\n
- \n
\n- 9.1 Generate Stubs<\/a><\/dt>\n
- 9.2 Create Client Services<\/a><\/dt>\n
- 9.3 JUnit Tests<\/a><\/dt>\n
- 9.4 Acceptance Tests<\/a><\/dt>\n<\/dl>\n<\/dd>\n
- 10. JAX-WS Tutorial – Summary<\/a><\/dt>\n
- 11. Download the Source Code<\/a><\/dt>\n<\/dl>\n<\/div>\n
<\/a>1. Introduction<\/h2>\nJava API for XML Web Services<\/a>\u00a0(JAX-WS) is a Java programming language for creating web services, particularly SOAP services.\u00a0JAX-WS 2.0 specification was introduced in 2005 and has been part of JDK since JDK6.\u00a0JAX-WS uses\u00a0annotations\u00a0to simplify the development of web services.<\/p>\nJAX-WS provides the\u00a0javax.jws.WebService<\/code> annotation to define a class as a web service. A service endpoint interface (SEI) is an interface which defines the web methods that clients can invoke.\u00a0An SEI is not required when building a JAX-WS endpoint. There are a few rules when developing JAX-WS web services:<\/p>\n\n- The implementation class of SEI must be annotated with either\u00a0
javax.jws.WebService<\/code> or\u00a0javax.jws.WebServiceProvider<\/code><\/li>\n- The implementation class of SEI must have a default public constructor<\/li>\n
- The methods of the\u00a0implementation class of SEI must be public and must not be declared with
static<\/code>, abstract<\/code>, or final<\/code><\/li>\n- The methods must be annotated with
javax.jws.WebMethod<\/code> if clients need to invoke it<\/li>\n<\/ul>\nIn this example, I will demonstrate how to:<\/p>\n
\n- Create a web service using a Bottom-up approach<\/li>\n
- Create a web service using a Top-down\u00a0approach<\/li>\n
- Deploy a web service<\/li>\n
- Consume a web service<\/li>\n<\/ul>\n
<\/a>2. A Brief History of Web Services<\/h2>\nWeb services evolved from the Remote Procedure Call<\/a> (RPC) mechanism in the\u00a0Distributed Computing Environment<\/a> (DCE) in the early 1990s.\u00a0Common Object Request Broker Architecture<\/a>\u00a0(CORBA) and\u00a0Microsoft\u2019s Distributed COM<\/a> are first-generation frameworks for DCE. Java Remote Method Invocation<\/a>\u00a0and Microsoft\u2019s DotNet<\/a> are second-generation frameworks for DCE. In 1998, Dave Winer of the UserLand Software<\/a> developed XML-RPC<\/a>, a technology innovation that marked the birth of web service<\/a>. XML-RPC has two key features:<\/p>\n\n- Use of XML marshalling\/unmarshalling<\/a> to achieve language neutrality<\/li>\n
- Reliance on HTTP<\/a>\u00a0for a transport layer<\/li>\n<\/ul>\n
![\"JAX-WS](\"http:\/\/examples.javacodegeeks.com\/wp-content\/uploads\/2018\/09\/jax-ws.jpg\")
<\/a>Figure 1 Web Service<\/figcaption><\/figure><\/p>\n<\/a>3. Technologies Used<\/h2>\nThe example code in this article was built and run using:<\/p>\n
\n- Java 1.8.101<\/li>\n
- Maven 3.3.9<\/li>\n
- Eclipse Oxygen<\/li>\n
- Tomcat 8.0.36<\/li>\n
- SoapUI 5.2.1<\/li>\n
- Cucumber 2.3.1<\/li>\n<\/ul>\n
<\/a>4. Maven Project<\/h2>\nApache Maven<\/a> is a software project management and comprehension tool.\u00a0It manages a project’s build, reporting, and documentation from a\u00a0project object model (POM) file. In this step,\u00a0I will create a\u00a0jax-ws-tutorial<\/code> Maven project with five modules:<\/p>\n
- \n
- 4.1. Parent Project<\/a><\/dt>\n<\/dl>\n<\/dd>\n
- 5. Generated Stubs from Employee WSDL<\/a><\/dt>\n
- 6. Bottom-Up<\/a><\/dt>\n
- \n
- \n
- 6.1 Pom.xml<\/a><\/dt>\n
- 6.2 HelloWorldService<\/a><\/dt>\n
- 6.3 Publish Web Services<\/a><\/dt>\n
- 6.4\u00a0<\/a>Demo with SoapUI<\/a><\/dt>\n<\/dl>\n<\/dd>\n
- 7. Top-Down<\/a><\/dt>\n
- \n
- \n
- 7.1 Pom.xml<\/a><\/dt>\n
- 7.2 EmployeeLookupService<\/a><\/dt>\n
- 7.3 Publish Web Service<\/a><\/dt>\n
- 7.4 <\/a>Demo with SoapUI<\/a><\/dt>\n<\/dl>\n<\/dd>\n
- 8. Tomcat Server<\/a><\/dt>\n
- \n
- \n
- 8.1 Pom.xml<\/a><\/dt>\n
- 8.2 EmployeeService<\/a><\/dt>\n
- 8.3 Web Configuration<\/a><\/dt>\n
- 8.4 Start the Web Services<\/a><\/dt>\n<\/dl>\n<\/dd>\n
- 9. SOAP Client<\/a><\/dt>\n
- \n
- \n
- 9.1 Generate Stubs<\/a><\/dt>\n
- 9.2 Create Client Services<\/a><\/dt>\n
- 9.3 JUnit Tests<\/a><\/dt>\n
- 9.4 Acceptance Tests<\/a><\/dt>\n<\/dl>\n<\/dd>\n
- 10. JAX-WS Tutorial – Summary<\/a><\/dt>\n
- 11. Download the Source Code<\/a><\/dt>\n<\/dl>\n<\/div>\n
<\/a>1. Introduction<\/h2>\n
Java API for XML Web Services<\/a>\u00a0(JAX-WS) is a Java programming language for creating web services, particularly SOAP services.\u00a0JAX-WS 2.0 specification was introduced in 2005 and has been part of JDK since JDK6.\u00a0JAX-WS uses\u00a0annotations\u00a0to simplify the development of web services.<\/p>\n
JAX-WS provides the\u00a0
javax.jws.WebService<\/code> annotation to define a class as a web service. A service endpoint interface (SEI) is an interface which defines the web methods that clients can invoke.\u00a0An SEI is not required when building a JAX-WS endpoint. There are a few rules when developing JAX-WS web services:<\/p>\n- \n
- The implementation class of SEI must be annotated with either\u00a0
javax.jws.WebService<\/code> or\u00a0javax.jws.WebServiceProvider<\/code><\/li>\n- The implementation class of SEI must have a default public constructor<\/li>\n
- The methods of the\u00a0implementation class of SEI must be public and must not be declared with
static<\/code>,abstract<\/code>, orfinal<\/code><\/li>\n- The methods must be annotated with
javax.jws.WebMethod<\/code> if clients need to invoke it<\/li>\n<\/ul>\nIn this example, I will demonstrate how to:<\/p>\n
- \n
- Create a web service using a Bottom-up approach<\/li>\n
- Create a web service using a Top-down\u00a0approach<\/li>\n
- Deploy a web service<\/li>\n
- Consume a web service<\/li>\n<\/ul>\n
<\/a>2. A Brief History of Web Services<\/h2>\n
Web services evolved from the Remote Procedure Call<\/a> (RPC) mechanism in the\u00a0Distributed Computing Environment<\/a> (DCE) in the early 1990s.\u00a0Common Object Request Broker Architecture<\/a>\u00a0(CORBA) and\u00a0Microsoft\u2019s Distributed COM<\/a> are first-generation frameworks for DCE. Java Remote Method Invocation<\/a>\u00a0and Microsoft\u2019s DotNet<\/a> are second-generation frameworks for DCE. In 1998, Dave Winer of the UserLand Software<\/a> developed XML-RPC<\/a>, a technology innovation that marked the birth of web service<\/a>. XML-RPC has two key features:<\/p>\n
- \n
- Use of XML marshalling\/unmarshalling<\/a> to achieve language neutrality<\/li>\n
- Reliance on HTTP<\/a>\u00a0for a transport layer<\/li>\n<\/ul>\n
<\/a>Figure 1 Web Service<\/figcaption><\/figure><\/p>\n <\/a>3. Technologies Used<\/h2>\n
The example code in this article was built and run using:<\/p>\n
- \n
- Java 1.8.101<\/li>\n
- Maven 3.3.9<\/li>\n
- Eclipse Oxygen<\/li>\n
- Tomcat 8.0.36<\/li>\n
- SoapUI 5.2.1<\/li>\n
- Cucumber 2.3.1<\/li>\n<\/ul>\n
<\/a>4. Maven Project<\/h2>\n
Apache Maven<\/a> is a software project management and comprehension tool.\u00a0It manages a project’s build, reporting, and documentation from a\u00a0project object model (POM) file. In this step,\u00a0I will create a\u00a0
jax-ws-tutorial<\/code> Maven project with five modules:<\/p>\n
- Reliance on HTTP<\/a>\u00a0for a transport layer<\/li>\n<\/ul>\n
- Use of XML marshalling\/unmarshalling<\/a> to achieve language neutrality<\/li>\n
- 9.2 Create Client Services<\/a><\/dt>\n
- 8.2 EmployeeService<\/a><\/dt>\n
- 7.2 EmployeeLookupService<\/a><\/dt>\n
- 6.2 HelloWorldService<\/a><\/dt>\n
- 5. Generated Stubs from Employee WSDL<\/a><\/dt>\n