WebService入门

　　实现一个简单的webservice。

　　java中有三种webservice规范，分别为JAX-WS、JAX-RS、JAXM&SAAJ。

　　同时Java中开发webservice的框架有很多，常见的几种jdk6、Apache Axis1、Apache Axis2、Codehaus XFire、Apache CXF等。其中jdk6集成了JAX-WS.

　　本人第一次发博客，参考Fskjb同志。实验过程中遇到很多中问题，比如如何处理XML返回、复杂数据类型等等。常见错误会发在下一个博客中。

创建并发布服务器端应用

　　1.新建web service project。
　　设置如下图。

　　

2.建立一个实现类，代码如下：

package cug;
import java.io.StringWriter;

import javax.jws.WebService;
import javax.xml.parsers.DocumentBuilder;
import javax.xml.parsers.DocumentBuilderFactory;
import javax.xml.transform.OutputKeys;
import javax.xml.transform.Transformer;
import javax.xml.transform.TransformerFactory;
import javax.xml.transform.dom.DOMSource;
import javax.xml.transform.stream.StreamResult;

import org.w3c.dom.*;
@WebService
public class XmlTest {
    public String sayHaha(String request)
    {
        return "Haha, " + request + ", O.K. !"; 
    }
    public double add(double num1,double num2)
    {
        return num1+num2;        
    }
    public String Test()
    {
        return "This is a Test";
    }
    public  String CreateDom()
    {
        Document doc=null ;
        Element school=null,student=null;
        Element name = null;
        Element num = null;
        Element classes = null;
        Element address = null;
        Element tel = null;
        try{
            DocumentBuilderFactory dbFactory=DocumentBuilderFactory.newInstance();
            DocumentBuilder dbBuilder=dbFactory.newDocumentBuilder();
            doc=dbBuilder.newDocument();
            if(doc!=null)
            {
                school = doc.createElement("School");
                student = doc.createElement("Student");
                student.setAttribute("examId", "23");
                name = doc.createElement("Name");
                name.appendChild(doc.createTextNode("香香"));
                student.appendChild(name);
                num = doc.createElement("Num");
                num.appendChild(doc.createTextNode("1006010066"));
                student.appendChild(num);

                classes = doc.createElement("Classes");
                classes.appendChild(doc.createTextNode("眼视光5"));
                student.appendChild(classes);

                address = doc.createElement("Address");
                address.appendChild(doc.createTextNode("浙江温州"));
                student.appendChild(address);

                tel = doc.createElement("Tel");
                tel.appendChild(doc.createTextNode("123890"));
                student.appendChild(tel);
                school.appendChild(student);
                doc.appendChild(school);
            }
        }
        catch (Exception e) {
            e.printStackTrace();
        }
        
        String result = null;

        if (doc != null)
        {
            StringWriter strWtr = new StringWriter();
            StreamResult strResult = new StreamResult(strWtr);
            TransformerFactory tfac = TransformerFactory.newInstance();
            try
            {
                Transformer t = tfac.newTransformer();
                t.setOutputProperty(OutputKeys.ENCODING, "gb2312");
                t.setOutputProperty(OutputKeys.INDENT, "yes");
                t.setOutputProperty(OutputKeys.METHOD, "xml"); // xml, html,// text
                t.setOutputProperty(
                        "{http://xml.apache.org/xslt}indent-amount", "4");
                t.transform(new DOMSource(doc.getDocumentElement()),
                        strResult);
            }
            catch (Exception e)
            {
                System.err.println("XML.toString(Document): " + e);
            }
            result = strResult.getWriter().toString();
        }
        return result;
    }
}

这里只需要一个实现类，不过为了更加规范，一般还是写成接口+实现类的形式。
　3.建立 webservice  

选择工程名，点击工具栏的new web service按钮。


然后如下配置：

接着(在JAVA BEAN中输入实现类的名称，选择generate wsdl in project)：

点击finish后包中多出一个该实现类的代理类XmlTestDelegate.java

4.导入包
工程-属性-build path-add library-myeclipse libraries导入以下两个包：

如果缺少这两个包，tomcat启动时会出现以下错误： 

严重: Error configuring application listener of class com.sun.xml.ws.transport.http.servlet.WSServletContextListener
java.lang.ClassNotFoundException: com.sun.xml.ws.transport.http.servlet.WSServletContextListener

5.启动tomcat，验证并获取WSDL文件

启动tomcat后在浏览器中输入http://localhost:8080/jaxws_src/XmlTestPort并点击页面中的链接查看WSDL文件，如果该文件能正确显示证明服务器端大功告成。
wsdl文件的uri是http://localhost:8080/jaxws_src/XmlTestPort?wsdl(你可能会问URI中的XmlTestPort从何而来，其实这个名字由图4中的Services port设定）

也可以直接运行为Server Application，自动启动Tomcat。

创建客户端调用：

（不要关闭TOMCAT啊，不然。。。。。）
1.新建java project,建立一包（包名安需求）net.
2.选择包点new web services client(参照本文的第二张图)
   ps:有别与xfire，客户端不一定是服务端相同类型的web services client，可以是一个普通的工程也OK!!
3.指定wsdl的URI或wsdl的文件路径(见上)。

 

 

4.新建一个测试类：

package cug;

public class Client {
	public static void main(String[] args)
	{
		XmlTestService service=new XmlTestService();
		XmlTestDelegate d=service.getXmlTestPort();
		System.out.println(d.createDom());
	}
}

 输出结果：

 

OK！大功告成！

感谢Fskjb的博客

参考文献：Fskjb http://www.cnblogs.com/Fskjb/archive/2009/08/17/1548370.html

作者：西芒xiaoP

出处：http://www.cnblogs.com/panweishadow/

若用于非商业目的，您可以自由转载，但请保留原作者信息和文章链接URL。