1d1766043SAndrew Rist/************************************************************** 2cdf0e10cSrcweir * 3d1766043SAndrew Rist * Licensed to the Apache Software Foundation (ASF) under one 4d1766043SAndrew Rist * or more contributor license agreements. See the NOTICE file 5d1766043SAndrew Rist * distributed with this work for additional information 6d1766043SAndrew Rist * regarding copyright ownership. The ASF licenses this file 7d1766043SAndrew Rist * to you under the Apache License, Version 2.0 (the 8d1766043SAndrew Rist * "License"); you may not use this file except in compliance 9d1766043SAndrew Rist * with the License. You may obtain a copy of the License at 10d1766043SAndrew Rist * 11d1766043SAndrew Rist * http://www.apache.org/licenses/LICENSE-2.0 12d1766043SAndrew Rist * 13d1766043SAndrew Rist * Unless required by applicable law or agreed to in writing, 14d1766043SAndrew Rist * software distributed under the License is distributed on an 15d1766043SAndrew Rist * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 16d1766043SAndrew Rist * KIND, either express or implied. See the License for the 17d1766043SAndrew Rist * specific language governing permissions and limitations 18d1766043SAndrew Rist * under the License. 19d1766043SAndrew Rist * 20d1766043SAndrew Rist *************************************************************/ 21d1766043SAndrew Rist 22d1766043SAndrew Rist 23cdf0e10cSrcweir#ifndef __com_sun_star_sdbc_JDBCConnectionProperties_idl__ 24cdf0e10cSrcweir#define __com_sun_star_sdbc_JDBCConnectionProperties_idl__ 25cdf0e10cSrcweir 26cdf0e10cSrcweir#ifndef __com_sun_star_sdbc_ConnectionProperties_idl__ 27cdf0e10cSrcweir#include <com/sun/star/sdbc/ConnectionProperties.idl> 28cdf0e10cSrcweir#endif 29cdf0e10cSrcweir#ifndef __com_sun_star_beans_NamedValue_idl__ 30cdf0e10cSrcweir#include <com/sun/star/beans/NamedValue.idl> 31cdf0e10cSrcweir#endif 32cdf0e10cSrcweir 33cdf0e10cSrcweirmodule com { module sun { module star { module sdbc { 34cdf0e10cSrcweir 35cdf0e10cSrcweir/** represents the properties for a JDBC connection (session) with a specific 36cdf0e10cSrcweir database. These properties can be used when calling the method 37cdf0e10cSrcweir <member scope="com::sun::star::sdbc">XDriver::connect()</member> or 38cdf0e10cSrcweir <member scope="com::sun::star::sdbc">XDriverManager::getConnectionWithInfo()</member>. 39cdf0e10cSrcweir 40cdf0e10cSrcweir <p> 41cdf0e10cSrcweir The properties for a connection contain additonal information about how to connect to a database and 42cdf0e10cSrcweir how to control the behavior of the resulting connection should be. 43cdf0e10cSrcweir 44cdf0e10cSrcweir </p> 45cdf0e10cSrcweir @see com::sun::star::sdbc::XDriver 46cdf0e10cSrcweir @see com::sun::star::sdbc::XDriverManager 47cdf0e10cSrcweir @see com::sun::star::sdbc::ConnectionProperties 48cdf0e10cSrcweir */ 49cdf0e10cSrcweirservice JDBCConnectionProperties 50cdf0e10cSrcweir{ 51cdf0e10cSrcweir service com::sun::star::sdbc::ConnectionProperties; 52cdf0e10cSrcweir 53cdf0e10cSrcweir /** which jdbc driver class should be loaded to create the connection. 54cdf0e10cSrcweir 55cdf0e10cSrcweir @see com::sun::star::sdbc::JDBCConnectionProperties::JavaDriverClassPath 56cdf0e10cSrcweir */ 57cdf0e10cSrcweir [optional, property] string JavaDriverClass; 58cdf0e10cSrcweir 59cdf0e10cSrcweir /** an optional class path to locate the <member 60cdf0e10cSrcweir scope="com::sun::star::sdbc">JDBCConnectionProperties::JavaDriverClass 61cdf0e10cSrcweir </member>. 62cdf0e10cSrcweir 63cdf0e10cSrcweir <p>The class path is a list of zero or more internal (see the 64cdf0e10cSrcweir <type scope="com::sun::star::uri">ExternalUriReferenceTranslator</type> 65cdf0e10cSrcweir service) URI references, where any space characters 66cdf0e10cSrcweir (<code>U+0020</code>) are ignored (and, in particular, separate adjacent 67cdf0e10cSrcweir URI references). Any “vnd.sun.star.expand” URL references 68cdf0e10cSrcweir in the list are expanded using the 69cdf0e10cSrcweir <type scope="com::sun::star::util">theMacroExpander</type> 70cdf0e10cSrcweir singleton.</p> 71cdf0e10cSrcweir 72*96af39f7SJürgen Schmidt @since OpenOffice 2.3 73cdf0e10cSrcweir */ 74cdf0e10cSrcweir [optional, property] string JavaDriverClassPath; 75cdf0e10cSrcweir 76cdf0e10cSrcweir /** specifies a set of properties to pass to <code>java.lang.System.setProperty</code> before 77cdf0e10cSrcweir loading the system's JDBC driver. 78cdf0e10cSrcweir */ 79cdf0e10cSrcweir [optional, property] sequence< ::com::sun::star::beans::NamedValue > SystemProperties; 80cdf0e10cSrcweir 81cdf0e10cSrcweir /** specifies if retrieving of auto generated values should be enabled or not. 82cdf0e10cSrcweir If <TRUE/> than the statement will support the XGeneratedResultSet (future concept) interface, otherwise not. 83cdf0e10cSrcweir */ 84cdf0e10cSrcweir [optional, property] boolean IsAutoRetrievingEnabled; 85cdf0e10cSrcweir 86cdf0e10cSrcweir /** specifies the statement which should be executed 87cdf0e10cSrcweir when asking an "INSERT" statement for the XGeneratedResultSet (future concept) interface. 88cdf0e10cSrcweir */ 89cdf0e10cSrcweir [optional, property] string AutoRetrievingStatement; 90cdf0e10cSrcweir 91cdf0e10cSrcweir /** specifies how the type info returned by <member scope="com::sun::star::sdbc">XDatabaseMetaData::getTypeInfo()</member> will be modified. 92cdf0e10cSrcweir <p>The sequence contains an even amount of string values. Each pair describes 93cdf0e10cSrcweir <li>what should be searched for and </li> 94cdf0e10cSrcweir <li>what should be replaced if found.</li> 95cdf0e10cSrcweir <br> 96cdf0e10cSrcweir The syntax is: 97cdf0e10cSrcweir <p> 98cdf0e10cSrcweir <li>COLUMN(2) = -5</li> 99cdf0e10cSrcweir <li>COLUMN(6) = PRECISION</li> 100cdf0e10cSrcweir </p> 101cdf0e10cSrcweir COLUMN(X) defines the column which will be compared and the column which will be replaced. In the example above column 2 will be compared 102cdf0e10cSrcweir with the value -5. If this is true than column 6 will now return the value PRECISION. 103cdf0e10cSrcweir </p> 104cdf0e10cSrcweir */ 105cdf0e10cSrcweir [optional, property] sequence< any > TypeInfoSettings; 106cdf0e10cSrcweir}; 107cdf0e10cSrcweir 108cdf0e10cSrcweir//============================================================================= 109cdf0e10cSrcweir 110cdf0e10cSrcweir}; }; }; }; 111cdf0e10cSrcweir 112cdf0e10cSrcweir/*=========================================================================== 113cdf0e10cSrcweir 114cdf0e10cSrcweir===========================================================================*/ 115cdf0e10cSrcweir#endif 116