1 /*************************************************************************
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
5 * Copyright 2008 by Sun Microsystems, Inc.
7 * OpenOffice.org - a multi-platform office productivity suite
9 * $RCSfile: JDBCConnectionProperties.idl,v $
12 * This file is part of OpenOffice.org.
14 * OpenOffice.org is free software: you can redistribute it and/or modify
15 * it under the terms of the GNU Lesser General Public License version 3
16 * only, as published by the Free Software Foundation.
18 * OpenOffice.org is distributed in the hope that it will be useful,
19 * but WITHOUT ANY WARRANTY; without even the implied warranty of
20 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21 * GNU Lesser General Public License version 3 for more details
22 * (a copy is included in the LICENSE file that accompanied this code).
24 * You should have received a copy of the GNU Lesser General Public License
25 * version 3 along with OpenOffice.org. If not, see
26 * <http://www.openoffice.org/license.html>
27 * for a copy of the LGPLv3 License.
29 ************************************************************************/
30 #ifndef __com_sun_star_sdbc_JDBCConnectionProperties_idl__
31 #define __com_sun_star_sdbc_JDBCConnectionProperties_idl__
33 #ifndef __com_sun_star_sdbc_ConnectionProperties_idl__
34 #include
<com
/sun
/star
/sdbc
/ConnectionProperties.idl
>
36 #ifndef __com_sun_star_beans_NamedValue_idl__
37 #include
<com
/sun
/star
/beans
/NamedValue.idl
>
40 module com
{ module sun
{ module star
{ module sdbc
{
42 /** represents the properties for a JDBC connection (session) with a specific
43 database. These properties can be used when calling the method
44 <member scope="com::sun::star::sdbc">XDriver::connect()</member> or
45 <member scope="com::sun::star::sdbc">XDriverManager::getConnectionWithInfo()</member>.
48 The properties for a connection contain additonal information about how to connect to a database and
49 how to control the behavior of the resulting connection should be.
52 @see com::sun::star::sdbc::XDriver
53 @see com::sun::star::sdbc::XDriverManager
54 @see com::sun::star::sdbc::ConnectionProperties
56 service JDBCConnectionProperties
58 service com
::sun
::star
::sdbc
::ConnectionProperties
;
60 /** which jdbc driver class should be loaded to create the connection.
62 @see com::sun::star::sdbc::JDBCConnectionProperties::JavaDriverClassPath
64 [optional, property
] string JavaDriverClass
;
66 /** an optional class path to locate the <member
67 scope="com::sun::star::sdbc">JDBCConnectionProperties::JavaDriverClass
70 <p>The class path is a list of zero or more internal (see the
71 <type scope="com::sun::star::uri">ExternalUriReferenceTranslator</type>
72 service) URI references, where any space characters
73 (<code>U+0020</code>) are ignored (and, in particular, separate adjacent
74 URI references). Any “vnd.sun.star.expand” URL references
75 in the list are expanded using the
76 <type scope="com::sun::star::util">theMacroExpander</type>
81 [optional, property
] string JavaDriverClassPath
;
83 /** specifies a set of properties to pass to <code>java.lang.System.setProperty</code> before
84 loading the system's JDBC driver.
86 [optional, property
] sequence
< ::com
::sun
::star
::beans
::NamedValue
> SystemProperties
;
88 /** specifies if retrieving of auto generated values should be enabled or not.
89 If <TRUE/> than the statement will support the XGeneratedResultSet (future concept) interface, otherwise not.
91 [optional, property
] boolean IsAutoRetrievingEnabled
;
93 /** specifies the statement which should be executed
94 when asking an "INSERT" statement for the XGeneratedResultSet (future concept) interface.
96 [optional, property
] string AutoRetrievingStatement
;
98 /** specifies how the type info returned by <member scope="com::sun::star::sdbc">XDatabaseMetaData::getTypeInfo()</member> will be modified.
99 <p>The sequence contains an even amount of string values. Each pair describes
100 <li>what should be searched for and </li>
101 <li>what should be replaced if found.</li>
105 <li>COLUMN(2) = -5</li>
106 <li>COLUMN(6) = PRECISION</li>
108 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
109 with the value -5. If this is true than column 6 will now return the value PRECISION.
112 [optional, property
] sequence
< any
> TypeInfoSettings
;
115 //=============================================================================
119 /*===========================================================================
121 ===========================================================================*/