3232use Google \Cloud \Datastore \V1 \Client \DatastoreClient ;
3333use Google \Cloud \Datastore \V1 \CommitRequest ;
3434use Google \Cloud \Datastore \V1 \CommitRequest \Mode ;
35- use Google \Cloud \Datastore \V1 \Key as GrpcKey ;
35+ use Google \Cloud \Datastore \V1 \EntityResult ;
36+ use Google \Cloud \Datastore \V1 \Key as ProtobufKey ;
3637use Google \Cloud \Datastore \V1 \LookupRequest ;
3738use Google \Cloud \Datastore \V1 \Mutation ;
3839use Google \Cloud \Datastore \V1 \ReadOptions ;
4142use Google \Cloud \Datastore \V1 \RunAggregationQueryRequest ;
4243use Google \Cloud \Datastore \V1 \RunQueryRequest ;
4344use Google \Cloud \Datastore \V1 \TransactionOptions ;
45+ use Google \Protobuf \RepeatedField ;
4446use Google \Protobuf \Timestamp as ProtobufTimestamp ;
4547use InvalidArgumentException ;
4648
@@ -310,10 +312,10 @@ public function beginTransaction($transactionOptions, array $options = [])
310312 $ protoTransactionOptions = new TransactionOptions ();
311313 $ protoTransactionOptions ->mergeFromJsonString (json_encode ($ transactionOptions ));
312314
313- $ beginTransactionRequest = new BeginTransactionRequest ();
314- $ beginTransactionRequest ->setProjectId ($ this ->projectId );
315- $ beginTransactionRequest ->setDatabaseId ($ options ['databaseId ' ] ?? $ this ->databaseId );
316- $ beginTransactionRequest ->setTransactionOptions ($ protoTransactionOptions );
315+ $ beginTransactionRequest = ( new BeginTransactionRequest ())
316+ ->setProjectId ($ this ->projectId )
317+ ->setDatabaseId ($ options ['databaseId ' ] ?? $ this ->databaseId )
318+ ->setTransactionOptions ($ protoTransactionOptions );
317319
318320 $ res = $ this ->gapicClient ->beginTransaction ($ beginTransactionRequest , $ options );
319321
@@ -353,19 +355,19 @@ public function allocateIds(array $keys, array $options = [])
353355
354356 $ serviceKeys = [];
355357 foreach ($ keys as $ key ) {
356- $ keyMessage = new GrpcKey ();
358+ $ keyMessage = new protobufKey ();
357359 $ keyMessage ->mergeFromJsonString (json_encode ($ key ->keyObject ()));
358360 $ serviceKeys [] = $ keyMessage ;
359361 }
360362
361- $ request = new AllocateIdsRequest ();
362- $ request ->setProjectId ($ this ->projectId );
363- $ request ->setDatabaseId ($ options ['databaseId ' ] ?? $ this ->databaseId );
364- $ request ->setKeys ($ serviceKeys );
363+ $ request = ( new AllocateIdsRequest ())
364+ ->setProjectId ($ this ->projectId )
365+ ->setDatabaseId ($ options ['databaseId ' ] ?? $ this ->databaseId )
366+ ->setKeys ($ serviceKeys );
365367
366368 $ allocateIdsResponse = $ this ->gapicClient ->allocateIds ($ request , $ options );
367369
368- /** @var GrpcKey $responseKey */
370+ /** @var protobufKey $responseKey */
369371 foreach ($ allocateIdsResponse ->getKeys () as $ index => $ responseKey ) {
370372 $ path = $ responseKey ->getPath ();
371373
@@ -425,17 +427,16 @@ public function lookup(array $keys, array $options = [])
425427 ));
426428 }
427429
428- $ grpcKey = new GrpcKey ();
429- $ grpcKey ->mergeFromJsonString (json_encode ($ key ->keyObject ()));
430- $ serviceKeys [] = $ grpcKey ;
430+ $ protobufKey = new protobufKey ();
431+ $ protobufKey ->mergeFromJsonString (json_encode ($ key ->keyObject ()));
432+ $ serviceKeys [] = $ protobufKey ;
431433 });
432434
433- $ lookupRequest = new LookupRequest ();
434- $ lookupRequest ->setDatabaseId ($ options ['databaseId ' ] ?? $ this ->databaseId );
435- $ lookupRequest ->setProjectId ($ this ->projectId );
436- $ lookupRequest ->setKeys ($ serviceKeys );
437-
438- $ lookupRequest ->setReadOptions ($ this ->createReadOptions ($ options ));
435+ $ lookupRequest = (new LookupRequest ())
436+ ->setDatabaseId ($ options ['databaseId ' ] ?? $ this ->databaseId )
437+ ->setProjectId ($ this ->projectId )
438+ ->setKeys ($ serviceKeys )
439+ ->setReadOptions ($ this ->createReadOptions ($ options ));
439440
440441 $ lookupResponse = $ this ->gapicClient ->lookup ($ lookupRequest , $ options );
441442
@@ -445,7 +446,7 @@ public function lookup(array $keys, array $options = [])
445446 'deferred ' => [],
446447 ];
447448
448- /** @var GrpcEntity $found */
449+ /** @var protoEntity $found */
449450 foreach ($ lookupResponse ->getFound () as $ found ) {
450451 $ result ['found ' ][] = $ this ->mapEntityResult (
451452 $ this ->serializer ->encodeMessage ($ found ), $ options ['className ' ]
@@ -456,15 +457,15 @@ public function lookup(array $keys, array $options = [])
456457 $ result ['found ' ] = $ this ->sortEntities ($ result ['found ' ], $ keys );
457458 }
458459
459- /** @var GrpcEntity $missing */
460+ /** @var entityResult $missing*/
460461 foreach ($ lookupResponse ->getMissing () as $ missing ) {
461462 $ result ['missing ' ][] = $ this ->key (
462463 $ missing ->getEntity ()->getKey ()->getPath (),
463464 $ missing ->getEntity ()->getKey ()->getPartitionId ()
464465 );
465466 }
466467
467- /** @var GrpcKey $deferred */
468+ /** @var protobufKey $deferred */
468469 foreach ($ lookupResponse ->getDeferred () as $ deferred ) {
469470 $ result ['deferred ' ][] = $ this ->key (
470471 $ deferred ->getPath (),
@@ -615,6 +616,8 @@ function (array $entityResult) use ($options) {
615616 * [ReadConsistency](https://cloud.google.com/datastore/reference/rest/v1/ReadOptions#ReadConsistency).
616617 * @type string $databaseId ID of the database to which the entities belong.
617618 * @type Timestamp $readTime Reads entities as they were at the given timestamp.
619+ * @type ExplainOptions $explainOptions An ExplainOptions object to get the execution stats
620+ * {@see ExplainOptions}
618621 * }
619622 * @return AggregationQueryResult
620623 */
@@ -692,11 +695,12 @@ public function commit(array $mutations, array $options = [])
692695 $ protoMutations [] = $ protoMutation ;
693696 }
694697
695- $ commitRequest = new CommitRequest ();
696- $ commitRequest ->setMutations ($ protoMutations );
697- $ commitRequest ->setDatabaseId ($ options ['databaseId ' ]);
698- $ commitRequest ->setProjectId ($ this ->projectId );
699- $ commitRequest ->setMode ($ transactionMode );
698+ $ commitRequest = (new CommitRequest ())
699+ ->setMutations ($ protoMutations )
700+ ->setDatabaseId ($ options ['databaseId ' ])
701+ ->setProjectId ($ this ->projectId )
702+ ->setMode ($ transactionMode );
703+
700704 if ($ transactionMode === Mode::TRANSACTIONAL ) {
701705 $ commitRequest ->setTransaction (base64_decode ($ options ['transaction ' ]));
702706 }
@@ -793,10 +797,10 @@ public function mutation(
793797 */
794798 public function rollback ($ transactionId )
795799 {
796- $ rollbackRequest = new RollbackRequest ();
797- $ rollbackRequest ->setProjectId ($ this ->projectId );
798- $ rollbackRequest ->setDatabaseId ($ this ->databaseId );
799- $ rollbackRequest ->setTransaction (base64_decode ($ transactionId ));
800+ $ rollbackRequest = ( new RollbackRequest ())
801+ ->setProjectId ($ this ->projectId )
802+ ->setDatabaseId ($ this ->databaseId )
803+ ->setTransaction (base64_decode ($ transactionId ));
800804
801805 $ this ->gapicClient ->rollback ($ rollbackRequest );
802806 }
@@ -885,7 +889,7 @@ private function mapEntityResult(array $result, $class)
885889 }
886890
887891 return $ this ->entity ($ key , $ properties , [
888- 'cursor ' => ( isset ( $ result ['cursor ' ]) && $ result [ ' cursor ' ] !== '' )
892+ 'cursor ' => ! empty ( $ result ['cursor ' ])
889893 ? $ result ['cursor ' ]
890894 : null ,
891895 'baseVersion ' => (isset ($ result ['version ' ]))
0 commit comments