Revisited

Try to Create a
WebServices Client

Kazuhiro Fujie
Itochu techno-science corporation

quot; Have you ever had a dream,
Neo, that you were so sure
was real?
What if you were unable to
wake from that dream, Neo?
How would you know the
difference between the
dream world and the real. quot;

Morpheus

quot; You take the blue pill, the
story ends; you wake up in
your bed and believe...
whatever you want to believe.
You take the red pill, you
stay in Wonderland; and I
show you how deep the
rabbit hole goes. quot;

Morpheus

quot; Remember ... all I'm
offering you is the truth.
Nothing more. quot;

Morpheus

Web Services Architecture
• よくみる図
Broker

publish
find

Requester Provider

bind

• 初めて観た時は、何だか新しいモノのような気が
したけど…

quot; There is no spoon. quot;

Neo

Program
• 普通のアプリケーションプログラム
• 一つのマシンで実行する
• ローカルなプログラム

Main program Sub program

Program Code
• ローカルなプログラムの場合、例えば…
/* メインプログラム。サブルーチンを呼び出す。 */
String result = doSpellingSuggestion(quot;britnay sparsquot;);
:

/* サブルーチン*/
String doSpellingSuggestion(String phrase) {
特定の機能を担うサブルーチン。
例えば、スペル候補の処理などを行い結果を返り値として返す。
return result;
}

• 同じマシンでしか実行できない…

quot; He was so different.
He was like you. quot;

Persephone

Separate Ways
• 分散環境のアプリケーションでは？
– 別々のマシンで実行するために…

Socket…
Server
Client

• Socket, PIPE, …
– 自分で通信のやり取りの中味を考える必要がある。

RPC
Remote Procedure Call
• 基本的に同じように簡単に行いたい。
/* メインプログラム。サブルーチンを呼び出す。 */
String result = doSpellingSuggestion(quot;britnay sparsquot;);
:
APIのフック
サーバー受信
通信処理
処理結果送信

/* サブルーチン*/
String doSpellingSuggestion(String phrase) {
特定の機能を担うサブルーチン。
例えば、スペル候補の処理などを行い結果を返り値として返す。
return result;
}

distributed environment
• 分散環境コンピューティング
• プログラムが離れたマシンの上にあるサブ
ルーチンを、同じマシン上にあるかのよう
に簡易に呼び出すことができる。
• Remote Procedure Call (RPC)
– 遠隔手続き呼び出し
• Distributed Object
– 分散オブジェクト

Genealogy of distributed
environment
• Sun RPC
– ONC-RPC Open Network Computing
– XDR (eXternal Data Representations)
• DCE RPC (OSF)
– Distributed Computing Environment (DCE)
• CORBA (OMG)
– CORBA (Common Object Request Broker Architecture)
– CORBA IDL (Interface Definition Language)
– IIOP (Internet Inter-ORB Protocol)
• Java RMI
– Remote Method Invocation (RMI)
– Java Interface

quot; I’ll let you in on a little secret.
Being the one is just like being
love.
No one can tell you you’re in
love.
You just knew it…
through and through.
Balls to bones. quot;

The Oracle

Stub / Skeleton
• 離れていても同じように。


• なるべく簡単に出来るための…

Stub / Skeleton ( Tie )
• そのための仕組み。
Interface Interface
Language Language
Stub Skeleton

Runtime Runtime

Transport

Web Services
• JAX-RPC
WSDL WSDL
Web Service Web Service
Client
Implementation
Application Stub
Tie (Skeleton)

JAX-RPC JAX-RPC
Runtime Runtime

SOAP/HTTP

quot; That’s a nice trick. quot;

Trinity

JAX-RPC
• Java APIs for XML-based RPC
– JavaでSOAPとWSDLを使った開発ができる。
• Standards
– JCPによる標準仕様であるJSR 101
• Interoperability
– クライアントのAPI、ツールやランタイム実装な
どについて決められてポータブルなアプリケー
ションを実現できるようにの工夫がされている。

quot; I Love Candy. quot;

The Oracle

quot; When I see 3 objectives,
3 captains, 3 ships …
I do not coincidence.
I see providence.
I see purpose. quot;

Morpheus

3 objectives,
3 captains, 3 ships

The Magi
• 東方の三賢人
– Gaspar (Caspar), Melchior, Balthazar
• 三種の神器
– 洗濯機, 冷蔵庫, 白黒テレビ
• Webサービス
– SOAP, WSDL, UDDI

Web Services Standards
• SOAP
– Simple Object Access Protocol
• WSDL
– Web Services Description Language
• UDDI
– Universal Description, Discovery, and
Integration

quot; Free your mind quot;

Morpheus

Web Services Architecture
• もういちど。 UDDI registry

publish
find

WSDL
Client Service

