Tomcat Publishing Web Service tutorial

http://blog.csdn.net/fengqiuzhihua/article/details/8783878

1. Download Jax-WS Dependency Package

Because Tomcat does not have the dependent environment required by JAX-WS, the first step is to download jax-ws RIS, the JAX-ws reference Implemantation, Address: http://jax-ws.java.net.

2. Installing JAX-ws RIS to the Tomcat server

First download Ant and Tomcat, set the environment variables Ant_home and Catalina_home, and then introduce the respective bin directory under path to open a command prompt and run the ant install in the directory of the JAX-ws RIS package.

This command will directly import the required package into the ${tomcat}\shared\lib directory, in fact, the Jaxws RI Lib package is copied to the Tomcat installation directory shared\lib inside.

3. Set up Tomcat in eclipse

Since eclipse is a tomcat configuration file of its own definition, you need to add something, add the shared\lib, and open the Ctalina.properties file.

After opening for (excerpt):

[HTML]View PlainCopy

2. # Licensed to the Apache software Foundation (ASF) under one or more
4. # Contributor license agreements. See the NOTICE file distributed with
6. # This work for additional information regarding copyright ownership.
8. # The ASF licenses this file to you under the Apache License, Version 2.0
10. # (the "License"); Except in compliance with
12. # The License. Obtain a copy of the License at
14. #
16. # http://www.apache.org/licenses/LICENSE-2.0
18. #
20. # unless required by applicable or agreed to writing, software
22. # Distributed under the License is distributed on a "as is" BASIS,
24. # without warranties or CONDITIONS of any KIND, either express or implied.
26. # See the License for the specific language governing permissions and
28. # Limitations under the License.
32. #
34. # List of comma-separated packages that start with or equal this string
36. # would cause a security exception to being thrown when
38. # passed to Checkpackageaccess unless the
40. # corresponding Runtimepermission ("Accessclassinpackage.") +package) has
42. # been granted.
44. package.access=Sun.,org.apache.catalina.,org.apache.coyote.,org.apache.tomcat.,org.apache.jasper.
46. #
48. # List of comma-separated packages that start with or equal this string
50. # would cause a security exception to being thrown when
52. # passed to Checkpackagedefinition unless the
54. # corresponding Runtimepermission ("Defineclassinpackage.") +package) has
56. # been granted.
58. #
60. # By default, no packages is restricted for definition, and none of
62. # The class loaders supplied with the JDK call checkpackagedefinition.
64. #
66. package.definition=Sun.,java.,org.apache.catalina.,org.apache.coyote.,org.apache.tomcat.,org.apache.jasper  .
70. #
72. #
74. # List of comma-separated paths defining the contents of the "common"
76. # ClassLoader. Prefixes should was used to define, what's the repository type.
78. # path is relative to the Catalina_home or catalina_base path or absolute.
80. # If left as blank,the JVM system loader would be used as Catalina ' s "common"
82. # loader.
84. # Examples:
86. # "Foo": Add this folder as a class repository
88. # "Foo/*.jar": Add all the JARs of the specified folder as Class
90. # repositories
92. # "Foo/bar.jar": Add Bar.jar as a class repository
94. common.loader=${catalina.home}/shared/lib/*.jar,${catalina.home}/shared/lib,${catalina.base}/lib,${ Catalina.base}/lib/*.jar,${catalina.home}/lib,${catalina.home}/lib/*.jar

Locate the Common.loader configuration item to add ${catalina.home}/shared/lib/*.jar,${catalina.home}/shared/lib both paths

4. Set up the project

Create a new Web project, Webservice_web, with the following directory structure

Helloservice.java is an interface that provides a Web service with the following code:

[Java]View PlainCopy

1. Package com.zxuqian.webservice;
3. Import Javax.jws.WebMethod;
4. Import Javax.jws.WebService;
6. @WebService
7. Public interface HelloService {
9. @WebMethod
10. String Greetings (string name);
12. }

Helloserviceimpl.java is the implementation class with the following code:

[Java]View PlainCopy

2. Package Com.zxuqian.webservice.impl;
6. Import Javax.jws.WebService;
10. Import Com.zxuqian.webservice.HelloService;
14. @WebService (Endpointinterface = "Com.zxuqian.webservice.HelloService")
16. Public class Helloserviceimpl implements HelloService {
20. @Override
22. Public string Greetings (string name) {
24. return "Hello:" + name;
26. }
30. }

5. Add Sun-jaxws.xml

Sun-jaxws.xml is a Web service application that publishes a profile with the following content:

[HTML]View PlainCopy

2. <? XML version= "1.0" encoding="UTF-8"?>
4. <endpoints xmlns="Http://java.sun.com/xml/ns/jax-ws/ri/runtime" version="2.0 " >
6. <endpoint name="HelloWorld" implementation=" Com.zxuqian.webservice.impl.HelloServiceImpl "
8. url-pattern="/hello" />
10. </Endpoints>

For specific instructions on each node, please refer to the Docs document in the Jaxws RI package that you downloaded, and here is a brief explanation that endpoint needs to specify
The interface and implementation class for the Web Service service, and its URL-relative path

6. Configure Web. xml

The contents are as follows:

[HTML]View PlainCopy

2. <? XML version= "1.0" encoding="UTF-8"?>
4. <web-app xmlns:xsi=" http://www.w3.org/2001/XMLSchema-instance " xmlns=" Http://java.sun.com/xml/ns/javaee " xmlns:web=" http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd " xsi: Schemalocation= "http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ Ns/javaee/web-app_2_5.xsd " id=" webapp_id " < span class= "attribute" >version= "2.5" >&NBSP;&NBSP;
6. <display-name>webservice_web</display-name>
10. <listener>
12. <listener-class>com.sun.xml.ws.transport.http.servlet.wsservletcontextlistener</ listener-class>
14. </Listener>
16. <servlet>
18. <servlet-name>hello</servlet-name>
20. <servlet-class>com.sun.xml.ws.transport.http.servlet.wsservlet</servlet-class >
22. <load-on-startup>1</load-on-startup>
24. </servlet>
28. <servlet-mapping>
30. <servlet-name>hello</servlet-name>
32. <url-pattern>/hello</url-pattern>
34. </servlet-mapping>
36. </Web-app>

7. Testing

Start Tomcat, enter the Web service address in the browser Http://localhost:8088/webservice_web/hello my Tomcat's port number is 8088, and you make the appropriate changes based on your own port number.

8. Reference documents

http://www.mkyong.com/webservices/jax-ws/deploy-jax-ws-web-services-on-tomcat/

Tomcat Publishing Web Service tutorial