1/************************************************************************* 2 * 3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 4 * 5 * Copyright 2000, 2010 Oracle and/or its affiliates. 6 * 7 * OpenOffice.org - a multi-platform office productivity suite 8 * 9 * This file is part of OpenOffice.org. 10 * 11 * OpenOffice.org is free software: you can redistribute it and/or modify 12 * it under the terms of the GNU Lesser General Public License version 3 13 * only, as published by the Free Software Foundation. 14 * 15 * OpenOffice.org is distributed in the hope that it will be useful, 16 * but WITHOUT ANY WARRANTY; without even the implied warranty of 17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 18 * GNU Lesser General Public License version 3 for more details 19 * (a copy is included in the LICENSE file that accompanied this code). 20 * 21 * You should have received a copy of the GNU Lesser General Public License 22 * version 3 along with OpenOffice.org. If not, see 23 * <http://www.openoffice.org/license.html> 24 * for a copy of the LGPLv3 License. 25 * 26 ************************************************************************/ 27#ifndef __com_sun_star_sdbc_XIsolatedConnection_idl__ 28#define __com_sun_star_sdbc_XIsolatedConnection_idl__ 29 30#ifndef __com_sun_star_task_XInteractionHandler_idl__ 31#include <com/sun/star/task/XInteractionHandler.idl> 32#endif 33 34#ifndef __com_sun_star_sdbc_SQLException_idl__ 35#include <com/sun/star/sdbc/SQLException.idl> 36#endif 37 38 module com { module sun { module star { module sdbc { 39 40 published interface XConnection; 41/** is used for establishing isolated connections via a factory. 42 <p> 43 The <type>XIsolatedConnection</type> allows to create connections which are not shared among others 44 as it is the case when creating connections in normal way. 45 </p> 46 @see com::sun::star::sdb::DataSource 47 @since OOo 1.1.2 48 */ 49published interface XIsolatedConnection: com::sun::star::uno::XInterface 50{ 51 /** attempts to establish a database connection. 52 <p>If information is missing, such as 53 a user's password, they are completed by user interaction.</p> 54 @param handler 55 The handler which ask for the needed information when they are missing. 56 @returns 57 A connection which is not shared. 58 @throws com::sun::star::sdbc::SQLException 59 when an error occurs. 60 */ 61 XConnection 62 getIsolatedConnectionWithCompletion([in]com::sun::star::task::XInteractionHandler handler) 63 raises (SQLException); 64 65 /** attempts to establish a database connection. 66 @param user 67 The user name. 68 @param password 69 The password. 70 @returns 71 A connection which is not shared. 72 @throws com::sun::star::sdbc::SQLException 73 when an error occurs. 74 */ 75 XConnection getIsolatedConnection([in]string user, [in]string password) 76 raises (SQLException); 77}; 78 79//============================================================================= 80 81}; }; }; }; 82 83/*=========================================================================== 84===========================================================================*/ 85#endif 86