SOAP

• UDDIを無視すれば、RPCと観ることも。

quot; That means buckle your
seat belt, Dorothy,
`cause Kansas is going`
bye-bye.. quot;
Cypher

クライアントを作ってみる。

Google Web APIs

quot; But this is not a reason,
this is not a why,
The keymaker himself, his
very nature, is a means, it
is not an end. quot;

Merovingian

Google Web Services
• Google Web APIs (beta)
– Google 提供のWebサービスのベータ版
– スペルの候補を教えてくれる？みたい。
– キーワードでの検索などができる？みたい。
• Webサービスのクライアントをつくってみる。
– 標準であるJAX-RPC のAPIをつかう。
– 予めStubを作成しておいて、それに面倒な事
は、お任せしたプログラムを作成する。

Google Step 0/3
• JDK
– http://java.sun.com/j2se/1.4/

• JWSDP
– Java Web Services Developer Pack
– http://java.sun.com/webservices/jwsdp/
– JAX-RPC API, Runtime, Tools

Google Step 1/3
• サービスのWSDLを入手する。
– Webサービスを利用するための情報
• Download the developer's kit
– http://www.google.co.jp/apis/index.html

• アカウントの登録
• ライセンスの取得
– 検索機能を利用するためのライセンスキー

Google Step 2/3
• スタブクラスの作成
– WSDLインターフェースからスタブを生成する。
• 公開されているWSDL
– http://api.google.com/GoogleSearch.wsdl

• ツールでスタブを生成。
– wscompile で半自動生成。

Google Step 3/3
• クライアントプログラムの作成
– 必要なパッケージのインポート。
– スタブクラスのインスタンス生成。
– エンドポイントアドレスの指定。
– （遠隔オブジェクトの）メッセージの呼び出し。
• コンパイル
• 実行

quot; Okey, dokey. quot;

Neo

やってみましょう。

Demonstration

quot; I know Kung Fu. quot;

Neo

quot; Show me. quot;

Morpheus

いまみたこと

Revisited

WSDLをちょっとのぞく。

Look into Web Services
Description Language

WSDL Document Structure
WSDL Document
Types

Message

Port Type
Operation
Binding

Service
Port

Google WSDL
• http://api.google.com/GoogleSearch.wsdl

<?xml version=quot;1.0quot; ?>


<definitions name=quot;GoogleSearchquot;
targetNamespace=quot;urn:GoogleSearchquot;
xmlns:typens=quot;urn:GoogleSearchquot;
xmlns:xsd=http://www.w3.org/2001/XMLSchema
xmlns:soap=http://schemas.xmlsoap.org/wsdl/soap/
xmlns:soapenc=http://schemas.xmlsoap.org/soap/encoding/
xmlns:wsdl=http://schemas.xmlsoap.org/wsdl/
xmlns=quot;http://schemas.xmlsoap.org/wsdl/quot;>
<types>
:

Google WSDL cont.
:

<message name=quot;doSpellingSuggestionquot;>
<part name=quot;keyquot; type=quot;xsd:stringquot; />
<part name=quot;phrasequot; type=quot;xsd:stringquot; />
</message>


<portType name=quot;GoogleSearchPortquot;>


<binding name=quot;GoogleSearchBindingquot;
type=quot;typens:GoogleSearchPortquot;>
:

Google WSDL cont.

:

<service name=quot;GoogleSearchServicequot;>
<port name=quot;GoogleSearchPortquot;
binding=quot;typens:GoogleSearchBindingquot;>
<soap:address location=
quot;http://api.google.com/search/beta2quot; />
</port>
</service>
</definitions>

quot; It is purpose that created us.
Purpose that connects us.
Purpose that pull us.
That guides us.
That drives us.
It is purpose that defines.
Purpose that bind us.quot;

Smith (not Agent)

スタブを用意する。

Generate Static Stub

Generate Stub
• WSDLを基にスタブクラスを生成する。

wscompile -verbose -gen:client -d build config-wsdl.xml

• スタブクラス生成について設定ファイルで
指示できる。
– ex. config-wsdl.xml

wscompile configuration
• wscompile 設定ファイルの例

<?xml version=quot;1.0quot; encoding=quot;UTF-8quot; ?>
<configuration
xmlns=quot;http://java.sun.com/xml/ns/jax-rpc/ri/configquot;>
<wsdl location=quot;http://api.google.com/GoogleSearch.wsdlquot;
packageName=quot;jp.co.ctc_g.atd.google.stubquot; />
</configuration>

• ダウンロード済みWSDLを指定しても可。

quot; It’s starts so simply…
each line of the program
creating a new effect,
just like … poetry. quot;
Merovingian

クライアントのコードを書く。

Coding a Static Stub Client

