JbyJ

dv4.0J

JbyJとは

JbyJは、次の2つの機能を提供する4Dプラグインです。

  • 4Dがネットワーク上の他の4Dに接続し、そのプロジェクトメソッドを実行することを可能にします。他の4Dに対し自分のデータをメソッドへの引数として与え、メ ソッドの戻り値として、他の4Dからデータを受け取ることができます。
  • Javaプログラムがネットワーク上の4Dに接続し、そのプロジェクトメソッドを実行することを可能にします。JbyJには、このようなJavaプログラムを開発するためのクラスライブラリが付属しています。

    JbyJは上記の機能を実現するためにJava RMIを利用しています。

 


動作環境

JbyJは、Mac OS、Windows両プラットフォーム上のv6.06以降の4th Dimention、4D Serverで動作します。

ただし、v2004以前の4Dで使用する場合、インテルプロセッサーが搭載されたMacでは動作しません。これは、JbyJがRosetta上では動作できないからです。インテルプロセッサーが搭載されたMacでは、バージョン4.1.1以降のJbyJを4D v11以降で使用する必要があります。

Windowsでは、Sun Microsystems社のJavaバーチャルマシンが必要です。


特徴

1

JbyJが提供するプラグインメソッドは、JbyJサーバメソッド、JbyJクライアントメソッド、ユーティリティに大別されま す。

2

JbyJは、4Dと4Dとの接続の以外に、Javaプログラム(JSP、サーブレット、アプレット、アプリケーションなど)から 4Dへの接続も可能にします。JbyJには、これらを開発するためのJavaクラスライブラリが付属しています。

3

JbyJは、LAN内の接続のほかに、インタネット経由での接続も可能です。JbyJは通信プロトコルとしてRMIを使用します が、ファイアウォールの中には、このプロトコルでの通信を制限しているものがあります。このため、JbyJは通信プロトコルとしてHTTP/HTTPSを 使用する接続形態も提供しています。

4

JbyJは、Javaバーチャルマシンを起動するプラグインJWroldと一緒に使用する必要があります。

5

プラグインJbyJおよびJWroldは、Plugins(Mac4DX/Win4DX)フォルダ内にあるプラグインファイル以外に、Java 関連のファイル(JbyJ_xxx.jar、JWorld_xxx.jar、java.securiy、libJWorld.jnilib)を必要としま す。これらのファイルは、RonriKoboフォルダ内になければなりません。RonriKoboフォルダは、次のフォルダに配置することができます。

  1. パッケージ(JWorld_4xx.bundle)のContentsフォルダ
  2. ストラクチャファイルがあるフォルダ
  3. アプリケーションファイル(4th Dimension, 4D Server, 4D Client)があるフォルダ
  4. 4Dフォルダ(ACIフォルダ)

上記の順番で、RonriKoboフォルダは探索され、最初に見つかったRonriKoboフォルダのみが採用されます。


種別

JbyJには、2種類の製品があります。

JbyJ STD

4Dと4Dとの接続のみを可能にする製品です。4D Server、4D Client、スタンドアロン4Dのすべての組み合わせにおいて接続を可能にします。

JbyJ PRO

JbyJ STDの機能の他に、Javaプログラム(JSP、サーブレット、アプレット、アプリケーションなど)から4Dへの接続も可能にします。


用語

JbyJプラグインメソッドの説明の中では、JbyJ独自の用語が使用されています。

JbyJサーバ

自分が持っている4Dメソッドを、他の4DまたはJavaアプリケーションなどに提供する4Dのこと。

JbyJクライアント

他の4Dが持っているメソッドを利用する4D、またはJavaプログラムのこと。

リモートメソッド

JbyJサーバ上(他の4D上)にあり、JbyJクライアントからコールされる4Dメソッドのこと。

1つの4Dアプリケーション は、同時にJbyJサーバにもJbyJクライアントにもなることができます。

JbJ Start server ( ClientProcesses; ConnectMethod; DisconnectMethod ) --> Status [ C_LONGINT ]

パラメタ

タイプ

説明

ClientProcesses

ARRAY LONGINT

JbyJクライアントからの要求を処理するプロセスのプロセス番号が要素となっている配列

ConnectMethod

C_STRING

JbyJクライアントが最初に接続を試みたとき自動的に実行される4Dのメソッド名

DisconnectMethod

C_STRING

JbyJクライアントが接続を解除したとき自動的に実行される4Dのメソッド名

JbJ Start serverは、JbyJサーバとして動作することを宣言します。

ClientProcessesには、JbyJクライアントからのメソッドの実行要求を処理するためのプロセス番号がその要素となっている整数配列 (ARRAY LONGINTまたはARRAY INTEGER)を指定してください。JbyJクライアントからの要求は、すべてJbJ HANDLE CLIENT REQUESTSというプラグインメソッドが処理します。一 般には、次のようなコードを記述して、JbyJクライアントの要求を処理します。

Repeat   PAUSE PROCESS(Current process)
JbJ HANDLE CLIENT REQUESTS

Until
(False)

JbyJクライアントの要求を処理するプロセス数は、一般には、JbyJサーバに同 時に接続する可能性のあるJbyJクライアントの数と同じです。しかし、1つのJbyJクライアントが、同じJbyJサーバに対して、同時に複数の接続を 維持する場合もあります。JbyJクライアントの要求を処理するプロセス数の最大値(理論値)は、1024です。したがって、配列 ClientProcessesの要素数も最大1024です。

ConnectMethodには、JbyJクライアントが接続を試みたとき、自動的に実行される4Dメソッド名を指定します。ここで指定されたメ ソッドには、パラメタとしてJbyJクライアントIDが渡されます。このJbyJクライアントIDを利用して、JbyJクライアントのユーザ名やパスワー ドを調べることができます。以降の接続を許可する場合は、返り値として"True"を返してください。接続を拒否するときは、"False"を返してくだ さい。

DisconnectMethodには、JbyJクライアントが接続を解除したときに、自動的に実行される4Dのメソッド名を指定します。ここで指定さ れたメソッドは、ConnectMethod同様、パラメタとしてJbyJクライアントIDが渡され、JbyJクライアントのユーザ名などを調べることが できます。通常このメソッドでは、JbyJクライアントが利用した変数や配列の解放等の後処理を行います。このメソッドの返り値はありません。

このメソッドは、実行が成功すると0を返します。エラーが発生した場合は、エラー番号(負の整数)を返します。エラー番号を参照してください。

関連項目:JbJ HANDLE CLIENT REQUESTS

サンプルコード

` JbyJサーバを起動する
`

C_LONGINT($x;$Err)
`
ARRAY LONGINT(<>aClientProcess;10) `最大10クライアントの接続を許可する
For($x;1;Size of array(<>aClientProcess))
<>aClientProcess{$x}:=New process("ClientsHandler";64000;"ClientsHandler"+String($x))
End for

