Class: Google::Cloud::Datastore::Key
- Inherits:
-
Object
- Object
- Google::Cloud::Datastore::Key
- Defined in:
- lib/google/cloud/datastore/key.rb
Overview
Key
Every Datastore record has an identifying key, which includes the record's entity kind and a unique identifier. The identifier may be either a key name string, assigned explicitly by the application, or an integer numeric ID, assigned automatically by Datastore.
Instance Attribute Summary collapse
-
#id ⇒ Integer?
readonly
The id of the Key.
-
#kind ⇒ String
The kind of the Key.
-
#name ⇒ String?
readonly
The name of the Key.
-
#namespace ⇒ String?
The namespace of the Key.
-
#parent ⇒ Key?
The parent of the Key.
-
#project ⇒ String
(also: #dataset_id)
The project of the Key.
Instance Method Summary collapse
-
#complete? ⇒ Boolean
Determine if the key is complete.
-
#incomplete? ⇒ Boolean
Determine if the key is incomplete.
-
#initialize(kind = nil, id_or_name = nil) ⇒ Google::Cloud::Datastore::Dataset::Key
constructor
Create a new Key instance.
-
#path ⇒ Array<Array<(String, String)>>
Represent the Key's path (including parent) as an array of arrays.
-
#serialized_size ⇒ Object
The number of bytes the Key will take to serialize during API calls.
Constructor Details
#initialize(kind = nil, id_or_name = nil) ⇒ Google::Cloud::Datastore::Dataset::Key
Create a new Key instance.
99 100 101 102 103 104 105 106 |
# File 'lib/google/cloud/datastore/key.rb', line 99 def initialize kind = nil, id_or_name = nil @kind = kind if id_or_name.is_a? Integer @id = id_or_name else @name = id_or_name end end |
Instance Attribute Details
#id ⇒ Integer?
The id of the Key.
140 141 142 |
# File 'lib/google/cloud/datastore/key.rb', line 140 def id @id end |
#kind ⇒ String
The kind of the Key.
45 46 47 |
# File 'lib/google/cloud/datastore/key.rb', line 45 def kind @kind end |
#name ⇒ String?
The name of the Key.
174 175 176 |
# File 'lib/google/cloud/datastore/key.rb', line 174 def name @name end |
#namespace ⇒ String?
The namespace of the Key.
83 84 85 |
# File 'lib/google/cloud/datastore/key.rb', line 83 def namespace @namespace end |
#parent ⇒ Key?
The parent of the Key.
219 220 221 |
# File 'lib/google/cloud/datastore/key.rb', line 219 def parent @parent end |
#project ⇒ String Also known as: dataset_id
The project of the Key.
63 64 65 |
# File 'lib/google/cloud/datastore/key.rb', line 63 def project @project end |
Instance Method Details
#complete? ⇒ Boolean
Determine if the key is complete. A complete key has either an id or a name.
Inverse of #incomplete?
246 247 248 |
# File 'lib/google/cloud/datastore/key.rb', line 246 def complete? !incomplete? end |
#incomplete? ⇒ Boolean
Determine if the key is incomplete. An incomplete key has neither an id nor a name.
Inverse of #complete?
255 256 257 |
# File 'lib/google/cloud/datastore/key.rb', line 255 def incomplete? kind.nil? || (id.nil? && (name.nil? || name.empty?)) end |
#path ⇒ Array<Array<(String, String)>>
Represent the Key's path (including parent) as an array of arrays. Each inner array contains two values, the kind and the id or name. If neither an id or name exist then nil will be returned.
236 237 238 239 |
# File 'lib/google/cloud/datastore/key.rb', line 236 def path new_path = parent ? parent.path : [] new_path << [kind, (id || name)] end |
#serialized_size ⇒ Object
The number of bytes the Key will take to serialize during API calls.
261 262 263 |
# File 'lib/google/cloud/datastore/key.rb', line 261 def serialized_size to_grpc.to_proto.length end |