=================================================================== RCS file: /home/cvs/OpenXM/src/OpenMath/ORG/openxm/tam/OpenXM.java,v retrieving revision 1.1 retrieving revision 1.5 diff -u -p -r1.1 -r1.5 --- OpenXM/src/OpenMath/ORG/openxm/tam/OpenXM.java 2000/09/07 10:41:34 1.1 +++ OpenXM/src/OpenMath/ORG/openxm/tam/OpenXM.java 2000/10/11 08:32:15 1.5 @@ -1,5 +1,5 @@ /** - * $OpenXM$ + * $OpenXM: OpenXM/src/OpenMath/ORG/openxm/tam/OpenXM.java,v 1.4 2000/09/13 06:32:43 tam Exp $ */ package ORG.openxm.tam; @@ -8,15 +8,21 @@ import java.net.*; /** - * OpenXM サーバとの接続を行なう抽象クラス + * OpenXM サーバとの接続を行なうクラス. * クライアント側が使用する. + * 接続するサーバ毎に一つの OpenXM クラスが必要. */ public class OpenXM{ - private OpenXMconnection control = null, stream = null; + private OpenXMstream control = null, stream = null; final protected boolean debug = false; + /** + * OpenXM サーバとの接続を TCP/IP ソケットを用いて行なう. + * マシン名 host のポート番号 CtrlPort にコントロールを, + * ポート番号 StreamPort にデータ用の接続を行なう. + */ public OpenXM(String host,int CtrlPort,int StreamPort) throws IOException{ - control = new OpenXMconnection(host,CtrlPort); + control = new OpenXMstream(host,CtrlPort); try{ Thread.sleep(100); // We need a few wait for starting up server. @@ -24,14 +30,14 @@ public class OpenXM{ System.err.println(e.getMessage()); } - stream = new OpenXMconnection(host,StreamPort); + stream = new OpenXMstream(host,StreamPort); control.sendByteOrder(); stream.sendByteOrder(); } /** - * 接続の reset を行なう. 現在は未実装. + * 接続の初期化を行なう. 現在は未実装. */ public synchronized void resetConnection(){ debug("control: stopping computer process..."); @@ -39,23 +45,28 @@ public class OpenXM{ } /** - * OpenXM メッセージを送信する. ただし、このメソッドは - * ボディの部分だけでよい. ヘッダの部分は自動で付加される. + * OpenXM メッセージをデータストリームに送信する. + * このメソッドはメッセージのボディの部分だけでよい. + * ヘッダ部分は自動で付加される. + */ public void send(OXbody object) throws IOException,MathcapViolation{ stream.send(object); } /** - * OpenXM メッセージを受け取る. + * データストリームから OpenXM メッセージを受け取る. */ public OXmessage receive() throws IOException{ return stream.receive(); } /** - * MathCap を mathcap に設定する. - * 以後, mathcap に反した CMO を送ると - * MathcapViolation が発生する. + * データストリームの MathCap を mathcap に設定する. + * 以後, 送信するオブジェクトは mathcap に合っているかどうか + * チェックが入る. 実際にチェックが入るかどうかは + * OXbody クラスの派生クラスの実装による. + * mathcap に反したオブジェクトを送ろうとした時には, + * 以後 MathcapViolation が発生することが期待される. */ public void setMathCap(CMO_MATHCAP mathcap){ stream.setMathCap(mathcap); @@ -76,7 +87,7 @@ public class OpenXM{ for(int i=0;i