| Oracle® Fusion Middleware Oracle WebLogic Server RMIアプリケーションの開発 12c (12.1.2) E48079-02 |
|
 前 |
 次 |
| Oracle® Fusion Middleware Oracle WebLogic Server RMIアプリケーションの開発 12c (12.1.2) E48079-02 |
|
前 |
次 |
この章では、すべてのリモート・オブジェクトの基本的な構成要素であるjava.rmi.Remoteインタフェースについて説明します(ただし、このインタフェースにはメソッドは含まれません)。この「タグ付け」インタフェースを拡張し(リモート・クラスを識別するタグとして機能するように)、リモート・オブジェクトの構造を作成するメソッド・スタブを使って、使用するリモート・インタフェースを作成します。次に、リモート・クラスを使ってリモート・インタフェースを実装します。この実装はレジストリ内の名前にバインドされ、クライアントやサーバーはそこからオブジェクトをルックアップしてリモートで使用できます。
すでにRMIクラスを記述している場合は、リモート・インタフェースとそれを拡張するクラスでimport文を変えるだけでWebLogic RMIをインストールできます。クライアント・アプリケーションにリモート呼出しを追加するには、レジストリ内でオブジェクトを名前でルックアップします。Weblogic RMI例外はjava.rmi例外と同じ機能を備えているので、既存のインタフェースと実装で例外の処理方法を変える必要がありません。
以下の節ではWebLogic Server RMIの実装方法について説明します。
独自のWebLogic RMIクラスを簡単な手順で記述できます。
リモートで呼び出せるすべてのクラスは、リモート・インタフェースを実装します。次のガイドラインに従って、リモート・インタフェースを作成します。
リモート・インタフェースは、java.rmi.Remoteインタフェースを拡張する必要がありますが、これにはメソッド・シグネチャは含まれません。インタフェースを実装する各リモート・クラスで実装されるメソッド・シグネチャを含めます。
リモート・インタフェースはパブリックでなければなりません。パブリックでない場合、クライアントはリモート・インタフェースを実装するリモート・オブジェクトをロードしようとするとエラーを受け取ります。
インタフェース内の各メソッドがそのthrowsブロックでjava.rmi.RemoteExceptionを宣言する必要はありません。アプリケーションがスローする例外は、アプリケーション固有である可能性があり、次を拡張する場合があります: RuntimeException.WebLogic RMI subclasses java.rmi.RemoteException。したがって、すでにRMIクラスがある場合、例外処理を変更する必要はありません。
リモート・インタフェースにはコードがあまり記述されていない場合もあります。必要なのは、リモート・クラスで実装するメソッドのメソッド・シグネチャだけです。
以下の例に、メソッド・シグネチャsayHello()を持つリモート・インタフェースを示します。
例7-1 Hello.javaリモート・インタフェース
package examples.rmi.hello;
import java.rmi.RemoteException;
/**
* This interface is the remote interface.
*
* Copyright (c) 1999,2012, Oracle and/or its affiliates. All Rights Reserved.
*/
public interface Hello extends java.rmi.Remote {
String sayHello() throws RemoteException;
}
WebLogic RMIは、柔軟性の高い実行時のコード生成をサポートします。つまり、WebLogic RMIは、型さえ正しければ、そのほかはインタフェースを実装するクラスに依存しない動的プロキシと動的に生成されるバイトコードもサポートします。クラスが単一のリモート・インタフェースを実装する場合、コンパイラが生成したプロキシとバイトコードは、リモート・インタフェースと同じ名前になります。クラスが複数のリモート・インタフェースを実装する場合、コンパイルから生じたプロキシとバイトコードの名前は、コンパイラが使用する名前マングリングによって決まります。
リモートで呼び出すクラスを作成します。このクラスは、ステップ1で記述したリモート・インタフェースを実装する必要があります。これは、インタフェースに含まれるメソッド・シグネチャを実装することを意味します。WebLogic RMIで行われるコード生成はすべて、このクラス・ファイルに依存します。
クラスは、複数のリモート・インタフェースを実装できます。また、クラスにはリモート・インタフェースにないメソッドも定義できますが、このようなメソッドはリモートで呼び出せません。
例7-2では、HelloImplを作成するクラスを実装し、それをレジストリ内の一意の名前HelloServerにバインドします。メソッドsayHello()により、挨拶が表示されます。
main()メソッドは、リモート・オブジェクトのインスタンスを作成し、それを名前(オブジェクトの実装を指し示すURL)にバインドすることによってWebLogic JNDIツリーに登録します。リモートでオブジェクトを使用するためにプロキシを取得しようとするクライアントは、オブジェクトを名前でルックアップできます。
例7-2 HelloImpl.javaリモート・インタフェースの実装
package examples.rmi.hello;
import javax.naming.*;
import java.rmi.RemoteException;
/**
* Copyright (c) 1999,2012, Oracle and/or its affiliates. All Rights Reserved.
*/
public class HelloImpl implements Hello{
private String name;
/**
* Constructs a HelloImpl with the specified string.
*
* @param s String message
*/
public HelloImpl(String s) throws RemoteException {
super();
name = s;
}
/**
* Returns a string.
*
* @return String message
* @exception java.rmi.RemoteException
*/
public String sayHello() throws java.rmi.RemoteException {
return "Hello World!";
}
/**
* Allows the WebLogic Server to instantiate this implementation
* and bind it in the registry.
*/
public static void main(String args[]) throws Exception {
try {
HelloImpl obj = new HelloImpl("HelloServer");
Context ctx = new InitialContext();
ctx.bind("HelloServer", obj);
System.out.println("HelloImpl created and bound in the registry " +
"to the name HelloServer");
}
catch (Exception e) {
System.err.println("HelloImpl.main: an exception occurred:");
System.err.println(e.getMessage());
throw e;
}
}
}
WebLogic RMIでは、アプリケーションにセキュリティを統合するためにセキュリティ・マネージャを設定する必要はありません。セキュリティは、WebLogicのSSLとACLのサポートによって処理されます。
一般に、初期コンテキストを作成すると、リモート・オブジェクトの参照を取得する単一行のコードのみが取得されます。これは、Naming.lookup()メソッドで行います。次の項では、クライアント作成に関するその他の情報について説明します。
初期コンテキストを構成しながら、クライアント側のタイムアウトを設定できます。
リクエストが接続レスポンスを待機する時間を設定するには、weblogic.jndi.connectTimeoutを使用します。
接続の確立後に、リモート・サーバーからのレスポンスをリクエストが待機する時間を設定するには、weblogic.jndi.responseReadTimeoutを使用します。
「リクエスト・タイムアウト」を参照してください。
例:
. . . // Get an InitialContext Hashtable env = new Hashtable(); env.put(Context.INITIAL_CONTEXT_FACTORY,"weblogic.jndi.WLInitialContextFactory"); env.put(Context.PROVIDER_URL, url); env.put("weblogic.jndi.connectTimeout", new Long(15000)); env.put("weblogic.jndi.responseReadTimeout", new Long(15000)); return new InitialContext(env); . . .
次に、例7-2で作成したオブジェクトを使用する短いWebLogicクライアント・アプリケーションを示します。
例7-3 HelloClient.javaクライアントの例
package examples.rmi.hello;
import java.util.Hashtable;
import javax.naming.Context;
import javax.naming.InitialContext;
import javax.naming.NamingException;
/**
* This client uses the remote HelloServer methods.
*
* @author Copyright (c) 1999,2012, Oracle and/or its affiliates. All Rights Reserved.
*/
public class HelloClient
{
// Defines the JNDI context factory.
public final static String JNDI_FACTORY="weblogic.jndi.WLInitialContextFactory";
int port;
String host;
private static void usage() {
System.err.println("Usage: java examples.rmi.hello.HelloClient " +
"<hostname> <port number>");
}
public HelloClient() {}
public static void main(String[] argv) throws Exception {
if (argv.length < 2) {
usage();
return;
}
String host = argv[0];
int port = 0;
try {
port = Integer.parseInt(argv[1]);
}
catch (NumberFormatException nfe) {
usage();
throw nfe;
}
try {
InitialContext ic = getInitialContext("t3://" + host + ":" + port);
Hello obj = (Hello) ic.lookup("HelloServer");
System.out.println("Successfully connected to HelloServer on " +
host + " at port " +
port + ": " + obj.sayHello() );
}
catch (Exception ex) {
System.err.println("An exception occurred: "+ex.getMessage());
throw ex;
}
}
private static InitialContext getInitialContext(String url)
throws NamingException
{
Hashtable<String,String> env = new Hashtable<String,String>();
env.put(Context.INITIAL_CONTEXT_FACTORY, JNDI_FACTORY);
env.put(Context.PROVIDER_URL, url);
return new InitialContext(env);
}
}
javacまたは他のJavaコンパイラを使用して.javaファイルをコンパイルし、リモート・インタフェースとそれを実装するクラス用の.classファイルを作成します。
例7-4に、WebLogic Server examplesServerに構成されるserverclassesディレクトリとclientclassesディレクトリに対して、.javaファイルをコンパイルしたり.classファイルをインストールする場合にWebLogic Serverのサンプル環境で使用できるAntスクリプトを示します。
例7-4 Javaクラスをコンパイルするbuild.xmlファイルの例
<?xml version="1.0" encoding="ISO-8859-1"?>
<project name="rmi.hello" default="all" basedir=".">
<property environment="env"/>
<property file="../../../examples.properties"/>
<property name="build.compiler" value="${compiler}"/>
<!-- set global properties for this build -->
<property name="source" value="${basedir}"/>
<target name="all" depends="build"/>
<target name="build" depends="compile.server, compile.client"/>
<!-- Compile server classes into the serverclasses directory -->
<target name="compile.server">
<javac srcdir="${source}"
destdir="${server.classes.dir}"
includes="Hello.java, HelloImpl.java"
classpath="${ex.classpath};${server.classes.dir}"
deprecation="${deprecation}" debug="${debug}" debugLevel="${debugLevel}"
/>
</target>
<!-- Compile client classes into the clientclasses directory -->
<target name="compile.client">
<javac srcdir="${source}"
destdir="${client.classes.dir}"
includes="HelloClient.java"
classpath="${ex.classpath};${server.classes.dir}"
deprecation="${deprecation}" debug="${debug}" debugLevel="${debugLevel}"
/>
</target>
</project>
次の手順を使用して、WebLogic RMI Helloサンプルを実行します。
サンプルを含むWebLogicサーバーをインストールします。examplesServerの起動方法と、シェルに環境を設定してサンプルを実行する方法を把握していることが前提になります。
次の手順を使用して、Helloサンプルを設定します。
シェルを開き、サンプル環境を設定します。
EXAMPLES_HOME\wl_server\examples\src\examplesディレクトリに変更します。EXAMPLES_HOMEは、WebLogic Serverのサンプル・コードが構成されるディレクトリを示します。WebLogic Serverのサンプル・コードの詳細は、『Oracle WebLogic Serverの理解』のサンプル・アプリケーションおよびサンプル・コードに関する項を参照してください。
helloというサブディレクトリを含むrmiディレクトリを作成します。
例7-1のコンテンツをコピーして、Hello.javaという名前のファイルでhelloディレクトリに保存します。
例7-2のコンテンツをコピーして、HelloImpl.javaという名前のファイルでhelloディレクトリに保存します。
例7-3のコンテンツをコピーして、HelloClient.javaという名前のファイルでhelloディレクトリに保存します。
例7-4のコンテンツをコピーして、build.xmlという名前のファイルでhelloディレクトリに保存します。
サンプル・ファイルをコピーしたシェルから次のコマンドを実行します。
ant build
exampleServerのインスタンスを起動します。起動クラスを次の情報で作成します。
名前: MyHello
クラス名: examples.rmi.hello.HelloImpl
ターゲット: examplesServer
Oracle WebLogic Server管理コンソール・オンライン・ヘルプの起動クラスの構成に関する項を参照してください。
|
注意: このサンプルでは、ビルド・スクリプトは、起動クラスがサーバーのクラスパスの場所にあるかどうかを確認します。 |
examplesServerを再起動します。サーバーが起動したら、サーバー・ログで次の内容を確認する必要があります。
HelloImpl created and bound in the registry to the name HelloServer
サーバーが実行すると、JNDIを表示してHelloServerが登録されていることを確認できます。Oracle WebLogic Server管理コンソール・オンライン・ヘルプのJNDIツリーでのオブジェクトの表示に関する項を参照してください。
サンプル・ファイルをコピーしたシェルから次のコマンドを実行します。
java examples.rmi.hello.HelloClient localhost 7001
結果は次のようになります。
Successfully connected to HelloServer on localhost at port 7001: Hello World!
