1. trait
  2. Google
  3. \
  4. GAX
  5. \
  6. Testing
  7. \
  8. MockStubTrait

MockStubTrait

trait MockStubTrait

The MockStubTrait is used by generated mock stub classes which extent \Grpc\BaseStub (https://github.com/grpc/grpc/blob/master/src/php/lib/Grpc/BaseStub.php) It provides functionality to add responses, get received calls, and overrides the _simpleRequest method so that the elements of $responses are returned instead of making a call to the API.

Methods

MockUnaryCall
_simpleRequest(string $method, Message $argument, callable $deserialize, array $metadata = [], array $options = [])

Overrides the _simpleRequest method in \Grpc\BaseStub (https://github.com/grpc/grpc/blob/master/src/php/lib/Grpc/BaseStub.php) Returns a MockUnaryCall object that will return the first item from $responses

MockClientStreamingCall
_clientStreamRequest(string $method, callable $deserialize, array $metadata = [], array $options = [])

Overrides the _clientStreamRequest method in \Grpc\BaseStub (https://github.com/grpc/grpc/blob/master/src/php/lib/Grpc/BaseStub.php) Returns a MockClientStreamingCall object that will return the first item from $responses

MockServerStreamingCall
_serverStreamRequest(string $method, Message $argument, callable $deserialize, array $metadata = [], array $options = [])

Overrides the _serverStreamRequest method in \Grpc\BaseStub (https://github.com/grpc/grpc/blob/master/src/php/lib/Grpc/BaseStub.php) Returns a MockServerStreamingCall object that will stream items from $responses, and return a final status of $serverStreamingStatus.

MockBidiStreamingCall
_bidiRequest(string $method, callable $deserialize, array $metadata = [], array $options = [])

Overrides the _bidiRequest method in \Grpc\BaseStub (https://github.com/grpc/grpc/blob/master/src/php/lib/Grpc/BaseStub.php) Returns a MockBidiStreamingCall object that will stream items from $responses, and return a final status of $serverStreamingStatus.

static 
stripStatusFromResponses($responses)

No description

addResponse(Message $response, Status $status = null)

Add a response object, and an optional status, to the list of responses to be returned via _simpleRequest.

setStreamingStatus(Status $status)

Set the status object to be used when creating streaming calls.

ReceivedRequest[]
popReceivedCalls()

Return a list of calls made to _simpleRequest, and clear $receivedFuncCalls.

int
getReceivedCallCount()

No description

mixed[]
popCallObjects()

No description

bool
isExhausted()

No description

Details

at line 60
MockUnaryCall _simpleRequest(string $method, Message $argument, callable $deserialize, array $metadata = [], array $options = [])

Overrides the _simpleRequest method in \Grpc\BaseStub (https://github.com/grpc/grpc/blob/master/src/php/lib/Grpc/BaseStub.php) Returns a MockUnaryCall object that will return the first item from $responses

Parameters

string $method The API method name to be called
Message $argument The request object to the API method
callable $deserialize A function to deserialize the response object
array $metadata
array $options

Return Value

MockUnaryCall

at line 95
MockClientStreamingCall _clientStreamRequest(string $method, callable $deserialize, array $metadata = [], array $options = [])

Overrides the _clientStreamRequest method in \Grpc\BaseStub (https://github.com/grpc/grpc/blob/master/src/php/lib/Grpc/BaseStub.php) Returns a MockClientStreamingCall object that will return the first item from $responses

Parameters

string $method The name of the method to call
callable $deserialize A function that deserializes the responses
array $metadata A metadata map to send to the server (optional)
array $options An array of options (optional)

Return Value

MockClientStreamingCall The active call object

at line 127
MockServerStreamingCall _serverStreamRequest(string $method, Message $argument, callable $deserialize, array $metadata = [], array $options = [])

Overrides the _serverStreamRequest method in \Grpc\BaseStub (https://github.com/grpc/grpc/blob/master/src/php/lib/Grpc/BaseStub.php) Returns a MockServerStreamingCall object that will stream items from $responses, and return a final status of $serverStreamingStatus.

Parameters

string $method The name of the method to call
Message $argument The argument to the method
callable $deserialize A function that deserializes the responses
array $metadata A metadata map to send to the server (optional)
array $options An array of options (optional)

Return Value

MockServerStreamingCall The active call object

at line 162
MockBidiStreamingCall _bidiRequest(string $method, callable $deserialize, array $metadata = [], array $options = [])

Overrides the _bidiRequest method in \Grpc\BaseStub (https://github.com/grpc/grpc/blob/master/src/php/lib/Grpc/BaseStub.php) Returns a MockBidiStreamingCall object that will stream items from $responses, and return a final status of $serverStreamingStatus.

Parameters

string $method The name of the method to call
callable $deserialize A function that deserializes the responses
array $metadata A metadata map to send to the server (optional)
array $options An array of options (optional)

Return Value

MockBidiStreamingCall The active call object

at line 177
static stripStatusFromResponses($responses)

Parameters

$responses

at line 193
addResponse(Message $response, Status $status = null)

Add a response object, and an optional status, to the list of responses to be returned via _simpleRequest.

Parameters

Message $response
Status $status

at line 206
setStreamingStatus(Status $status)

Set the status object to be used when creating streaming calls.

Parameters

Status $status

at line 216
ReceivedRequest[] popReceivedCalls()

Return a list of calls made to _simpleRequest, and clear $receivedFuncCalls.

Return Value

ReceivedRequest[] An array of received requests

at line 226
int getReceivedCallCount()

Return Value

int The number of calls received.

at line 234
mixed[] popCallObjects()

Return Value

mixed[] The call objects created by calls to the stub

at line 244
bool isExhausted()

Return Value

bool True if $receivedFuncCalls and $response are empty.