Static Stub 1/4
Creates a Stub object
• Stubオブジェクトを生成する。
Stub stub =
(Stub) (new GoogleSearchService_Impl().getGoogleSearchPort());

• 実装依存のオブジェクトからスタブを生成
する。
• 実装依存のオブジェクトは、wscompileに
よって生成されたもの。

Static Stub 2/4
Set a endpoint address
• サービスのアドレスを設定する。
stub._setProperty
(javax.xml.rpc.Stub.ENDPOINT_ADDRESS_PROPERTY,
quot;http://api.google.com/search/beta2quot;);

• アドレスはURLをStringで指定する。
– http://api.google.com/search/beta2

Static Stub 3/4
Cast stub to the service
endpoint interface
• サービスエンドポイントインターフェースに
型変換する。
GoogleSearchPort google = (GoogleSearchPort)stub;

• これで該当のメソッドを呼び出す事が可能。

Static Stub 4/4
Coding a Client
• クライアントコードの一部
Stub stub =
(Stub) (new GoogleSearchService_Impl().getGoogleSearchPort());

endpointAddress = quot;http://api.google.com/search/beta2quot;;
stub._setProperty
(javax.xml.rpc.Stub.ENDPOINT_ADDRESS_PROPERTY,
endpointAddress);

GoogleSearchPort google = (GoogleSearchPort)stub;

// Call doSpellingSuggestion of Google Web Services
String result
= google.doSpellingSuggestion(googleLicenseKey, phrase );
System.out.println( quot;==> Candidate : quot; + result );

quot; I wrote it myself. quot;

Merovingian

quot; Have fun. quot;

Persephone

もういちどやってみましょう。

Reloaded

quot; Almost no one comes down here.
Unless, of course, there’s a
problem.
That’s new it is with people.
Nobody cares how it works as
long as it works. quot;

Councillor Hamann

tcpmon
• SOAPで通信していることを視認する。
• tcpmon モニタでやり取りを診る。
set CLASSPATH=%AXIS_HOME%¥lib¥axis.jar
java org.apache.axis.utils.tcpmon

• Apache AXIS に付属。
• 多少難在り。

SOAP Request
<env:Envelope
xmlns:env=http://schemas.xmlsoap.org/soap/envelope/
xmlns:xsd=http://www.w3.org/2001/XMLSchema
xmlns:xsi=quot;http://www.w3.org/2001/XMLSchema-instancequot;
xmlns:enc=http://schemas.xmlsoap.org/soap/encoding/
xmlns:ns0=quot;urn:GoogleSearchquot;
env:encodingStyle
=quot;http://schemas.xmlsoap.org/soap/encoding/quot;>
<env:Body>
<ns0:doSpellingSuggestion>
<key xsi:type=quot;xsd:stringquot;>XXXXX</key>
<phrase xsi:type=quot;xsd:stringquot;>britnay spars</phrase>
</ns0:doSpellingSuggestion>
</env:Body>
</env:Envelope>

SOAP Response

<SOAP-ENV:Envelope
xmlns:SOAP-ENV=http://schemas.xmlsoap.org/soap/envelope/
xmlns:xsi=http://www.w3.org/1999/XMLSchema-instance
xmlns:xsd=quot;http://www.w3.org/1999/XMLSchemaquot;>
<SOAP-ENV:Body>
<ns1:doSpellingSuggestionResponse
xmlns:ns1=quot;urn:GoogleSearch“
SOAP-ENV:encodingStyle
=quot;http://schemas.xmlsoap.org/soap/encoding/quot;>
<return xsi:type=quot;xsd:stringquot;>britney spears</return>
</ns1:doSpellingSuggestionResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

quot; Do you proceed? quot;

Agent (not Smith)

クライアントの種類について

Call Model of Web Services
Client with JAX-RPC

JAX-RPC Client Types
• Static Stub
– 実行前にスタブを用意しておく。
• Dynamic Proxy
– 実行前にインターフェースだけが必要。
– 実行時にプロキシクラスを作成する。
• Dynamic Invocation Interface (DII)
– 直接ランタイムにアクセスする。
– 複雑なコーディング。

其の弐
Coding a Dynamic Proxy
Client

Dynamic Proxy 1/2
Creates a Service object
• Proxy オブジェクトを生成する。
Service googleService =
serviceFactory.createService(googleWsdlUrl,
new QName(nameSpaceUri, serviceName));

• WSDLアドレスはURLをStringで指定する。
– http://api.google.com/GoogleSearch.wsdl
• サービス名、名前空間はWSDLの記載を
Stringで指定する。

Dynamic Proxy 2/2
Creates a proxy with a
service endpoint interface
• インターフェースオブジェクトを生成する。
GoogleSearchPort googleProxy = (GoogleSearchPort)
googleService.getPort(new QName(nameSpaceUri, portName),
GoogleSearchPort.class);

• getPort メソッドで呼び出す。
• エンドポイントインターフェースは
wscompile などで事前に用意が必要。

其の参
Coding a DII Client

DII 1/6
Creates a Service object
• Serviceオブジェクトを生成する。
Service service =
factory.createService(new QName(qnameService));

• サービス名はWSDLでの service name
を Stringで指定する。

DII 2/6
Creates a Call object
• Call オブジェクトを生成する。
String qnamePort = quot;GoogleSearchPortquot;;

QName port = new QName(qnamePort);
Call call = service.createCall(port);

• ポート名はWSDLでの port name を
Stringで指定する。

DII 3/6
Set a endpoint address
• サービスエンドポイントアドレスを設定する。
call.setTargetEndpointAddress(quot;http://api.google.com/search/beta2quot;);

• アドレスはURLをStringで指定する。
– http://api.google.com/search/beta2

DII 4/6
Set a properties
• プロパティを設定する。

call.setProperty(Call.SOAPACTION_USE_PROPERTY,
new Boolean(true));
call.setProperty(Call.SOAPACTION_URI_PROPERTY, quot;quot;);
call.setProperty(ENCODING_STYLE_PROPERTY,
quot;http://schemas.xmlsoap.org/soap/encoding/quot;);

• 詳細は、SOAP及びWSDLを参照の事。

DII 5/6
Specify parameter

• 返り値や引数の型や呼び出すメソッドを指
定する。
QName QNAME_TYPE_STRING =
new QName(NS_XSD, quot;stringquot;);
call.setReturnType(QNAME_TYPE_STRING);
call.setOperationName(
new QName(BODY_NAMESPACE_VALUE, quot;doSpellingSuggestionquot;));
call.addParameter(quot;String_1quot;, QNAME_TYPE_STRING,
ParameterMode.IN);
call.addParameter(quot;String_2quot;, QNAME_TYPE_STRING,
ParameterMode.IN);

DII 6/6
Invoke a remote method
• メソッドを呼び出す。
String googleLicenseKey = “XXXXXXXXXXXXXXquot;;
String phrase = quot;britnay sparsquot;;
String[] params = { googleLicenseKey, phrase };
String result = (String)call.invoke(params);

• ここではStringの配列で引数を渡す。
• ここでの返り値はString。

quot; There is a difference
between knowing the road
and following it. quot;

Morpheus

Round up
• WebServices は、RPCとも云える
• RPCは、Stub/Skeletonという仕組み
• JAX-RPCは、SOAPとWSDL
• WSDLは、インターフェース
• WSDLは、一番だいじ。
• WSDLからStubができる
• JAX-RPCでクライアントをつくる

Just after this

• サーバーであるサービスをつくる
• 相互運用性について考える
• WSDLを詳しくみる
• SOAPの構造、特徴を調べる
• そして、UDDI？
• BPELとは？

quot; But I can only show you
the door, you have to walk
through it. quot;

Morpheus

Bibliography
• XMLとJavaによるWebアプリケーション開
発第2版
– 丸山宏ほか
– ISBN：4-89471-662-3
• Java Webサービス
– David A.Chappell, Tyler Jewell (著), テ
クノロジックアート (著), 長瀬嘉秀 (翻訳)
– ISBN4-87311-101-3

Philosophy
• EXISTENTIAL PHENOMENOLOGY
AND THE BRAVE NEW WORLD OF
THE MATRIX
– HUBERT DREYFUS & STEPHEN
DREYFUS
– http://whatisthematrix.warnerbros.com/

• PHILOSOPHY AND THE MATRIX
– http://whatisthematrix.warnerbros.com/rl_cm
p/phi.html

Resources
• Java Technology and Web Services
– http://java.sun.com/webservices/

• Java API for XML-Based RPC (JAX-
RPC) Downloads & Specifications
– http://java.sun.com/xml/downloads/jaxrpc.ht
ml

Resources
• Google Web APIs (beta)
– http://www.google.co.jp/apis/index.html

• Apache AXIS
– http://ws.apache.org/axis/index.html

Resources
• Web Services Description
Language (WSDL) 1.1
– http://www.w3.org/TR/wsdl

• Simple Object Access Protocol
(SOAP) 1.1
– http://www.w3.org/TR/soap/

quot; You knew what that mean?
It’s Latin.
Means, ‘Know thyself’. quot;

The Oracle

Revisited

Recommended

Recommended

More Related Content

What's hot

What's hot (17)

Viewers also liked

Viewers also liked (9)

Similar to Revisited

Similar to Revisited (20)

More from Shunsaku Kudo

More from Shunsaku Kudo (6)

Recently uploaded

Recently uploaded (20)

Revisited