* @copyright Meritoo.pl */ class ParticipantServiceTest extends BaseTestCase { /** * Service that serves participants. * Without participants. * * @var ParticipantService */ private $serviceWithoutParticipants; /** * Service that serves participants. * With participants. * * @var ParticipantService */ private $serviceWithParticipants; public function testConstructorVisibilityAndArguments() { static::assertConstructorVisibilityAndArguments(ParticipantService::className, OopVisibilityType::IS_PUBLIC, 3, 1); } public function testGetClient() { $rpcClientManager = $this->getJsonRpcClientManager(0); $sessionManager = $this->getSessionManager(); $this->createServiceWithoutParticipants($rpcClientManager, $sessionManager); $this->createServiceWithParticipants($rpcClientManager, $sessionManager); static::assertInstanceOf(Client::className, $this->serviceWithoutParticipants->getClient()); static::assertInstanceOf(Client::className, $this->serviceWithParticipants->getClient()); $connectionConfiguration = $this->getConnectionConfiguration(); $client = new Client($connectionConfiguration); $participantService = new ParticipantService($client); static::assertEquals($client, $participantService->getClient()); } public function testGetSurveyParticipants() { $rpcClientManager = $this->getJsonRpcClientManager(3); $sessionManager = $this->getSessionManager(); $this->createServiceWithoutParticipants($rpcClientManager, $sessionManager); $this->createServiceWithParticipants($rpcClientManager, $sessionManager); static::assertCount(0, $this->serviceWithoutParticipants->getSurveyParticipants(1)); static::assertCount(0, $this->serviceWithoutParticipants->getSurveyParticipants(2)); static::assertCount(2, $this->serviceWithParticipants->getSurveyParticipants(1)); static::assertCount(1, $this->serviceWithParticipants->getSurveyParticipants(2)); static::assertCount(0, $this->serviceWithParticipants->getSurveyParticipants(3)); } public function testGetSurveyParticipantsWithImportantException() { $this->setExpectedException(CannotProcessDataException::className); $exception = new CannotProcessDataException(ReasonType::NO_TOKEN_TABLE); $rpcClientManager = $this->getJsonRpcClientManagerWithException(1, $exception); $sessionManager = $this->getSessionManager(); $this->createServiceWithParticipants($rpcClientManager, $sessionManager); $this->serviceWithParticipants->getSurveyParticipants(3); } public function testGetSurveyParticipantsWithNoParticipantsException() { $exception = new CannotProcessDataException(ReasonType::NO_PARTICIPANTS_FOUND); $rpcClientManager = $this->getJsonRpcClientManagerWithException(1, $exception); $sessionManager = $this->getSessionManager(); $this->createServiceWithParticipants($rpcClientManager, $sessionManager); static::assertCount(0, $this->serviceWithParticipants->getSurveyParticipants(3)); } public function testHasParticipantUsingServiceWithoutParticipants() { $rpcClientManager = $this->getJsonRpcClientManager(2); $sessionManager = $this->getSessionManager(); $this->createServiceWithoutParticipants($rpcClientManager, $sessionManager); static::assertFalse($this->serviceWithoutParticipants->hasParticipant(1, 'john@scott.com')); static::assertFalse($this->serviceWithoutParticipants->hasParticipant(2, 'john@scott.com')); } public function testHasParticipant() { $runMethodCallResults = [ [ 'tid' => '123', 'participant_id' => null, 'mpid' => null, 'firstname' => 'John', 'lastname' => 'Scott', 'email' => 'john@scott.com', 'emailstatus' => 'OK', 'token' => uniqid(), 'language' => 'pl', 'blacklisted' => 'N', 'sent' => 'Y', 'remindersent' => 'N', 'remindercount' => 0, 'completed' => 'N', 'usesleft' => 10, 'validfrom' => null, 'validuntil' => (new DateTime())->format('Y-m-d H:i:s'), ], [ null, ], [ null, ], ]; $rpcClientManager = $this->getJsonRpcClientManager(3, $runMethodCallResults); $sessionManager = $this->getSessionManager(); $this->createServiceWithParticipants($rpcClientManager, $sessionManager); static::assertTrue($this->serviceWithParticipants->hasParticipant(1, 'john@scott.com')); static::assertFalse($this->serviceWithParticipants->hasParticipant(2, 'john@scott.com')); static::assertFalse($this->serviceWithParticipants->hasParticipant(3, 'john@scott.com')); } public function testAddParticipantForNotExistingSurvey() { $this->setExpectedException(CannotProcessDataException::className); $exception = new CannotProcessDataException(ReasonType::NOT_EXISTING_SURVEY_ID); $rpcClientManager = $this->getJsonRpcClientManagerWithException(1, $exception); $sessionManager = $this->getSessionManager(); $this->createServiceWithoutParticipants($rpcClientManager, $sessionManager); $this->createServiceWithParticipants($rpcClientManager, $sessionManager); $surveyId = 1; $firstName = 'John'; $lastName = 'Scott'; $email = 'john@scott.com'; $this->serviceWithoutParticipants->addParticipant($surveyId, $firstName, $lastName, $email); $this->serviceWithParticipants->addParticipant($surveyId, $firstName, $lastName, $email); } public function testAddParticipant() { $surveyId = 1; $firstName = 'John'; $lastName = 'Scott'; $email = 'john@scott.com'; $runMethodCallCount = 1; $runMethodCallResults = [ [ [ 'firstname' => $firstName, 'lastname' => $lastName, 'email' => $email, ], ], ]; $rpcClientManager = $this->getJsonRpcClientManager($runMethodCallCount, $runMethodCallResults); $sessionManager = $this->getSessionManager(); $this->createServiceWithoutParticipants($rpcClientManager, $sessionManager); $result = $this->serviceWithoutParticipants->addParticipant($surveyId, $firstName, $lastName, $email); static::assertInstanceOf(Participant::className, $result); static::assertEquals($firstName, $result->getFirstName()); static::assertEquals($lastName, $result->getLastName()); static::assertEquals($email, $result->getEmail()); } public function testGetParticipant() { $rpcClientManager = $this->getJsonRpcClientManager(1); $sessionManager = $this->getSessionManager(); $this->createServiceWithoutParticipants($rpcClientManager, $sessionManager); $this->createServiceWithParticipants($rpcClientManager, $sessionManager); $participant1 = $this->serviceWithoutParticipants->getParticipant(1, 'john@scott.com'); $participant2 = $this->serviceWithParticipants->getParticipant(1, 'john@scott.com'); static::assertNull($participant1); static::assertInstanceOf(ParticipantShort::className, $participant2); static::assertEquals('John', $participant2->getFirstName()); static::assertEquals('Scott', $participant2->getLastName()); static::assertEquals('john@scott.com', $participant2->getEmail()); } public function testGetParticipantDetails() { $sessionManager = $this->getSessionManager(); $rpcClientManager = $this->getJsonRpcClientManager(1); $this->createServiceWithoutParticipants($rpcClientManager, $sessionManager); $id = 1; $firstName = 'John'; $lastName = 'Scott'; $email = 'john@scott.com'; $token = uniqid(); $runMethodCallResults = [ [ 'tid' => $id, 'firstname' => $firstName, 'lastname' => $lastName, 'email' => $email, 'token' => $token, 'sent' => 'N', 'completed' => 'N', ], ]; $rpcClientManager = $this->getJsonRpcClientManager(1, $runMethodCallResults); $this->createServiceWithParticipants($rpcClientManager, $sessionManager); $participant1 = $this->serviceWithoutParticipants->getParticipantDetails(1, 'john@scott.com'); $participant2 = $this->serviceWithParticipants->getParticipantDetails(1, 'john@scott.com'); static::assertNull($participant1); static::assertInstanceOf(Participant::className, $participant2); static::assertEquals($id, $participant2->getId()); static::assertEquals($firstName, $participant2->getFirstName()); static::assertEquals($lastName, $participant2->getLastName()); static::assertEquals($email, $participant2->getEmail()); static::assertEquals($token, $participant2->getToken()); static::assertFalse($participant2->isSent()); static::assertFalse($participant2->isCompleted()); static::assertNull($participant2->isBlacklisted()); static::assertNull($participant2->getValidFrom()); } public function testHasParticipantFilledSurveyWithoutParticipants() { $this->setExpectedException(MissingParticipantOfSurveyException::className); $rpcClientManager = $this->getJsonRpcClientManager(1); $sessionManager = $this->getSessionManager(); $this->createServiceWithoutParticipants($rpcClientManager, $sessionManager); $this->serviceWithoutParticipants->hasParticipantFilledSurvey(1, 'john@scott.com'); } public function testHasParticipantFilledSurveyUsingExistingParticipant() { $runMethodCallResults = [ [ 'firstname' => 'John', 'lastname' => 'Scott', 'email' => 'john@scott.com', 'completed' => (new DateTime())->format('Y-m-d H:i'), ], ]; $rpcClientManager = $this->getJsonRpcClientManager(1, $runMethodCallResults); $sessionManager = $this->getSessionManager(); $this->createServiceWithParticipants($rpcClientManager, $sessionManager); static::assertTrue($this->serviceWithParticipants->hasParticipantFilledSurvey(1, 'john@scott.com')); } public function testHasParticipantFilledSurveyUsingNotExistingParticipant() { $this->setExpectedException(MissingParticipantOfSurveyException::className); $rpcClientManager = $this->getJsonRpcClientManager(1); $sessionManager = $this->getSessionManager(); $this->createServiceWithParticipants($rpcClientManager, $sessionManager); $this->serviceWithParticipants->hasParticipantFilledSurvey(3, 'mary@jane.com'); } /** * Returns configuration used while connecting to LimeSurvey's API * * @return ConnectionConfiguration */ private function getConnectionConfiguration() { return new ConnectionConfiguration('http://test.com', 'test', 'test'); } /** * Returns manager of session started while connecting to LimeSurvey's API * * @return PHPUnit_Framework_MockObject_MockObject */ private function getSessionManager() { return $this->createMock(SessionManager::className); } /** * Returns manager of the JsonRPC client used while connecting to LimeSurvey's API with mocked method runMethod() * * @param int $runMethodCallCount Count of calls of the runMethod() method (who is mocked) * @param array $runMethodCallResults (optional) Results of calls of the runMethod() method (who is mocked) * @return PHPUnit_Framework_MockObject_MockObject */ private function getJsonRpcClientManager($runMethodCallCount, array $runMethodCallResults = []) { $rpcClientManager = $this->createMock(JsonRpcClientManager::className); $mocker = $rpcClientManager ->expects(static::exactly($runMethodCallCount)) ->method('runMethod'); if (!empty($runMethodCallResults)) { $function = [ $mocker, 'willReturnOnConsecutiveCalls', ]; /* * I have to use the call_user_func_array() function to pass elements of $runMethodCallResults array as * arguments of the willReturnOnConsecutiveCalls() method */ call_user_func_array($function, $runMethodCallResults); } return $rpcClientManager; } /** * Returns manager of the JsonRPC client used while connecting to LimeSurvey's API with mocked method runMethod() * that throws an exception * * @param int $runMethodCallCount Count of calls of the runMethod() method (who is mocked) * @param Exception $exception The exception that should be thrown * @return PHPUnit_Framework_MockObject_MockObject */ private function getJsonRpcClientManagerWithException($runMethodCallCount, Exception $exception) { $rpcClientManager = $this->createMock(JsonRpcClientManager::className); $rpcClientManager ->expects(static::exactly($runMethodCallCount)) ->method('runMethod') ->willThrowException($exception); return $rpcClientManager; } /** * Creates instance of the tested service without participants * * @param PHPUnit_Framework_MockObject_MockObject $rpcClientManager Manager of the JsonRPC client used while connecting to LimeSurvey's API * @param PHPUnit_Framework_MockObject_MockObject $sessionManager Manager of session started while connecting to LimeSurvey's API */ private function createServiceWithoutParticipants(PHPUnit_Framework_MockObject_MockObject $rpcClientManager, PHPUnit_Framework_MockObject_MockObject $sessionManager) { $configuration = $this->getConnectionConfiguration(); $client = new Client($configuration, $rpcClientManager, $sessionManager); $this->serviceWithoutParticipants = new ParticipantService($client); } /** * Creates instance of the tested service with participants * * @param PHPUnit_Framework_MockObject_MockObject $rpcClientManager Manager of the JsonRPC client used while connecting to LimeSurvey's API * @param PHPUnit_Framework_MockObject_MockObject $sessionManager Manager of session started while connecting to LimeSurvey's API */ private function createServiceWithParticipants(PHPUnit_Framework_MockObject_MockObject $rpcClientManager, PHPUnit_Framework_MockObject_MockObject $sessionManager) { $configuration = $this->getConnectionConfiguration(); $client = new Client($configuration, $rpcClientManager, $sessionManager); $allParticipants = new Participants([ 1 => new Collection([ new ParticipantShort([ 'tid' => 1, 'participant_info' => [ 'firstname' => 'John', 'lastname' => 'Scott', 'email' => 'john@scott.com', ], ]), new ParticipantShort([ 'tid' => 2, 'participant_info' => [ 'firstname' => 'Mary', 'lastname' => 'Jane', 'email' => 'mary@jane.com', ], ]), ]), 2 => new Collection([ new ParticipantShort(), ]), ]); $this->serviceWithParticipants = new ParticipantService($client, $allParticipants); } }