WSDL Info

A WSDL document defines services as collections of network endpoints, or ports. In WSDL, the abstract definition of endpoints and messages is separated from their concrete network deployment or data format bindings. This allows the reuse of abstract definitions: messages, which are abstract descriptions of the data being exchanged, and port types which are abstract collections of operations. The concrete protocol and data format specifications for a particular port type constitutes a reusable binding. A port is defined by associating a network address with a reusable binding, and a collection of ports define a service. Hence, a WSDL document uses the following elements in the definition of network services:

Services are defined using six major elements:

• types, which provides data type definitions used to describe the messages exchanged.
• message, which represents an abstract definition of the data being transmitted. A message consists of logical parts, each of which is associated with a definition within some type system.
• portType, which is a set of abstract operations. Each operation refers to an input message and output messages.
• binding, which specifies concrete protocol and data format specifications for the operations and messages defined by a particular portType.
• port, which specifies an address for a binding, thus defining a single communication endpoint.
• service, which is used to aggregate a set of related ports.

If the values being passed are part1=1, part2=2, part3=3, the request format would be as follows for each port:

port1: GET, URL="http://example.com/o1/A1B2/3"
port2: GET, URL="http://example.com/o1?p1=1&p2=2&p3=3
port3: POST, URL="http://example.com/o1", PAYLOAD="p1=1&p2=2&p3=3"

For each port, the response is either a GIF or a JPEG image.

Example 6. GET and FORM POST returning GIF or JPG

<definitions .... >
    <message name="m1">
        <part name="part1" type="xsd:string"/>
        <part name="part2" type="xsd:int"/>
        <part name="part3" type="xsd:string"/>
    </message>

    <message name="m2">
        <part name="image" type="xsd:binary"/>
    </message>

    <portType name="pt1">
        <operation name="o1">
           <input message="tns:m1"/>
           <output message="tns:m2"/>
        </operation>
    </portType>

    <service name="service1">
        <port name="port1" binding="tns:b1">
           <http:address location="http://example.com/"/>
        </port>
        <port name="port2" binding="tns:b2">
           <http:address location="http://example.com/"/>
        </port>
        <port name="port3" binding="tns:b3">
             <http:address location="http://example.com/"/>
        </port>
    </service>

    <binding name="b1" type="pt1">
        <http:binding verb="GET"/>
        <operation name="o1">
           <http:operation location="o1/A(part1)B(part2)/(part3)"/>
           <input>
               <http:urlReplacement/>
           </input>
           <output>
               <mime:content type="image/gif"/>
               <mime:content type="image/jpeg"/>
           </output>
        </operation>
    </binding>

    <binding name="b2" type="pt1">
        <http:binding verb="GET"/>
        <operation name="o1">
           <http:operation location="o1"/>
           <input>
               <http:urlEncoded/>
           </input>
           <output>
               <mime:content type="image/gif"/>
               <mime:content type="image/jpeg"/>
           </output>
        </operation>
    </binding>

    <binding name="b3" type="pt1">
        <http:binding verb="POST"/>
        <operation name="o1">
           <http:operation location="o1"/>
           <input>
               <mime:content type="application/x-www-form-urlencoded"/>
           </input>
           <output>
               <mime:content type="image/gif"/>
               <mime:content type="image/jpeg"/>
           </output>
        </operation>
    </binding>
</definitions>

4.2 How the HTTP GET/POST Binding Extends WSDL

The HTTP GET/POST Binding extends WSDL with the following extension elements:

<definitions .... >
    <binding .... >
        <http:binding verb="nmtoken"/>
        <operation .... >
           <http:operation location="uri"/>
           <input .... >
               <-- mime elements -->
           </input>
           <output .... >
               <-- mime elements -->
           </output>
        </operation>
    </binding>

    <port .... >
        <http:address location="uri"/>
    </port>
</definitions>

These elements are covered in the subsequent sections.

4.3 http:address

The location attribute specifies the base URI for the port. The value of the attribute is combined with the values of the location attribute of the http:operation binding element. See section 4.5 for more details.

4.4 http:binding

