ServiceContainerTest.php

Go to the documentation of this file.

<?php
use MediaWiki\Services\ServiceContainer;

class ServiceContainerTest extends PHPUnit_Framework_TestCase {

    private function newServiceContainer( $extraArgs = [] ) {
        return new ServiceContainer( $extraArgs );
    }

    public function testGetServiceNames() {
        $services = $this->newServiceContainer();
        $names = $services->getServiceNames();

        $this->assertInternalType( 'array', $names );
        $this->assertEmpty( $names );

        $name = 'TestService92834576';
        $services->defineService( $name, function() {
            return null;
        } );

        $names = $services->getServiceNames();
        $this->assertContains( $name, $names );
    }

    public function testHasService() {
        $services = $this->newServiceContainer();

        $name = 'TestService92834576';
        $this->assertFalse( $services->hasService( $name ) );

        $services->defineService( $name, function() {
            return null;
        } );

        $this->assertTrue( $services->hasService( $name ) );
    }

    public function testGetService() {
        $services = $this->newServiceContainer( [ 'Foo' ] );

        $theService = new stdClass();
        $name = 'TestService92834576';
        $count = 0;

        $services->defineService(
            $name,
            function( $actualLocator, $extra ) use ( $services, $theService, &$count ) {
                $count++;
                PHPUnit_Framework_Assert::assertSame( $services, $actualLocator );
                PHPUnit_Framework_Assert::assertSame( $extra, 'Foo' );
                return $theService;
            }
        );

        $this->assertSame( $theService, $services->getService( $name ) );

        $services->getService( $name );
        $this->assertSame( 1, $count, 'instantiator should be called exactly once!' );
    }

    public function testGetService_fail_unknown() {
        $services = $this->newServiceContainer();

        $name = 'TestService92834576';

        $this->setExpectedException( 'MediaWiki\Services\NoSuchServiceException' );

        $services->getService( $name );
    }

    public function testPeekService() {
        $services = $this->newServiceContainer();

        $services->defineService(
            'Foo',
            function() {
                return new stdClass();
            }
        );

        $services->defineService(
            'Bar',
            function() {
                return new stdClass();
            }
        );

        // trigger instantiation of Foo
        $services->getService( 'Foo' );

        $this->assertInternalType(
            'object',
            $services->peekService( 'Foo' ),
            'Peek should return the service object if it had been accessed before.'
        );

        $this->assertNull(
            $services->peekService( 'Bar' ),
            'Peek should return null if the service was never accessed.'
        );
    }

    public function testPeekService_fail_unknown() {
        $services = $this->newServiceContainer();

        $name = 'TestService92834576';

        $this->setExpectedException( 'MediaWiki\Services\NoSuchServiceException' );

        $services->peekService( $name );
    }

    public function testDefineService() {
        $services = $this->newServiceContainer();

        $theService = new stdClass();
        $name = 'TestService92834576';

        $services->defineService( $name, function( $actualLocator ) use ( $services, $theService ) {
            PHPUnit_Framework_Assert::assertSame( $services, $actualLocator );
            return $theService;
        } );

        $this->assertTrue( $services->hasService( $name ) );
        $this->assertSame( $theService, $services->getService( $name ) );
    }

    public function testDefineService_fail_duplicate() {
        $services = $this->newServiceContainer();

        $theService = new stdClass();
        $name = 'TestService92834576';

        $services->defineService( $name, function() use ( $theService ) {
            return $theService;
        } );

        $this->setExpectedException( 'MediaWiki\Services\ServiceAlreadyDefinedException' );

        $services->defineService( $name, function() use ( $theService ) {
            return $theService;
        } );
    }

    public function testApplyWiring() {
        $services = $this->newServiceContainer();

        $wiring = [
            'Foo' => function() {
                return 'Foo!';
            },
            'Bar' => function() {
                return 'Bar!';
            },
        ];

        $services->applyWiring( $wiring );

        $this->assertSame( 'Foo!', $services->getService( 'Foo' ) );
        $this->assertSame( 'Bar!', $services->getService( 'Bar' ) );
    }

    public function testImportWiring() {
        $services = $this->newServiceContainer();

        $wiring = [
            'Foo' => function() {
                return 'Foo!';
            },
            'Bar' => function() {
                return 'Bar!';
            },
            'Car' => function() {
                return 'FUBAR!';
            },
        ];

        $services->applyWiring( $wiring );

        $newServices = $this->newServiceContainer();

        // define a service before importing, so we can later check that
        // existing service instances survive importWiring()
        $newServices->defineService( 'Car', function() {
            return 'Car!';
        } );

        // force instantiation
        $newServices->getService( 'Car' );

        // Define another service, so we can later check that extra wiring
        // is not lost.
        $newServices->defineService( 'Xar', function() {
            return 'Xar!';
        } );

        // import wiring, but skip `Bar`
        $newServices->importWiring( $services, [ 'Bar' ] );

        $this->assertNotContains( 'Bar', $newServices->getServiceNames(), 'Skip `Bar` service' );
        $this->assertSame( 'Foo!', $newServices->getService( 'Foo' ) );

        // import all wiring, but preserve existing service instance
        $newServices->importWiring( $services );

        $this->assertContains( 'Bar', $newServices->getServiceNames(), 'Import all services' );
        $this->assertSame( 'Bar!', $newServices->getService( 'Bar' ) );
        $this->assertSame( 'Car!', $newServices->getService( 'Car' ), 'Use existing service instance' );
        $this->assertSame( 'Xar!', $newServices->getService( 'Xar' ), 'Predefined services are kept' );
    }