`
$Err:=JbJ Start server(<>aClientProcess;"ClientConnected";"ClientDisconnected")
If
($Err # 0)
ALERT("Error:JbJ Start server")
End if
` ClientsHandlerメソッド
`

Repeat
PAUSE PROCESS(Current process)
JbJ HANDLE CLIENT REQUESTS Until(False)
` ClientConnectedメソッド
`

C_LONGINT($1) ` JbyJクライアントID
`
C_LONGINT
($PortNo)
C_STRING
(31;$UserName;$Password;$StructureName;$DataName)
C_STRING
(175;$IPAddress)
`
$UserName:=JbJ Get client name($1)
$Password:=JbJ Get client password($1)
$StructureName:=JbJ Get client structure name($1)
$DataName:=JbJ Get client data name($1)
$IPAddress:=JbJ Get client address($1)
$PortNo:=JbJ Get client port($1)
..........
..........

C_BOOLEAN
($0)
$0:=
True ` True--接続を許可する False--接続を拒否する
` ClientDisconnectedメソッド
`

C_LONGINT($1) ` JbyJクライアントID
`

C_LONGINT($PortNo)
C_STRING
(31;$UserName;$Password;$StructureName;$DataName)
C_STRING
(175;$IPAddress)
`
$UserName:=JbJ Get client name($1)
$Password:=JbJ Get client password($1)
$StructureName:=JbJ Get client structure name($1)
$DataName:=JbJ Get client data name($1)
$IPAddress:=JbJ Get client address($1)
$PortNo:=JbJ Get client port($1)
..........
..........

JbJ HANDLE CLIENT REQUESTS

パラメタ

タイプ

説明

パラメタなし



JbJ HANDLE CLIENT REQUESTSは、JbyJクライアントからのメソッドの実行要求を処理するメソッドです。

このプラグインメソッドは、JbyJクライアントからのメソッドの実行要求を処理す るためのプロセス内でのみ使用します。他のプロセスで使用しても無意味です。

関連項目:JbJ Start server

JbJ Get client name ( ClientID ) --> UserName [ C_STRING ]

パラメタ

タイプ

説明

ClientID

C_LONGINT

JbyJクライアントID

JbJ Get client nameはClientIDで指定されるJbyJクライアントのユーザ名を返します。

このメソッドでエラーが発生した場合は、 ""を返します。

JbJ Get client password ( ClientID ) --> Password [ C_STRING ]

パラメタ

タイプ

説明

ClientID

C_LONGINT

JbyJクライアントID

JbJ Get client passwordは、ClientIDで指定されるJbyJクライアントのパスワードを返します。

このメソッドでエラーが発生した場合は、 ""を返します。

JbJ Get client structure name ( ClientID ) --> StructureFileName [ C_STRING ]

パラメタ

タイプ

説明

ClientID

C_LONGINT

JbyJクライアントID

JbJ Get client structure nameは、ClientIDで指定されるJbyJクライアントのストラクチャファイル名を返します。Javaクライアントの場合は、"Java" を返します。

このメソッドでエラーが発生した場合は、 ""を返します。

JbJ Get client data name ( ClientID ) --> DataFileName [ C_STRING ]

パラメタ

タイプ

説明

ClientID

C_LONGINT

JbyJクライアントID

JbJ Get client data nameは、ClientIDで指定されるJbyJクライアントのデータファイル名を返します。Javaクライアントの場合は、"Java"を返し ます。

このメソッドでエラーが発生した場合は、 ""を返します。

JbJ Get client address ( ClientID ) --> IPAddress [ C_STRING ]

パラメタ

タイプ

説明

ClientID

C_LONGINT

JbyJクライアントID

JbJ Get client addressは、ClientIDで指定されるJbyJクライアントのIPアドレスを返します。

このメソッドでエラーが発生した場合は、 ""を返します。

JbJ Get client port ( ClientID ) --> PortNumber [ C_LONGINT ]

パラメタ

タイプ

説明

ClientID

C_LONGINT

JbyJクライアントID

JbJ Get client portは、ClientIDで指定されるJbyJクライアントのポート番号を返します。JavaがJbyJクライアントの場合は、無意味な整数を 返します。なぜなら、JavaはJbyJサーバにはなり得ないからです。

このメソッドでエラーが発生した場合は、エラー番号(負の整数)を返します。エラー番号を参照してください。

JbJ Get client process ( ClientID ) --> ProcessNumber [ C_LONGINT ]

パラメタ

タイプ

説明

ClientID

C_LONGINT

JbyJクライアントID

JbJ Get client processは、ClientIDで指定されるJbyJクライアントからのメソッドの実行要求が処理されるプロセス番号を返します。

このメソッドでエラーが発生した場合は、エラー番号(負の整数)を返します。エラー番号を参照してください。

関連項目:JbJ Get client id

JbJ Get client id ( ProcessNo ) --> ClientID [ C_LONGINT ]

パラメタ

タイプ

説明

ProcessNo

C_LONGINT

プロセス番号

JbJ Get client idは、ProcessNoで指定されるプロセスに対応するJbyJクライアントの識別番号(JbyJクライアントID)を返します。JbyJク ライアントからのメソッドの実行要求が処理されるプロセス番号以外のプロセス番号を指定した場合は、0を返します。

このメソッドでエラーが発生した場合は、エラー番号(負の整数)を返します。エラー番号を参照してください。

関連項目:JbJ Get client process

JbJ Disconnect client ( ClientID ) --> Status [ C_LONGINT ]

パラメタ

タイプ

説明

ClientID

C_LONGINT

JbyJクライアントID

JbJ Disconnect clientは、ClientIDで指定されるJbyJクライアントとの接続を、サーバ側から強制的に解除します。接続が解除されたにもかかわらず、 JbyJクライアントがメソッドの実行を要求した場合は、JbyJクライアントでエラーが発生します。

このメソッドは、実行が成功すると0を返します。エラーが発生した場合は、エラー番 号(負の整数)を返します。エラー番号を参照してください。

関連項目:JbJ Disconnect server

JbJ Connect server ( IPAddress; PortNo; UserName; Password ) --> ServerID [ C_LONGINT ]

パラメタ

タイプ

説明

IPAddress

C_STRING

JbyJサーバのIPアドレスまたはホスト名 (最大175バイト)

PortNo

C_LONGINT

JbyJサーバのポート番号

UserName

C_STRING

ユーザ名 (最大63バイト)

Password

C_STRING

パスワード (最大63バイト)

