Info*Engine ベースの Web サービスの作成

Web サービスが Info*Engine リリース 7.0 で最初にサポートされるようになって以来、Info*Engine ベースの Web サービスを作成する方法は変わっていません。JAX-WS ベースの Web サービスについては、1 つ変更点があり、アタッチメントの付いた SOAP がサポートされるようになりました。詳細については、SOAP アタッチメントの使用を参照してください。

Info*Engine ベースの Web サービスを作成するだけではなく、Java ベースの Web サービスを作成することもできます。セクションセキュリティ要件についての「トラストストアとキーストア」で説明されている <Windchill>/prog_examples/jws にあるリリース済みの例がそれを示しています。

Info*Engine ベースの Web サービスは一連の Info*Engine タスクで構成され、それぞれのタスクはタイプ識別子に関連付けられている Web サービスのメソッドを表します。Web サービスの場合、タイプ識別子は、単に一連の Info*Engine タスクを論理的にグループ化して Web サービスを形成する方法として使用され、静的なメソッドのみを公開する Java クラスに類似するものと考えることができます (Info*Engine タスクであるそれぞれのメソッドは対応する Web サービス操作をサポート)。

実行時、Info*Engine は、タイプ識別子と対応する Info*Engine タスクが LDAP で Info*Engine のコンフィギュレーションに登録されていることを必要とします。これを手動で行うことはできますが、プロセスが使用されることがあり、エラーが発生しやすいため、Info*Engine は、Web サービスの基盤である Info*Engine タスクをパッケージ化してインストールする Apache Ant ツーリングとともにリリースされています。これらのユーティリティは、Apache Ant フレームワークと統合されています。

このセクションでは、以下の手順を使用して簡単な Info*Engine タスクベースの Web サービスおよびクライアントを作成する方法について説明します。

1. Web サービスのタスクとクライアントのソースを格納するためのプロジェクトを作成します (これは単純なディレクトリ構造です)。

3. JAX-WS Web サービスのセキュリティを確保し、それを展開します。これを行うには、Info*Engine タスクと対応するサーブレットを展開します。

• セクションセキュリティ要件についての「トラストストアとキーストア」で説明されている Apache Ant スクリプトをすでに実行している。

• このコマンドの例は、Unix 環境であることを前提としています。Windows 環境である場合は、オペレーティングシステム固有のコマンドを、使用している環境に適合するように変更する必要があります (たとえば、パスで / ではなく \ を使用するなど)。

Web サービスのフレームワークとともに、Web サービスとクライアントの新規作成を簡素化するツールがリリースされています。

このサービスは、説明に使用することのみを目的としており、Info*Engine を使用して一般的に作成されるものとは異なります。

<Windchill>/bin/adminTools/WebServices/new-project.xml Apache Ant ビルドスクリプトを使用してプロジェクトを作成します。このスクリプトは、クライアントプロジェクト、サービスプロジェクト、またはその両方を作成するために使用できます。

% cd <Windchill>
% mkdir prog_examples/jws/MyProject
% ant -Dproject.dir=<Windchill>/prog_examples/jws/MyProject -Dservlet.name=MathService
-Dsecurity.policy=userNameAuthSymmetricKeys -Dservice.type.id=org.myorg.MathService
-Dmain.class=org.myorg.MathClient
-f bin/adminTools/WebServices/new-project.xml create

project.dir プロパティは絶対パスです。これにより、プロジェクトが適切なロケーションに作成されます。new-project.xml ビルドスクリプトによってサポートされている入力オプションを確認するには、引数を使用せずにそれを実行します。例:

ant -f bin/adminTools/WebServices/new-project.xml

Info*Engine タスクを作成できるサブディレクトリ。必要に応じて、ユーザーの要件に適合する別のディレクトリ階層を作成することもできます。これらのツールは、プロジェクトの作成時にユーザーが service.type.id プロパティで指定したタイプ識別子を使用してサービスをパッケージ化します。

% ant -p
% ant usage

最初のコマンドは、関連付けられているビルドスクリプトのパブリックターゲットとその説明を表示します。2 番目のコマンドは、ビルドスクリプトをカスタマイズする必要がある場合にそれを行う方法の詳細な説明を表示します。ほとんどの基本的なプロジェクトにおいて、これは必要ではありません。

この手順では、4 つの簡単なタスク (Add.xml、Divide.xml、Multiply.xml、Subtract.xml) が、以下のソースが指定されているロケーションに作成されます。これらのタスクは非常に単純であり、主にドキュメンテーションを含んでいることに注意してください。

<%@page language="java"%>
<%@ taglib uri="http://www.ptc.com/infoengine/taglib/core" prefix="ie"%>
<%@taglib uri="/com/infoengine/tlds/iejstl.tld" prefix="c"%>

<ie:webject name="Create-Group" type="GRP">
<ie:param name="GROUP_OUT" data="output"/>
</ie:webject>

