offapi/com/sun/star/sdbc/Connection.idl

   1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
   2 /*
   3  * This file is part of the LibreOffice project.
   4  *
   5  * This Source Code Form is subject to the terms of the Mozilla Public
   6  * License, v. 2.0. If a copy of the MPL was not distributed with this
   7  * file, You can obtain one at http://mozilla.org/MPL/2.0/.
   8  *
   9  * This file incorporates work covered by the following license notice:
  10  *
  11  *   Licensed to the Apache Software Foundation (ASF) under one or more
  12  *   contributor license agreements. See the NOTICE file distributed
  13  *   with this work for additional information regarding copyright
  14  *   ownership. The ASF licenses this file to you under the Apache
  15  *   License, Version 2.0 (the "License"); you may not use this file
  16  *   except in compliance with the License. You may obtain a copy of
  17  *   the License at http://www.apache.org/licenses/LICENSE-2.0 .
  18  */
  19
  20  module com {  module sun {  module star {  module sdbc {
  21
  22  published interface XConnection;
  23  published interface XWarningsSupplier;
  24
  25
  26 /** represents a connection (session) with a specific
  27     database. Within the context of a Connection, SQL statements are
  28     executed and results are returned.
  29
  30     <p>
  31     A Connection's database is able to provide information
  32     describing its tables, its supported SQL grammar, its stored
  33     procedures, and the capabilities of this connection. This
  34     information is obtained with the
  35     com::sun::star::sdbc::XConnection::getMetaData()
  36     method.
  37     </p>
  38     <p>
  39     <b>
  40     Note:
  41     </b>
  42     By default the Connection automatically commits
  43     changes after executing each statement. If auto commit has been
  44     disabled, an explicit commit must be done or database changes will
  45     not be saved.
  46
  47     </p>
  48     @see com::sun::star::sdbc::XStatement
  49     @see com::sun::star::sdbc::XResultSet
  50     @see com::sun::star::sdbc::XDatabaseMetaData
  51  */
  52 published service Connection
  53 {
  54
  55     /** controls the closing of a connection.
  56      */
  57     interface com::sun::star::lang::XComponent;
  58
  59
  60     /** the main interface for interaction with a connection to a database.
  61      */
  62     interface XConnection;
  63
  64
  65     /** controls the chaining of warnings, which may occur on every call
  66              to the connected database. Chained warnings from previous calls will be
  67              cleared before processing a new call.
  68      */
  69     interface XWarningsSupplier;
  70 };
  71
  72
  73 }; }; }; };
  74
  75 /*===========================================================================
  76 ===========================================================================*/
  77
  78 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */