Organize Docs

README.md

@@ -43,22 +43,26 @@ $conn = \ByJG\AnyDataset\Db\Factory::getDbInstance("mysql://root:[email protected]
 
 - [Getting Started](docs/getting-started.md)
 - [Basic Query and Update](docs/basic-query.md)
+- [Sql Statement Object](docs/sqlstatement.md)
 - [Cache results](docs/cache.md)
 - [Database Transaction](docs/transaction.md)
 - [Load Balance and Connection Pooling](docs/load-balance.md)
 - [Database Helper](docs/helper.md)
+- [Filtering the Query](docs/iteratorfilter.md)
 
 ## Advanced Topics
 
 - [Passing Parameters to PDODriver](docs/parameters.md)
 - [Generic PDO Driver](docs/generic-pdo-driver.md)
 - [Running Tests](docs/tests.md)
+- [Getting an Iterator from an existing PDO Statament](docs/pdostatement.md)
 
 ## Database Specifics
 
 - [MySQL](docs/mysql.md)
 - [Oracle](docs/oracle.md)
 - [SQLServer](docs/sqlserver.md)
+- [Literal PDO Connection String](docs/literal-pdo-driver.md)
 
 
 ## Install

docs/basic-query.md

@@ -1,3 +1,7 @@
+---
+sidebar_position: 2
+---
+
 # Basics
 
 ## Basic Query

docs/cache.md

@@ -1,3 +1,7 @@
+---
+sidebar_position: 4
+---
+
 # Cache results
 
 You can easily cache your results to speed up the results of long queries;

docs/generic-pdo-driver.md

@@ -1,3 +1,7 @@
+---
+sidebar_position: 10
+---
+
 # Generic PDO configuration
 
 If you want to use a PDO driver that is not mapped into the `anydataset-db` library you can use the generic PDO driver.

docs/getting-started.md

@@ -1,3 +1,7 @@
+---
+sidebar_position: 1
+---
+
 # Getting Started
 
 ## 1. Install the ByJG AnyDatasetDB library

docs/helper.md

@@ -1,3 +1,7 @@
+---
+sidebar_position: 7
+---
+
 # Helper - DbFunctions
 
 AnyDataset has a helper `ByJG\AnyDataset\Db\DbFunctionsInterface` that can be return some specific data based on the database connection. 

docs/iteratorfilter.md

@@ -1,3 +1,7 @@
+---
+sidebar_position: 8
+---
+
 # Using IteratorFilter
 
 `IteratorFilter` is a class that helps you to create a filter to be used in the Iterator. 

docs/literal-pdo-driver.md

@@ -1,7 +1,14 @@
+---
+sidebar_position: 16
+---
+
 # Literal PDO configuration
 
-If you want to use a PDO driver, and it requires special parameters don't fit well using the URI model you can use the literal object.
-It will allow you to pass the PDO connection string directly.
+If you want to use a PDO driver and this driver is not available in the AnyDatasetDB or and it requires special
+parameters don't fit well
+using the URI model you can use the literal object.
+
+The `PdoLiteral` object uses the PDO connection string instead of the URI model.
 
 Example:
 
@@ -11,6 +18,10 @@ Example:
 $literal = new \ByJG\AnyDataset\Db\PdoLiteral("sqlite::memory:");
 ```
 
-The general rule is use the string as you would use in the PDO constructor.
+Drawbacks:
+
+* You can't use the `Factory::getDbInstance` to get the database instance. You need to use the `PdoLiteral` object
+  directly.
+* The DBHelper won't work with the `PdoLiteral` object.
 
 

docs/load-balance.md

@@ -1,3 +1,7 @@
+---
+sidebar_position: 6
+---
+
 # Load balancing
 
 The API have support for connection load balancing, connection pooling and persistent connection.

docs/mysql.md

@@ -1,3 +1,7 @@
+---
+sidebar_position: 13
+---
+
 # Driver: MySQL
 
 The connection string can have special attributes to connect using SSL. 

docs/oracle.md

@@ -1,3 +1,7 @@
+---
+sidebar_position: 14
+---
+
 # Driver: Oracle
 
 The Oracle Driver don't use the PHP PDO Driver. Instead, uses the OCI library.

docs/parameters.md

@@ -1,3 +1,7 @@
+---
+sidebar_position: 9
+---
+
 # Passing Parameters to PDODriver
 
 You can pass parameter directly to the PDODriver by adding to the connection string a query parameter with the value.

docs/pdostatement.md

@@ -0,0 +1,37 @@
+---
+sidebar_position: 12
+---
+
+# Using a PDO Statement
+
+If you have a PDO Statement created outside the AnyDatasetDB library,
+you can use it to create an iterator.
+
+```php
+<?php
+$pdo = new PDO('sqlite::memory:');
+$stmt = $pdo->prepare('select * from info where id = :id');
+$stmt->execute(['id' => 1]);
+
+$iterator = $this->dbDriver->getIterator($stmt);
+$this->assertEquals(
+    [
+        [ 'id'=> 1, 'iduser' => 1, 'number' => 10.45, 'property' => 'xxx'],
+    ],
+    $iterator->toArray()
+);
+```
+
+Note:
+
+* Although you can use a PDO Statement, it is recommended to use the
+  `SqlStatement` or `DbDriverInterface` to get the Query.
+* Use this feature with legacy code or when you have a specific need to use a PDO Statement.
+
+## Benefits
+
+You can integrate the AnyDatasetDB library with your legacy code and get the benefits of the library
+as for example the standard `GenericIterator` 
+
+
+

docs/sqlserver.md

@@ -1,3 +1,7 @@
+---
+sidebar_position: 15
+---
+
 # Driver: Microsoft SQL Server
 
 There are two Drivers to connect to Microsoft SQL Server.

docs/sqlstatement.md

@@ -1,3 +1,7 @@
+---
+sidebar_position: 3
+---
+
 # SQL Statement
 
 The SQL Statement is a class to abstract the SQL query from the database.

docs/tests.md

@@ -1,3 +1,7 @@
+---
+sidebar_position: 11
+---
+
 # Running Unit tests
 
 ## Unit Tests (no DBConnection)

docs/transaction.md

@@ -1,3 +1,7 @@
+---
+sidebar_position: 5
+---
+
 # Database Transaction
 
 ## Basics

tests/PdoSqliteTest.php

@@ -440,4 +440,20 @@ public function testCachedResults2()
             $iterator->toArray()
         );
     }
+
+    public function testPDOStatement()
+    {
+        $pdo = $this->dbDriver->getDbConnection();
+        $stmt = $pdo->prepare('select * from info where id = :id');
+        $stmt->execute(['id' => 1]);
+
+        $iterator = $this->dbDriver->getIterator($stmt);
+        $this->assertEquals(
+            [
+                ['id' => 1, 'iduser' => 1, 'number' => 10.45, 'property' => 'xxx'],
+            ],
+            $iterator->toArray()
+        );
+
+    }
 }