JbJ Connect serverは、JbyJサーバとの接続を確立し、JbyJサーバの識別番号であるJbyJサーバIDを返します。JbyJクライ アントは、同時に最大1024(理論値)の接続を維持することが可能です。同じJbyJサーバに対して1024の接続を確立することも、またすべて異なる 1024のJbyJサーバと接続を確立することも可能です。

このメソッドでは、通信プロトコルにRMIが使用されます。このプラグインメソッド 以外に、JbyJサーバと接続を確立するめのプラグインメソッドとして、JbJ Connect server by servletがあります。こちらでは、通信プロトコルとしてHTTPまたはHTTPSとRMIを併用しています。

IPAddressには、接続するJbyJサーバのIPアドレスまたはホスト名を指定してください。

PortNoには、接続するJbyJサーバのポート番号を指定してください。

UserNameには、ユーザの名前を指定してください。

Passwordには、ユーザのパスワードを指定してください。

UserNameまたはPasswordによっては、JbyJサーバから接続が拒否されることがあります。接続が拒否された場合は、結果として負の整数が返っ てきます。

このメソッドは、実行が成功すると0を返します。エラーが発生した場合は、エラー番 号(負の整数)を返します。エラー番号を参照してください。

関連項目:JbJ Connect server by servlet JbJ Call remote method JbJ Disconnect server

サンプルコード

` JbyJサーバとの接続
`

C_LONGINT($ServerID)
$ServerID:=JbJ Connect server("192.168.10.150";9999;"Monica";"Whitehouse")
..........
..........

` JbyJサーバとの接続解除
$Err:=JbJ Disconnect server($ServerID)

JbJ Connect server by servlet ( ServletURL; IPAddress; PortNo; UserName; Password ) --> ServerID [ C_LONGINT ]

パラメタ

タイプ

説明

ServletURL

C_STRING

サーブレットのURL (最大175バイト)

IPAddress

C_STRING

JbyJサーバのIPアドレスまたはホスト名 (最大175バイト)

PortNo

C_LONGINT

JbyJサーバのポート番号

UserName

C_STRING

ユーザ名 (最大63バイト)

Password

C_STRING

パスワード (最大63バイト)

JbJ Connect server by servletは、JbyJサーバとの接続を確立し、JbyJサーバの識別番号であるJbyJサーバIDを返します。JbyJクライ アントは、同時に最大1024(理論値)の接続を維持することが可能です。同じJbyJサーバに対して1024の接続を確立することも、またすべて異なる 1024のJbyJサーバと接続を確立することも可能です。

このメソッドは、JbJ Connect serverと違い、直接JbyJサーバと接続するのではなく、JbyJ専用サーブレットJbyJAdaptorを仲介して、 JbyJサーバと接続します。サーブレットとは、Webサーバとともに動作する比較的小さなJavaプログラムのことで、CGIのように機能します。サー ブレットのための環境を提供するソフトウェアとしてTomcatやJettyが有名です。JbyJにはTomcatとJettyで動作確認されたJbyJ 専用サーブレットJbyJAdaptorが付属しています。

この接続の場合、JbyJクライアントからサーブレットまでは、通信プロトコルとし てHTTPまたはHTTPSを使用し、サーブレットからJbyJサーバまではRMIを使用します。

ServletURLには、JbyJ専用サーブレットJbyJAdaptorのURLを指定してください。

他のパラメタは、JbJ Connect serverのパラメタと同様です。そちらの説明を参照してください。

このメソッドは、実行が成功すると0を返します。エラーが発生した場合は、エラー番 号(負の整数)を返します。エラー番号を参照してください。

関連項目:JbJ Connect server JbJ Call remote method JbJ Disconnect server

サンプルコード

` JbyJサーバとの接続
`

C_LONGINT($ServerID)
$ServerID:=JbJ Connect server by servlet(
"http://www.xxx.com/JbyJAdaptor";
`JbyJ専用サーブレットのURL
"192.168.10.150"; `JbyJサーバのIPアドレス
9999;
"Monica";
"Whitehouse")
..........
..........

` JbyJサーバとの接続解除
$Err:=JbJ Disconnect server($ServerID)

JbJ Call remote method ( ServerID; MethodName; Parameters; Async ) --> Status [ C_LONGINT ]

パラメタ

タイプ

説明

ServerID

C_LONGINT

JbyJサーバID

MethodName

C_STRING

JbyJサーバのIPアドレスまたはホスト名 (最大175バイト)

Parameters

ARRAY POINTER

リモートメソッドに渡すパラメタへのポインタが要素となっているポインタ配列

Async

C_LONGINT

0--同期実行 1--非同期実行 

JbJ Call remote methodは、JbyJサーバ上のメソッドを呼び出し、実行します。

ServerIDには、JbJ Connect serverまたはJbJ Connect server by servletで獲得したJbyJサーバIDを指定 してください。同じJbyJサーバIDを指定する限り接続を閉じるまで、JbyJサーバ上でのメソッドの実行は、同じプロセス内で実行されます。したがっ て、次回のJbJ Call remote methodの際にも、JbyJサーバ上のカレントレコード、カレントセレクション、プロセス変数などは維持されます。

MethodNameには、実行しようとするJbyJサーバ上のメソッド名を指定してください。

Paramsには、JbyJサーバ上のメソッドへ渡すパラメタへのポインタが、要素となっているポインタ配列を指定してください。 JbyJサーバ上のメソッドの実行後、そのメソッドが返す値を、このポインタ配列の要素として受け取ることができます。この結果、このポインタ配列の要素 は、JbyJサーバ上のメソッドの実行の前後で変化します。その配列のサイズも変化する可能性があります。

Asyncに1を指定すると、非同期にJbyJサーバ上のメソッドを実行します。非同期実行では、JbyJサーバ上のメソッド実 行の終了を待たずに、制御がすぐにJbyJクライアントに戻ります。結果を返さないメソッドの実行に有効です。

Async に0を指定すると、JbyJサーバ上のメソッドの実行が終了するまで、制御はJbyJクライアントに戻りません(同期実行)。通常はこちらを指定します。

このメソッドは、実行が成功すると0を返します。エラーが発生した場合は、エラー番 号(負の整数)を返します。エラー番号を参照してください。

関連項目:JbJ Connect server JbJ Connect server by servlet JbJ Disconnect server

サンプルコード

`JbyJサーバ上のメソッドを実行する
`

C_LONGINT($ServerID)
` $ServerID:=JbJ Connect server("www.xxx.com";9999;"Monica";"Whitehouse")
` or

$ServerID:=JbJ Connect server by servlet(
"http://www.xxx.com/JbyJAdaptor";
"192.168.10.150";
9999;
"Monica";
"Whitehouse")
If
($ServerID>0)
C_STRING(32;$StructureName;$DataName)