The http:binding element indicates that this binding uses the HTTP protocol.

<definitions .... >
    <binding .... >
        <http:binding verb="nmtoken"/>
    </binding>
</definitions>

The value of the required verb attribute indicates the HTTP verb. Common values are GET or POST, but others may be used. Note that HTTP verbs are case sensitive.

posted @ 2007-01-28 16:24 junhong 閱讀(346) | 評論 (0) | 編輯 收藏

SAX2.0

/*
自從XML真正形成以來(我認為是Org.W3C組織發(fā)布XML標準時開始),XML得到了很快的發(fā)展,
?很多廠商都有推出了自己的XML解析器,如Apache的xalan,IBM的xerces,sun的JDOM等,不過這些都是在
?基于JAXP(java API for XML processing)的,從JDK 1.4.0開始的后續(xù)j2sdk里都附加了JAXP,這給開發(fā)人員
?帶來了很大的方便,這使得我們在處理一般的XML功能上的問題時不再需要去用第三方的XML處理器了.
?隨著XML的迅速發(fā)展,SAX也從1.0到了現(xiàn)在的2.0了(還是能夠和1.0兼容),結(jié)構(gòu)上有了一些較大的變化.

?DOM(document object model)每次讀取XML節(jié)點時都要把它load到內(nèi)存里 來,在文檔很大時,就顯得很慢了,SAX(simple API for XML),是一個XML解析器的接口,它比DOM更低級一些,它是一種基于事件和回調(diào)模式的XML處理方式,?因此在解析速度上DOM是沒法比 的(當要解析的XML文檔很大的時更是如此).那么在SAX中事件響應(yīng)(event)是什么呢 ??我個人認為這一點和Swing,AWT中的事件義有點相似的,都有是指在觸發(fā)某些特定的行為時所做的處理,如:mouse 的click事件等到.?這里則是指碰到特定的XML節(jié)點的所做的處理,如文檔開始(startDocument),文檔結(jié)束 (endDocument),元素開始(startElement)等很多,大家看一下SAX的API中的方法名字就知道有哪些事件了,基本上可以做到見 文知義的.在只想分析XML內(nèi)容(只讀),要求高性能,靈活性?能夠定位錯誤信息(SAX能夠定位錯誤的行列位置)時,最好用SAX來做.?一般情況下SAX是按下面的原理去使用的:
? <1>設(shè)置事件處理器(SAX 1.0是使用一個通過繼承HandlerBase類的實例來設(shè)置的,SAX 2.0則是繼承DefaultHandler的,還有用XMLReader方式的,在原理上沒有很大的區(qū)別)
? <2>載入要解析的內(nèi)容
? <3>在需要解析的事件方法里(具體參見SAX API文檔)加入自己的控制邏輯.
? <4>重復(fù)<3>直到解析完為止.??????? ?????????
?
?在這里我自己寫了一個描述電影海報信息的XML文件(file.xml),用SAX2.0寫了一個很簡單的XML內(nèi)容閱讀器來解析它,?和大家交流一下自己的心得.程序在我的機器上經(jīng)過了測試的(OS: win2k Advanced Server(English version),
?Intel pentium CPU, 256M RAM)
*/

import org.w3c.dom.*;
import org.xml.sax.*;
import org.xml.sax.helpers.*;
import javax.xml.parsers.*;

