]> source.dussan.org Git - nextcloud-server.git/commitdiff
Add DBConnection to server container
authorBart Visscher <bartv@thisnet.nl>
Fri, 20 Sep 2013 12:33:45 +0000 (14:33 +0200)
committerBart Visscher <bartv@thisnet.nl>
Fri, 20 Sep 2013 12:33:45 +0000 (14:33 +0200)
lib/db/connection.php
lib/public/idbconnection.php [new file with mode: 0644]
lib/public/iservercontainer.php
lib/server.php

index 2581969dbd0a34a7a1ab3d61e381f49810943095..2d3193a148a46fa84cd38b31879612f22d64a708 100644 (file)
@@ -12,7 +12,7 @@ use Doctrine\DBAL\Configuration;
 use Doctrine\DBAL\Cache\QueryCacheProfile;
 use Doctrine\Common\EventManager;
 
-class Connection extends \Doctrine\DBAL\Connection {
+class Connection extends \Doctrine\DBAL\Connection implements \OCP\IDBConnection {
        /**
         * @var string $tablePrefix
         */
diff --git a/lib/public/idbconnection.php b/lib/public/idbconnection.php
new file mode 100644 (file)
index 0000000..67dd7cc
--- /dev/null
@@ -0,0 +1,71 @@
+<?php
+/**
+ * Copyright (c) 2013 Bart Visscher <bartv@thisnet.nl>
+ * This file is licensed under the Affero General Public License version 3 or
+ * later.
+ * See the COPYING-README file.
+ * 
+ */
+
+namespace OCP;
+
+/**
+ * TODO: Description
+ */
+interface IDBConnection {
+       /**
+        * Used to abstract the owncloud database access away
+        * @param string $sql the sql query with ? placeholder for params
+        * @param int $limit the maximum number of rows
+        * @param int $offset from which row we want to start
+        * @return \Doctrine\DBAL\Driver\Statement The prepared statement.
+        */
+       public function prepare($sql, $limit=null, $offset=null);
+
+       /**
+        * Used to get the id of the just inserted element
+        * @param string $tableName the name of the table where we inserted the item
+        * @return int the id of the inserted element
+        */
+       public function lastInsertId($table = null);
+
+       /**
+        * @brief Insert a row if a matching row doesn't exists.
+        * @param $table string The table name (will replace *PREFIX*) to perform the replace on.
+        * @param $input array
+        *
+        * The input array if in the form:
+        *
+        * array ( 'id' => array ( 'value' => 6,
+        *      'key' => true
+        *      ),
+        *      'name' => array ('value' => 'Stoyan'),
+        *      'family' => array ('value' => 'Stefanov'),
+        *      'birth_date' => array ('value' => '1975-06-20')
+        *      );
+        * @return bool
+        *
+        */
+       public function insertIfNotExist($table, $input);
+
+       /**
+        * @brief Start a transaction
+        */
+       public function beginTransaction();
+
+       /**
+        * @brief Commit the database changes done during a transaction that is in progress
+        */
+       public function commit();
+
+       /**
+        * @brief Rollback the database changes done during a transaction that is in progress
+        */
+       public function rollBack();
+
+       /**
+        * returns the error code and message as a string for logging
+        * @return string
+        */
+       public function getError();
+}
index ad714276660b5399d72f32b0be16425d94ed0bfd..5481cd6ce6a9f0fca493e749985071643f0c703c 100644 (file)
@@ -83,4 +83,11 @@ interface IServerContainer {
         */
        function getSession();
 
+       /**
+        * Returns the current session
+        *
+        * @return \OCP\IDBConnection
+        */
+       function getDatabaseConnection();
+
 }
index 316ed39665bb015081b7b5941bb57125261ebbd1..a5288fa148270060059647124202e7e8cdd41b43 100644 (file)
@@ -170,4 +170,12 @@ class Server extends SimpleContainer implements IServerContainer {
                return \OC::$session;
        }
 
+       /**
+        * Returns the current session
+        *
+        * @return \OCP\IDBConnection
+        */
+       function getDatabaseConnection() {
+               return \OC_DB::getConnection();
+       }
 }