`
$StructureName:=JbJ Get server structure name($ServerID)
$DataName:=JbJ Get server data name($ServerID)

`
C_BOOLEAN(vSex)
C_STRING(20;vName)
C_LONGINT(vHisAge)
C_LONGINT($Err)

`
vSex:=True `Male
vName:="Bill Clinton"
ARRAY STRING(21;aHisChildren;3)
aHisChildren{1}:="John"
aHisChildren{2}:="Mary"
aHisChildren{3}:="Mike"

`
ARRAY POINTER($Parameter;2)
$Parameter{1}:=->vSex
`第1パラメタ
$Parameter{2}:=->vName `第2パラメタ
$Err:=JbJ Call remote method($ServerID;"TestMethod1";$Parameter;0)
If($Err=0)
If(Size of array($Parameter)=1)
If(Type($Parameter{1}->)=Is LongInt)
vHisAge:=$Parameter{1}->
`結果を受け取る
Else
ALERT("Error:JbJ Call remote method")
End if
Else
ALERT("Error:JbJ Call remote method")
End if
Else
ALERT("Error:JbJ Call remote method")
End if

`
ARRAY POINTER($Parameter;3)
$Parameter{1}:=->vSex
`第1パラメタ
$Parameter{2}:=->vName `第2パラメタ
$Parameter{3}:=->aHisChildren `第3パラメタ
$Err:=JbJ Call remote method($ServerID;"TestMethod2";$Parameter;0)
If($Err=0)
If(Size of array($Parameter)=1)
If(Type($Parameter{1}->)=LongInt array)
ARRAY LONGINT(aSalary;0)
COPY ARRAY($Parameter{1}->;aSalary)
`結果を受け取る
Else
ALERT("Error:JbJ Call remote method")
End if
Else
ALERT("Error:JbJ Call remote method")
End if
Else
ALERT("Error:JbJ Call remote method")
End if

`
ARRAY POINTER($Parameter;3)
$Parameter{1}:=->vSex
`第1パラメタ
$Parameter{2}:=->vName `第2パラメタ
$Parameter{3}:=->aHisChildren `第3パラメタ
$Err:=JbJ Call remote method($ServerID;"TestMethod3";$Parameter;0)
If($Err=0)
If(Size of array($Parameter)=2)
If(Type($Parameter{1}->)=Is LongInt) & (Type($Parameter{2}->)=LongInt array)
vHisAge:=$Parameter{1}->
`結果-1を受け取る
ARRAY LONGINT(aSalary;0)
COPY ARRAY($Parameter{2}->;aSalary)
`結果-2を受け取る
Else
ALERT("Error:JbJ Call remote method")
End if
Else
ALERT("Error:JbJ Call remote method")
End if
Else
ALERT("Error:JbJ Call remote method")
End if

`
$Err:=JbJ Disconnect server($ServerID)
If($Err # 0)
ALERT("Error:JbJ Disconnect server")
End if

`
Else
ALERT("Error:JbJ Connect server")
End if
`JbyJサーバ上のメソッド TestMethod1
C_BOOLEAN($1) `Sex 第1パラメタ
C_STRING(20;$2) `Name 第2パラメタ
..........
..........
C_LONGINT($0)
QUERY
([Personnel];[Personnel]Sex=$1;*)
QUERY
([Personnel]; & ;[Personnel]Name=$2)
$0:=[Personnel]Age
`結果を返す
`JbyJサーバ上のメソッド "TestMethod2"
C_BOOLEAN($1) `Sex 第1パラメタ
C_STRING(20;$2) `Name 第2パラメタ
C_POINTER($3) `His children 第3パラメタ
`

C_LONGINT($Size;$x)
$Size:=Size of array($3->)
ARRAY STRING
(21;aHisChildren;$Size)
For($x;1;$Size)
aHisChildren{$x}:=$3->{$x}
End for
..........
..........
QUERY([Personnel];[Personnel]Sex=$1;*)
QUERY
([Personnel]; & ;[Personnel]Name=$2)
RELATE MANY
([Personnel]ID)
ARRAY LONGINT
(aSalary;0)
SELECTION TO ARRAY
([Salary]Paid;aSalary)

`
C_POINTER
($0)
$0:=->aSalary
`結果として配列を返す
`JbyJサーバ上のメソッド "TestMethod3"
C_BOOLEAN($1) `Sex 第1パラメタ
C_STRING(20;$2) `Name 第2パラメタ
C_POINTER($3) `His children 第3パラメタ
`

C_LONGINT($Size;$x)
$Size:=Size of array($3->)
ARRAY STRING
(21;aHisChildren;$Size)
For
($x;1;$Size)
aHisChildren{$x}:=$3->{$x}
End for
..........
..........
QUERY([Personnel];[Personnel]Sex=$1;*)
QUERY
([Personnel]; & ;[Personnel]Name=$2)
RELATE MANY
([Personnel]ID)
ARRAY LONGINT
(aSalary;0)
SELECTION TO ARRAY
([Salary]Paid;aSalary)

`
` 複数の結果を返す

ARRAY POINTER(aReturn;2)
aReturn{1}:=->[Personnel]Age
`結果-1
aReturn{2}:=->aSalary `結果-2
`

C_POINTER
($0)
$0:=->aReturn

JbJ Disconnect server ( ServerID ) --> Status [ C_LONGINT ]

パラメタ

タイプ

説明

ServerID

C_LONGINT

JbyJサーバID

JbJ Disconnect serverは、ServerIDで指定されるJbyJサーバとの接続を解除します。

このメソッドは、実行が成功すると0を返します。エラーが発生した場合は、エラー番 号(負の整数)を返します。エラー番号を参照してください。

関連項目:JbJ Disconnect client

JbJ Get server structure name ( ServerID ) --> StructureFileName [C_STRING]

パラメタ

タイプ

説明

ServerID

C_LONGINT

JbyJサーバID

JbJ Get server structure nameは、 ServerIDで指定されるJbyJサーバのストラクチャファイル名を返します。

このメソッドでエラーが発生した場合は、 ""を返します。

JbJ Get server data name ( ServerID ) --> DataFileName [C_STRING]

パラメタ

タイプ

説明

ServerID

C_LONGINT

JbyJサーバID

JbJ Get server data nameは、 ServerIDで指定されるJbyJサーバのデータファイル名を返します。

このメソッドでエラーが発生した場合は、 ""を返します。

JbJ Get servlet url ( ServerID ) --> ServletURL [C_STRING]

パラメタ

タイプ

説明

ServerID

C_LONGINT

JbyJサーバID

JbJ Get servlet urlは、 JbJ Connect server by servletを使用して、ServerIDで指定されるJbyJサーバと接続している場合、仲介しているJbyJ専用サーブレットのURLを返します。JbJ Connect serverを使用して接続している場合は、 ""を返します。

このメソッドでエラーが発生した場合は、 ""を返します。

JbJ Get server address ( ServerID ) --> IPAddress [C_STRING]

パラメタ

タイプ

説明

ServerID

C_LONGINT

JbyJサーバID

JbJ Get server addressは、 ServerIDで指定されるJbyJサーバのIPアドレスまたはホスト名を返します。

このメソッドでエラーが発生した場合は、 ""を返します。

JbJ Get server port ( ServerID ) --> PortNumber [ C_LONGINT ]

パラメタ

タイプ

説明

ServerID

C_LONGINT

JbyJサーバID

JbJ Get server portは、 ServerIDで指定されるJbyJサーバのポート番号を返します。

このメソッドでエラーが発生した場合は、エラー番号(負の整数)を返します。エラー番号を参照してください。

JbJ Get my client id ( ServerID ) --> ClientID [ C_LONGINT ]

パラメタ

タイプ

説明

ServerID

C_LONGINT

JbyJサーバID

JbJ Get my client idは、 ServerIDで指定されるJbyJサーバが、JbyJクライアントとしての識別に使用している自分のJbyJクライアントIDを返 します。

このメソッドでエラーが発生した場合は、エラー番号(負の整数)を返します。エラー番号を参照してください。

JbJ Get my address --> IPAddress [C_STRING]

パラメタ

タイプ

説明

パラメタなし



JbJ Get my addressは、使用中のコンピュータに設定されているIPアドレスを返します。

このメソッドでエラーが発生した場合は、 ""を返します。

JbJ Get my host name --> hostName [C_STRING]

パラメタ

タイプ

説明

パラメタなし



JbJ Get my host nameは、使用中のコンピュータに設定されているホスト名を返します。

このメソッドでエラーが発生した場合は、 ""を返します。

JbJ Copy record to BLOB ( TableNo; BLOB ) --> Status [ C_LONGINT ]

パラメタ

タイプ

説明

TableNo

C_LONGINT

テーブル番号

BLOB

C_BLOB

レコードの内容がコピーされるBLOB変数

JbJ Copy record to BLOBは、TableNoで指定されるテーブルのカレントレコード内容を、サブレコードも含めてすべて、BLOBで指定されるBLOB変数にコピーしま す。

このメソッドは、実行が成功すると0を返します。エラーが発生した場合は、エラー番 号(負の整数)を返します。エラー番号を参照してください。

関連項目:JbJ Copy BLOB to record

JbJ Copy BLOB to record ( BLOB; TableNo ) --> Status [ C_LONGINT ]

パラメタ

タイプ

説明

BLOB

C_BLOB

レコードの内容がコピーされるBLOB変数

TableNo

C_LONGINT

テーブル番号

JbJ Copy BLOB to recordは、TableNoで指定されるテーブルのカレントレコード内容をBLOBで指定されるBLOB変数の内容で置き換えます。このBLOB変数は、JbJ Copy record to BLOBで獲得したものでなければなりません。

このメソッドは、実行が成功すると0を返します。エラーが発生した場合は、エラー番 号(負の整数)を返します。エラー番号を参照してください。

関連項目:JbJ Copy record to BLOB

JbJ Set environment ( JVM_ID; License; PortNo ) --> Status [ C_LONGINT ]

パラメタ

タイプ

説明

JVM_ID

C_LONGINT

JWD create java worldが返すJavaバーチャルマシンのID番号

License

C_STRING

デモ版と製品版を区別するための文字列

PortNo

C_LONGINT

ポート番号

JbJ Set environmentは、JbyJが動作するための基本的環境を整えます。このプラグインメソッ ドをエラーなく実行しない限り、他のJbyJのプラグインメソッドは、すべてエラー(エラー番号-18021)になります。通常このメソッドは、 On Startupで実行します。

JVM_IDには、JWD create java worldが返し たJavaバーチャルマシンのID番号を指定してください。

Licenseには、"PRODUCT"または"TRIAL"のどちらかの文字列を指定してください。

"PRODUCT"を指定すると、次回の4Dの起動からライセンスキーコードを入力する画面が表示されます。"TRIAL"を指定 すると、試用時間が60分に制限されたデモ版として動作します。

PortNoには、JbyJサーバとして使用するときのポート番号を指定してください。9000番台のポート番号を 使用することを推奨します。JbyJサーバとして使用せず、JbyJクライアントとしての機能しか使用しないときは、-1のようなダミーのポート番号を指 定してください。

このメソッドは、実行が成功すると0を返します。エラーが発生した場合は、エラー番号(負の整数)を返します。エラー番号を参照してください。

関連項目:JWD create java world

サンプルコード

` 通常 On Startupで、次のように記述する
`

C_LONGINT($JVM_ID)
C_LONGINT
($Err)
`
$JVM_ID:=JWD Create java world("") `Javaバーチャルマシンを起動する
If($JVM_ID>0)
$Err:=
JbJ Set environment($JVM_ID;"PRODUCT";9999)
`デモ版では"PRODUCT"の代わりに"TRIAL"を使用する
      `JbyJサーバは、ポート番号として9999番を使用する

If($Err # 0)
ALERT("Error:JbJ Set environment")
End if
Else

ALERT("Error:JWD Create java world")
End if

JWorld

JWorldは、Javaバーチャルマシンを起動させるためのプラグインであり、JbyJにとって必須のものです。JWorldに は、次のようなプラグインメソッドがあります。

JWD Create java world
JWD Close java world
JWD Convert line separator
JWD Set JVM options

Mac OS Xでは、Javaバーチャルマシンはシステムにビルトインされています。

Windowsでは、サンマイクロシステムズ社のJ2SE(Java2 Platform Standard Edition)を使用します。サンマイクロシステムズ社のWebサイトから、最新版のJ2SEを入手してインストールしてください。J2SEには、 JREとJDKの2種類ありますが、どちらも使用できます。

Javaバーチャルマシンを起動する機能は、他のプラグインJExternalでも同様に必要なため、そのプラグインと共有できるように、JbyJの中に含めずJWorldとして独立しています。

JWD Create java world ( JVM_Path ) --> JVM_ID [ C_LONGINT ]

パラメタ

タイプ

説明

JVM_Path

C_STRING

JavaバーチャルマシンDLLへのパス(Windows)

JWD Create java worldは、Javaバーチャルマシン(JVM)を起動し、そのJavaバー チャルマシンの識別番号(正の整数)を返します。

JVM_PathとしてWindowsでは、"jvm.dll"までのフルパス名、またはそのフルパス名を設定して いる環境変数を指定してください。ブランク("")が指定された場合は、環境変数「JVMDLL_PATH」が指定されたものと見なされます。

JWorldバージョン3.1.0以降では、JVM_Pathにブランク("")が指定され、しかも環境変数 「JVMDLL_PATH」が存在しない場合、Javaバーチャルマシンのインストール時に設定されたレジストリを参照します。最初に、 HKEY_LOCAL_MACHINE\SOFTWARE\JavaSoft\Java Runtime EnvironmentにあるCurrentVersionキーからJavaバーチャルマシンの現在のバージョンを取得し、次に HKEY_LOCAL_MACHINE\SOFTWARE\JavaSoft\Java Runtime Environment\(現在のバージョン)にあるRuntimeLibキーからjvm.dllのパスを取得します。

"jvm.dll"までのフルパス名の例

JRE 1.6.0_02

"C:\Program Files\Java\jre1.6.0_02\bin\client\jvm.dll"

JDK 1.6.0_02

"C:\Program Files\Java\jdk1.6.0_02\jre\bin\client\jvm.dll"

Mac OSでは、JVM_Pathは無視され、現在コンピュータにインストールされているアップル社のJava バーチャルマシンが起動されます。

Javaバーチャルマシンが正しくインストールされていれば、WindowsとMac OS共通で、ブランク("")がJVM_Pathとして指定できます。

このプラグインメソッドは、4th Dimensionまたは4D Clientでは、通常、On Startupで使用します。4D Serverでは、On Server Startupから起動される別プロセスで使用してください。

4D Clientで使用する場合は、このプラグインメソッドを呼ぶ前に、4D Server上にあるRonriKoboフォルダを、4D Clientにコピーしておきます。4D Clientでの利用を参照してください。

このメソッドでエラーが発生した場合は、エラー番号(負の整数)を返します。エラー番号を参照してください。

サンプルコード

`4Dまたは4D Clientの場合の On Startup
`
`**** For 4D Client ****

If(Application type=4D Client)
`4D Clientのときは、ここでRoniKoboフォルダの中のファイルを
`4D Serverから4D Clientにコピーする処理行う
End if
`
C_LONGINT($JVM_ID)
C_LONGINT
($Err)
$JVM_ID:=JWD Create java world("")
If($JVM_ID>0)
$Err:=JEX Set environment($JVM_ID;"PRODUCT")
If($Err # 0)
ALERT("Error:JEX Set environment")
End if Else ALERT("Error:JWD Create java world") End if
`4D Serverの場合の On Server Startup 
`別プロセスを起動する

`
C_LONGINT($Proc)
$Proc:=
New process("SETUP_JbyJ";64000;"$SETUP_JbyJ")
While
(Process state($Proc)>=0)
IDLE
DELAY PROCESS(Current process;60)
End while
`On Server Startupとは別プロセスで実行される"SETUP_JbyJ"
`
C_LONGINT($JVM_ID)
C_LONGINT
($Err)
`
$JVM_ID:=JWD Create java world("")
If($JVM_ID>0)
$Err:=JbJ Set environment($JVM_ID;"PRODUCT";9999)
If($Err # 0)
ALERT("Error:JbJ Set environment")
End if
Else
ALERT("Error:JWD Create java world")
End if

JWD Close java world --> Status [ C_LONGINT ]

パラメタ

タイプ

説明

なし



JWD Close java worldは、4D ServerのOn Server Shutdownで実行し、正常に4D Serverを終了させるためのプラグインメソッドです。4D Serverでこのメソッドを実行せずに終了した場合は、終了までに余分な時間がかかる場合があります。

4th Dimensionまたは4D Clientでは、必ずしもこのメソッドを実行する必要はありません(実行しても問題ありません)。

このメソッドでエラーが発生した場合は、エラー番号(負の整数)を返します。エラー番号を参照してください。

サンプルコード

`On Server Shutdown
`
C_LONGINT($Err)
$Err:=JWD Close java world

JWD Convert line separator ( ON_or_OFF ) --> Status [ C_LONGINT ]

パラメタ

タイプ

説明

ON_or_OFF

C_BOOLEAN

行区切りコードの変換のオン/オフを指定する

JWD Convert line separatorに、引数としてTRUEを指定すると、4DからJavaに文 字列が渡されるとき、自動的に4Dの行区切りコードCRをJavaの行区切りコードLFに変換します。また、Javaから4Dに戻される文字列の中に Javaの行区切りコードLFがあれば、自動的に4Dの行区切りコードCRに変換します。

このメソッドに、引数としてFALSEを指定すると、上記の変換は行われません。JWorldプラグイン起動直後は、このメソッド にFALSEを指定した状態になっています

このメソッドでエラーが発生した場合は、エラー番号(負の整数)を返します。エラー番号を参照してください。

サンプルコード

C_LONGINT($Err)
C_BOOLEAN
($Switch)
$Switch:=
TRUE
$Err:=JWD Convert line separator($Switch)

JWD Set JVM options ( Options ) --> Status [ C_LONGINT ]   JWorld ver 4.1.1以降で有効

パラメタ

タイプ

説明

Options

ARRAY TEXT

JVM起動オプションを要素とする配列

JWD Set JVM optionsは、Javaバーチャルマシンの起動オプションを設定するために使用します。起動オプションを要素とした配列を引数として指定してください。JWD Set JVM optionsは、JWD Create java worldを実行する前に呼び出してください。

このプラグインメソッドは、JWorld ver 4.1.1以降で使用できます。リソースにJavaバーチャルマシンの起動オプションを設定する方法も引き続き有効です。両者を併用できます。

Javaバーチャルマシンの起動オプション

このメソッドでエラーが発生した場合は、エラー番号(負の整数)を返します。エラー番号を参照してください。

サンプルコード

C_LONGINT($Err)
C_LONGINT($JVM_ID)

ARRAY TEXT($aOptions;2)
$aOptions{1}:="-Xms128M"
$aOptions{2}:="-Xmx128M"
$Err:=
JWD Set JVM options($aOptions)
If ($Err=0)
 $JVM_ID:=
JWD Create java world("")
 ...
End if

Javaクラスライブラリ

JbyJでは、4Dと同様、Javaプログラム(JSP、サーブレット、アプレット、アプリケーションなど)も、JbyJクライア ントとしてJbyJサーバに接続して、4Dメソッドを実行することができます。

このため、JavaのJbyJクライアントを開発するためのクラスライブラリとしてJbyJClasses_xxx.jarが提供 されています。

注意:JavaのJbyJクライアントが接続するJbyJサーバには、JbyJ PROが必要です。JbyJ PROにつては、製品種別を参照してください。

JbyJClasses_xxx.jarには、次ぎようなクラスがあります。

Class com.ronri_kobo.JbyJ.JbyJ4DServer
Class com.ronri_kobo.Time
Class com.ronri_kobo.Date
Class com.ronri_kobo.String255
Class com.ronri_kobo.Picture
Class com.ronri_kobo.JbyJ.InvalidLicenseCodeException
Class com.ronri_kobo.JbyJ.RefuseConnectionException
Class com.ronri_kobo.JbyJ.FullEntryException
Class com.ronri_kobo.JbyJ.ShutOutException
Class com.ronri_kobo.JbyJ.MethodErrorException

クラス com.ronri_kobo.JbyJ.JbyJ4DServer

java.lang.Object
|
+----com.ronri_kobo.JbyJ.JbyJ4DServer
public class JbyJ4DServer extends java.lang.Object

このクラスは、JbyJサーバと接続するための2つのコンストラクタ、JbyJサーバ上のメソッドを実行するためメソッド、 JbyJサーバの諸情報を獲得するためのメソッドなどを提供します。

コンストラクタ JbyJ4DServer

public JbyJ4DServer(java.lang.String ipaddress,
int portNo,
java.lang.String userName,
java.lang.String password)
throws com.ronri_kobo.JbyJ.InvalidLicenseCodeException,
com.ronri_kobo.JbyJ.RefuseConnectionException,
com.ronri_kobo.JbyJ.FullEntryException,
java.net.UnknownHostException,
java.rmi.RemoteException,
java.rmi.NotBoundException,
java.rmi.MalformedURLException,
java.io.IOException,
java.lang.Exception

このメソッドは、 JbyJ4DServerクラスのコンストラクタで、JavaのRMIを利用してJbyJサーバとの接続を確立し、JbyJ4DServerクラスのオブ ジェクトを生成します。プラグインメソッドJbJ Connect serverに対応するJavaメソッドです。

ipAddressには、接続するJbyJサーバのIPアドレスまたはホスト名(最大175バイト)を指定してくだ さい。

portNoには、接続するJbyJサーバのポート番号を指定してください。

userNameには、ユーザの名前(最大63バイト)を指定してください。

passwordには、ユーザのパスワード(最大63バイト)を指定してください。

userNameまたはpasswordによっては、JbyJサーバから接続を拒否されることがあり ます。接続が拒否された場合は、例外com.ronri_kobo.JbyJ.RefuseConnectionExceptionが 発生します。

関連項目:JbJ Connect server

コンストラクタ JbyJ4DServer

public JbyJ4DServer(java.lang.String servletURL, 
java.lang.String ipaddress,
int portNo,
java.lang.String userName,
java.lang.String password)
throws com.ronri_kobo.JbyJ.InvalidLicenseCodeException,
com.ronri_kobo.JbyJ.RefuseConnectionException,
com.ronri_kobo.JbyJ.FullEntryException,
java.net.UnknownHostException,
java.rmi.RemoteException,
java.rmi.NotBoundException,
java.rmi.MalformedURLException,
java.io.IOException,
java.lang.Exception,
java.lang.ClassNotFoundException

このメソッドは、 JbyJ4DServerクラスのコンストラクタで、前ページのコンストラクタと違って、JbyJ専用サーブレットを仲介して、JbyJサーバとの接続を 確立し、JbyJ4DServerクラスのオブジェクトを生成します。プラグインメソッドJbJ Connect server by servletに対応するJavaメソッドです。

サーブレットまでは、通信プロトコルとしてHTTPまたはHTTSを使用し、サーブレットからJbyJサーバまではRMIを使用し て、接続を確立します。

servletURLには、JbyJ専用サーブレットのURL(最大175バイト)を指定してください。

ipAddressには、接続するJbyJサーバのIPアドレスまたはホスト名(最大175バイト)を指定してくだ さい。

portNoには、接続するJbyJサーバのポート番号を指定してください。

userNameには、ユーザの名前(最大63バイト)を指定してください。

passwordには、ユーザのパスワード(最大63バイト)を指定してください。

userNameまたはpasswordによっては、JbyJサーバから接続を拒否されることがあり ます。接続を拒否された場合は、例外com.ronri_kobo.JbyJ.RefuseConnectionExceptionが 発生します。

関連項目:JbJ Connect server by servlet

インスタンスメソッド call4DMethod

public java.lang.Object call4DMethod(java.lang.String methodName,
java.lang.Object parameter[],
int async)
throws com.ronri_kobo.JbyJ.ShutOutException,
com.ronri_kobo.JbyJ.MethodErrorException,
java.net.UnknownHostException,
java.rmi.RemoteException,
java.rmi.NotBoundException,
java.rmi.MalformedURLException,
java.io.IOException,
java.lang.Exception

このメソッドは、接続しているJbyJサーバ上のmethodNameで指定される4Dメソッドを実行します。プラ グインメソッドJbJ Call remote methodに対応するJavaメソッドで す。

parameter[]には、4Dメソッドに渡すパラメタを要素としたObjectクラスの配列を指定してくださ い。int型やdouble型などのプリミティブ型のパラメタを4Dに渡す場合は、それらのラッパ−オブジェクトを作成してから、その配列の要素としてく ださい。

このメソッドは、返り値として4Dの$0に対応した1つのObjectクラスのオブジェクトを返します。必要に応じて、そのオブ ジェクトをキャストあるいはアンラップして、返り値を獲得してください。

4Dメソッドで複数の値を返したい場合は、それらの値へのポインタを要素としたポインタ配列へのポインタを返してください。 Javaでは、返されたObjectクラスのオブジェクトを、まずObjectクラスの配列にキャストし、その配列の要素を必要に応じて、アンラップまた はキャストして、4Dから複数の値を受け取ります。

Asyncに1を指定すると、非同期にJbyJサーバ上のメソッドを実行します。非同期実行では、JbyJサーバ上 のメソッド実行の終了を待たずに、制御がすぐにJavaに戻ります。結果を返さないメソッドの実行に有効です。

Async に0を指定すると、JbyJサーバ上のメソッドの実行が終了するまで、制御はJavaに戻りません(同期実行)。通常はこちらを指定します。

関連項目:JbJ Call remote method 4DとJavaの型変換

イ ンスタンスメソッド disconnect

public void disconnect() throws com.ronri_kobo.JbyJ.ShutOutException,
java.net.UnknownHostException,
java.rmi.RemoteException,
java.rmi.NotBoundException,
java.rmi.MalformedURLException,
java.io.IOException

このメソッドは、JbyJサーバとの接続を解除します。プラグインメソッドJbJ Disconnect serverに対応するJavaメソッドです。

関連項目:JbJ Disconnect server

インスタンスメソッド getStructureName

public java.lang.String getStructureName()

このメソッドは、接続しているJbyJサーバのストラクチャファイル名を返します。プラグインメソッドJbJ Get server structure nameに対応するJavaメソッドです。

関連項目:JbJ Get server structure name

インスタンスメソッド getDataName

public java.lang.String getDataName()

このメソッドは、接続しているJbyJサーバのデータファイル名を返します。プラグインメソッドJbJ Get server data nameに対応するJavaメソッドです。

関連項目:JbJ Get server data name

インスタンスメソッド getServletURL

public java.lang.String getServletURL()

このメソッドは、JbyJサーバとの接続に使用されているJbyJ専用サーブレットのURLを返します。JbyJ専用サーブレット を仲介してJbyJサーバと接続をいる場合のみ有効です。プラグインメソッドJbJ Get servlet urlに対応するJavaメソッドです。

関連項目:JbJ Get servlet url

インスタンスメソッド getAddress

public java.lang.String getAddress()

このメソッドは、接続しているJbyJサーバのIPアドレスまたはホスト名を返します。プラグインメソッドJbJ Get server addressに対応するJavaメソッドです。

関連項目:JbJ Get server address

インスタンスメソッド getPort

public int getPort()

このメソッドは、接続しているJbyJサーバのポート番号を返します。プラグインメソッドJbJ Get server portに対応するJavaメソッドです。

関連項目:JbJ Get server port

インスタンスメソッド getMyClientID

public int getMyClientID()

このメソッドは、接続しているJbyJサーバが、JbyJクライアントの識別に使用している自分のJbyJクライアントIDを返し ます。プラグインメソッドJbJ Get my client idに対応するJavaメ ソッドです。

関連項目:JbJ Get my client id

サンプルコード

import java.lang.*;
import com.ronri_kobo.*;
import com.ronri_kobo.JbyJ.*;

public class TestClass
{
..........
..........

/**************************/
// execute4Dmethod
/**************************/
public void execute4Dmethod()
{
try{

// JbyJ4DServer server = new JbyJ4DServer( "192.168.10.150",
// 9999,
// "Monica",
// "Whitehouse" );

// or

JbyJ4DServer server = new JbyJ4DServer(
"http://www.xxx.com/JbyJAdaptor",
"192.168.10.150",
9999,
"Monica",
"Whitehouse" );

String structureName = server.getStructureName();
String dataName = server.getDataName();
String servletURL = server.getServletURL();
String ipAddress = server.getAddress();
int portNo = server.getPort();
int myClientID = server.getMyClientID();

Object[] params;
Object[] results;
Object resultObj;
int hisAge;
int[] hisSalary;

boolean sex = true; //Male
String255 name = new String255( "Bill Clinton" );
String255[] hisChildren = new String255[ 3 ];
hisChildren[ 0 ] = new String255( "John" );
hisChildren[ 1 ] = new String255( "Mary" );
hisChildren[ 2 ] = new String255( "Mike" );

params = new Object[ 2 ];
params[ 0 ] = new Boolean( sex ); // 第1パラメタ
params[ 1 ] = name; // 第2パラメタ
resultObj = server.call4DMethod( "TestMethod1", params, 0 );
hisAge = ( (Integer)resultObj).intValue(); // 結果を受け取る
params = new Object[ 3 ];
params[ 0 ] = new Boolean( sex ); // 第1パラメタ
params[ 1 ] = name; // 第2パラメタ
params[ 2 ] = hisChildren; // 第3パラメタ
resultObj = server.call4DMethod( "TestMethod2", params, 0 );
hisSalary = (int[])resultObj; // 結果を受け取る
resultObj = server.call4DMethod( "TestMethod3", params, 0 );
resultArray = (Object[])resultObj;
hisAge = ( (Integer)( resultArray[ 0 ] ) ).intValue(); // 結果を受け取る
hisSalary = (int[])( resultArray[ 1 ] ); // 結果を受け取る
server.disconnect();

}catch( Exception e ) { System.err.println( "" + e ); }
}
..........
..........
}

クラス com.ronri_kobo.Time

java.lang.Object
|
+----com.ronri_kobo.Time

public class Time extends java.lang.Object implements java.io.Serializable

このクラスは、4DのTIME型に対応するJavaクラスです。

コンストラクタ Time

public Time(int hour, int min, int sec)

このメソッドは、Timeクラスのコンストラクタで、Timeクラスのオブジェクトを生成し、パラメタで指定された値(時間 (0-23)、分 (0-59)、秒 (0-59))でそのオブジェクトを初期化します。

インスタンスメソッド getHours

public int getHours()

このメソッドは、Timeクラスのオブジェクトの「時間」を返します。

インスタンスメソッド getMinutes

public int getMinutes()

このメソッドは、Timeクラスのオブジェクトの「分」を返します。

インスタンスメソッド getSeconds

public int getSeconds()

このメソッドは、Timeクラスのオブジェクトの「秒」を返します。

インスタンスメソッド setHours

public void setHours(int hour)

このメソッドは、Timeクラスのオブジェクトに「時間」をセットします。

インスタンスメソッド setMinutes

public void setMinutes(int min)

このメソッドは、Timeクラスのオブジェクトに「分」をセットします。

インスタンスメソッド setSeconds

public void setSeconds(int sec)

このメソッドは、Timeクラスのオブジェクトに「秒」をセットします。


クラス com.ronri_kobo.Date

java.lang.Object
|
+----com.ronri_kobo.Date

public class Date extends java.lang.Object implements java.io.Serializable

このクラスは、4DのDATE型に対応するJavaクラスです。

コンストラクタ Date

public Date(int year, int month, int date)

このメソッドは、Dateクラスのコンストラクタで、Dateクラスのオブジェクトを生成し、パラメタで指定された値(年(0- 32767)、月(1-12)、日 (1-31))でそのオブジェクトを初期化します。

インスタンスメソッド getYear

public int getYear()

このメソッドは、Dateクラスのオブジェクトの「年」を返します。

インスタンスメソッド getMonth

public int getMonth()

このメソッドは、Dateクラスのオブジェクトの「月」を返します。

インスタンスメソッド getDate

public int getDate()

このメソッドは、Dateクラスのオブジェクトの「月」を返します。

インスタンスメソッド setYear

public void setYear(int year)

このメソッドは、Dateクラスのオブジェクトに「年」をセットします。

インスタンスメソッド setMonth

public void setMonth(int month)

このメソッドは、Dateクラスのオブジェクトに「月」をセットします。

インスタンスメソッド setDate

public void setDate(int date)

このメソッドは、Dateクラスのオブジェクトに「日」をセットします。


クラス com.ronri_kobo.String255

java.lang.Object
|
+----com.ronri_kobo.String255

public class String255 extends java.lang.Object implements java.io.Serializable

このクラスは、4DのSTRING型に対応するJavaクラスです。

コンストラクタ String255

public String255(java.lang.String str)

このメソッドは、String255クラスのコンストラクタで、String255クラスのオブジェクトを生成し、パラメタで指定 された文字列でそのオブジェクトを初期化します。指定された文字列が255バイトを超えた場合は、255バイトにカットします。