TSCObjectの実行空間の構成

TSCRootAcceptorの実行空間でTSCObjectを実行させる場合，例えば，TSCRootAcceptorの管理するスレッド上でTSCObjectを実行させる場合，そのTSCObjectに対応するTSCAcceptorをTSCRootAcceptorに登録します。TSCRootAcceptorには複数のTSCAcceptorを登録できます。

提供するサービスの管理

TSCRootAcceptorには複数のTSCAcceptorを登録できます。TSCRootAcceptorは，各TSCAcceptorの複数のTSCサービス識別子を集め，かつ，重複を削除したものを属性として管理します。TSCRootAcceptorが提供できるサービスの種類は，このTSCサービス識別子によって表現されます。つまり，TSCサービス識別子の列で表されるサービスを提供することになります。

TSCルートアクセプタ状態ごとのスレッドの管理方式

TSCルートアクセプタ状態にはactive状態とnon-active状態の2種類があります。各状態の遷移中の場合も含めて，それぞれの状態のときのスレッドの管理方式を次に示します。

• non-active状態
  non-active状態のオブジェクトが管理するスレッドはありません。
  non-active状態のときは，TSCAcceptorの登録および削除ができます。TSCAcceptorの登録時には，登録識別子が返されます。TSCAcceptorを削除するときには，その登録識別子を指定します。
  TSCRootAcceptorを生成した時点ではnon-active状態です。
  
• non-active状態からactive状態に遷移中
  パラレルカウント数と同数のスレッドを生成します。また，登録されているすべてのTSCAcceptorにオブジェクト管理開始通知を出します。すべてのTSCAcceptorがオブジェクトの管理を開始したあと，クライアント側からのTSCユーザオブジェクト呼び出し要求を受け付けることができます。
  
• active状態
  クライアント側にサービスを提供できる状態です。クライアント側からTSCユーザオブジェクト呼び出し要求を受け取ると，適切なTSCAcceptorに振り分けます。non-active状態からactive状態に遷移するときに生成されたスレッドはTSCRootAcceptorに管理されています。ユーザは，TSC経由以外でこれらのTSCユーザオブジェクトにアクセスしないでください。また，active状態のときは，TSCAcceptorの登録および削除はできません。
  
• active状態からnon-active状態に遷移中
  登録されているすべてのTSCAcceptorにオブジェクト管理終了通知を出します。また，TSCRootAcceptorの管理下にあるスレッドを削除します。
  

active状態での障害通知

サーバアプリケーション内やTSCデーモンとの接続に障害が発生してスレッドが存続できなくなる場合，そのスレッド上でオブジェクト管理終了通知をTSCAcceptorに渡します。その後，そのスレッドを削除します。なお，このときはまだactive状態です。

障害が解除されると，再度，スレッドを生成します。その後，そのスレッド上でオブジェクト管理開始通知をTSCAcceptorに渡します。つまり，障害が発生してから解除されるまでの間は，TSCRootAcceptorは，スレッド数がパラレルカウント（常駐するスレッド数）以下の状態で存続します。

TSCRootAcceptorがactive状態に遷移すると，TSCRootAcceptorと関連づけられているTSCServerにTSCルートアクセプタ登録名称が登録されます。以降，クライアント側のメソッド呼び出し要求がTSCRootAcceptorに振り分けられるようになります。

TSCRootAcceptorをactive状態に遷移させるときに，TSCルートアクセプタ登録名称を指定することもできます。activateの呼び出し時に，TSCルートアクセプタ登録名称を指定する場合と指定しない場合について，それぞれ次に示します。

• TSCルートアクセプタ登録名称を指定してactivateを呼び出した場合
  TSCルートアクセプタ登録名称を"abc"とすると，関連づけられているTSCServerに"abc"として，登録されます。
  
• TSCルートアクセプタ登録名称を指定しないでactivateを呼び出した場合
  関連づけられているTSCServerに，デフォルトのTSCルートアクセプタ登録名称で登録されます。デフォルトのTSCルートアクセプタ登録名称は"default"ですが，サーバアプリケーションの開始時に指定するコマンドオプション引数-TSCRootAcceptorによって変更できます。
  

また，同じTSCルートアクセプタ登録名称で，TSCRootAcceptorを同じTSCデーモンに登録できます。同じTSCルートアクセプタ登録名称で登録した場合，スケジュール用キュー（配送機構）が共有されます。ただし，スケジュール用キューを共有する場合，登録するTSCRootAcceptor間で提供できるサービス内容が一致している必要があります。つまり，同じTSCルートアクセプタ登録名称で登録するTSCRootAcceptorは，同じTSCサービス識別子の列を持っている必要があります。

