/*
このファイルの中身は、NTT オープンソースライセンス　バージョン 1.0（「本
契約」という）の適用を受けます。
本契約を遵守しない限り、このファイルを使用してはなりません。
本契約のコピーは、次のＵＲＬから入手できます。
【配布サイトのURL】 http://www.oss.ecl.ntt.co.jp/lms/

本契約に基づき頒布されるソフトウェアは、現状のまま、明示又は黙示のあらゆ
る種類の保証なしで、頒布されます。本契約に基づく権利及び制限を律する特定
の文言については、本契約を参照してください。

「オリジナルコード」は、 NTT Cyber Space Laboratories Code です。 
「オリジナルコード」の「初期開発者」は、日本電信電話株式会社です。  
日本電信電話株式会社により創作された部分は、Copyright (C) 2004 
日本電信電話株式会社 です。
全ての権利が留保されます。 
「コントリビュータ」：_____________________________________ 


The contents of this file are subject to the NTT Opensource License
Version 1.0 (the License); you may not use this file except in
compliance with the License. You may obtain a copy of the License at
【配布サイトのURL】 http://www.oss.ecl.ntt.co.jp/lms/

Software distributed under the License is distributed on an AS IS
basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the
License for the specific language governing rights and limitations
under the License.

The Original Code is NTT Cyber Space Laboratories Code .

The Initial Developer of the Original Code is NIPPON TELEGRAPH AND 
TELEPHONE CORPORATION.
Portions created by the NIPPON TELEGRAPH AND TELEPHONE CORPORATION 
are Copyright (C) 2004 NIPPON TELEGRAPH AND TELEPHONE CORPORATION. 
All Rights Reserved.

Contributor(s) ______________________________________.
*/

//
//	Role 役割情報保持クラス
//			変更履歴
//				2004/01/08	新規作成	柴田宗近
//
package jp.co.ntt.lms.xms.login.base;

import java.util.Vector;

import jp.co.ntt.lms.xmo.Roles.RolesClient;
import jp.co.ntt.lms.xms.framework.XmsException;
import jp.co.ntt.lms.xms.framework.XmsSystemException;

/**
 * 役割情報保持クラス。<BR>
 * 
 * 役割（Role）情報を取得、保持します。<BR>
 * 
 */
public class Role {

	/**
	 * ロールID<BR>
	 */
	private String roleID = null;

	/**
	 * ロール名<BR>
	 */
	private String roleName = null;

	/**
	 * XMO保持クラスリスト<BR>
	 */
	private Vector XMOList = null;

	/**
	 * コンストラクタ
	 * @param roleID ロールID
	 */
	public Role( String roleID ) {
	
		// ロールID
		this.roleID = roleID;
	}

	/**
	 * 権限情報保持クラスリストを取得します。<BR>
	 * @return Vector 権限情報保持クラスリスト
	 */
	public Vector getXMOList() {

		// 権限情報保持クラスリスト
		return this.XMOList;
	}

	/**
	 * 役割情報保持クラスを初期化します。<BR>
	 * <PRE>
	 * 1. コンストラクタによって設定されたロールIDで
	 *    RoleテーブルとRolesFunctionテーブルを検索します
	 * 2. 各プロパティに取得したデータを設定します
	 * </PRE>
	 * @return なし
	 * @exception XmsSystemException  システムエラー
	 */
	public void load() 
		throws XmsException {
			
		// 権限管理XMOクライアントのインスタンス化
		RolesClient rolesObject = null;
		try {
			rolesObject = new RolesClient();
	
			// ユーザに割り当てられている権限IDから権限情報を検索するための検索条件設定を行います
			// ロールIDをキーにする
			rolesObject.setWhereRoleID( this.roleID );
	
			// 検索処理
			//	ロールIDをキーにして、RolesテーブルとRolesFunctionテーブルを検索する
			if( rolesObject.select() == false ) {
				// ＸＭＯアクセス時で処理が失敗した場合
				// システムエラーとする
				throw new XmsSystemException( rolesObject.getMessage() );
			}
		}
		catch(XmsException ex) {
			throw ex;	
		}
		catch(Exception ex) {
			throw new XmsSystemException(ex);	
		}

		// 一時的なXMOリスト
		Vector XMOTempList = new Vector();

		// データがあるかどうか
		if( rolesObject.next() == true ) {
			// データがある場合
			this.roleName = rolesObject.getRoleName();
			
			// 権限で使用できるXMOのリスト数を取得し
			// XMOの詳細情報を取得します。
			int XmoCount = rolesObject.getFunctionCount();

			// RolesAssignmentsのFunctionのレコード数分繰り返し
			for( int j = 0; j < XmoCount; j++ ) {

				// Function（XMOID）を取得
				String XMOID = rolesObject.getFunction( j );

				// 役割情報保持クラスを生成する
				// XMOIDを設定する
				XMO XMOObject = new XMO( XMOID );
	
				// 役割情報保持クラス初期化
				XMOObject.load();
	
				// 一時的なXMOリストに追加
				XMOTempList.add( XMOObject );
			}
		}

		// プロパティに設定する
		this.XMOList = XMOTempList;
	}
	
	/**
	 * roleIDを返却する。
	 * @return String
	 */
	public String getRoleID() {
		return roleID;
	}

	/**
	 * ロール名を返却する.
	 * @return String
	 */
	public String getRoleName() {
		return roleName;
	}

}