    public function testLoadWiringFiles() {
        $services = $this->newServiceContainer();

        $wiringFiles = [
            __DIR__ . '/TestWiring1.php',
            __DIR__ . '/TestWiring2.php',
        ];

        $services->loadWiringFiles( $wiringFiles );

        $this->assertSame( 'Foo!', $services->getService( 'Foo' ) );
        $this->assertSame( 'Bar!', $services->getService( 'Bar' ) );
    }

    public function testLoadWiringFiles_fail_duplicate() {
        $services = $this->newServiceContainer();

        $wiringFiles = [
            __DIR__ . '/TestWiring1.php',
            __DIR__ . '/./TestWiring1.php',
        ];

        // loading the same file twice should fail, because
        $this->setExpectedException( 'MediaWiki\Services\ServiceAlreadyDefinedException' );

        $services->loadWiringFiles( $wiringFiles );
    }

    public function testRedefineService() {
        $services = $this->newServiceContainer( [ 'Foo' ] );

        $theService1 = new stdClass();
        $name = 'TestService92834576';

        $services->defineService( $name, function() {
            PHPUnit_Framework_Assert::fail(
                'The original instantiator function should not get called'
            );
        } );

        // redefine before instantiation
        $services->redefineService(
            $name,
            function( $actualLocator, $extra ) use ( $services, $theService1 ) {
                PHPUnit_Framework_Assert::assertSame( $services, $actualLocator );
                PHPUnit_Framework_Assert::assertSame( 'Foo', $extra );
                return $theService1;
            }
        );

        // force instantiation, check result
        $this->assertSame( $theService1, $services->getService( $name ) );
    }

    public function testRedefineService_disabled() {
        $services = $this->newServiceContainer( [ 'Foo' ] );

        $theService1 = new stdClass();
        $name = 'TestService92834576';

        $services->defineService( $name, function() {
            return 'Foo';
        } );

        // disable the service. we should be able to redefine it anyway.
        $services->disableService( $name );

        $services->redefineService( $name, function() use ( $theService1 ) {
            return $theService1;
        } );

        // force instantiation, check result
        $this->assertSame( $theService1, $services->getService( $name ) );
    }

    public function testRedefineService_fail_undefined() {
        $services = $this->newServiceContainer();

        $theService = new stdClass();
        $name = 'TestService92834576';

        $this->setExpectedException( 'MediaWiki\Services\NoSuchServiceException' );

        $services->redefineService( $name, function() use ( $theService ) {
            return $theService;
        } );
    }

    public function testRedefineService_fail_in_use() {
        $services = $this->newServiceContainer( [ 'Foo' ] );

        $theService = new stdClass();
        $name = 'TestService92834576';

        $services->defineService( $name, function() {
            return 'Foo';
        } );

        // create the service, so it can no longer be redefined
        $services->getService( $name );

        $this->setExpectedException( 'MediaWiki\Services\CannotReplaceActiveServiceException' );

        $services->redefineService( $name, function() use ( $theService ) {
            return $theService;
        } );
    }

    public function testDisableService() {
        $services = $this->newServiceContainer( [ 'Foo' ] );

        $destructible = $this->getMock( 'MediaWiki\Services\DestructibleService' );
        $destructible->expects( $this->once() )
            ->method( 'destroy' );

        $services->defineService( 'Foo', function() use ( $destructible ) {
            return $destructible;
        } );
        $services->defineService( 'Bar', function() {
            return new stdClass();
        } );
        $services->defineService( 'Qux', function() {
            return new stdClass();
        } );

        // instantiate Foo and Bar services
        $services->getService( 'Foo' );
        $services->getService( 'Bar' );

        // disable service, should call destroy() once.
        $services->disableService( 'Foo' );

        // disabled service should still be listed
        $this->assertContains( 'Foo', $services->getServiceNames() );

        // getting other services should still work
        $services->getService( 'Bar' );

        // disable non-destructible service, and not-yet-instantiated service
        $services->disableService( 'Bar' );
        $services->disableService( 'Qux' );

        $this->assertNull( $services->peekService( 'Bar' ) );
        $this->assertNull( $services->peekService( 'Qux' ) );

        // disabled service should still be listed
        $this->assertContains( 'Bar', $services->getServiceNames() );
        $this->assertContains( 'Qux', $services->getServiceNames() );

        $this->setExpectedException( 'MediaWiki\Services\ServiceDisabledException' );
        $services->getService( 'Qux' );
    }

    public function testDisableService_fail_undefined() {
        $services = $this->newServiceContainer();

        $theService = new stdClass();
        $name = 'TestService92834576';

        $this->setExpectedException( 'MediaWiki\Services\NoSuchServiceException' );

        $services->redefineService( $name, function() use ( $theService ) {
            return $theService;
        } );
    }

    public function testDestroy() {
        $services = $this->newServiceContainer();

        $destructible = $this->getMock( 'MediaWiki\Services\DestructibleService' );
        $destructible->expects( $this->once() )
            ->method( 'destroy' );

        $services->defineService( 'Foo', function() use ( $destructible ) {
            return $destructible;
        } );

        $services->defineService( 'Bar', function() {
            return new stdClass();
        } );

        // create the service
        $services->getService( 'Foo' );

        // destroy the container
        $services->destroy();

        $this->setExpectedException( 'MediaWiki\Services\ContainerDisabledException' );
        $services->getService( 'Bar' );
    }

}