TSCThreadFactoryを引数としてTSCRootAcceptorを生成した場合を前提にします。この場合，TSCRootAcceptorは，non-active状態からactive状態に遷移する過程でスレッドを生成したあと，TSCThreadFactoryのcreateを呼び出して，戻り値であるTSCThreadをそのスレッドに割り当てます。また，active状態からnon-active状態に遷移する過程で，スレッドごとに割り当てたTSCThreadを引数にTSCThreadFactoryのdestroyを呼び出したあと，スレッドを削除します。

 
package JP.co.Hitachi.soft.TPBroker.TSC;
 
public class TSCRootAcceptor
{
 
  public static TSCRootAcceptor create(TSCServer tsc_server);
  
  public static TSCRootAcceptor create(TSCServer tsc_server,
                                TSCThreadFactory tsc_thr_fact);
 
 
  //TSCAcceptorの追加
  public int registerAcceptor(TSCAcceptor tsc_acpt);
  
  //TSCAcceptorの削除
  public void cancelAcceptor(int reg_id);
  
  //パラレルカウントの設定
  public void setParallelCount(int p_count);
  public int getParallelCount();
  
  //TSCRootAcceptorの活性化
  public int activate();
  public int activate(String rt_acpt_req_name);
  
  //TSCRootAcceptorの非活性化
  public int deactivate();
 
  //スケジュール用キュー長の設定
  public void setQueueLength(int length);
  public int getQueueLength();
};

 
import JP.co.Hitachi.soft.TPBroker.TSC.TSCRootAcceptor;

●public static TSCRootAcceptor create(TSCServer tsc_server)

項目	型・意味
引数	TSCServer tsc_server	接続したTSCServer
戻り値	生成されたTSCRootAcceptor
例外	TSCBadParamException TSCNoMemoryException

tsc_serverと関連づけられた，TSCRootAcceptorオブジェクトを生成します。

引数で渡すTSCServerの解放責任はユーザにあるので，適切な状態のときに解放してください。

なお，このメソッドを複数のスレッド上から同時に呼び出すことができます。

●public static TSCRootAcceptor create(TSCServer tsc_server,

                                                           TSCThreadFactory tsc_thr_fact)
 

項目	型・意味
引数	TSCServer tsc_server	接続したTSCServer
	TSCThreadFactory tsc_thr_fact	TSCユーザスレッドファクトリ
戻り値	生成されたTSCRootAcceptor
例外	TSCBadParamException TSCNoMemoryException

tsc_serverと関連づけられた，tsc_thr_factを保持するTSCRootAcceptorオブジェクトを生成します。

引数で渡すTSCServerの解放責任はユーザにあるので，適切な状態のときに解放してください。

なお，このメソッドを複数のスレッド上から同時に呼び出すことができます。

●public int registerAcceptor(TSCAcceptor tsc_acpt)

項目	型・意味
引数	TSCAcceptor tsc_acpt	登録するTSCAcceptor
戻り値	TSCユーザアクセプタの登録識別子（正数）
例外	TSCBadParamException TSCNoPermissionException

TSCAcceptorを登録します。activeの状態のときは登録できません。

●public void cancelAcceptor(int reg_id)

項目	型・意味
引数	int reg_id	削除するTSCの登録識別子
戻り値	ありません。
例外	TSCBadParamException TSCNoPermissionException

TSCAcceptorの登録を削除します。reg_idにはregisterAcceptorで戻された値を指定してください。activate状態のときは登録を削除できません。

なお，このメソッドを複数のスレッド上から同時に呼び出すことはできません。

●public void setParallelCount(int p_count)

項目	型・意味
引数	int p_count	パラレルカウント
戻り値	ありません。
例外	TSCBadParamException TSCNoPermissionException

パラレルカウント（常駐するスレッド数）を設定します。

サーバアプリケーションの開始時にコマンドオプション引数-TSCParallelCountを指定しない場合，パラレルカウントのデフォルト値は"1"です。コマンドオプション引数-TSCParallelCountを指定する場合は，パラレルカウントのデフォルト値はその指定値となります。

なお，このメソッドを複数のスレッド上から同時に呼び出すことはできません。

●public int getParallelCount()

項目	型・意味
戻り値	パラレルカウント

パラレルカウント（常駐するスレッド数）を取得します。

なお，このメソッドを複数のスレッド上から同時に呼び出すことができます。

●public int activate()

項目	型・意味
戻り値	常に0
例外	TSCBadInvOrderException TSCCommFailureException TSCInternalException TSCNoMemoryException TSCNoPermissionException TSCNoResourcesException ユーザが通知する各種例外

デフォルトのTSCルートアクセプタ登録名称で，active状態に遷移します。

