/*
 * bonobo-item-container.idl: Implements a generic container for objects
 *
 * Copyright (C) 2000  Helix Code, Inc.
 *
 * Author:
 *	Miguel de Icaza (miguel@helixcode.com)
 */

#ifndef BONOBO_ITEM_CONTAIER_IDL
#define BONOBO_ITEM_CONTAIER_IDL

#include "Bonobo_Unknown.idl"

module Bonobo {

	interface ItemContainer : Unknown {
		typedef sequence<string> ObjectNames;

		/**
		 * enumObjects:
		 *
		 * Returns: a list of names of contained objects
		 */
		ObjectNames enumObjects ();

		/**
		 * NotFound{}:
		 * 
		 * This exception is raised if the specified name could not
		 * be found
		 */
		exception NotFound {};

		/**
		 * SyntaxError{}:
		 *
		 * This exception is launched if there is a syntax error
		 * during the name parsing
		 */
		exception SyntaxError {};

		/**
		 * getObjectByName:
		 * @item_name: Item name to bind to
		 * @only_if_exists: if TRUE, only bind if this object currently exists
		 * otherwise, it will try to create the server for it.
		 */
		Unknown getObjectByName (in string  item_name,
					 in boolean only_if_exists)
			raises (SyntaxError, NotFound);
	};
};

#endif /* BONOBO_ITEM_CONTAIER_IDL */
