1*d1766043SAndrew Rist/************************************************************** 2cdf0e10cSrcweir * 3*d1766043SAndrew Rist * Licensed to the Apache Software Foundation (ASF) under one 4*d1766043SAndrew Rist * or more contributor license agreements. See the NOTICE file 5*d1766043SAndrew Rist * distributed with this work for additional information 6*d1766043SAndrew Rist * regarding copyright ownership. The ASF licenses this file 7*d1766043SAndrew Rist * to you under the Apache License, Version 2.0 (the 8*d1766043SAndrew Rist * "License"); you may not use this file except in compliance 9*d1766043SAndrew Rist * with the License. You may obtain a copy of the License at 10*d1766043SAndrew Rist * 11*d1766043SAndrew Rist * http://www.apache.org/licenses/LICENSE-2.0 12*d1766043SAndrew Rist * 13*d1766043SAndrew Rist * Unless required by applicable law or agreed to in writing, 14*d1766043SAndrew Rist * software distributed under the License is distributed on an 15*d1766043SAndrew Rist * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 16*d1766043SAndrew Rist * KIND, either express or implied. See the License for the 17*d1766043SAndrew Rist * specific language governing permissions and limitations 18*d1766043SAndrew Rist * under the License. 19*d1766043SAndrew Rist * 20*d1766043SAndrew Rist *************************************************************/ 21*d1766043SAndrew Rist 22*d1766043SAndrew Rist 23cdf0e10cSrcweir#ifndef __com_sun_star_sdbc_XConnection_idl__ 24cdf0e10cSrcweir#define __com_sun_star_sdbc_XConnection_idl__ 25cdf0e10cSrcweir 26cdf0e10cSrcweir#ifndef __com_sun_star_uno_XInterface_idl__ 27cdf0e10cSrcweir#include <com/sun/star/uno/XInterface.idl> 28cdf0e10cSrcweir#endif 29cdf0e10cSrcweir 30cdf0e10cSrcweir module com { module sun { module star { module container { 31cdf0e10cSrcweir published interface XNameAccess; 32cdf0e10cSrcweir};};};}; 33cdf0e10cSrcweir 34cdf0e10cSrcweir#ifndef __com_sun_star_sdbc_SQLException_idl__ 35cdf0e10cSrcweir#include <com/sun/star/sdbc/SQLException.idl> 36cdf0e10cSrcweir#endif 37cdf0e10cSrcweir 38cdf0e10cSrcweir#ifndef __com_sun_star_sdbc_XCloseable_idl__ 39cdf0e10cSrcweir#include <com/sun/star/sdbc/XCloseable.idl> 40cdf0e10cSrcweir#endif 41cdf0e10cSrcweir 42cdf0e10cSrcweir module com { module sun { module star { module sdbc { 43cdf0e10cSrcweir 44cdf0e10cSrcweir published interface XStatement; 45cdf0e10cSrcweir published interface XPreparedStatement; 46cdf0e10cSrcweir published interface XDatabaseMetaData; 47cdf0e10cSrcweir 48cdf0e10cSrcweir 49cdf0e10cSrcweir/** represents a connection (session) with a specific 50cdf0e10cSrcweir database. Within the context of a Connection, SQL statements are 51cdf0e10cSrcweir executed and results are returned. 52cdf0e10cSrcweir 53cdf0e10cSrcweir 54cdf0e10cSrcweir <p> 55cdf0e10cSrcweir A Connection's database is able to provide information 56cdf0e10cSrcweir describing its tables, its supported SQL grammar, its stored 57cdf0e10cSrcweir procedures, and the capabilities of this connection. This 58cdf0e10cSrcweir information is obtained with the 59cdf0e10cSrcweir <member scope="com::sun::star::sdbc">XDatabaseMetaData::getMetaData()</member> 60cdf0e10cSrcweir method. 61cdf0e10cSrcweir 62cdf0e10cSrcweir </p> 63cdf0e10cSrcweir @see com::sun::star::sdbc::XDriverManager 64cdf0e10cSrcweir @see com::sun::star::sdbc::XStatement 65cdf0e10cSrcweir @see com::sun::star::sdbc::XDatabaseMetaData 66cdf0e10cSrcweir */ 67cdf0e10cSrcweirpublished interface XConnection: com::sun::star::sdbc::XCloseable 68cdf0e10cSrcweir{ 69cdf0e10cSrcweir 70cdf0e10cSrcweir /** creates a new 71cdf0e10cSrcweir <type scope="com::sun::star::sdbc">Statement</type> 72cdf0e10cSrcweir object for sending SQL statements to the database. 73cdf0e10cSrcweir 74cdf0e10cSrcweir 75cdf0e10cSrcweir <p> 76cdf0e10cSrcweir SQL statements without parameters are normally 77cdf0e10cSrcweir executed using Statement objects. If the same SQL statement 78cdf0e10cSrcweir is executed many times, it is more efficient to use a 79cdf0e10cSrcweir <type scope="com::sun::star::sdbc">PreparedStatement</type> 80cdf0e10cSrcweir . 81cdf0e10cSrcweir </p> 82cdf0e10cSrcweir <p> 83cdf0e10cSrcweir Result sets created using the returned Statement will have 84cdf0e10cSrcweir forward-only type, and read-only concurrency, by default. 85cdf0e10cSrcweir </p> 86cdf0e10cSrcweir <p> 87cdf0e10cSrcweir Escape processing for the SQL-Statement is enabled, by default. 88cdf0e10cSrcweir </p> 89cdf0e10cSrcweir 90cdf0e10cSrcweir @returns 91cdf0e10cSrcweir a new Statement object 92cdf0e10cSrcweir @throws SQLException 93cdf0e10cSrcweir if a database access error occurs. 94cdf0e10cSrcweir */ 95cdf0e10cSrcweir XStatement createStatement() raises (SQLException); 96cdf0e10cSrcweir //------------------------------------------------------------------------- 97cdf0e10cSrcweir 98cdf0e10cSrcweir /** creates a 99cdf0e10cSrcweir <type scope="com::sun::star::sdbc">PreparedStatement</type> 100cdf0e10cSrcweir object for sending parameterized SQL statements to the database. 101cdf0e10cSrcweir 102cdf0e10cSrcweir 103cdf0e10cSrcweir <p> 104cdf0e10cSrcweir A SQL statement with or without IN parameters can be 105cdf0e10cSrcweir pre-compiled and stored in a PreparedStatement object. This 106cdf0e10cSrcweir object can then be used to efficiently execute this statement 107cdf0e10cSrcweir multiple times. 108cdf0e10cSrcweir 109cdf0e10cSrcweir </p> 110cdf0e10cSrcweir <p> 111cdf0e10cSrcweir <b> 112cdf0e10cSrcweir Note: 113cdf0e10cSrcweir </b> 114cdf0e10cSrcweir This method is optimized for handling 115cdf0e10cSrcweir parametric SQL statements that benefit from precompilation. If 116cdf0e10cSrcweir the driver supports precompilation, 117cdf0e10cSrcweir the method 118cdf0e10cSrcweir <code>prepareStatement</code> 119cdf0e10cSrcweir will send 120cdf0e10cSrcweir the statement to the database for precompilation. Some drivers 121cdf0e10cSrcweir may not support precompilation. In this case, the statement may 122cdf0e10cSrcweir not be sent to the database until the 123cdf0e10cSrcweir <type scope="com::sun::star::sdbc">PreparedStatement</type> 124cdf0e10cSrcweir is executed. This has no direct effect on users; however, it does 125cdf0e10cSrcweir affect which method throws certain SQLExceptions. 126cdf0e10cSrcweir </p> 127cdf0e10cSrcweir <p> 128cdf0e10cSrcweir Result sets created using the returned PreparedStatement will have 129cdf0e10cSrcweir forward-only type and read-only concurrency, by default. 130cdf0e10cSrcweir </p> 131cdf0e10cSrcweir <p> 132cdf0e10cSrcweir Escape processing for the SQL-Statement is enabled, by default. 133cdf0e10cSrcweir </p> 134cdf0e10cSrcweir 135cdf0e10cSrcweir @param sql 136cdf0e10cSrcweir a SQL statement that may contain one or more '?' IN parameter placeholders 137cdf0e10cSrcweir @returns 138cdf0e10cSrcweir a new PreparedStatement object containing the pre-compiled statement 139cdf0e10cSrcweir @throws SQLException 140cdf0e10cSrcweir if a database access error occurs. 141cdf0e10cSrcweir */ 142cdf0e10cSrcweir XPreparedStatement prepareStatement([in]string sql) raises (SQLException); 143cdf0e10cSrcweir //------------------------------------------------------------------------- 144cdf0e10cSrcweir 145cdf0e10cSrcweir /** creates a 146cdf0e10cSrcweir <type scope="com::sun::star::sdbc">CallableStatement</type> 147cdf0e10cSrcweir object for calling 148cdf0e10cSrcweir database stored procedures. 149cdf0e10cSrcweir 150cdf0e10cSrcweir 151cdf0e10cSrcweir <p> 152cdf0e10cSrcweir The CallableStatement provides methods for setting up its IN and OUT 153cdf0e10cSrcweir parameters, and methods for executing the call to a stored procedure. 154cdf0e10cSrcweir </p> 155cdf0e10cSrcweir <p> 156cdf0e10cSrcweir <b> 157cdf0e10cSrcweir Note: 158cdf0e10cSrcweir </b> 159cdf0e10cSrcweir This method is optimized for handling stored 160cdf0e10cSrcweir procedure call statements. Some drivers may send the call 161cdf0e10cSrcweir statement to the database when the method 162cdf0e10cSrcweir <code>prepareCall</code> 163cdf0e10cSrcweir is done; 164cdf0e10cSrcweir <br/> 165cdf0e10cSrcweir others may wait until the CallableStatement is executed. This has no 166cdf0e10cSrcweir direct effect on users; however, it does affect which method 167cdf0e10cSrcweir throws certain SQLExceptions. 168cdf0e10cSrcweir Result sets created using the returned CallableStatement will have 169cdf0e10cSrcweir forward-only type and read-only concurrency, by default. 170cdf0e10cSrcweir </p> 171cdf0e10cSrcweir 172cdf0e10cSrcweir @param sql 173cdf0e10cSrcweir a SQL statement that may contain one or more '?' IN parameter placeholders 174cdf0e10cSrcweir @returns 175cdf0e10cSrcweir a new PreparedStatement object containing the pre-compiled statement 176cdf0e10cSrcweir @throws SQLException 177cdf0e10cSrcweir if a database access error occurs. 178cdf0e10cSrcweir */ 179cdf0e10cSrcweir XPreparedStatement prepareCall([in]string sql) raises (SQLException); 180cdf0e10cSrcweir //------------------------------------------------------------------------- 181cdf0e10cSrcweir 182cdf0e10cSrcweir /** converts the given SQL statement into the system's native SQL grammar. 183cdf0e10cSrcweir A driver may convert the JDBC SQL grammar into its system's 184cdf0e10cSrcweir native SQL grammar prior to sending it; this method returns the 185cdf0e10cSrcweir native form of the statement that the driver would have sent. 186cdf0e10cSrcweir 187cdf0e10cSrcweir @param sql 188cdf0e10cSrcweir a SQL statement that may contain one or more '?' parameter placeholders 189cdf0e10cSrcweir @returns 190cdf0e10cSrcweir the native form of this statement 191cdf0e10cSrcweir @throws SQLException 192cdf0e10cSrcweir if a database access error occurs. 193cdf0e10cSrcweir */ 194cdf0e10cSrcweir string nativeSQL([in]string sql) raises (SQLException); 195cdf0e10cSrcweir //------------------------------------------------------------------------- 196cdf0e10cSrcweir 197cdf0e10cSrcweir /** sets this connection's auto-commit mode. 198cdf0e10cSrcweir 199cdf0e10cSrcweir 200cdf0e10cSrcweir <p> 201cdf0e10cSrcweir If a connection is in auto-commit mode, then all its SQL 202cdf0e10cSrcweir statements will be executed and committed as individual 203cdf0e10cSrcweir transactions. Otherwise, its SQL statements are grouped into 204cdf0e10cSrcweir transactions that are terminated by a call to either 205cdf0e10cSrcweir the method 206cdf0e10cSrcweir <member scope="com::sun::star::sdbc">XConnection::commit()</member> 207cdf0e10cSrcweir or the method 208cdf0e10cSrcweir <member scope="com::sun::star::sdbc">XConnection::rollback()</member> 209cdf0e10cSrcweir . 210cdf0e10cSrcweir By default, new connections are in auto-commit mode. 211cdf0e10cSrcweir </p> 212cdf0e10cSrcweir <p> 213cdf0e10cSrcweir The commit occurs when the statement completes or the next 214cdf0e10cSrcweir execute occurs, whichever comes first. In the case of 215cdf0e10cSrcweir statements returning a ResultSet, the statement completes when 216cdf0e10cSrcweir the last row of the ResultSet has been retrieved or the 217cdf0e10cSrcweir ResultSet has been closed. In advanced cases, a single 218cdf0e10cSrcweir statement may return multiple results as well as output 219cdf0e10cSrcweir parameter values. In these cases the commit occurs when all results and 220cdf0e10cSrcweir output parameter values have been retrieved. 221cdf0e10cSrcweir </p> 222cdf0e10cSrcweir 223cdf0e10cSrcweir @param autoCommit 224cdf0e10cSrcweir <TRUE/> enables auto-commit; <FALSE/> disables auto-commit. 225cdf0e10cSrcweir @throws SQLException 226cdf0e10cSrcweir if a database access error occurs. 227cdf0e10cSrcweir */ 228cdf0e10cSrcweir void setAutoCommit([in] boolean autoCommit) raises (SQLException); 229cdf0e10cSrcweir //------------------------------------------------------------------------- 230cdf0e10cSrcweir 231cdf0e10cSrcweir /** gets the current auto-commit state. 232cdf0e10cSrcweir 233cdf0e10cSrcweir @returns 234cdf0e10cSrcweir the current state of auto-commit mode. 235cdf0e10cSrcweir @throws SQLException 236cdf0e10cSrcweir if a database access error occurs. 237cdf0e10cSrcweir 238cdf0e10cSrcweir @see setAutoCommit 239cdf0e10cSrcweir */ 240cdf0e10cSrcweir boolean getAutoCommit() raises (SQLException); 241cdf0e10cSrcweir //------------------------------------------------------------------------- 242cdf0e10cSrcweir 243cdf0e10cSrcweir /** makes all changes made since the previous commit/rollback 244cdf0e10cSrcweir permanent and releases any database locks currently held 245cdf0e10cSrcweir by the Connection. This method should be 246cdf0e10cSrcweir used only when auto-commit mode has been disabled. 247cdf0e10cSrcweir 248cdf0e10cSrcweir @throws SQLException 249cdf0e10cSrcweir if a database access error occurs. 250cdf0e10cSrcweir 251cdf0e10cSrcweir @see setAutoCommit 252cdf0e10cSrcweir */ 253cdf0e10cSrcweir void commit() raises (SQLException); 254cdf0e10cSrcweir //------------------------------------------------------------------------- 255cdf0e10cSrcweir 256cdf0e10cSrcweir /** drops all changes made since the previous 257cdf0e10cSrcweir commit/rollback and releases any database locks currently held 258cdf0e10cSrcweir by this Connection. This method should be used only when auto-commit has been disabled. 259cdf0e10cSrcweir 260cdf0e10cSrcweir @throws SQLException 261cdf0e10cSrcweir if a database access error occurs. 262cdf0e10cSrcweir 263cdf0e10cSrcweir @see setAutoCommit 264cdf0e10cSrcweir */ 265cdf0e10cSrcweir void rollback() raises (SQLException); 266cdf0e10cSrcweir //------------------------------------------------------------------------- 267cdf0e10cSrcweir 268cdf0e10cSrcweir /** tests to see if a connection is closed. 269cdf0e10cSrcweir 270cdf0e10cSrcweir 271cdf0e10cSrcweir <p> 272cdf0e10cSrcweir <b> 273cdf0e10cSrcweir Note: 274cdf0e10cSrcweir </b> 275cdf0e10cSrcweir A Connection is automatically closed if no one references it 276cdf0e10cSrcweir anymore. Certain fatal errors also result in a closed Connection. 277cdf0e10cSrcweir </p> 278cdf0e10cSrcweir 279cdf0e10cSrcweir @returns 280cdf0e10cSrcweir <TRUE/> if the connection is closed; <FALSE/> if it's still open. 281cdf0e10cSrcweir @throws SQLException 282cdf0e10cSrcweir if a database access error occurs. 283cdf0e10cSrcweir */ 284cdf0e10cSrcweir boolean isClosed() raises (SQLException); 285cdf0e10cSrcweir //------------------------------------------------------------------------- 286cdf0e10cSrcweir 287cdf0e10cSrcweir /** gets the metadata regarding this connection's database. 288cdf0e10cSrcweir 289cdf0e10cSrcweir 290cdf0e10cSrcweir <p> 291cdf0e10cSrcweir A Connection's database is able to provide information 292cdf0e10cSrcweir describing its tables, its supported SQL grammar, its stored 293cdf0e10cSrcweir procedures, the capabilities of this connection, and so on. This 294cdf0e10cSrcweir information is made available through a DatabaseMetaData 295cdf0e10cSrcweir object. 296cdf0e10cSrcweir </p> 297cdf0e10cSrcweir 298cdf0e10cSrcweir @returns 299cdf0e10cSrcweir a DatabaseMetaData object for this Connection. 300cdf0e10cSrcweir @throws SQLException 301cdf0e10cSrcweir if a database access error occurs. 302cdf0e10cSrcweir */ 303cdf0e10cSrcweir XDatabaseMetaData getMetaData() raises (SQLException); 304cdf0e10cSrcweir //------------------------------------------------------------------------- 305cdf0e10cSrcweir 306cdf0e10cSrcweir /** puts this connection in read-only mode as a hint to enable 307cdf0e10cSrcweir database optimizations. 308cdf0e10cSrcweir 309cdf0e10cSrcweir 310cdf0e10cSrcweir <p> 311cdf0e10cSrcweir <b> 312cdf0e10cSrcweir Note: 313cdf0e10cSrcweir </b> 314cdf0e10cSrcweir This method cannot be called while in the 315cdf0e10cSrcweir middle of a transaction. Calling setReadOnly with 316cdf0e10cSrcweir <TRUE/> 317cdf0e10cSrcweir does not 318cdf0e10cSrcweir necessarily cause writes to be prohibited. 319cdf0e10cSrcweir </p> 320cdf0e10cSrcweir 321cdf0e10cSrcweir @param readONly 322cdf0e10cSrcweir <TRUE/> enables read-only mode; <FALSE/> disables read-only mode. 323cdf0e10cSrcweir @throws SQLException 324cdf0e10cSrcweir if a database access error occurs. 325cdf0e10cSrcweir */ 326cdf0e10cSrcweir void setReadOnly([in]boolean readOnly) raises (SQLException); 327cdf0e10cSrcweir //------------------------------------------------------------------------- 328cdf0e10cSrcweir 329cdf0e10cSrcweir /** tests to see if the connection is in read-only mode. 330cdf0e10cSrcweir @returns 331cdf0e10cSrcweir <TRUE/> if connection is read-only and <FALSE/> otherwise. 332cdf0e10cSrcweir @throws SQLException 333cdf0e10cSrcweir if a database access error occurs. 334cdf0e10cSrcweir */ 335cdf0e10cSrcweir boolean isReadOnly() raises (SQLException); 336cdf0e10cSrcweir //------------------------------------------------------------------------- 337cdf0e10cSrcweir 338cdf0e10cSrcweir /** sets a catalog name in order to select 339cdf0e10cSrcweir a subspace of this Connection's database in which to work. 340cdf0e10cSrcweir If the driver does not support catalogs, it will 341cdf0e10cSrcweir silently ignore this request. 342cdf0e10cSrcweir @param catalog 343cdf0e10cSrcweir the name of the catalog. 344cdf0e10cSrcweir @throws SQLException 345cdf0e10cSrcweir if a database access error occurs. 346cdf0e10cSrcweir */ 347cdf0e10cSrcweir void setCatalog([in]string catalog) raises (SQLException); 348cdf0e10cSrcweir //------------------------------------------------------------------------- 349cdf0e10cSrcweir 350cdf0e10cSrcweir /** returns the Connection's current catalog name. 351cdf0e10cSrcweir @returns 352cdf0e10cSrcweir the current catalog name or an empty string. 353cdf0e10cSrcweir @throws SQLException 354cdf0e10cSrcweir if a database access error occurs. 355cdf0e10cSrcweir */ 356cdf0e10cSrcweir string getCatalog() raises (SQLException); 357cdf0e10cSrcweir //------------------------------------------------------------------------- 358cdf0e10cSrcweir 359cdf0e10cSrcweir /** attempts to change the transaction isolation level to the one given. 360cdf0e10cSrcweir 361cdf0e10cSrcweir 362cdf0e10cSrcweir <p> 363cdf0e10cSrcweir The constants defined in 364cdf0e10cSrcweir <type scope="com::sun::star::sdbc">TransactionIsolation</type> 365cdf0e10cSrcweir are the possible transaction isolation levels. 366cdf0e10cSrcweir </p> 367cdf0e10cSrcweir <p> 368cdf0e10cSrcweir <b> 369cdf0e10cSrcweir Note: 370cdf0e10cSrcweir </b> 371cdf0e10cSrcweir This method cannot be called while 372cdf0e10cSrcweir in the middle of a transaction. 373cdf0e10cSrcweir </p> 374cdf0e10cSrcweir @param level 375cdf0e10cSrcweir one of the TransactionIsolation values with the exception of NONE; some databases may not support other values. 376cdf0e10cSrcweir @throws SQLException 377cdf0e10cSrcweir if a database access error occurs. 378cdf0e10cSrcweir 379cdf0e10cSrcweir @see com::sun::star::sdbc::XDatabaseMetaData::supportsTransactionIsolationLevel() 380cdf0e10cSrcweir */ 381cdf0e10cSrcweir void setTransactionIsolation([in]long level) raises (SQLException); 382cdf0e10cSrcweir //------------------------------------------------------------------------- 383cdf0e10cSrcweir 384cdf0e10cSrcweir /** gets this Connection's current transaction isolation level. 385cdf0e10cSrcweir @returns 386cdf0e10cSrcweir the current TransactionIsolation mode value. 387cdf0e10cSrcweir @throws SQLException 388cdf0e10cSrcweir if a database access error occurs. 389cdf0e10cSrcweir */ 390cdf0e10cSrcweir long getTransactionIsolation() raises (SQLException); 391cdf0e10cSrcweir //------------------------------------------------------------------------- 392cdf0e10cSrcweir 393cdf0e10cSrcweir /** gets the type map object associated with this connection. Only drivers 394cdf0e10cSrcweir which implement the custom type mapping facility will return an object otherwise 395cdf0e10cSrcweir NULL could be returned. 396cdf0e10cSrcweir 397cdf0e10cSrcweir <p> 398cdf0e10cSrcweir Unless the application has added an entry to the type map, the map 399cdf0e10cSrcweir returned will be empty. 400cdf0e10cSrcweir </p> 401cdf0e10cSrcweir @returns 402cdf0e10cSrcweir the XNameAccess object associated with this Connection object. 403cdf0e10cSrcweir 404cdf0e10cSrcweir @throws SQLException 405cdf0e10cSrcweir if a database access error occurs. 406cdf0e10cSrcweir */ 407cdf0e10cSrcweir com::sun::star::container::XNameAccess getTypeMap() raises (SQLException); 408cdf0e10cSrcweir //------------------------------------------------------------------------- 409cdf0e10cSrcweir 410cdf0e10cSrcweir /** installs the given type map as the type map for this connection. 411cdf0e10cSrcweir The type map will be used for the custom mapping of SQL structured types 412cdf0e10cSrcweir and distinct types. 413cdf0e10cSrcweir 414cdf0e10cSrcweir 415cdf0e10cSrcweir <p> 416cdf0e10cSrcweir Only if the driver supports custom type mapping is the setting of a map allowed. 417cdf0e10cSrcweir </p> 418cdf0e10cSrcweir 419cdf0e10cSrcweir @param typeMap 420cdf0e10cSrcweir set the XNameAccess object associated with this Connection object. 421cdf0e10cSrcweir @throws SQLException 422cdf0e10cSrcweir if a database access error occurs. 423cdf0e10cSrcweir */ 424cdf0e10cSrcweir void setTypeMap([in]com::sun::star::container::XNameAccess typeMap) 425cdf0e10cSrcweir raises (SQLException); 426cdf0e10cSrcweir}; 427cdf0e10cSrcweir 428cdf0e10cSrcweir//============================================================================= 429cdf0e10cSrcweir 430cdf0e10cSrcweir}; }; }; }; 431cdf0e10cSrcweir 432cdf0e10cSrcweir/*=========================================================================== 433cdf0e10cSrcweir===========================================================================*/ 434cdf0e10cSrcweir#endif 435