class MyXMLReader extends DefaultHandler
{??
?//Fields
?private int index;
?private Locator locator;

?//Constructor
?public MyXMLReader(){
??super(); //it must be done !
?}

?//nain method
?public static void main(String[] args){
??try{???
????? SAXParserFactory sf? = SAXParserFactory.newInstance();
????? SAXParser sp = sf.newSAXParser();
????? MyXMLReader reader = new MyXMLReader();
????? sp.parse(new InputSource("film.xml"),reader);
??}
??catch(Exception e){
???e.printStackTrace();
??}
?}?

?//Response the startDocument event
?public void startDocument() {
??System.out.println("\n********************************* (:?元旦電影海報 :)?***********************************\n");
?}??

//Response the startElement event
?public void startElement(String uri, String localName, String qName, Attributes attrs){??
??if( qName.equalsIgnoreCase("film") ){???
???index ++;???
???int attrCount = attrs.getLength();
???for( int i = 0; i < attrCount; i ++ ){
????String attrName = attrs.getQName(i);
????if( attrName.equalsIgnoreCase("name") ){
?????System.out.println("\t第" + index + "場,片名:<<" +? attrs.getValue(i) + ">>");
????}
????if( attrName.equalsIgnoreCase("price") ){
?????System.out.println("\t票價:" + attrs.getValue(i) );?????
????}
????if( attrName.equalsIgnoreCase("station") ){
?????System.out.println("\t放映地點:" + attrs.getValue(i) );?????
????}
????if( attrName.equalsIgnoreCase("time") ){
?????System.out.println("\t放映時間:" + attrs.getValue(i) );
????}
????if( attrName.equalsIgnoreCase("describtion") ){
?????System.out.println("\t影片簡介:" + attrs.getValue(i) );
????}
????System.out.println();
??}
?}

?//Response the endDocument event
?public void endDocument(){
??System.out.println("\t\t\t\t\t\t\t------?共有" + index + "場電影要放映");??
?}

?//Response the endElement event
?public void endElement(String uri, String localName, String qName){
??? ?//add your codes if neccessary ...
?}

?//Print the fata error information
?public void fatalError(SAXParseException e){
??System.out.println("\nFatal error information -->");
??System.out.println("\t" + e.getMessage());
??System.out.println("\tAt line " + locator.getLineNumber() +
????????????????? ",column " + locator.getColumnNumber());
?}
?
?//Print the usual error information
?public void error(SAXParseException e){
??System.out.println("\nUsual error information -->");??
??System.out.println("\t" + e.getMessage());
??System.out.println("\tAt line " + locator.getLineNumber() +
????????????????? ",column " + locator.getColumnNumber());
?}
?
?//Print the warning information
?public void warning(SAXParseException e){
??System.out.println("\nWarning information -->");????
??System.out.println("\t" + e.getMessage());??
??System.out.println("\tAt line " + locator.getLineNumber() +
????????????????? ",column " + locator.getColumnNumber());
?}

?//Store the error locator object
?public void setDocumentLocator(Locator lct){
??locator = lct;
?}

}//End class MyXMLReader

附 : film.xml完全的內(nèi)容:

<?xml version="1.0" encoding="GB2312"?>
?? <!-- 2003年元月1號長沙市各大影院落放映列表 -->
?? <common city="ChangSha China" date="01/01/2003">
???? <film name="英雄" price="30" station="田漢大劇場" time="19:00"
??????? describtion="國產(chǎn)最新大片,張藝謀導(dǎo)演,梁朝偉,張曼玉,李連杰等眾多大明星主演">
??</film>
??<film name="無間道" price="20" station="長沙市演藝中心" time="15:00"
??????? describtion="韓國大片">
??</film>
??<film name="武士" price="20" station="湖南省電影院" time="17:00"
??????? describtion="韓國大片,有點像英雄">
??</film>??
??<film name="長排山之戰(zhàn)" price="15" station="長沙市電影超市A1廳" time="19:00"
??????? describtion="反映對越自衛(wèi)反擊戰(zhàn)時期中國軍人的故事片">
? ??? </film>
??<film name="高山下的花環(huán)" price="15" station="長沙市電影超市A2廳" time="19:00"
??????? describtion="反映對越自衛(wèi)反擊戰(zhàn)時期中國軍人的故事片">
??</film>??
??? <film name="這里的黎明靜悄悄" price="15" station="長沙市電影超市A3廳" time="19:00"
??????? describtion="反映對越自衛(wèi)反擊戰(zhàn)時期中國軍人的故事片">
??</film>
??<film name="子夜" price="15" station="長沙市電影超市B1廳" time="19:00"
??????? describtion="反映對越自衛(wèi)反擊戰(zhàn)時期中國軍人的故事片">
??</film>
? </common>

?

posted @ 2006-11-24 10:21 junhong 閱讀(651) | 評論 (0) | 編輯 收藏