320 lines
16 KiB
PHP
320 lines
16 KiB
PHP
<?php
|
|
/**
|
|
* @author Daniel J. Summers <daniel@bitbadger.solutions>
|
|
* @license MIT
|
|
*/
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace Test\Integration\PostgreSQL;
|
|
|
|
use BitBadger\PDODocument\{AutoId, Configuration, Custom, Document, DocumentException, Field, Find, Query};
|
|
use BitBadger\PDODocument\Mapper\ArrayMapper;
|
|
use PHPUnit\Framework\Attributes\TestDox;
|
|
use PHPUnit\Framework\TestCase;
|
|
use Test\Integration\{NumDocument, SubDocument, TestDocument};
|
|
|
|
/**
|
|
* PostgreSQL integration tests for the Document class
|
|
*/
|
|
#[TestDox('Document (PostgreSQL integration)')]
|
|
class DocumentTest extends TestCase
|
|
{
|
|
/** @var string Database name for throwaway database */
|
|
private string $dbName;
|
|
|
|
protected function setUp(): void
|
|
{
|
|
parent::setUp();
|
|
$this->dbName = ThrowawayDb::create();
|
|
}
|
|
|
|
protected function tearDown(): void
|
|
{
|
|
ThrowawayDb::destroy($this->dbName);
|
|
parent::tearDown();
|
|
}
|
|
|
|
#[TestDox('insert() succeeds for array no auto ID')]
|
|
public function testInsertSucceedsForArrayNoAutoId(): void
|
|
{
|
|
Document::insert(ThrowawayDb::TABLE, ['id' => 'turkey', 'sub' => ['foo' => 'gobble', 'bar' => 'gobble']]);
|
|
$tryDoc = Find::byId(ThrowawayDb::TABLE, 'turkey', TestDocument::class);
|
|
$this->assertTrue($tryDoc->isSome, 'There should have been a document inserted');
|
|
$doc = $tryDoc->value;
|
|
$this->assertEquals('turkey', $doc->id, 'The ID was incorrect');
|
|
$this->assertEquals('', $doc->value, 'The value was incorrect');
|
|
$this->assertEquals(0, $doc->num_value, 'The numeric value was incorrect');
|
|
$this->assertNotNull($doc->sub, 'The sub-document should not have been null');
|
|
$this->assertEquals('gobble', $doc->sub->foo, 'The sub-document foo property was incorrect');
|
|
$this->assertEquals('gobble', $doc->sub->bar, 'The sub-document bar property was incorrect');
|
|
}
|
|
|
|
#[TestDox('insert() succeeds for array with auto number ID not provided')]
|
|
public function testInsertSucceedsForArrayWithAutoNumberIdNotProvided(): void
|
|
{
|
|
Configuration::$autoId = AutoId::Number;
|
|
try {
|
|
Custom::nonQuery('DELETE FROM ' . ThrowawayDb::TABLE, []);
|
|
|
|
Document::insert(ThrowawayDb::TABLE, ['id' => 0, 'value' => 'new', 'num_value' => 8]);
|
|
$doc = Custom::single('SELECT data FROM ' . ThrowawayDb::TABLE, [], new ArrayMapper());
|
|
$this->assertTrue($doc->isSome, 'There should have been a document returned');
|
|
$obj = json_decode($doc->value['data']);
|
|
$this->assertEquals(1, $obj->id, 'The ID 1 should have been auto-generated');
|
|
|
|
Document::insert(ThrowawayDb::TABLE, ['id' => 0, 'value' => 'again', 'num_value' => 7]);
|
|
$doc = Custom::single('SELECT data FROM ' . ThrowawayDb::TABLE . " WHERE " . Query::whereById(docId: 2),
|
|
[':id' => 2], new ArrayMapper());
|
|
$this->assertTrue($doc->isSome, 'There should have been a document returned');
|
|
$obj = json_decode($doc->value['data']);
|
|
$this->assertEquals(2, $obj->id, 'The ID 2 should have been auto-generated');
|
|
} finally {
|
|
Configuration::$autoId = AutoId::None;
|
|
}
|
|
}
|
|
|
|
#[TestDox('insert() succeeds for array with auto number ID with ID provided')]
|
|
public function testInsertSucceedsForArrayWithAutoNumberIdWithIdProvided(): void
|
|
{
|
|
Configuration::$autoId = AutoId::Number;
|
|
try {
|
|
Custom::nonQuery('DELETE FROM ' . ThrowawayDb::TABLE, []);
|
|
Document::insert(ThrowawayDb::TABLE, ['id' => 7, 'value' => 'new', 'num_value' => 8]);
|
|
$doc = Custom::single('SELECT data FROM ' . ThrowawayDb::TABLE, [], new ArrayMapper());
|
|
$this->assertTrue($doc->isSome, 'There should have been a document returned');
|
|
$obj = json_decode($doc->value['data']);
|
|
$this->assertEquals(7, $obj->id, 'The ID 7 should have been stored');
|
|
} finally {
|
|
Configuration::$autoId = AutoId::None;
|
|
}
|
|
}
|
|
|
|
#[TestDox('insert() succeeds for array with auto UUID ID not provided')]
|
|
public function testInsertSucceedsForArrayWithAutoUuidIdNotProvided(): void
|
|
{
|
|
Configuration::$autoId = AutoId::UUID;
|
|
try {
|
|
Custom::nonQuery('DELETE FROM ' . ThrowawayDb::TABLE, []);
|
|
Document::insert(ThrowawayDb::TABLE, ['id' => '', 'num_value' => 5]);
|
|
$doc = Find::firstByFields(ThrowawayDb::TABLE, [Field::equal('num_value', 5)], TestDocument::class);
|
|
$this->assertTrue($doc->isSome, 'There should have been a document returned');
|
|
$this->assertNotEmpty($doc->value->id, 'The ID should have been auto-generated');
|
|
} finally {
|
|
Configuration::$autoId = AutoId::None;
|
|
}
|
|
}
|
|
|
|
#[TestDox('insert() succeeds for array with auto UUID ID with ID provided')]
|
|
public function testInsertSucceedsForArrayWithAutoUuidIdWithIdProvided(): void
|
|
{
|
|
Configuration::$autoId = AutoId::UUID;
|
|
try {
|
|
Custom::nonQuery('DELETE FROM ' . ThrowawayDb::TABLE, []);
|
|
$uuid = AutoId::generateUUID();
|
|
Document::insert(ThrowawayDb::TABLE, ['id' => $uuid, 'value' => 'uuid', 'num_value' => 12]);
|
|
$doc = Find::firstByFields(ThrowawayDb::TABLE, [Field::equal('num_value', 12)], TestDocument::class);
|
|
$this->assertTrue($doc->isSome, 'There should have been a document returned');
|
|
$this->assertEquals($uuid, $doc->value->id, 'The ID should not have been changed');
|
|
} finally {
|
|
Configuration::$autoId = AutoId::None;
|
|
}
|
|
}
|
|
|
|
#[TestDox('insert() succeeds for array with auto string ID not provided')]
|
|
public function testInsertSucceedsForArrayWithAutoStringIdNotProvided(): void
|
|
{
|
|
Configuration::$autoId = AutoId::RandomString;
|
|
Configuration::$idStringLength = 6;
|
|
try {
|
|
Custom::nonQuery('DELETE FROM ' . ThrowawayDb::TABLE, []);
|
|
Document::insert(ThrowawayDb::TABLE, ['id' => '', 'value' => 'new', 'num_value' => 8]);
|
|
$doc = Find::firstByFields(ThrowawayDb::TABLE, [Field::equal('num_value', 8)], TestDocument::class);
|
|
$this->assertTrue($doc->isSome, 'There should have been a document returned');
|
|
$this->assertEquals(6, strlen($doc->value->id),
|
|
'The ID should have been auto-generated and had 6 characters');
|
|
} finally {
|
|
Configuration::$autoId = AutoId::None;
|
|
Configuration::$idStringLength = 16;
|
|
}
|
|
}
|
|
|
|
#[TestDox('insert() succeeds for array with auto string ID with ID provided')]
|
|
public function testInsertSucceedsForArrayWithAutoStringIdWithIdProvided(): void
|
|
{
|
|
Configuration::$autoId = AutoId::RandomString;
|
|
try {
|
|
Custom::nonQuery('DELETE FROM ' . ThrowawayDb::TABLE, []);
|
|
Document::insert(ThrowawayDb::TABLE, ['id' => 'my-key', 'value' => 'old', 'num_value' => 3]);
|
|
$doc = Find::firstByFields(ThrowawayDb::TABLE, [Field::equal('num_value', 3)], TestDocument::class);
|
|
$this->assertTrue($doc->isSome, 'There should have been a document returned');
|
|
$this->assertEquals('my-key', $doc->value->id, 'The ID should not have been changed');
|
|
} finally {
|
|
Configuration::$autoId = AutoId::None;
|
|
}
|
|
}
|
|
|
|
#[TestDox('insert() succeeds for object no auto ID')]
|
|
public function testInsertSucceedsForObjectNoAutoId(): void
|
|
{
|
|
Document::insert(ThrowawayDb::TABLE, new TestDocument('turkey', sub: new SubDocument('gobble', 'gobble')));
|
|
$tryDoc = Find::byId(ThrowawayDb::TABLE, 'turkey', TestDocument::class);
|
|
$this->assertTrue($tryDoc->isSome, 'There should have been a document inserted');
|
|
$doc = $tryDoc->value;
|
|
$this->assertEquals('turkey', $doc->id, 'The ID was incorrect');
|
|
$this->assertEquals('', $doc->value, 'The value was incorrect');
|
|
$this->assertEquals(0, $doc->num_value, 'The numeric value was incorrect');
|
|
$this->assertNotNull($doc->sub, 'The sub-document should not have been null');
|
|
$this->assertEquals('gobble', $doc->sub->foo, 'The sub-document foo property was incorrect');
|
|
$this->assertEquals('gobble', $doc->sub->bar, 'The sub-document bar property was incorrect');
|
|
}
|
|
|
|
#[TestDox('insert() succeeds for object with auto number ID not provided')]
|
|
public function testInsertSucceedsForObjectWithAutoNumberIdNotProvided(): void
|
|
{
|
|
Configuration::$autoId = AutoId::Number;
|
|
try {
|
|
Custom::nonQuery('DELETE FROM ' . ThrowawayDb::TABLE, []);
|
|
|
|
Document::insert(ThrowawayDb::TABLE, new NumDocument(value: 'taco'));
|
|
$doc = Find::firstByFields(ThrowawayDb::TABLE, [Field::equal('value', 'taco')], NumDocument::class);
|
|
$this->assertTrue($doc->isSome, 'There should have been a document returned');
|
|
$this->assertEquals(1, $doc->value->id, 'The ID 1 should have been auto-generated');
|
|
|
|
Document::insert(ThrowawayDb::TABLE, new NumDocument(value: 'burrito'));
|
|
$doc = Find::firstByFields(ThrowawayDb::TABLE, [Field::equal('value', 'burrito')], NumDocument::class);
|
|
$this->assertTrue($doc->isSome, 'There should have been a document returned');
|
|
$this->assertEquals(2, $doc->value->id, 'The ID 2 should have been auto-generated');
|
|
} finally {
|
|
Configuration::$autoId = AutoId::None;
|
|
}
|
|
}
|
|
|
|
#[TestDox('insert() succeeds for object with auto number ID with ID provided')]
|
|
public function testInsertSucceedsForObjectWithAutoNumberIdWithIdProvided(): void
|
|
{
|
|
Configuration::$autoId = AutoId::Number;
|
|
try {
|
|
Custom::nonQuery('DELETE FROM ' . ThrowawayDb::TABLE, []);
|
|
Document::insert(ThrowawayDb::TABLE, new NumDocument(64, 'large'));
|
|
$doc = Find::firstByFields(ThrowawayDb::TABLE, [Field::equal('value', 'large')], NumDocument::class);
|
|
$this->assertTrue($doc->isSome, 'There should have been a document returned');
|
|
$this->assertEquals(64, $doc->value->id, 'The ID 64 should have been stored');
|
|
} finally {
|
|
Configuration::$autoId = AutoId::None;
|
|
}
|
|
}
|
|
|
|
#[TestDox('insert() succeeds for object with auto UUID ID not provided')]
|
|
public function testInsertSucceedsForObjectWithAutoUuidIdNotProvided(): void
|
|
{
|
|
Configuration::$autoId = AutoId::UUID;
|
|
try {
|
|
Custom::nonQuery('DELETE FROM ' . ThrowawayDb::TABLE, []);
|
|
Document::insert(ThrowawayDb::TABLE, new TestDocument(value: 'something', num_value: 9));
|
|
$doc = Find::firstByFields(ThrowawayDb::TABLE, [Field::exists('value')], TestDocument::class);
|
|
$this->assertTrue($doc->isSome, 'There should have been a document returned');
|
|
$this->assertNotEmpty($doc->value->id, 'The ID should have been auto-generated');
|
|
} finally {
|
|
Configuration::$autoId = AutoId::None;
|
|
}
|
|
}
|
|
|
|
#[TestDox('insert() succeeds for object with auto UUID ID with ID provided')]
|
|
public function testInsertSucceedsForObjectWithAutoUuidIdWithIdProvided(): void
|
|
{
|
|
Configuration::$autoId = AutoId::UUID;
|
|
try {
|
|
Custom::nonQuery('DELETE FROM ' . ThrowawayDb::TABLE, []);
|
|
$uuid = AutoId::generateUUID();
|
|
Document::insert(ThrowawayDb::TABLE, new TestDocument($uuid, num_value: 14));
|
|
$doc = Find::firstByFields(ThrowawayDb::TABLE, [Field::equal('num_value', 14)], TestDocument::class);
|
|
$this->assertTrue($doc->isSome, 'There should have been a document returned');
|
|
$this->assertEquals($uuid, $doc->value->id, 'The ID should not have been changed');
|
|
} finally {
|
|
Configuration::$autoId = AutoId::None;
|
|
}
|
|
}
|
|
|
|
#[TestDox('insert() succeeds for object with auto string ID not provided')]
|
|
public function testInsertSucceedsForObjectWithAutoStringIdNotProvided(): void
|
|
{
|
|
Configuration::$autoId = AutoId::RandomString;
|
|
Configuration::$idStringLength = 40;
|
|
try {
|
|
Custom::nonQuery('DELETE FROM ' . ThrowawayDb::TABLE, []);
|
|
Document::insert(ThrowawayDb::TABLE, new TestDocument(num_value: 55));
|
|
$doc = Find::firstByFields(ThrowawayDb::TABLE, [Field::equal('num_value', 55)], TestDocument::class);
|
|
$this->assertTrue($doc->isSome, 'There should have been a document returned');
|
|
$this->assertEquals(40, strlen($doc->value->id),
|
|
'The ID should have been auto-generated and had 40 characters');
|
|
} finally {
|
|
Configuration::$autoId = AutoId::None;
|
|
Configuration::$idStringLength = 16;
|
|
}
|
|
}
|
|
|
|
#[TestDox('insert() succeeds for object with auto string ID with ID provided')]
|
|
public function testInsertSucceedsForObjectWithAutoStringIdWithIdProvided(): void
|
|
{
|
|
Configuration::$autoId = AutoId::RandomString;
|
|
try {
|
|
Custom::nonQuery('DELETE FROM ' . ThrowawayDb::TABLE, []);
|
|
Document::insert(ThrowawayDb::TABLE, new TestDocument('my-key', num_value: 3));
|
|
$doc = Find::firstByFields(ThrowawayDb::TABLE, [Field::equal('num_value', 3)], TestDocument::class);
|
|
$this->assertTrue($doc->isSome, 'There should have been a document returned');
|
|
$this->assertEquals('my-key', $doc->value->id, 'The ID should not have been changed');
|
|
} finally {
|
|
Configuration::$autoId = AutoId::None;
|
|
}
|
|
}
|
|
|
|
#[TestDox('insert() fails for duplicate key')]
|
|
public function testInsertFailsForDuplicateKey(): void
|
|
{
|
|
$this->expectException(DocumentException::class);
|
|
Document::insert(ThrowawayDb::TABLE, new TestDocument('one'));
|
|
}
|
|
|
|
#[TestDox('save() succeeds when a document is inserted')]
|
|
public function testSaveSucceedsWhenADocumentIsInserted(): void
|
|
{
|
|
Document::save(ThrowawayDb::TABLE, new TestDocument('test', sub: new SubDocument('a', 'b')));
|
|
$doc = Find::byId(ThrowawayDb::TABLE, 'one', TestDocument::class);
|
|
$this->assertTrue($doc->isSome, 'There should have been a document returned');
|
|
}
|
|
|
|
#[TestDox('save() succeeds when a document is updated')]
|
|
public function testSaveSucceedsWhenADocumentIsUpdated(): void
|
|
{
|
|
Document::save(ThrowawayDb::TABLE, new TestDocument('two', num_value: 44));
|
|
$tryDoc = Find::byId(ThrowawayDb::TABLE, 'two', TestDocument::class);
|
|
$this->assertTrue($tryDoc->isSome, 'There should have been a document returned');
|
|
$doc = $tryDoc->value;
|
|
$this->assertEquals(44, $doc->num_value, 'The numeric value was not updated');
|
|
$this->assertNull($doc->sub, 'The sub-document should have been null');
|
|
}
|
|
|
|
#[TestDox('update() succeeds when replacing a document')]
|
|
public function testUpdateSucceedsWhenReplacingADocument(): void
|
|
{
|
|
Document::update(ThrowawayDb::TABLE, 'one', new TestDocument('one', 'howdy', 8, new SubDocument('y', 'z')));
|
|
$tryDoc = Find::byId(ThrowawayDb::TABLE, 'one', TestDocument::class);
|
|
$this->assertNotFalse($tryDoc->isSome, 'There should have been a document returned');
|
|
$doc = $tryDoc->value;
|
|
$this->assertEquals('howdy', $doc->value, 'The value was incorrect');
|
|
$this->assertEquals(8, $doc->num_value, 'The numeric value was incorrect');
|
|
$this->assertNotNull($doc->sub, 'The sub-document should not have been null');
|
|
$this->assertEquals('y', $doc->sub->foo, 'The sub-document foo property was incorrect');
|
|
$this->assertEquals('z', $doc->sub->bar, 'The sub-document bar property was incorrect');
|
|
}
|
|
|
|
#[TestDox('update() succeeds when no document is replaced')]
|
|
public function testUpdateSucceedsWhenNoDocumentIsReplaced(): void
|
|
{
|
|
Document::update(ThrowawayDb::TABLE, 'two-hundred', new TestDocument('200'));
|
|
$doc = Find::byId(ThrowawayDb::TABLE, 'two-hundred', TestDocument::class);
|
|
$this->assertTrue($doc->isNone, 'There should not have been a document returned');
|
|
}
|
|
}
|