chore: refactor datastore samples (#2033)

Author: bshaffer

datastore/api/src/ancestor_query.php

@@ -23,10 +23,11 @@
 /**
  * Create an ancestor query.
  *
- * @param DatastoreClient $datastore
+ * @param string $namespaceId
  */
-function ancestor_query(DatastoreClient $datastore)
+function ancestor_query(string $namespaceId = null)
 {
+    $datastore = new DatastoreClient(['namespaceId' => $namespaceId]);
     // [START datastore_ancestor_query]
     $ancestorKey = $datastore->key('TaskList', 'default');
     $query = $datastore->query()

datastore/api/src/array_value.php

@@ -18,16 +18,17 @@
 namespace Google\Cloud\Samples\Datastore;
 
 use Google\Cloud\Datastore\DatastoreClient;
-use Google\Cloud\Datastore\Key;
 
 /**
  * Create a Datastore entity with some array properties.
  *
- * @param DatastoreClient $datastore
- * @param Key $key
+ * @param string $keyId
+ * @param string $namespaceId
  */
-function array_value(DatastoreClient $datastore, Key $key)
+function array_value(string $keyId, string $namespaceId = null)
 {
+    $datastore = new DatastoreClient(['namespaceId' => $namespaceId]);
+    $key = $datastore->key('Task', $keyId);
     // [START datastore_array_value]
     $task = $datastore->entity(
         $key,

datastore/api/src/array_value_equality.php

@@ -23,10 +23,11 @@
 /**
  * Create a query with equality filters.
  *
- * @param DatastoreClient $datastore
+ * @param string $namespaceId
  */
-function array_value_equality(DatastoreClient $datastore)
+function array_value_equality(string $namespaceId = null)
 {
+    $datastore = new DatastoreClient(['namespaceId' => $namespaceId]);
     // [START datastore_array_value_equality]
     $query = $datastore->query()
         ->kind('Task')

datastore/api/src/array_value_inequality_range.php

@@ -23,10 +23,11 @@
 /**
  * Create a query with inequality filters.
  *
- * @param DatastoreClient $datastore
+ * @param string $namespaceId
  */
-function array_value_inequality_range(DatastoreClient $datastore)
+function array_value_inequality_range(string $namespaceId = null)
 {
+    $datastore = new DatastoreClient(['namespaceId' => $namespaceId]);
     // [START datastore_array_value_inequality_range]
     $query = $datastore->query()
         ->kind('Task')

datastore/api/src/ascending_sort.php

@@ -23,10 +23,11 @@
 /**
  * Create a query with ascending sort.
  *
- * @param DatastoreClient $datastore
+ * @param string $namespaceId
  */
-function ascending_sort(DatastoreClient $datastore)
+function ascending_sort(string $namespaceId = null)
 {
+    $datastore = new DatastoreClient(['namespaceId' => $namespaceId]);
     // [START datastore_ascending_sort]
     $query = $datastore->query()
         ->kind('Task')

datastore/api/src/basic_entity.php

@@ -22,10 +22,11 @@
 /**
  * Create a Datastore entity.
  *
- * @param DatastoreClient $datastore
+ * @param string $namespaceId
  */
-function basic_entity(DatastoreClient $datastore)
+function basic_entity(string $namespaceId = null)
 {
+    $datastore = new DatastoreClient(['namespaceId' => $namespaceId]);
     // [START datastore_basic_entity]
     $task = $datastore->entity('Task', [
         'category' => 'Personal',

datastore/api/src/basic_gql_query.php

@@ -23,10 +23,11 @@
 /**
  * Create a basic Datastore Gql query.
  *
- * @param DatastoreClient $datastore
+ * @param string $namespaceId
  */
-function basic_gql_query(DatastoreClient $datastore)
+function basic_gql_query(string $namespaceId = null)
 {
+    $datastore = new DatastoreClient(['namespaceId' => $namespaceId]);
     // [START datastore_basic_gql_query]
     $gql = <<<EOF
 SELECT * from Task

datastore/api/src/basic_query.php

@@ -23,10 +23,11 @@
 /**
  * Create a basic Datastore query.
  *
- * @param DatastoreClient $datastore
+ * @param string $namespaceId
  */
-function basic_query(DatastoreClient $datastore)
+function basic_query(string $namespaceId = null)
 {
+    $datastore = new DatastoreClient(['namespaceId' => $namespaceId]);
     // [START datastore_basic_query]
     $query = $datastore->query()
         ->kind('Task')

datastore/api/src/batch_delete.php

@@ -18,16 +18,17 @@
 namespace Google\Cloud\Samples\Datastore;
 
 use Google\Cloud\Datastore\DatastoreClient;
-use Google\Cloud\Datastore\Key;
 
 /**
  * Delete multiple Datastore entities with the given keys.
  *
- * @param DatastoreClient $datastore
- * @param array<Key> $keys
+ * @param array<string> $keyIds
+ * @param string $namespaceId
  */
-function batch_delete(DatastoreClient $datastore, array $keys)
+function batch_delete(array $keyIds, string $namespaceId = null)
 {
+    $datastore = new DatastoreClient(['namespaceId' => $namespaceId]);
+    $keys = array_map(fn ($keyId) => $datastore->key('Task', $keyId), $keyIds);
     // [START datastore_batch_delete]
     $result = $datastore->deleteBatch($keys);
     // [END datastore_batch_delete]

datastore/api/src/batch_lookup.php

@@ -18,16 +18,17 @@
 namespace Google\Cloud\Samples\Datastore;
 
 use Google\Cloud\Datastore\DatastoreClient;
-use Google\Cloud\Datastore\Key;
 
 /**
  * Lookup multiple entities.
  *
- * @param DatastoreClient $datastore
- * @param array<Key> $keys
+ * @param array<string> $keyIds
+ * @param string $namespaceId
  */
-function batch_lookup(DatastoreClient $datastore, array $keys)
+function batch_lookup(array $keyIds, string $namespaceId = null)
 {
+    $datastore = new DatastoreClient(['namespaceId' => $namespaceId]);
+    $keys = array_map(fn ($keyId) => $datastore->key('Task', $keyId), $keyIds);
     // [START datastore_batch_lookup]
     $result = $datastore->lookupBatch($keys);
     if (isset($result['found'])) {