/**
 * 最初の著者:: トゥイー
 * リポジトリ情報:: $Id: MultiRelationController.hpp 11 2011-05-14 02:11:18Z yutaka_at_home $
 * 著作権:: Copyright (C) Ownway.info, 2011. All rights reserved.
 * ライセンス:: CPL(Common Public Licence)
 */

#ifndef _UTILITY_MULTI_RELATION_CONTROLLER_HPP_
#define _UTILITY_MULTI_RELATION_CONTROLLER_HPP_

#include "tops/utilities/CloseContainer/RelationController.hpp"

#include <map>

namespace Utility {

	/**
	 * 複数の密コンテナとの密関連を許す複数コンテナ密関連制御クラスです。
	 * ただし、一つの密コンテナとは一つの密関連しかできません。
	 * 既に密関連済みの密コンテナと密関連した場合、
	 * 以前の密関連を破棄し、新しい密関連を構築します。
	 *
	 * @author トゥイー
	 */
	class MultiRelationController : public RelationController {
	private:
		typedef std::map<CloseContainer*, CloseRelationPtr> RelationMap;
		RelationMap m_relations;

	public:
		/**
		 * 密関連制御オブジェクトを構築します。
		 */
		MultiRelationController();

		/**
		 * 密関連制御オブジェクトを破棄します。
		 */
		~MultiRelationController();

	public:
		/**
		 * 密関連しているかどうかを判断します。
		 *
		 * @return 密関連している場合は true、それ以外の場合は false。
		 */
		bool isOwned() const;

		/**
		 * 対象密コンテナを指定して、密関連しているかどうかを判断します。
		 *
		 * @param owner 密コンテナ。
		 * @return 対象密コンテナと密関連している場合は true、それ以外の場合は false。
		 */
		bool isOwned(CloseContainer& owner) const;

		/**
		 * 密関連を解放します。密関連していない場合は何もしません。
		 * このメソッドは、密コンテナ要素が全ての密関連を解放するときに呼び出されます。
		 */
		void release();

		/**
		 * 対象密コンテナを指定して密関連を解放します。
		 * 対象密コンテナと密関連していない場合は何もしません。
		 * このメソッドは、密コンテナ要素が特定の密コンテナと密関連を解放するときに呼び出されます。
		 *
		 * @param from 密コンテナ。
		 */
		void release(CloseContainer& from);

		/**
		 * 密関連を追加します。
		 * このメソッドは、密コンテナ要素が密コンテナ要素と密関連するときに呼び出されます。
		 *
		 * @param relation 密関連。
		 */
		void addRelation(const CloseRelationPtr& relation);
	};

}  // namespace Utility

#endif
