BridgeIOCI

Author: 秋山朋之 

last update - 2004.06.04　Version: 0.03b

• HORB用の拡張プロトコル・ドライバです。プロトコル名は、bridgeio です。
• 一番やさしく、ＪａｖａとＣ＃/ＶＢ.Net/Managed C++の間の橋渡しを実現します。
• クライアントが.Netで、サーバがＪａｖａといった組み合わせを簡単に実現出来ます。勿論、その逆の組み合わせや、クライアントとサーバ共に.Netという組み合わせも可能です。
• 使い勝手はＨＯＲＢ従来の手順から全く替わりません。従来の開発手順を継承し’再利用’しているので、学習コストは、他のどのメカニズムと比べても最小です。特にアジャイルな開発ミッションを持つ開発チームが導入すれば効果が顕著です。
• .Netの複数言語基盤のメリットを継承して十分に活用出来ます。
  • Proxyを使う.NetクライアントはJ#以外のC#/VBといった他言語で実装可能
  • ServerのinterfaceをJavaで宣言すれば、その実装はJ#以外のC#/VBといった他言語で実装可能
  • （上記の事から）既存のC/C++で書かれたコード資産をManaged C++でビルド出来ればそればもう、HORBを介してJavaとつながる分散オブジェクトとして再利用可能です。

• 以下の仮想マシン間で通信をする為のプロトコルドライバです。
  • Sun Microsystems - JavaVM
  • Microsoft - Common Language Runtime (以降CLR)
• JDK/J2SEに予め用意されたオブジェクトの転送時のバージョン不一致の例外に対処します。
  • サンプル：examples/bridgeIOCIやexamples/exceptionを参考にして下さい。
• 本ドライバはBasicIOCIとSerializingIOCIを使い分けます.
  1. 転送するオブジェクトの_Proxyが見つかればBasicIOCIのメソッドを使います。
     • 先ず、同一パッケージ内の_Proxyを検索します。
     • 次に、horbx.bridgeパッケージを先頭に加えたパッケージ名の_Proxyを検索します。
  2. 見つからない場合はSerializingIOCI.のメソッドを使います。
• CLR用のHORBはMicorsoft J#でHorb2.0を、本パッケージと一緒にFullBuildしてください。
• HORB2.0/HORB2.1b1に対応（最新のHORB2.1b2はJ2SE1.3とJSSEでのBuildを前提にしているので、J#でBuild不可）

[download 2003.08.15 630kb]

BridgeIOCIの互換性を確認するサンプルです。

• BridgeIOCIを効率良く確認出来ます。
• JavaVM向けと、CLR向けの二種類があります。
• JavaVM向けのTestSuiteはJUnitの利用を前提にしています。
  • JUnit3.8.1 http://www.junit.org/
• CLR向けのTestSuiteはNUnitの利用を前提にしています。
  • NUnit2.0 http://nunit.org/
• TestSuiteを実行する場合、examples.ServerInfo.javaからhost名とプロトコルの指定を変更できます。

Horbに付属するexampleをできる限り忠実に移行しました。

TestSuite用HORBServerの起動方法

Java版 horb -v -conf HorbTestSuite.conf -type bridgeio

CLR版　TestBridgeIOCIServer  -v -conf HorbTestSuite.conf -type bridgeio

1. BridgeIOCIの機能を検証するサンプルです。
   • 先ず問題の認識として、Microsoft J#はJDK1.1.4 相当のクラスライブラリまでのサポートである点があげられます。
   • CLRが、J2SE等の異なるバージョンのJavaVMで、オブジェクト転送する場合と、オブジェクト転送される場合に問題が起きます。
   • BridgeIOCI は、この問題に対処する為以下のケースを想定してテストケースを追加しました。
     • サンプル：examples/bridgeIOCI
       • java.util.Vector/java.util..Hashtableクラスの転送
       • 基底クラスがjava.util.Vector/java.util..Hashtableクラスの転送
     • サンプル：examples/exception
       • 例外の転送 examples.exception.MyException

    

2. CLRのミックスランゲージの検証
   • examples.interfaceCallに準拠して実現しています。
   • Javaによるサーバのインターフェース宣言と、VB/C#のクライアント/サーバの実装のサンプルです。
   • C#版 /HorbOpen/BridgeIOCI/clrsrc/TestSuiteInterfaceCallCS
   • VB版 /HorbOpen/BridgeIOCI/clrsrc/TestSuiteInterfaceCallVB

1. J#をインストールします。

2. J2SEとAntをインストールします。

3. NAntをインストールします。但し、<vjc>/<vbc>/<csc>-実行タスクの為にコンフィグレーション・ファイルと、インストールした開発環境のバージョンを合せる必要があります。"NAnt.exe.config"で適切なバージョンを指定してください。

4. HORBを展開します。本例では、c:\を指定し、c:\horb2.1に展開されたとします。

5. 本パッケージを展開し、\\HorbOpen\BridgeIOCI以下のフォルダとファイルをc:\horb2.1へ全て上書きします。

6. フォルダをc:\horb2.1に移動しＡｎｔを実行する。  ant -buildfile buildAnt.xml

   • propertyを必要に応じ変更して下さい。'horb.install.path','horb.version'をあわせてHORBを展開したPATHになる様に変更してください。　

7. Ｎａｎｔを実行する。                                     nant -buildfile:buildNAnt.xml

   • propertyを必要に応じ変更して下さい。HORBを展開したPATHと共に、NUnitやvjslib.dllの指定も確認してください。　

8. Jarファイルは、c:\horb2.1\libに出来ます。

9. DLL/EXEは、c:\horb2.1\clr\binに出来ます。

1. ドキュメントの充実
2. The Mono runtime での動作確認　> Mono
3. VisualStudio.NetでGnu ClasspathのFullBuild。（その場合、技術的にはBridgeIOCIは不要かも。）

有志の貢献も募集します。HorbOpenへぜひメールを送ってください。

• 本リリースのBridgeioドライバは、以下のテストケースで問題が残っている。
  • CLR<->JavaVM :examples.equals.ClientTest#test01
    • Client/Serverがどちらに限らずServer側で例外発生)：原因調査中 
    • horb.orb.HORBException: null object at horb.orb.HORBServer.globalEquals(Object obj1, Object obj2) in C:\dev\HorbOpen\BridgeIOCI\TestSuite\CLR\HorbCore\horb\orb\HORBServer.java:line 791