Class: Gcloud::Datastore::Query
- Inherits:
-
Object
- Object
- Gcloud::Datastore::Query
- Defined in:
- lib/gcloud/datastore/query.rb
Overview
Instance Method Summary collapse
-
#ancestor(parent) ⇒ Object
Add a filter for entities that inherit from a key.
-
#group_by(*names) ⇒ Object
Group results by a list of properties.
-
#initialize ⇒ Query
constructor
Returns a new query object.
-
#kind(*kinds) ⇒ Object
Add the kind of entities to query.
-
#limit(num) ⇒ Object
Set a limit on the number of results to be returned.
-
#offset(num) ⇒ Object
Set an offset for the results to be returned.
-
#order(name, direction = :asc) ⇒ Object
Sort the results by a property name.
-
#select(*names) ⇒ Object
(also: #projection)
Retrieve only select properties from the matched entities.
-
#start(cursor) ⇒ Object
(also: #cursor)
Set the cursor to start the results at.
-
#to_proto ⇒ Object
:nodoc:.
-
#where(name, operator, value) ⇒ Object
(also: #filter)
Add a property filter to the query.
Constructor Details
Instance Method Details
#ancestor(parent) ⇒ Object
86 87 88 89 90 |
# File 'lib/gcloud/datastore/query.rb', line 86 def ancestor parent # Use key if given an entity parent = parent.key if parent.respond_to? :key where "__key__", "~", parent end |
#group_by(*names) ⇒ Object
178 179 180 181 182 |
# File 'lib/gcloud/datastore/query.rb', line 178 def group_by *names @_query.group_by ||= [] @_query.group_by += Proto.new_property_references(*names) self end |
#kind(*kinds) ⇒ Object
48 49 50 51 52 53 |
# File 'lib/gcloud/datastore/query.rb', line 48 def kind *kinds @_query.kind ||= Proto::KindExpression.new @_query.kind.name ||= [] @_query.kind.name |= kinds self end |
#limit(num) ⇒ Object
121 122 123 124 |
# File 'lib/gcloud/datastore/query.rb', line 121 def limit num @_query.limit = num self end |
#offset(num) ⇒ Object
135 136 137 138 |
# File 'lib/gcloud/datastore/query.rb', line 135 def offset num @_query.offset = num self end |
#order(name, direction = :asc) ⇒ Object
103 104 105 106 107 108 109 110 111 |
# File 'lib/gcloud/datastore/query.rb', line 103 def order name, direction = :asc @_query.order ||= [] po = Proto::PropertyOrder.new po.property = Proto::PropertyReference.new po.property.name = name po.direction = Proto.to_prop_order_direction direction @_query.order << po self end |
#select(*names) ⇒ Object Also known as: projection
163 164 165 166 167 |
# File 'lib/gcloud/datastore/query.rb', line 163 def select *names @_query.projection ||= [] @_query.projection += Proto.new_property_expressions(*names) self end |
#start(cursor) ⇒ Object Also known as: cursor
149 150 151 152 |
# File 'lib/gcloud/datastore/query.rb', line 149 def start cursor @_query.start_cursor = Proto.decode_cursor cursor self end |
#to_proto ⇒ Object
:nodoc:
184 185 186 |
# File 'lib/gcloud/datastore/query.rb', line 184 def to_proto #:nodoc: @_query end |
#where(name, operator, value) ⇒ Object Also known as: filter
63 64 65 66 67 68 69 70 71 72 73 74 75 |
# File 'lib/gcloud/datastore/query.rb', line 63 def where name, operator, value # Initialize filter @_query.filter ||= Proto.new_filter.tap do |f| f.composite_filter = Proto.new_composite_filter end # Create new property filter filter = Proto.new_filter.tap do |f| f.property_filter = Proto.new_property_filter name, operator, value end # Add new property filter to the list @_query.filter.composite_filter.filter << filter self end |