外部言語の操作

Java、.NET、および Python 外部サーバそれぞれに、getJavaGateway()、getDotNetGateway()、getPythonGateway() の固有のゲートウェイ作成メソッドがあります。これらの各メソッドは既定の構成で外部サーバを開始し、Gateway オブジェクトを返して接続を管理します。

  set javaGate = $system.external.getJavaGateway()
  set netGate = $system.external.getDotNetGateway()
  set pyGate = $system.external.getPythonGateway()

また、カスタマイズされた外部サーバ構成で使用するための汎用の getGateway() メソッドもありますが (詳細は “外部サーバの定義のカスタマイズ” を参照)、ほとんどの目的には既定のメソッドで十分なはずです。

各ゲートウェイ・オブジェクトには、ターゲット・オブジェクトとプロキシ・オブジェクトを作成するための new() メソッドがあります。new() メソッドへの各呼び出しでは、クラス名と必要なすべての引数を指定します。呼び出しを実行すると、外部サーバはクラスのターゲット・インスタンスを作成し、ゲートウェイはターゲットと同じメソッドとプロパティのセットを持つ対応するプロキシ・オブジェクトを作成します。プロキシへの各呼び出しはターゲットによってエコーされ、結果がプロキシに返されます。

この例では、3 つの異なる外部サーバ (各言語に独自のサーバが必要であるため) を介して接続される 3 つのプロキシ・オブジェクトを作成します。

  set javaProxy = javaGate.new("java.util.Date")
  set netProxy = netGate.new("System.DateTime",0)
  set pyProxy = pyGate.new("datetime.datetime",1,1,1).now()

各プロキシは、その他の ObjectScript オブジェクトと同様に扱うことができます。3 つすべてを、同じ ObjectScript アプリケーションで使用できます。

同じ文で、3 つすべてのプロキシ・オブジェクトからのメソッド呼び出しとプロパティ呼び出しを使用できます。

  write !,"  Java: "_javaProxy.toString(),!,"  .NET: "_netProxy.Now,!, "Python: "_pyProxy.strftime("%c")

      Java: Wed Jun 12 18:55:34 EDT 2024
      .NET: 2024-06-12 18:56:25.7779755
    Python: Wed Jun 12 18:55:37 2024

Java および Python の例はメソッドの呼び出しで、.NET の例ではプロパティを使用しています。

  do javaGate.addToPath("/home/myhome/someclasses.jar")
  do netGate.addToPath("C:\Dev\myApp\somedll.dll")
  do pyGate.addToPath("/rootpath/person.py")

Java ゲートウェイと .NET ゲートウェイは、1 つ以上の共有ライブラリを含むフォルダへのパスも受け入れます。高度な Python オプションの詳細は、“Python パッケージとクラス・パスの指定” を参照してください。

Gateway.addToPath() は、連鎖ができるように Gateway オブジェクトを返します。

set javaGate = $system.external.getJavaGateway().addToPath("\Lib1\Some.jar").addToPath("\Lib2\Other.jar")

%DynamicArrayOpens in a new tab クラスは、JSON 配列構造を簡単に作成できるようにする ObjectScript ラッパです。動的配列の %Push() メソッドを使用して、配列にパスの文字列を追加します ("JSON の使用" の "動的配列での %Push と %Pop の使用" を参照)。以下の例は、配列 pathlist に 2 つのパスを追加し、それを Java Gateway オブジェクトの addToPath() メソッドに渡します。

  set pathlist = []
  do pathlist.%Push("/home/myhome/firstpath.jar")
  do pathlist.%Push("/home/myhome/another.jar")
  do javaGate.addToPath(pathlist)

Java の場合、パスにはフォルダまたは jar を指定できます。以下の例は、someclasses.jar へのパスを追加し、次に someclasses.classname のインスタンスのプロキシを作成します。

  set javaGate = getJavaGateway()
  do javaGate.addToPath("/home/myhome/someclasses.jar")
  set someProxy = javaGate.new("someclasses.classname")

.NET の場合、パスにはフォルダまたはアセンブリを指定できます。以下の例は、someassembly.dll へのパスを追加し、次に someassembly.classname のインスタンスのプロキシを作成します。

  set netGate = getDotNetGateway()
  do netGate.addToPath("C:\Dev\myApp\somedll.dll")
  set someProxy = netGate.new("someassembly.classname")

Python の場合、パスにはモジュールまたはパッケージを指定できます。モジュールがパッケージの一部である場合、モジュールのパスはパッケージの最上位のディレクトリから開始するドット表記で指定する必要があります。例えば、モジュール Foo.py へのパスは、以下の 2 つの方法のどちらかで指定できます。

• モジュールとして処理される場合の標準のパス表記 ： C:\Dev\demo\Foo.py

• パッケージ demo の一部として処理される場合のドット表記 ： C:\Dev\demo.Foo.py

以下の例は、動的配列を使用して、フォルダ C:\Dev\demo\ に含まれる 2 つの異なるファイルへのパスを追加します。ファイル Foo.py には、パッケージ化されていないクラス personOne が含まれ、ファイル Bar.py には、パッケージ demo の一部であるクラス personTwo が含まれます。new() を呼び出すと、以下のように両方のクラスのプロキシが作成されます。

  set pyPaths = []
  do pyPaths.%Push("C:\Dev\demo\Foo.py")
  do pyPaths.%Push("C:\Dev\demo.Bar.py")

  set pyGate = getPythonGateway()
  do pyGate.addToPath(pyPaths)
  set fooProxy = pyGate.new("Foo.personOne")
  set barProxy = pyGate.new("demo.Bar.personTwo")

クラスのないモジュールまたはパッケージのターゲットを割り当てることも可能です ("Python パッケージとクラス・パスの指定" を参照)。