<c:set var="A" value="${0+@FORM[0]a[0]}" />
<c:set var="${output[0]result}" value="${A+@FORM[0]b[0]}" />

<%@page language="java"%>
<%@ taglib uri="http://www.ptc.com/infoengine/taglib/core" prefix="ie"%>
<%@taglib uri="/com/infoengine/tlds/iejstl.tld" prefix="c"%>

<ie:webject name="Create-Group" type="GRP">
<ie:param name="GROUP_OUT" data="output"/>
</ie:webject>

<c:set var="A" value="${0.0+@FORM[0]a[0]}" />
<c:set var="${output[0]result}" value="${A/@FORM[0]b[0]}" />

<%@page language="java"%>
<%@ taglib uri="http://www.ptc.com/infoengine/taglib/core" prefix="ie"%>
<%@taglib uri="/com/infoengine/tlds/iejstl.tld" prefix="c"%>

<ie:webject name="Create-Group" type="GRP">
<ie:param name="GROUP_OUT" data="output"/>
</ie:webject>

<c:set var="A" value="${0+@FORM[0]a[0]}" />
<c:set var="${output[0]result}" value="${A*@FORM[0]b[0]}" />

<%@page language="java"%>
<%@ taglib uri="http://www.ptc.com/infoengine/taglib/core" prefix="ie"%>
<%@taglib uri="/com/infoengine/tlds/iejstl.tld" prefix="c"%>

<ie:webject name="Create-Group" type="GRP">
<ie:param name="GROUP_OUT" data="output"/>
</ie:webject>

<c:set var="A" value="${0+@FORM[0]a[0]}" />
<c:set var="${output[0]result}" value="${A-@FORM[0]b[0]}" />

このプロジェクトが作成されたときに、userNameAuthSymmetricKeys の値が明示的に渡される security.policy というパラメータが指定されています。したがって、この例では、ユーザー名とパスワードの両方を Web サービスクライアントに指定する必要があります。

% cd <Windchill>/prog_examples/MyProject/src
% ant

• サービスが Windchill でパッケージ化され、コンパイルされてインストールされます。Info*Engine タスクベースのサービスの場合、タスクは PTCTAR ファイルにパッケージ化されてインストールされます。この例では、結果の PTCTAR ファイルは以下のようになります。

Web サービスが Java オブジェクトを必要とする場合は、src ディレクトリ内にこれらのオブジェクトのパッケージ階層とソースを作成します。スクリプトが自動的にこれらのクラスをコンパイルしてパッケージ化します。Web サービスに関連付けられているクラスは、サービスのサーブレット名を反映する JAR ファイル内の <Windchill>/codebase/WEB-INF/lib でパッケージ化されます。

• 次に、<Windchill>/bin/adminTools/WebServices/build.xml スクリプトが実行されて、サーバー側のコンポーネントが生成され、コンパイルされると同時に、セキュリティが確保された Web サービスが展開されます。このビルドスクリプトは、必要に応じて、自動で実行することもできます。詳細については、Web サービス展開用ビルドスクリプトの使用を参照してください。

Apache Ant フレームワークを使用する場合、このビルドスクリプトを手動で実行する必要はありません。Apache Ant フレームワークは、すでにシステムにインストールされている既存のレガシー Web サービスを展開するために使用することもできます。この場合、src ディレクトリには build.xml スクリプトのみが含まれ、タスクソースは含まれません。

これでサービスが展開され、Windchill が実行されるようになったため、以下のような URL を閲覧することで、Web サービスの WSDL を確認できます。

Java ベースの Web サービスクライアントの作成で説明されているように、Java クライアントを作成する場合、WSDL にアクセスする方法を知っておく必要はありません。ただし、サービスを別の Web サービスクライアントと統合する場合は、WSDL にアクセスする必要があります。

Web サービスの展開をインストールから解除する場合は、プロジェクトの src/build.xml スクリプトの undeploy ターゲットを実行します例:

% cd <Windchill>/prog_examples/MyProject/src
% ant undeploy

Info*Engine タスクを適切に文書化するプロセスについて理解しておく必要があります。オンラインで次の URL にアクセスして、新規 Web サービスに関するドキュメントを参照してください。

このユーティリティは、タイプ識別子の下で登録されているいくつかのインストール済みのタスクに関するドキュメンテーションを提供します。これらのタスクのほとんどは、Web サービスとしてアクセスされるために作成されていないため、そのような目的では使用しないでください。

Web ブラウザのリポジトリタイプの表示枠から com.ptc.windchill を選択します。クラスの表示枠から org.myorg.MathService サービスのタイプ識別子を選択します。表示されるドキュメンテーションは、展開したタスクのコンテンツに基づいて決定されます。タスクのドキュメンテーションの作成の詳細については、以下を参照してください。