Ⅰ 我想用java做一個web services.請問該怎麼做
網上有很多答案的,下面這個是個專業性的答案:
webservice的應用已經越來越廣泛了,下面介紹幾種在Java體系中開發webservice的方式,相當於做個記錄。
1.Axis2
Axis是apache下一個開源的webservice開發組件,出現的算是比較早了,也比較成熟。這里主要介紹Axis+eclipse開發webservice,當然不用eclipse也可以開發和發布webservice,只是用eclipse會比較方便。
(1)下載eclipse的Java EE版本
(2)下載axis2
(3)下載eclipse的axis2插件
Axis2_Codegen_Wizard
Axis2_Service_Archiver
推薦使用1.3的版本
(4)eclipse安裝axis2插件
1)在任意目錄下新建一個Axis2文件夾,在該文件夾下新建eclipse目錄,在eclipse目錄中新建plugins目錄和features目錄,例如:D:\programSoftware\eclipse-SVN\Axis2\eclipse;
2)把下載的axis2插件解壓,並把解壓的文件放到新建的eclipse的plugins目錄下;
3)在%eclipse_home%的目錄下新建links目錄,並在links目錄下新建axis2.link文件,內容為:path=D:\programSoftware\eclipse-SVN\Axis2;
4)重啟eclipse,點擊·file-new-other,如果看到Axis2 Wizards,則表明插件安裝成功。
(5)安裝axis2
(6)使用eclipse新建web工程,創建一個普通java類,至少包含一個方法。
(7)發布webservice
1)點擊eclipse的File-New-other,打開Axis2 Wizards,選擇Axis2 Service Archiver,然後Next;
2)選擇Class File Location,也就是類文件存放路徑,注意:只選到classes目錄,不要包括包文件夾,然後Next;
3)選擇Skip WSDL,然後Next
4)一路Next到Select the Service XML file to be included in the Service archive,勾選Generate theservice xml automatically;
5)Service Name-填寫你的service名稱,Class Name-填寫類名稱,要包括包名,然後點擊load,然後點擊Finish,這時webservice就發布成功了;
6)然後到%TOMCAT_HOME%/webapps/axis2/WEB-INF/services 看看是否多了一個.aar的文件;
注意:以上的方式是發布到axis2.war包中,你也可以把生成.aar文件到你的實際應用中,同時,你也可以使用eclipse的create webservice功能發布你的webservice,選擇axis2生成你的webservice,這樣webservice就會部署到你的應用中了。
2.Apche CXF
CXF開發webservice也是比較方便和簡單的,它和spring的集成可以說是非常地好。舉一個CXF開發webservice的例子吧。
1)在eclipse中新建一個web工程,導入依賴包,如圖:
2)編寫一個介面,如:
注意:CXF開發的webservice,介面中的方法的參數一定要以這種方式,否則客戶端調用的時候CXF服務端會接收不到參數的值,name:參數名稱,可不寫(建議寫上),targetNamespace:命名空間,一定要填寫上,默認是包名反過來的順序,mode:參數類型,IN表示輸入。
3)編寫一個實現類,實現介面的方法;
4)和spring的集成,編寫一個bean文件,如:cxf-beans.xml,內容如下:
Cxf-beans.xml代碼
<?xml version="1.0" encoding="UTF-8" ?>
<import resource="classpath:META-INF/cxf/cxf.xml" />
<import resource="classpath:META-INF/cxf/cxf-extension-soap.xml" />
<import resource="classpath:META-INF/cxf/cxf-servlet.xml" />
<jaxws:endpoint id="vote" implementor="com.zcl.cxf.service.VoteImpl" address="/Vote" />
</beans>
這個文件比較容易理解,就不解釋了。
5)配置CXFServlet
在web.xml文件中配置CXFServlet,載入cxf-beans.xml文件,內容如下:
Web.xml代碼
id="WebApp_ID" version="2.5">
<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>WEB-INF/cxf-beans.xml</param-value>
</context-param>
<listener>
<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>
<servlet>
<servlet-name>cxf</servlet-name>
<servlet-class>org.apache.cxf.transport.servlet.CXFServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>cxf</servlet-name>
<url-pattern>/services/*</url-pattern>
</servlet-mapping>
</web-app>
把工程部署到中間件,如tomcat,就可以訪問該webservice了。
3.JDK開發webservice
1)編寫一個Java類,如下:
Jdkwebservice.java代碼
package demo;
import javax.jws.WebParam;
import javax.jws.WebService;
import javax.xml.ws.Endpoint;
@WebService
public class JdkWebService {
return "Just do it," + value + "!";
}
public static void main(String[] args) {
}
}
2)運行該java類,在瀏覽器上就可以訪問該webservice了。
注意:開發web工程的時候,這種方法不太友好。我們可以編寫一個servlet類,在servlet類的初始化方法中發布webservice,這樣我們的中間件伺服器啟動的時候就會幫我們自動webservice了。
4) xfire
開發WebService的框架不少,每個框架都有各自的有點,最近我用xfire練習開發WebService,下面是開發WebService的小例子,希望對入門的人有些小幫助
1.新建一個java web project命名為TestWebService,將xfire相關的jar包添加到lib目錄中,寫介面類和實現類
Java代碼
package com.lamp.service;
public interface MessageService {
public String getName(String name);
}
[java] view plainprint?
package com.lamp.service;
public interface MessageService {
public String getName(String name);
}
實現類
Java代碼
package com.lamp.service.impl;
import com.lamp.service.MessageService;
public class MessageServiceImpl implements MessageService {
public String getName(String name) {
return "hellow " + name + ", welcome to WebService world";
}
}
[java] view plainprint?
package com.lamp.service.impl;
import com.lamp.service.MessageService;
public class MessageServiceImpl implements MessageService {
public String getName(String name) {
return "hellow " + name + ", welcome to WebService world";
}
}
在src目錄下新建文件夾META-INF,然後再在其下新建文件夾xfire,在xfire目錄下新建配置文件services.xml
Xml代碼
<?xml version="1.0" encoding="UTF-8"?>
<service>
<name>MessageService</name>
<serviceClass>com.lamp.service.MessageService</serviceClass>
<implementationClass>com.lamp.service.impl.MessageServiceImpl</implementationClass>
</service>
</beans>
[xml] view plainprint?
<?xml version="1.0" encoding="UTF-8"?>
<service>
<name>MessageService</name>
<serviceClass>com.lamp.service.MessageService</serviceClass>
<implementationClass>com.lamp.service.impl.MessageServiceImpl</implementationClass>
</service>
</beans>
最後在web.xml中配置xfire的servlet
Xml代碼
<servlet>
<servlet-name>XFireServlet</servlet-name>
<servlet-class>
</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>XFireServlet</servlet-name>
<url-pattern>/servlet/XFireServlet/*</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>XFireServlet</servlet-name>
<url-pattern>/services/*</url-pattern>
</servlet-mapping>
[xml] view plainprint?
<servlet>
<servlet-name>XFireServlet</servlet-name>
<servlet-class>
</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>XFireServlet</servlet-name>
<url-pattern>/servlet/XFireServlet/*</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>XFireServlet</servlet-name>
<url-pattern>/services/*</url-pattern>
</servlet-mapping>
這樣伺服器端開發完畢,現在開始客戶端的開發
新建一個java project也將xfire相關的jar引入,我用ant在客戶端生成代理對象,在項目路徑下新建build.xml,代碼為
Xml代碼
<?xml version="1.0" encoding="UTF-8"?>
<project name="WebService" basedir="." default="gen-webservice">
<property file="build.properties">
</property>
<path id="project-classpath">
<fileset dir="${lib.dir}">
<include name="**/*.jar" />
</fileset>
</path>
<target name="gen-webservice">
<taskdef name="wsgen" classname="org.codehaus.xfire.gen.WsGenTask" classpathref="project-classpath" />
<wsgen outputDirectory="${src.dir}"
wsdl="${wsdl.dir}" package="com.lamp.ws.client" overwrite="true"/>
</target>
</project>
[xml] view plainprint?
<?xml version="1.0" encoding="UTF-8"?>
<project name="WebService" basedir="." default="gen-webservice">
<property file="build.properties">
</property>
<path id="project-classpath">
<fileset dir="${lib.dir}">
<include name="**/*.jar" />
</fileset>
</path>
<target name="gen-webservice">
<taskdef name="wsgen" classname="org.codehaus.xfire.gen.WsGenTask" classpathref="project-classpath" />
<wsgen outputDirectory="${src.dir}"
wsdl="${wsdl.dir}" package="com.lamp.ws.client" overwrite="true"/>
</target>
</project>
Ⅱ 用java客戶端程序調用web service時,編譯時出現"軟體包org.apache.axis2不存在"等錯誤
首先你要了解來一下你的Tomcat類載入路徑源,順序如下:
%JAVA_HOME%/jre/lib -> %JAVA_HOME%/jre/lib/ext -> %TOMCAT_HOME%/webapps/%Your App%/lib -> %TOMCAT_HOME%/lib
在這幾個路徑中找到合適的位置把jar包加進去就可以了
Ⅲ Axis2的具體使用
為了搞個Web Services,讓我真是煞費苦心.還好最後用到了axis,在axis上發布Web Services是一件很輕松的事情.甚至不做配置的情況下都可以採用即時發布.就象jsP的發布
安裝axis需要Servlet容器,我用的是Tomcat-5.0.28,下載Tomcat和axis我就不說了,下載後將axis解壓後,將axis文件夾考到Tomcat的webapps下.
設置環境變數是非常重要的,設置環境變數:AXISCLASSPATH為:
%AXIS_LIB%axis.jar;%AXIS_LIB%commons-discovery-0.2.jar;%AXIS_LIB%commons-logging-1.0.4.jar;%AXIS_LIB%jaxrpc.jar;%AXIS_LIB%saaj.jar;%AXIS_LIB%log4j-1.2.8.jar;%AXIS_LIB%wsdl4j-1.5.1.jar;%AXIS_LIB%xml-apis.jar;%AXIS_LIB%xercesImpl.jar
設置AXIS_LIB為隨便一個文件夾,將上面的一堆jar包搞進去.再將activation.jar, mail.jar, wsdl4j-1.5.1.jar搞到 %CATALINA_HOME%commonlib下.
若啟動Tomcat後在瀏覽器輸入:http://localhost:8080/axis/happyaxis.jsp,若Needed Components都載入了就說明正常啟動了axis.
axis支持兩種發布方式:(先啟動Tomcat)
1.即時發布:直接使用java語言編輯.jws文件,將它放到axis目錄下.
實例:用文本編輯器編寫HelloWorld.jws
public class HelloWorld
{
public String helloWorld(){
System.out.println("Hello World!");
return "Hello World!";
}
}
拷貝到axis下,在瀏覽器中輸入:http://localhost:8080/axis/HelloWorld.jws?wsdl,若顯示出相應的描述,說明發布成功,一般不會失敗的,除非axis本身有問題.
2.定製發布:將編譯完的.class文件放到axisWEB-INF,要包含包的文件夾.然後編寫.wsdd文件,用org.apache.axis.client.AdminClient來發布
實例:編寫並編譯文件Capacity.java.
package samples.capacity;
public class Capacity
{
public double convertGallon2Litre(double gallon,String user){
if("Andy".equals(user))
return gallon * 4.546;
else
return 0.0d;
}
}
將Capacity.class文件拷貝到axisWEB-INFclasses下(帶著文件夾拷),編寫deploy.wsdd文件
<deployment xmlns="http://xml.apache.org/axis/wsdd/" xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">
<service name="Capacity" provider="java:RPC">
<parameter name="className" value="samples.capacity.Capacity"/>
<parameter name="allowedMethods" value="*"/>
</service>
</deployment>
拷到Capacity.class所在的目錄,在控制台切換到該目錄執行:
java -cp %AXISCLASSPATH% org.apache.axis.client.AdminClient deploy.wsdd
顯示如下信息說明發布完畢:
Processing file deploy.wsdd
<Admin>Doneprocessing</Admin>
在瀏覽器輸入http://localhost:8080/axis/services/Capacity?wsdl,若顯示描述,則說明發布成功.(好象要等一段時間才)
調用Web Services:編寫AXISTest.java文件:
package axisexercise;
import org.apache.axis.client.Call;
import org.apache.axis.client.Service;
import org.apache.axis.encoding.XMLType;
import javax.xml.rpc.ParameterMode;
public class AXISTest
{
public static void main(String[] args) throws Exception{
Service service = new Service();
Call call = ( Call ) service.createCall();
//////////訪問即時發布的Distance服務
//設置訪問點
call.setTargetEndpointAddress("http://localhost:8080/axis/Distance.jws");
//設置操作名
call.setOperationName("convertMile2Kilometre");
//設置入口參數
call.addParameter("op1",XMLType.XSD_DOUBLE,ParameterMode.IN);
call.setReturnType( XMLType.XSD_DOUBLE );
Double d1 = new Double( 190 );
//調用服務
System.out.println(d1 + " 英里相當於 " + call.invoke(new Object[] {d1}) + " 公里!");
//////////訪問定製發布的Capacity服務
call = ( Call ) service.createCall();
//設置訪問點
call.setTargetEndpointAddress("http://localhost:8080/axis/services/Capacity");
//設置操作名
call.setOperationName("convertGallon2Litre");
//設置入口參數
call.addParameter("op1",XMLType.XSD_DOUBLE,ParameterMode.IN);
call.addParameter("op2",XMLType.XSD_STRING,ParameterMode.IN);
call.setReturnType( XMLType.XSD_DOUBLE );
d1 = new Double( 10.00 );
String str1 = "ss";
//調用服務
System.out.println(d1 + " 加侖相當於 " + call.invoke( new Object[] {d1,str1} ) + " 升!");
}
}
編譯:javac -classpath .;%AXISCLASSPATH% AXISTest.java
執行:java -classpath .;%CATALINA_HOME%commonlibwsdl4j-1.5.1.jar;%AXISCLASSPATH% axisexercise.AXISTest
顯示如下結果:
log4j:WARN No appenders could be found for logger (org.apache.axis.i18n.ProjectResourceBundle).
log4j:WARN Please initialize the log4j system properly.
190.0 英里相當於 305.71 公里!
10.0 加侖相當於 0.0 升!
若將AXISTest.java中的str1改為Andy,則接過就是45.46升