xref: /aoo4110/main/offapi/com/sun/star/sdb/DatabaseAccessContext.idl (revision b1cdbd2c)

/**************************************************************
 *
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you under the Apache License, Version 2.0 (the
 * "License"); you may not use this file except in compliance
 * with the License.  You may obtain a copy of the License at
 *
 *   http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing,
 * software distributed under the License is distributed on an
 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 * KIND, either express or implied.  See the License for the
 * specific language governing permissions and limitations
 * under the License.
 *
 *************************************************************/


#ifndef __com_sun_star_sdb_DatabaseAccessContext_idl__
#define __com_sun_star_sdb_DatabaseAccessContext_idl__

#ifndef __com_sun_star_container_XEnumerationAccess_idl__
#include <com/sun/star/container/XEnumerationAccess.idl>
#endif

#ifndef __com_sun_star_container_XNameAccess_idl__
#include <com/sun/star/container/XNameAccess.idl>
#endif

#ifndef __com_sun_star_util_XLocalizedAliases_idl__
#include <com/sun/star/util/XLocalizedAliases.idl>
#endif

#ifndef __com_sun_star_lang_XLocalizable_idl__
#include <com/sun/star/lang/XLocalizable.idl>
#endif

 module com {  module sun {  module star {  module sdb {

/** is the context for data access beans. It allows to register aliases for database
	access beans. It is possible to have different aliases for different locales.


	<p>
	A DatabaseContext stores an alias for the URL of a database access component
	for a given locale. It is also allowed to work with a default locale. This is useful
	in connection with Enumeration or NameAccess to the context. In common use, the
	default language is set during the initialization of the component.
	</p>
	<p>
	The service also provides a default handling for locales, where an alias isn't
	set. The first time an alias is registered for a programmatic name, the alias
	becomes the default for all other known locales.

	</p>@see com::sun::star::util::XLocalizedAliases

    @deprecated
 */
published service DatabaseAccessContext
{
	/** Enumeration on all registered data sources for a default locale.
	 */
	interface com::sun::star::container::XEnumerationAccess;

	/** NameAccess on all registered data sources for a default locale.
	 */
	interface com::sun::star::container::XNameAccess;

	/** Interface for registering aliases for data sources.
	 */
	interface com::sun::star::util::XLocalizedAliases;

	/** Interface for setting and retrieving the default language.
	 */
	interface com::sun::star::lang::XLocalizable;
};

//=============================================================================

}; }; }; };

/*===========================================================================
===========================================================================*/
#endif