サーバアプリケーションの開始時に指定するコマンドオプション引数-TSCRootAcceptorを指定しない場合，TSCルートアクセプタ登録名称のデフォルト値は"default"です。コマンドオプション引数-TSCRootAcceptorを指定した場合，TSCルートアクセプタのデフォルト値はその指定値となります。

なお，このメソッドを複数のスレッド上から同時に呼び出すことはできません。

●public int activate(String rt_acpt_req_name)

項目	型・意味
引数	String rt_acpt_req_name	TSCルートアクセプタの登録名称
戻り値	常に0
例外	TSCBadInvOrderException TSCBadParamException TSCCommFailureException TSCInternalException TSCNoMemoryException TSCNoPermissionException TSCNoResourcesException ユーザが通知する各種例外

指定したTSCルートアクセプタ登録名称で，active状態に遷移します。rt_acpt_nameに文字列を指定する場合，1〜31文字で指定してください。

なお，このメソッドを複数のスレッド上から同時に呼び出すことはできません。

●public int deactivate()

項目	型・意味
戻り値	ありません。
例外	TSCBadInvOrderException TSCCommFailureException TSCInternalException TSCNoMemoryException TSCNoPermissionException

deactive状態に遷移します。

なお，このメソッドを複数のスレッド上から同時に呼び出すことはできません。

●public void setQueueLength(int_length)

項目	型・意味
引数	int length	スケジュール用キューの長さ
戻り値	ありません。
例外	TSCBadParamException TSCNoPermissionException

生成するスケジュール用キューの長さを指定します。指定できる範囲は1〜32767です。active状態のときは指定できません。

このメソッドでスケジュール用キューの長さを指定しない場合，生成されるスケジュール用キューの長さは，tscstartprcコマンドまたはサーバアプリケーションの開始コマンドの-TSCQueueLengthオプションで指定した長さになります。スケジュール用キューを共有する場合，すでに生成されているスケジュール用キューの長さが有効になります。

なお，このメソッドを複数のスレッド上から同時に呼び出すことはできません。

●public int getQueueLength()

項目	型・意味
戻り値	スケジュール用キューの長さ

non-active状態の場合は，setQueueLength()メソッド，またはtscstartprcコマンドもしくはサーバアプリケーションの開始コマンドの-TSCQueueLengthオプションで指定したスケジュール用キューの長さを取得します。setQueueLength()メソッドが未発行で，かつtscstartprcコマンドまたはサーバアプリケーションの開始コマンドの-TSCQueueLengthオプションが指定されていないときの戻り値は"0"となります。

active状態の場合は，現在有効になっているスケジュール用キューの長さを取得します。

なお，このメソッドを複数のスレッド上から同時に呼び出すことができます。

TSCServerを引数に指定したTSCRootAcceptorのcreateで生成します。

マルチスレッド環境で，TSCRootAcceptorクラスのインスタンスのメソッドを呼び出す規則を次に示します。

メソッド	複数のスレッド上からの同時呼び出し
create(TSCServer)	○
create(TSCServer, TSCThreadFactory)	○
registerAcceptor	×
cancelAcceptor	×
setParallelCount	×
getParallelCount	○
activate()	×
activate(String)	×
deactivate()	×
setQueueLength	×
getQueueLength	○

（凡例）

○：できます。

×：できません。

TSCRootAcceptorクラスのインスタンスがほかのクラスのインスタンスを内部参照（アクセス）する規則を次に示します。

メソッド	内部参照
registerAcceptor	ありません。
cancelAcceptor	ありません。
setParallelCount	ありません。
getParallelCount	ありません。
activate()	生成時に指定されたTSCServer型のインスタンス 登録されているTSCAcceptor型のインスタンス
activate(String)	生成時に指定されたTSCServer型のインスタンス 登録されているTSCAcceptor型のインスタンス
deactivate()	生成時に指定されたTSCServer型のインスタンス 登録されているTSCAcceptor型のインスタンス
setQueueLength	ありません。
getQueueLength	ありません。
active状態	registerAcceptorの引数で指定されたTSCAcceptor型のインスタンス（TSCRootAcceptorに登録されているTSCAcceptor型のインスタンス）

TSCRootAcceptorクラスのインスタンスがほかのクラスのインスタンスの公開メソッドを呼び出す規則を次に示します。

メソッド	公開メソッド呼び出し
activate()	生成時に指定されたTSCThreadFactory型のインスタンス
activate(String)	生成時に指定されたTSCThreadFactory型のインスタンス
deactivate()	生成時に指定されたTSCThreadFactory型のインスタンス

複数のスレッド上から同時に，TSCRootAcceptorクラスの同じインスタンスを内部参照できます。