Weblogic Server ant開發Web Service一(圖)

　　 
　　前言：本文不是專門講述Web Service技術的，讀者在閱讀本文之前需要具備一定的SOAP和Web Service知識基礎，同時對Weblogic Server的使用也應該熟悉。

如果要自己動手實踐本文的例子，就需要安裝Weblogic Server 81,盡管本文是以weblogic server 81為測試環境，但是針對weblogic server 7下也是差不多的。本文只是起個拋磚引玉的作用，如果想深入研究Web Service的開發，還需要參考、學習相關的資料，包括Weblogic Service的相關文檔。
　　
　　一、概述
　　
　　在JBuilder中也支持開發基于weblogic的web service，不過實際上在JBuilder下開發web service也是基于ant任務來生成和構造web service的。但是，當初筆者在一個項目中使用JBuilder下自動生成構造ant腳本生成的web service時碰到了一個問題，通過JBuilder生成的web service，如果你的web service調用接口中存在一個或者多個String類型參數的時候，在生成的wsdl文件中對該接口的參數命名不會按照你的后端組件對應方法中參數的名字，而是以string、string0、string1…等形式命名的。而在那個項目中需要在Delphi環境中調用web service，問題就出現了，string在Delphi中是關鍵詞，產生了沖突，不能進行調用。于是筆者決定采用自編寫ant腳本的方式來生成和構造web service來解決前面所述Delphi調用的問題。
　　
　　BEA Weblogic提供了一些Ant任務，用來幫助開發者生成、構造一個Web服務的重要部件，（例如：序列化類、客戶端jar支持庫、以及web-services.xml描述文件），并且把一個Weblogic Web 服務的所有部分打包成一個可部署的EAR文件。
　　
　　BEA Weblogic所提供的Web服務Ant任務，支持從實現了Web Service接口的普通JAVA源文件和EJB jar生成Web Service部件，也支持從WSDL描述文件生成，同時支持基于http/https傳輸協議和JMS傳輸協議的Web Service。在這一節我們只講述通過基于一個普通JAVA類作為后端組件來實現的Web Service，傳輸協議使用http（基于https的方式將在后述關于Web Service安全的部分講述）。
　　
　　二、使用Weblogic ant工具生成Web Service
　　
　　我們先建立D:wls_ws_demo的工作目錄，在此目錄下分別建立src、build、ddfiles、webapp、test目錄。具體用途后文會涉及到。
　　
　　首先我們編寫一個實現了兩個Web Service接口的普通JAVA類：
　　
　　package com.wnetw.ws.demo;
　　
　　public class HelloWorldWS{
　　
　　public String sayHello(){
　　return "Hello World!";
　　}
　　
　　public String welcome(String name){
　　return "Hello " + name + ",Welcome to WebService!";
　　}
　　
　　}
　　上面兩個方法就不需要解釋了，很簡單。把此類按封裝包一致的路徑放置在src目錄下。
　　
　　下面是本示例中ant腳本文件內的屬性設置：
　　<property name="build.compiler" value="modern"/>
　　<property name="src.dir" value="src"/>
　　<property name="build.dir" value="build"/>
　　<property name="war.file" value="/
　　applications/HelloWorldWS.war" />
　　<property name="ear.file" value="/applications/HelloWorldWS.ear" />
　　<property name="clients.lib" value="/clientslib/HelloWorldWS_clients.jar"/>
　　<property name="bea.home" value="D:/bea"/>
　　<property name="wls.dir" value="/weblogic81/server"/>
　　<property name="wlslib.dir" value="/lib"/>
　　<property name="wlsext.dir" value="/ext"/>
　　<property name="namespace" value="http://www.wnetw.com/demo/"/>
　　<path id="classpath">
　　<dirset dir="/classes">
　　<include name="**"/>
　　</dirset>
　　<fileset dir="">
　　<include name="**/weblogic.jar"/>
　　<include name="**/webservices.jar"/>
　　</fileset>
　　</path>
　　<property name="javac.fork" value="no"/>
　　<property name="javac.debug" value="no"/>
　　<property name="javac.optimize" value="on"/>
　　<property name="javac.listfiles" value="yes"/>
　　<property name="javac.failonerror" value="yes"/>
　　
　　上面的屬性應該不是很難理解，關鍵的是對于bea weblogic server安裝目錄和構造生成文件的路徑說明，其次是對classpath的設置，需要用到的兩個weblogic庫是weblogic.jar和webservices.jar。
　　
　　接著我們看看我們在本節中使用的Weblogic提供的Ant任務：
　　
　　1、source2wsdd
　　
　　source2wsdd Ant任務最基本的功能是根據我們編寫的普通JAVA類源文件生成一個Web Service所必需的兩個部件：web-services.xml和.wsdl描述文件。
　　
　　下面是針對上面HelloWorldWS.java對應的Ant腳本：
　　<target name="genwsdd">
　　<source2wsdd javaSource="/com/wnetw/ws/demo/HelloWorldWS.java"
　　ddFile="/wsddfiles/web-services.xml"
　　wsdlFile="/wsddfiles/HelloWorldWS.wsdl"
　　serviceURI="/HelloWorldWS">
　　<classpath refid="classpath"/>
　　</source2wsdd>
　　</target>
　　
　　屬性說明
　　
　　javaSource：指定web service的實現后端組件，這里是普通JAVA類com.wnetw.ws.demo HelloWorldWS.java。注意屬性里面是對源文件目錄路徑設置，而不是包路徑。
　　
　　ddFile：生成的web service部署描述符文件web-services.xml的存放路徑。
　　
　　wsdlFile：生成的.wsdl文件存放的路徑和名字。
　　
　　serviceURI：客戶應用程序調用此Web服務的URL中的Web Service URI部分。注意：必須以“/”開頭。例如：/ HelloWorldWS 。同時這個URI屬性也會成為生成的web-services.xml 部署描述符文件中<web-service>元素的uri屬性。
　　
　　例如：本機訪問本web service例子的url是http://localhost:7001/ WSDemo/ HelloWorldWS
　　
　　上面的serviceURI屬性就指定了上述url中的/ HelloWorldWS這一部分。
　　
　　2、clientgen
　　
　　clientgen可以用來生成JAVA環境下客戶端應用調用一個Web Service客戶端jar支持庫?？梢酝ㄟ^wsdl文件來生成，也可以通過一個包含web service實現的ear文件來生成。
　　
　　下面是clientgen ant任務的腳本示例：
　　<target name="genclient">
　　<clientgen wsdl="/wsddfiles/HelloWorldWS.wsdl"
　　packageName="com.wnetw.ws.demo.client"
　　clientJar=""
　　keepGenerated="false">
　　<classpath refid="classpath"/>
　　</clientgen>
　　</target>
　　
　　這里采用從前面source2wsdd任務生成的wsdl文件來生成客戶端jar支持庫。通過wsdl屬性指定。
　　
　　3、war
　　
　　這是ant提供的標準任務，這里與其他普通的war包有一點區別是，需要把web-services.xml文件打包到war中去。
　　
　　說明：需要準備web.xml，后面對于安全設置的時候還需要weblogic.xml文件，這里先都打包進去，這些文件都需要提前編輯準備好：
　　
　　---Web.xml---
　　<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd">
　　<web-app>
　　<mime-mapping>
　　<extension>wsdl</extension>
　　<mime-type>text/xml</mime-type>
　　</mime-mapping>
　　</web-app>
　　
　　---weblogic.xml---
　　<?xml version="1.0" encoding="UTF-8"?>
　　<!DOCTYPE weblogic-web-app PUBLIC "-//BEA Systems, Inc.//DTD Web Application 7.0//EN" "http://www.bea.com/servers/wls700/dtd/weblogic700-web-jar.dtd">
　　<weblogic-web-app>
　　</weblogic-web-app>
　　
　　這個文件沒設置，在后面關于安全的處理里面需要這里配置角色映射。
　　
　　下面是war ant腳本示例：
　　
　　<target name="genwar">
　　<war destfile="" webxml="webapp/WEB-INF/web.xml">
　　<classes dir="/classes"/>
　　<webinf dir="/wsddfiles">
　　<include name="web-services.xml"/>
　　</webinf>
　　<webinf dir="webapp/WEB-INF">
　　<include name="weblogic.xml"/>
　　</webinf>
　　</war>
　　</target>
　　4、ear
　　
　　這也是ant標準任務，需要注意的是必須提前編寫application.xml文件，下面針對本文例子的application.xml文件：
　　
　　<!DOCTYPE application PUBLIC '-//Sun Microsystems, Inc.//DTD J2EE Application 1.3//EN' 'http://java.sun.com/dtd/application_1_3.dtd'>
　　<application>
　　<display-name></display-name>
　　<module>
　　<web>
　　<web-uri>HelloWorldWS.war</web-uri>
　　<context-root>WSDemo</context-root>
　　</web>
　　</module>
　　</application>
　　
　　說明：context-root元素指定此Web Service所在Web應用的應用根。
　　
　　例如：本機訪問本web service例子的url是http://localhost:7001/WSDemo/ HelloWorldWS
　　
　　上面的context-root元素就指定了上述url中的WSDem

原文轉自：http://www.anti-gravitydesign.com