JBOSS下Web 服务(Web Service)开发步骤
一.开发一个JSR-181 POJO Endpoint的Web Service 应遵守下面几个步骤：
1> 建立一个POJO endpoint
import javax.jws.WebMethod;
import javax.jws.WebService;
import javax.jws.soap.SOAPBinding;
@WebService(name = "HelloWorld", targetNamespace = "http://webservice", serviceName = "HelloWorldService")
//targetNamespace ,与包名相同
@SOAPBinding(style = SOAPBinding.Style.RPC)
public class HelloWorldService {
@WebMethod
public String SayHello(String name) {
return name + "说:这是我的第一个web 服务";
}
}
可能有错误，则加入：jboss-jaxws.jar
@WebService 这个注释放置在Java 类的前面，声明这个类的部分方法可以被发布为Web 服务。
@WebService 的属性用于设置Web 服务被发布时的一些配置信息，常用的属性说明如下
1. name
Web 服务的名字，WSDL 中wsdl:portType 元素的name 属性和它保持一致，默认是Java 类或者接口的名字。
2. serviceName
Web 服务的服务名，WSDL 中wsdl:service 元素的name 属性和它保持一致，默认是Java 类的名字+”Service” 。
3. targetNamespace
WSDL 文件所使用的namespace，该Web 服务中所产生的其他XML 文档同样采用这个作为namespace 。
@SOAPBinding()表示这个服务可以映射到一个SOAP 消息中。Style 用于指定SOAP 消息请求和回应的编码方式。
@WebMethod 这个注释放在需要被发布成Web 服务的方法前面。
2> 把endpoint 定义成一个servlet
<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.4"
xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
<servlet>
<servlet-name>HelloWorldService</servlet-name>
<servlet-class>webservice.HelloWorldService</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>HelloWorldService</servlet-name>
<url-pattern>/HelloWorldService/*</url-pattern>
</servlet-mapping>
</web-app>
3> 把endpoint 打包成一个Web 应用(war 文件)
进入所在目录：打成war包: jar cvf TestWS.war *
4>测试
输入：http://localhost:8080/jbossws/进入JbossWS 的查看界面
二.web service客户端调用
我们采用Xfire进行webservice 客户端调用 详见： http://blog.csdn.net/pengchua/archive/2007/08/02/1722156.aspx
三．问题解决：
1.问题
2008-7-25 8:56:37 org.apache.axis.utils.JavaUtils isAttachmentSupported
警告: Unable to find required classes (javax.activation.DataHandler and javax.mail.internet.MimeMultipart). Attachment support is disabled.
AxisFault
faultCode: {http://schemas.xmlsoap.org/soap/envelope/}Server.userException
faultSubcode:
faultString: org.xml.sax.SAXParseException: Premature end of file.
faultActor:
faultNode:
faultDetail:
{http://xml.apache.org/axis/}stackTrace:org.xml.sax.SAXParseException: Premature end of file.
at com.sun.org.apache.xerces.internal.util.ErrorHandlerWrapper.createSAXParseException(Unknown Source)
at com.sun.org.apache.xerces.internal.util.ErrorHandlerWrapper.fatalError(Unknown Source)
解决：放入activation.jar和mail.jar
2．问题： : jboss 控制台上出现错误Caused by: java.lang.UnsupportedOperationException: setProperty must be overridden by all subclasses of SOAPMessage
| at javax.xml.soap.SOAPMessage.setProperty(SOAPMessage.java:424)
解决：This usually shows up when running with JDK 6. If that is the case, either use JDK 5,也就是将%JAVA_HOME%变成jdk1.5. or see http://wiki.jboss.org/wiki/JBossWithJDK6?action=e&windowstate=normal&mode=view