com.amazonaws.services.dynamodbv2.model.Condition Maven / Gradle / Ivy
Show all versions of aws-java-sdk Show documentation
/*
* Copyright 2010-2014 Amazon.com, Inc. or its affiliates. All Rights Reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License").
* You may not use this file except in compliance with the License.
* A copy of the License is located at
*
* http://aws.amazon.com/apache2.0
*
* or in the "license" file accompanying this file. This file is distributed
* on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
* express or implied. See the License for the specific language governing
* permissions and limitations under the License.
*/
package com.amazonaws.services.dynamodbv2.model;
import java.io.Serializable;
/**
*
* Represents a selection criteria for a Query or Scan
* operation.
*
*
*
* -
* For a Query operation, the condition specifies the key
* attributes to use when querying a table or an index.
*
*
* -
* For a Scan operation, the condition is used to evaluate the
* scan results and return only the desired values.
*
*
*
*
*
* Multiple conditions are "ANDed" together. In other words, all of the
* conditions must be met to be included in the output.
*
*/
public class Condition implements Serializable {
/**
* One or more values to evaluate against the supplied attribute. This
* list contains exactly one value, except for a BETWEEN or
* IN comparison, in which case the list contains two
* values. For type Number, value comparisons are numeric.
*
String value comparisons for greater than, equals, or less than are
* based on ASCII character code values. For example, a is
* greater than A, and aa is greater than
* B. For a list of code values, see http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters.
*
For Binary, DynamoDB treats each byte of the binary data as
* unsigned when it compares binary values, for example when evaluating
* query expressions.
*/
private com.amazonaws.internal.ListWithAutoConstructFlag attributeValueList;
/**
* A comparator for evaluating attributes. For example, equals, greater
* than, less than, etc. Valid comparison operators for Query:
*
EQ | LE | LT | GE | GT | BEGINS_WITH | BETWEEN
*
Valid comparison operators for Scan:
EQ | NE | LE | LT |
* GE | GT | NOT_NULL | NULL | CONTAINS | NOT_CONTAINS | BEGINS_WITH | IN
* | BETWEEN
For information on specifying data types in JSON,
* see JSON
* Data Format in the Amazon DynamoDB Developer Guide.
The
* following are descriptions of each comparison operator.
-
*
EQ : Equal.
AttributeValueList can contain
* only one AttributeValue of type String, Number, or Binary (not
* a set). If an item contains an AttributeValue of a different
* type than the one specified in the request, the value does not match.
* For example, {"S":"6"} does not equal
* {"N":"6"}. Also, {"N":"6"} does not equal
* {"NS":["6", "2", "1"]}.
-
*
NE : Not equal.
AttributeValueList can
* contain only one AttributeValue of type String, Number, or
* Binary (not a set). If an item contains an AttributeValue of a
* different type than the one specified in the request, the value does
* not match. For example, {"S":"6"} does not equal
* {"N":"6"}. Also, {"N":"6"} does not equal
* {"NS":["6", "2", "1"]}.
-
*
LE : Less than or equal.
AttributeValueList
* can contain only one AttributeValue of type String, Number, or
* Binary (not a set). If an item contains an AttributeValue of a
* different type than the one specified in the request, the value does
* not match. For example, {"S":"6"} does not equal
* {"N":"6"}. Also, {"N":"6"} does not compare
* to {"NS":["6", "2", "1"]}.
-
*
LT : Less than.
AttributeValueList can
* contain only one AttributeValue of type String, Number, or
* Binary (not a set). If an item contains an AttributeValue of a
* different type than the one specified in the request, the value does
* not match. For example, {"S":"6"} does not equal
* {"N":"6"}. Also, {"N":"6"} does not compare
* to {"NS":["6", "2", "1"]}.
-
*
GE : Greater than or equal.
*
AttributeValueList can contain only one
* AttributeValue of type String, Number, or Binary (not a set).
* If an item contains an AttributeValue of a different type than
* the one specified in the request, the value does not match. For
* example, {"S":"6"} does not equal {"N":"6"}.
* Also, {"N":"6"} does not compare to {"NS":["6",
* "2", "1"]}.
-
GT : Greater than.
*
AttributeValueList can contain only one
* AttributeValue of type String, Number, or Binary (not a set).
* If an item contains an AttributeValue of a different type than
* the one specified in the request, the value does not match. For
* example, {"S":"6"} does not equal {"N":"6"}.
* Also, {"N":"6"} does not compare to {"NS":["6",
* "2", "1"]}.
-
NOT_NULL : The
* attribute exists.
-
NULL : The attribute does
* not exist.
-
CONTAINS : checks for a
* subsequence, or value in a set.
AttributeValueList can
* contain only one AttributeValue of type String, Number, or
* Binary (not a set). If the target attribute of the comparison is a
* String, then the operation checks for a substring match. If the target
* attribute of the comparison is Binary, then the operation looks for a
* subsequence of the target that matches the input. If the target
* attribute of the comparison is a set ("SS", "NS", or "BS"), then the
* operation checks for a member of the set (not as a substring).
* -
NOT_CONTAINS : checks for absence of a
* subsequence, or absence of a value in a set.
*
AttributeValueList can contain only one
* AttributeValue of type String, Number, or Binary (not a set).
* If the target attribute of the comparison is a String, then the
* operation checks for the absence of a substring match. If the target
* attribute of the comparison is Binary, then the operation checks for
* the absence of a subsequence of the target that matches the input. If
* the target attribute of the comparison is a set ("SS", "NS", or "BS"),
* then the operation checks for the absence of a member of the set (not
* as a substring).
-
BEGINS_WITH : checks for a
* prefix.
AttributeValueList can contain only one
* AttributeValue of type String or Binary (not a Number or a
* set). The target attribute of the comparison must be a String or
* Binary (not a Number or a set).
-
IN :
* checks for exact matches.
AttributeValueList can contain
* more than one AttributeValue of type String, Number, or Binary
* (not a set). The target attribute of the comparison must be of the
* same type and exact value to match. A String never matches a String
* set.
-
BETWEEN : Greater than or equal to the
* first value, and less than or equal to the second value.
*
AttributeValueList must contain two AttributeValue
* elements of the same type, either String, Number, or Binary (not a
* set). A target attribute matches if the target value is greater than,
* or equal to, the first element and less than, or equal to, the second
* element. If an item contains an AttributeValue of a different
* type than the one specified in the request, the value does not match.
* For example, {"S":"6"} does not compare to
* {"N":"6"}. Also, {"N":"6"} does not compare
* to {"NS":["6", "2", "1"]}
*
* Constraints:
* Allowed Values: EQ, NE, IN, LE, LT, GE, GT, BETWEEN, NOT_NULL, NULL, CONTAINS, NOT_CONTAINS, BEGINS_WITH
*/
private String comparisonOperator;
/**
* Default constructor for a new Condition object. Callers should use the
* setter or fluent setter (with...) methods to initialize this object after creating it.
*/
public Condition() {}
/**
* One or more values to evaluate against the supplied attribute. This
* list contains exactly one value, except for a BETWEEN or
* IN comparison, in which case the list contains two
* values. For type Number, value comparisons are numeric.
*
String value comparisons for greater than, equals, or less than are
* based on ASCII character code values. For example, a is
* greater than A, and aa is greater than
* B. For a list of code values, see http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters.
*
For Binary, DynamoDB treats each byte of the binary data as
* unsigned when it compares binary values, for example when evaluating
* query expressions.
*
* @return One or more values to evaluate against the supplied attribute. This
* list contains exactly one value, except for a BETWEEN or
* IN comparison, in which case the list contains two
* values. For type Number, value comparisons are numeric.
*
String value comparisons for greater than, equals, or less than are
* based on ASCII character code values. For example, a is
* greater than A, and aa is greater than
* B. For a list of code values, see http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters.
*
For Binary, DynamoDB treats each byte of the binary data as
* unsigned when it compares binary values, for example when evaluating
* query expressions.
*/
public java.util.List getAttributeValueList() {
return attributeValueList;
}
/**
* One or more values to evaluate against the supplied attribute. This
* list contains exactly one value, except for a BETWEEN or
* IN comparison, in which case the list contains two
* values. For type Number, value comparisons are numeric.
*
String value comparisons for greater than, equals, or less than are
* based on ASCII character code values. For example, a is
* greater than A, and aa is greater than
* B. For a list of code values, see http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters.
*
For Binary, DynamoDB treats each byte of the binary data as
* unsigned when it compares binary values, for example when evaluating
* query expressions.
*
* @param attributeValueList One or more values to evaluate against the supplied attribute. This
* list contains exactly one value, except for a BETWEEN or
* IN comparison, in which case the list contains two
* values. For type Number, value comparisons are numeric.
*
String value comparisons for greater than, equals, or less than are
* based on ASCII character code values. For example, a is
* greater than A, and aa is greater than
* B. For a list of code values, see http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters.
*
For Binary, DynamoDB treats each byte of the binary data as
* unsigned when it compares binary values, for example when evaluating
* query expressions.
*/
public void setAttributeValueList(java.util.Collection attributeValueList) {
if (attributeValueList == null) {
this.attributeValueList = null;
return;
}
com.amazonaws.internal.ListWithAutoConstructFlag attributeValueListCopy = new com.amazonaws.internal.ListWithAutoConstructFlag(attributeValueList.size());
attributeValueListCopy.addAll(attributeValueList);
this.attributeValueList = attributeValueListCopy;
}
/**
* One or more values to evaluate against the supplied attribute. This
* list contains exactly one value, except for a BETWEEN or
* IN comparison, in which case the list contains two
* values. For type Number, value comparisons are numeric.
*
String value comparisons for greater than, equals, or less than are
* based on ASCII character code values. For example, a is
* greater than A, and aa is greater than
* B. For a list of code values, see http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters.
*
For Binary, DynamoDB treats each byte of the binary data as
* unsigned when it compares binary values, for example when evaluating
* query expressions.
*
* Returns a reference to this object so that method calls can be chained together.
*
* @param attributeValueList One or more values to evaluate against the supplied attribute. This
* list contains exactly one value, except for a BETWEEN or
* IN comparison, in which case the list contains two
* values. For type Number, value comparisons are numeric.
*
String value comparisons for greater than, equals, or less than are
* based on ASCII character code values. For example, a is
* greater than A, and aa is greater than
* B. For a list of code values, see http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters.
*
For Binary, DynamoDB treats each byte of the binary data as
* unsigned when it compares binary values, for example when evaluating
* query expressions.
*
* @return A reference to this updated object so that method calls can be chained
* together.
*/
public Condition withAttributeValueList(AttributeValue... attributeValueList) {
if (getAttributeValueList() == null) setAttributeValueList(new java.util.ArrayList(attributeValueList.length));
for (AttributeValue value : attributeValueList) {
getAttributeValueList().add(value);
}
return this;
}
/**
* One or more values to evaluate against the supplied attribute. This
* list contains exactly one value, except for a BETWEEN or
* IN comparison, in which case the list contains two
* values. For type Number, value comparisons are numeric.
*
String value comparisons for greater than, equals, or less than are
* based on ASCII character code values. For example, a is
* greater than A, and aa is greater than
* B. For a list of code values, see http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters.
*
For Binary, DynamoDB treats each byte of the binary data as
* unsigned when it compares binary values, for example when evaluating
* query expressions.
*
* Returns a reference to this object so that method calls can be chained together.
*
* @param attributeValueList One or more values to evaluate against the supplied attribute. This
* list contains exactly one value, except for a BETWEEN or
* IN comparison, in which case the list contains two
* values. For type Number, value comparisons are numeric.
*
String value comparisons for greater than, equals, or less than are
* based on ASCII character code values. For example, a is
* greater than A, and aa is greater than
* B. For a list of code values, see http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters.
*
For Binary, DynamoDB treats each byte of the binary data as
* unsigned when it compares binary values, for example when evaluating
* query expressions.
*
* @return A reference to this updated object so that method calls can be chained
* together.
*/
public Condition withAttributeValueList(java.util.Collection attributeValueList) {
if (attributeValueList == null) {
this.attributeValueList = null;
} else {
com.amazonaws.internal.ListWithAutoConstructFlag attributeValueListCopy = new com.amazonaws.internal.ListWithAutoConstructFlag(attributeValueList.size());
attributeValueListCopy.addAll(attributeValueList);
this.attributeValueList = attributeValueListCopy;
}
return this;
}
/**
* A comparator for evaluating attributes. For example, equals, greater
* than, less than, etc. Valid comparison operators for Query:
*
EQ | LE | LT | GE | GT | BEGINS_WITH | BETWEEN
*
Valid comparison operators for Scan:
EQ | NE | LE | LT |
* GE | GT | NOT_NULL | NULL | CONTAINS | NOT_CONTAINS | BEGINS_WITH | IN
* | BETWEEN
For information on specifying data types in JSON,
* see JSON
* Data Format in the Amazon DynamoDB Developer Guide.
The
* following are descriptions of each comparison operator.
-
*
EQ : Equal.
AttributeValueList can contain
* only one AttributeValue of type String, Number, or Binary (not
* a set). If an item contains an AttributeValue of a different
* type than the one specified in the request, the value does not match.
* For example, {"S":"6"} does not equal
* {"N":"6"}. Also, {"N":"6"} does not equal
* {"NS":["6", "2", "1"]}.
-
*
NE : Not equal.
AttributeValueList can
* contain only one AttributeValue of type String, Number, or
* Binary (not a set). If an item contains an AttributeValue of a
* different type than the one specified in the request, the value does
* not match. For example, {"S":"6"} does not equal
* {"N":"6"}. Also, {"N":"6"} does not equal
* {"NS":["6", "2", "1"]}.
-
*
LE : Less than or equal.
AttributeValueList
* can contain only one AttributeValue of type String, Number, or
* Binary (not a set). If an item contains an AttributeValue of a
* different type than the one specified in the request, the value does
* not match. For example, {"S":"6"} does not equal
* {"N":"6"}. Also, {"N":"6"} does not compare
* to {"NS":["6", "2", "1"]}.
-
*
LT : Less than.
AttributeValueList can
* contain only one AttributeValue of type String, Number, or
* Binary (not a set). If an item contains an AttributeValue of a
* different type than the one specified in the request, the value does
* not match. For example, {"S":"6"} does not equal
* {"N":"6"}. Also, {"N":"6"} does not compare
* to {"NS":["6", "2", "1"]}.
-
*
GE : Greater than or equal.
*
AttributeValueList can contain only one
* AttributeValue of type String, Number, or Binary (not a set).
* If an item contains an AttributeValue of a different type than
* the one specified in the request, the value does not match. For
* example, {"S":"6"} does not equal {"N":"6"}.
* Also, {"N":"6"} does not compare to {"NS":["6",
* "2", "1"]}.
-
GT : Greater than.
*
AttributeValueList can contain only one
* AttributeValue of type String, Number, or Binary (not a set).
* If an item contains an AttributeValue of a different type than
* the one specified in the request, the value does not match. For
* example, {"S":"6"} does not equal {"N":"6"}.
* Also, {"N":"6"} does not compare to {"NS":["6",
* "2", "1"]}.
-
NOT_NULL : The
* attribute exists.
-
NULL : The attribute does
* not exist.
-
CONTAINS : checks for a
* subsequence, or value in a set.
AttributeValueList can
* contain only one AttributeValue of type String, Number, or
* Binary (not a set). If the target attribute of the comparison is a
* String, then the operation checks for a substring match. If the target
* attribute of the comparison is Binary, then the operation looks for a
* subsequence of the target that matches the input. If the target
* attribute of the comparison is a set ("SS", "NS", or "BS"), then the
* operation checks for a member of the set (not as a substring).
* -
NOT_CONTAINS : checks for absence of a
* subsequence, or absence of a value in a set.
*
AttributeValueList can contain only one
* AttributeValue of type String, Number, or Binary (not a set).
* If the target attribute of the comparison is a String, then the
* operation checks for the absence of a substring match. If the target
* attribute of the comparison is Binary, then the operation checks for
* the absence of a subsequence of the target that matches the input. If
* the target attribute of the comparison is a set ("SS", "NS", or "BS"),
* then the operation checks for the absence of a member of the set (not
* as a substring).
-
BEGINS_WITH : checks for a
* prefix.
AttributeValueList can contain only one
* AttributeValue of type String or Binary (not a Number or a
* set). The target attribute of the comparison must be a String or
* Binary (not a Number or a set).
-
IN :
* checks for exact matches.
AttributeValueList can contain
* more than one AttributeValue of type String, Number, or Binary
* (not a set). The target attribute of the comparison must be of the
* same type and exact value to match. A String never matches a String
* set.
-
BETWEEN : Greater than or equal to the
* first value, and less than or equal to the second value.
*
AttributeValueList must contain two AttributeValue
* elements of the same type, either String, Number, or Binary (not a
* set). A target attribute matches if the target value is greater than,
* or equal to, the first element and less than, or equal to, the second
* element. If an item contains an AttributeValue of a different
* type than the one specified in the request, the value does not match.
* For example, {"S":"6"} does not compare to
* {"N":"6"}. Also, {"N":"6"} does not compare
* to {"NS":["6", "2", "1"]}
*
* Constraints:
* Allowed Values: EQ, NE, IN, LE, LT, GE, GT, BETWEEN, NOT_NULL, NULL, CONTAINS, NOT_CONTAINS, BEGINS_WITH
*
* @return A comparator for evaluating attributes. For example, equals, greater
* than, less than, etc.
Valid comparison operators for Query:
*
EQ | LE | LT | GE | GT | BEGINS_WITH | BETWEEN
*
Valid comparison operators for Scan:
EQ | NE | LE | LT |
* GE | GT | NOT_NULL | NULL | CONTAINS | NOT_CONTAINS | BEGINS_WITH | IN
* | BETWEEN
For information on specifying data types in JSON,
* see JSON
* Data Format in the Amazon DynamoDB Developer Guide.
The
* following are descriptions of each comparison operator.
-
*
EQ : Equal.
AttributeValueList can contain
* only one AttributeValue of type String, Number, or Binary (not
* a set). If an item contains an AttributeValue of a different
* type than the one specified in the request, the value does not match.
* For example, {"S":"6"} does not equal
* {"N":"6"}. Also, {"N":"6"} does not equal
* {"NS":["6", "2", "1"]}.
-
*
NE : Not equal.
AttributeValueList can
* contain only one AttributeValue of type String, Number, or
* Binary (not a set). If an item contains an AttributeValue of a
* different type than the one specified in the request, the value does
* not match. For example, {"S":"6"} does not equal
* {"N":"6"}. Also, {"N":"6"} does not equal
* {"NS":["6", "2", "1"]}.
-
*
LE : Less than or equal.
AttributeValueList
* can contain only one AttributeValue of type String, Number, or
* Binary (not a set). If an item contains an AttributeValue of a
* different type than the one specified in the request, the value does
* not match. For example, {"S":"6"} does not equal
* {"N":"6"}. Also, {"N":"6"} does not compare
* to {"NS":["6", "2", "1"]}.
-
*
LT : Less than.
AttributeValueList can
* contain only one AttributeValue of type String, Number, or
* Binary (not a set). If an item contains an AttributeValue of a
* different type than the one specified in the request, the value does
* not match. For example, {"S":"6"} does not equal
* {"N":"6"}. Also, {"N":"6"} does not compare
* to {"NS":["6", "2", "1"]}.
-
*
GE : Greater than or equal.
*
AttributeValueList can contain only one
* AttributeValue of type String, Number, or Binary (not a set).
* If an item contains an AttributeValue of a different type than
* the one specified in the request, the value does not match. For
* example, {"S":"6"} does not equal {"N":"6"}.
* Also, {"N":"6"} does not compare to {"NS":["6",
* "2", "1"]}.
-
GT : Greater than.
*
AttributeValueList can contain only one
* AttributeValue of type String, Number, or Binary (not a set).
* If an item contains an AttributeValue of a different type than
* the one specified in the request, the value does not match. For
* example, {"S":"6"} does not equal {"N":"6"}.
* Also, {"N":"6"} does not compare to {"NS":["6",
* "2", "1"]}.
-
NOT_NULL : The
* attribute exists.
-
NULL : The attribute does
* not exist.
-
CONTAINS : checks for a
* subsequence, or value in a set.
AttributeValueList can
* contain only one AttributeValue of type String, Number, or
* Binary (not a set). If the target attribute of the comparison is a
* String, then the operation checks for a substring match. If the target
* attribute of the comparison is Binary, then the operation looks for a
* subsequence of the target that matches the input. If the target
* attribute of the comparison is a set ("SS", "NS", or "BS"), then the
* operation checks for a member of the set (not as a substring).
* -
NOT_CONTAINS : checks for absence of a
* subsequence, or absence of a value in a set.
*
AttributeValueList can contain only one
* AttributeValue of type String, Number, or Binary (not a set).
* If the target attribute of the comparison is a String, then the
* operation checks for the absence of a substring match. If the target
* attribute of the comparison is Binary, then the operation checks for
* the absence of a subsequence of the target that matches the input. If
* the target attribute of the comparison is a set ("SS", "NS", or "BS"),
* then the operation checks for the absence of a member of the set (not
* as a substring).
-
BEGINS_WITH : checks for a
* prefix.
AttributeValueList can contain only one
* AttributeValue of type String or Binary (not a Number or a
* set). The target attribute of the comparison must be a String or
* Binary (not a Number or a set).
-
IN :
* checks for exact matches.
AttributeValueList can contain
* more than one AttributeValue of type String, Number, or Binary
* (not a set). The target attribute of the comparison must be of the
* same type and exact value to match. A String never matches a String
* set.
-
BETWEEN : Greater than or equal to the
* first value, and less than or equal to the second value.
*
AttributeValueList must contain two AttributeValue
* elements of the same type, either String, Number, or Binary (not a
* set). A target attribute matches if the target value is greater than,
* or equal to, the first element and less than, or equal to, the second
* element. If an item contains an AttributeValue of a different
* type than the one specified in the request, the value does not match.
* For example, {"S":"6"} does not compare to
* {"N":"6"}. Also, {"N":"6"} does not compare
* to {"NS":["6", "2", "1"]}
*
* @see ComparisonOperator
*/
public String getComparisonOperator() {
return comparisonOperator;
}
/**
* A comparator for evaluating attributes. For example, equals, greater
* than, less than, etc. Valid comparison operators for Query:
*
EQ | LE | LT | GE | GT | BEGINS_WITH | BETWEEN
*
Valid comparison operators for Scan:
EQ | NE | LE | LT |
* GE | GT | NOT_NULL | NULL | CONTAINS | NOT_CONTAINS | BEGINS_WITH | IN
* | BETWEEN
For information on specifying data types in JSON,
* see JSON
* Data Format in the Amazon DynamoDB Developer Guide.
The
* following are descriptions of each comparison operator.
-
*
EQ : Equal.
AttributeValueList can contain
* only one AttributeValue of type String, Number, or Binary (not
* a set). If an item contains an AttributeValue of a different
* type than the one specified in the request, the value does not match.
* For example, {"S":"6"} does not equal
* {"N":"6"}. Also, {"N":"6"} does not equal
* {"NS":["6", "2", "1"]}.
-
*
NE : Not equal.
AttributeValueList can
* contain only one AttributeValue of type String, Number, or
* Binary (not a set). If an item contains an AttributeValue of a
* different type than the one specified in the request, the value does
* not match. For example, {"S":"6"} does not equal
* {"N":"6"}. Also, {"N":"6"} does not equal
* {"NS":["6", "2", "1"]}.
-
*
LE : Less than or equal.
AttributeValueList
* can contain only one AttributeValue of type String, Number, or
* Binary (not a set). If an item contains an AttributeValue of a
* different type than the one specified in the request, the value does
* not match. For example, {"S":"6"} does not equal
* {"N":"6"}. Also, {"N":"6"} does not compare
* to {"NS":["6", "2", "1"]}.
-
*
LT : Less than.
AttributeValueList can
* contain only one AttributeValue of type String, Number, or
* Binary (not a set). If an item contains an AttributeValue of a
* different type than the one specified in the request, the value does
* not match. For example, {"S":"6"} does not equal
* {"N":"6"}. Also, {"N":"6"} does not compare
* to {"NS":["6", "2", "1"]}.
-
*
GE : Greater than or equal.
*
AttributeValueList can contain only one
* AttributeValue of type String, Number, or Binary (not a set).
* If an item contains an AttributeValue of a different type than
* the one specified in the request, the value does not match. For
* example, {"S":"6"} does not equal {"N":"6"}.
* Also, {"N":"6"} does not compare to {"NS":["6",
* "2", "1"]}.
-
GT : Greater than.
*
AttributeValueList can contain only one
* AttributeValue of type String, Number, or Binary (not a set).
* If an item contains an AttributeValue of a different type than
* the one specified in the request, the value does not match. For
* example, {"S":"6"} does not equal {"N":"6"}.
* Also, {"N":"6"} does not compare to {"NS":["6",
* "2", "1"]}.
-
NOT_NULL : The
* attribute exists.
-
NULL : The attribute does
* not exist.
-
CONTAINS : checks for a
* subsequence, or value in a set.
AttributeValueList can
* contain only one AttributeValue of type String, Number, or
* Binary (not a set). If the target attribute of the comparison is a
* String, then the operation checks for a substring match. If the target
* attribute of the comparison is Binary, then the operation looks for a
* subsequence of the target that matches the input. If the target
* attribute of the comparison is a set ("SS", "NS", or "BS"), then the
* operation checks for a member of the set (not as a substring).
* -
NOT_CONTAINS : checks for absence of a
* subsequence, or absence of a value in a set.
*
AttributeValueList can contain only one
* AttributeValue of type String, Number, or Binary (not a set).
* If the target attribute of the comparison is a String, then the
* operation checks for the absence of a substring match. If the target
* attribute of the comparison is Binary, then the operation checks for
* the absence of a subsequence of the target that matches the input. If
* the target attribute of the comparison is a set ("SS", "NS", or "BS"),
* then the operation checks for the absence of a member of the set (not
* as a substring).
-
BEGINS_WITH : checks for a
* prefix.
AttributeValueList can contain only one
* AttributeValue of type String or Binary (not a Number or a
* set). The target attribute of the comparison must be a String or
* Binary (not a Number or a set).
-
IN :
* checks for exact matches.
AttributeValueList can contain
* more than one AttributeValue of type String, Number, or Binary
* (not a set). The target attribute of the comparison must be of the
* same type and exact value to match. A String never matches a String
* set.
-
BETWEEN : Greater than or equal to the
* first value, and less than or equal to the second value.
*
AttributeValueList must contain two AttributeValue
* elements of the same type, either String, Number, or Binary (not a
* set). A target attribute matches if the target value is greater than,
* or equal to, the first element and less than, or equal to, the second
* element. If an item contains an AttributeValue of a different
* type than the one specified in the request, the value does not match.
* For example, {"S":"6"} does not compare to
* {"N":"6"}. Also, {"N":"6"} does not compare
* to {"NS":["6", "2", "1"]}
*
* Constraints:
* Allowed Values: EQ, NE, IN, LE, LT, GE, GT, BETWEEN, NOT_NULL, NULL, CONTAINS, NOT_CONTAINS, BEGINS_WITH
*
* @param comparisonOperator A comparator for evaluating attributes. For example, equals, greater
* than, less than, etc.
Valid comparison operators for Query:
*
EQ | LE | LT | GE | GT | BEGINS_WITH | BETWEEN
*
Valid comparison operators for Scan:
EQ | NE | LE | LT |
* GE | GT | NOT_NULL | NULL | CONTAINS | NOT_CONTAINS | BEGINS_WITH | IN
* | BETWEEN
For information on specifying data types in JSON,
* see JSON
* Data Format in the Amazon DynamoDB Developer Guide.
The
* following are descriptions of each comparison operator.
-
*
EQ : Equal.
AttributeValueList can contain
* only one AttributeValue of type String, Number, or Binary (not
* a set). If an item contains an AttributeValue of a different
* type than the one specified in the request, the value does not match.
* For example, {"S":"6"} does not equal
* {"N":"6"}. Also, {"N":"6"} does not equal
* {"NS":["6", "2", "1"]}.
-
*
NE : Not equal.
AttributeValueList can
* contain only one AttributeValue of type String, Number, or
* Binary (not a set). If an item contains an AttributeValue of a
* different type than the one specified in the request, the value does
* not match. For example, {"S":"6"} does not equal
* {"N":"6"}. Also, {"N":"6"} does not equal
* {"NS":["6", "2", "1"]}.
-
*
LE : Less than or equal.
AttributeValueList
* can contain only one AttributeValue of type String, Number, or
* Binary (not a set). If an item contains an AttributeValue of a
* different type than the one specified in the request, the value does
* not match. For example, {"S":"6"} does not equal
* {"N":"6"}. Also, {"N":"6"} does not compare
* to {"NS":["6", "2", "1"]}.
-
*
LT : Less than.
AttributeValueList can
* contain only one AttributeValue of type String, Number, or
* Binary (not a set). If an item contains an AttributeValue of a
* different type than the one specified in the request, the value does
* not match. For example, {"S":"6"} does not equal
* {"N":"6"}. Also, {"N":"6"} does not compare
* to {"NS":["6", "2", "1"]}.
-
*
GE : Greater than or equal.
*
AttributeValueList can contain only one
* AttributeValue of type String, Number, or Binary (not a set).
* If an item contains an AttributeValue of a different type than
* the one specified in the request, the value does not match. For
* example, {"S":"6"} does not equal {"N":"6"}.
* Also, {"N":"6"} does not compare to {"NS":["6",
* "2", "1"]}.
-
GT : Greater than.
*
AttributeValueList can contain only one
* AttributeValue of type String, Number, or Binary (not a set).
* If an item contains an AttributeValue of a different type than
* the one specified in the request, the value does not match. For
* example, {"S":"6"} does not equal {"N":"6"}.
* Also, {"N":"6"} does not compare to {"NS":["6",
* "2", "1"]}.
-
NOT_NULL : The
* attribute exists.
-
NULL : The attribute does
* not exist.
-
CONTAINS : checks for a
* subsequence, or value in a set.
AttributeValueList can
* contain only one AttributeValue of type String, Number, or
* Binary (not a set). If the target attribute of the comparison is a
* String, then the operation checks for a substring match. If the target
* attribute of the comparison is Binary, then the operation looks for a
* subsequence of the target that matches the input. If the target
* attribute of the comparison is a set ("SS", "NS", or "BS"), then the
* operation checks for a member of the set (not as a substring).
* -
NOT_CONTAINS : checks for absence of a
* subsequence, or absence of a value in a set.
*
AttributeValueList can contain only one
* AttributeValue of type String, Number, or Binary (not a set).
* If the target attribute of the comparison is a String, then the
* operation checks for the absence of a substring match. If the target
* attribute of the comparison is Binary, then the operation checks for
* the absence of a subsequence of the target that matches the input. If
* the target attribute of the comparison is a set ("SS", "NS", or "BS"),
* then the operation checks for the absence of a member of the set (not
* as a substring).
-
BEGINS_WITH : checks for a
* prefix.
AttributeValueList can contain only one
* AttributeValue of type String or Binary (not a Number or a
* set). The target attribute of the comparison must be a String or
* Binary (not a Number or a set).
-
IN :
* checks for exact matches.
AttributeValueList can contain
* more than one AttributeValue of type String, Number, or Binary
* (not a set). The target attribute of the comparison must be of the
* same type and exact value to match. A String never matches a String
* set.
-
BETWEEN : Greater than or equal to the
* first value, and less than or equal to the second value.
*
AttributeValueList must contain two AttributeValue
* elements of the same type, either String, Number, or Binary (not a
* set). A target attribute matches if the target value is greater than,
* or equal to, the first element and less than, or equal to, the second
* element. If an item contains an AttributeValue of a different
* type than the one specified in the request, the value does not match.
* For example, {"S":"6"} does not compare to
* {"N":"6"}. Also, {"N":"6"} does not compare
* to {"NS":["6", "2", "1"]}
*
* @see ComparisonOperator
*/
public void setComparisonOperator(String comparisonOperator) {
this.comparisonOperator = comparisonOperator;
}
/**
* A comparator for evaluating attributes. For example, equals, greater
* than, less than, etc. Valid comparison operators for Query:
*
EQ | LE | LT | GE | GT | BEGINS_WITH | BETWEEN
*
Valid comparison operators for Scan:
EQ | NE | LE | LT |
* GE | GT | NOT_NULL | NULL | CONTAINS | NOT_CONTAINS | BEGINS_WITH | IN
* | BETWEEN
For information on specifying data types in JSON,
* see JSON
* Data Format in the Amazon DynamoDB Developer Guide.
The
* following are descriptions of each comparison operator.
-
*
EQ : Equal.
AttributeValueList can contain
* only one AttributeValue of type String, Number, or Binary (not
* a set). If an item contains an AttributeValue of a different
* type than the one specified in the request, the value does not match.
* For example, {"S":"6"} does not equal
* {"N":"6"}. Also, {"N":"6"} does not equal
* {"NS":["6", "2", "1"]}.
-
*
NE : Not equal.
AttributeValueList can
* contain only one AttributeValue of type String, Number, or
* Binary (not a set). If an item contains an AttributeValue of a
* different type than the one specified in the request, the value does
* not match. For example, {"S":"6"} does not equal
* {"N":"6"}. Also, {"N":"6"} does not equal
* {"NS":["6", "2", "1"]}.
-
*
LE : Less than or equal.
AttributeValueList
* can contain only one AttributeValue of type String, Number, or
* Binary (not a set). If an item contains an AttributeValue of a
* different type than the one specified in the request, the value does
* not match. For example, {"S":"6"} does not equal
* {"N":"6"}. Also, {"N":"6"} does not compare
* to {"NS":["6", "2", "1"]}.
-
*
LT : Less than.
AttributeValueList can
* contain only one AttributeValue of type String, Number, or
* Binary (not a set). If an item contains an AttributeValue of a
* different type than the one specified in the request, the value does
* not match. For example, {"S":"6"} does not equal
* {"N":"6"}. Also, {"N":"6"} does not compare
* to {"NS":["6", "2", "1"]}.
-
*
GE : Greater than or equal.
*
AttributeValueList can contain only one
* AttributeValue of type String, Number, or Binary (not a set).
* If an item contains an AttributeValue of a different type than
* the one specified in the request, the value does not match. For
* example, {"S":"6"} does not equal {"N":"6"}.
* Also, {"N":"6"} does not compare to {"NS":["6",
* "2", "1"]}.
-
GT : Greater than.
*
AttributeValueList can contain only one
* AttributeValue of type String, Number, or Binary (not a set).
* If an item contains an AttributeValue of a different type than
* the one specified in the request, the value does not match. For
* example, {"S":"6"} does not equal {"N":"6"}.
* Also, {"N":"6"} does not compare to {"NS":["6",
* "2", "1"]}.
-
NOT_NULL : The
* attribute exists.
-
NULL : The attribute does
* not exist.
-
CONTAINS : checks for a
* subsequence, or value in a set.
AttributeValueList can
* contain only one AttributeValue of type String, Number, or
* Binary (not a set). If the target attribute of the comparison is a
* String, then the operation checks for a substring match. If the target
* attribute of the comparison is Binary, then the operation looks for a
* subsequence of the target that matches the input. If the target
* attribute of the comparison is a set ("SS", "NS", or "BS"), then the
* operation checks for a member of the set (not as a substring).
* -
NOT_CONTAINS : checks for absence of a
* subsequence, or absence of a value in a set.
*
AttributeValueList can contain only one
* AttributeValue of type String, Number, or Binary (not a set).
* If the target attribute of the comparison is a String, then the
* operation checks for the absence of a substring match. If the target
* attribute of the comparison is Binary, then the operation checks for
* the absence of a subsequence of the target that matches the input. If
* the target attribute of the comparison is a set ("SS", "NS", or "BS"),
* then the operation checks for the absence of a member of the set (not
* as a substring).
-
BEGINS_WITH : checks for a
* prefix.
AttributeValueList can contain only one
* AttributeValue of type String or Binary (not a Number or a
* set). The target attribute of the comparison must be a String or
* Binary (not a Number or a set).
-
IN :
* checks for exact matches.
AttributeValueList can contain
* more than one AttributeValue of type String, Number, or Binary
* (not a set). The target attribute of the comparison must be of the
* same type and exact value to match. A String never matches a String
* set.
-
BETWEEN : Greater than or equal to the
* first value, and less than or equal to the second value.
*
AttributeValueList must contain two AttributeValue
* elements of the same type, either String, Number, or Binary (not a
* set). A target attribute matches if the target value is greater than,
* or equal to, the first element and less than, or equal to, the second
* element. If an item contains an AttributeValue of a different
* type than the one specified in the request, the value does not match.
* For example, {"S":"6"} does not compare to
* {"N":"6"}. Also, {"N":"6"} does not compare
* to {"NS":["6", "2", "1"]}
*
* Returns a reference to this object so that method calls can be chained together.
*
* Constraints:
* Allowed Values: EQ, NE, IN, LE, LT, GE, GT, BETWEEN, NOT_NULL, NULL, CONTAINS, NOT_CONTAINS, BEGINS_WITH
*
* @param comparisonOperator A comparator for evaluating attributes. For example, equals, greater
* than, less than, etc.
Valid comparison operators for Query:
*
EQ | LE | LT | GE | GT | BEGINS_WITH | BETWEEN
*
Valid comparison operators for Scan:
EQ | NE | LE | LT |
* GE | GT | NOT_NULL | NULL | CONTAINS | NOT_CONTAINS | BEGINS_WITH | IN
* | BETWEEN
For information on specifying data types in JSON,
* see JSON
* Data Format in the Amazon DynamoDB Developer Guide.
The
* following are descriptions of each comparison operator.
-
*
EQ : Equal.
AttributeValueList can contain
* only one AttributeValue of type String, Number, or Binary (not
* a set). If an item contains an AttributeValue of a different
* type than the one specified in the request, the value does not match.
* For example, {"S":"6"} does not equal
* {"N":"6"}. Also, {"N":"6"} does not equal
* {"NS":["6", "2", "1"]}.
-
*
NE : Not equal.
AttributeValueList can
* contain only one AttributeValue of type String, Number, or
* Binary (not a set). If an item contains an AttributeValue of a
* different type than the one specified in the request, the value does
* not match. For example, {"S":"6"} does not equal
* {"N":"6"}. Also, {"N":"6"} does not equal
* {"NS":["6", "2", "1"]}.
-
*
LE : Less than or equal.
AttributeValueList
* can contain only one AttributeValue of type String, Number, or
* Binary (not a set). If an item contains an AttributeValue of a
* different type than the one specified in the request, the value does
* not match. For example, {"S":"6"} does not equal
* {"N":"6"}. Also, {"N":"6"} does not compare
* to {"NS":["6", "2", "1"]}.
-
*
LT : Less than.
AttributeValueList can
* contain only one AttributeValue of type String, Number, or
* Binary (not a set). If an item contains an AttributeValue of a
* different type than the one specified in the request, the value does
* not match. For example, {"S":"6"} does not equal
* {"N":"6"}. Also, {"N":"6"} does not compare
* to {"NS":["6", "2", "1"]}.
-
*
GE : Greater than or equal.
*
AttributeValueList can contain only one
* AttributeValue of type String, Number, or Binary (not a set).
* If an item contains an AttributeValue of a different type than
* the one specified in the request, the value does not match. For
* example, {"S":"6"} does not equal {"N":"6"}.
* Also, {"N":"6"} does not compare to {"NS":["6",
* "2", "1"]}.
-
GT : Greater than.
*
AttributeValueList can contain only one
* AttributeValue of type String, Number, or Binary (not a set).
* If an item contains an AttributeValue of a different type than
* the one specified in the request, the value does not match. For
* example, {"S":"6"} does not equal {"N":"6"}.
* Also, {"N":"6"} does not compare to {"NS":["6",
* "2", "1"]}.
-
NOT_NULL : The
* attribute exists.
-
NULL : The attribute does
* not exist.
-
CONTAINS : checks for a
* subsequence, or value in a set.
AttributeValueList can
* contain only one AttributeValue of type String, Number, or
* Binary (not a set). If the target attribute of the comparison is a
* String, then the operation checks for a substring match. If the target
* attribute of the comparison is Binary, then the operation looks for a
* subsequence of the target that matches the input. If the target
* attribute of the comparison is a set ("SS", "NS", or "BS"), then the
* operation checks for a member of the set (not as a substring).
* -
NOT_CONTAINS : checks for absence of a
* subsequence, or absence of a value in a set.
*
AttributeValueList can contain only one
* AttributeValue of type String, Number, or Binary (not a set).
* If the target attribute of the comparison is a String, then the
* operation checks for the absence of a substring match. If the target
* attribute of the comparison is Binary, then the operation checks for
* the absence of a subsequence of the target that matches the input. If
* the target attribute of the comparison is a set ("SS", "NS", or "BS"),
* then the operation checks for the absence of a member of the set (not
* as a substring).
-
BEGINS_WITH : checks for a
* prefix.
AttributeValueList can contain only one
* AttributeValue of type String or Binary (not a Number or a
* set). The target attribute of the comparison must be a String or
* Binary (not a Number or a set).
-
IN :
* checks for exact matches.
AttributeValueList can contain
* more than one AttributeValue of type String, Number, or Binary
* (not a set). The target attribute of the comparison must be of the
* same type and exact value to match. A String never matches a String
* set.
-
BETWEEN : Greater than or equal to the
* first value, and less than or equal to the second value.
*
AttributeValueList must contain two AttributeValue
* elements of the same type, either String, Number, or Binary (not a
* set). A target attribute matches if the target value is greater than,
* or equal to, the first element and less than, or equal to, the second
* element. If an item contains an AttributeValue of a different
* type than the one specified in the request, the value does not match.
* For example, {"S":"6"} does not compare to
* {"N":"6"}. Also, {"N":"6"} does not compare
* to {"NS":["6", "2", "1"]}
*
* @return A reference to this updated object so that method calls can be chained
* together.
*
* @see ComparisonOperator
*/
public Condition withComparisonOperator(String comparisonOperator) {
this.comparisonOperator = comparisonOperator;
return this;
}
/**
* A comparator for evaluating attributes. For example, equals, greater
* than, less than, etc. Valid comparison operators for Query:
*
EQ | LE | LT | GE | GT | BEGINS_WITH | BETWEEN
*
Valid comparison operators for Scan:
EQ | NE | LE | LT |
* GE | GT | NOT_NULL | NULL | CONTAINS | NOT_CONTAINS | BEGINS_WITH | IN
* | BETWEEN
For information on specifying data types in JSON,
* see JSON
* Data Format in the Amazon DynamoDB Developer Guide.
The
* following are descriptions of each comparison operator.
-
*
EQ : Equal.
AttributeValueList can contain
* only one AttributeValue of type String, Number, or Binary (not
* a set). If an item contains an AttributeValue of a different
* type than the one specified in the request, the value does not match.
* For example, {"S":"6"} does not equal
* {"N":"6"}. Also, {"N":"6"} does not equal
* {"NS":["6", "2", "1"]}.
-
*
NE : Not equal.
AttributeValueList can
* contain only one AttributeValue of type String, Number, or
* Binary (not a set). If an item contains an AttributeValue of a
* different type than the one specified in the request, the value does
* not match. For example, {"S":"6"} does not equal
* {"N":"6"}. Also, {"N":"6"} does not equal
* {"NS":["6", "2", "1"]}.
-
*
LE : Less than or equal.
AttributeValueList
* can contain only one AttributeValue of type String, Number, or
* Binary (not a set). If an item contains an AttributeValue of a
* different type than the one specified in the request, the value does
* not match. For example, {"S":"6"} does not equal
* {"N":"6"}. Also, {"N":"6"} does not compare
* to {"NS":["6", "2", "1"]}.
-
*
LT : Less than.
AttributeValueList can
* contain only one AttributeValue of type String, Number, or
* Binary (not a set). If an item contains an AttributeValue of a
* different type than the one specified in the request, the value does
* not match. For example, {"S":"6"} does not equal
* {"N":"6"}. Also, {"N":"6"} does not compare
* to {"NS":["6", "2", "1"]}.
-
*
GE : Greater than or equal.
*
AttributeValueList can contain only one
* AttributeValue of type String, Number, or Binary (not a set).
* If an item contains an AttributeValue of a different type than
* the one specified in the request, the value does not match. For
* example, {"S":"6"} does not equal {"N":"6"}.
* Also, {"N":"6"} does not compare to {"NS":["6",
* "2", "1"]}.
-
GT : Greater than.
*
AttributeValueList can contain only one
* AttributeValue of type String, Number, or Binary (not a set).
* If an item contains an AttributeValue of a different type than
* the one specified in the request, the value does not match. For
* example, {"S":"6"} does not equal {"N":"6"}.
* Also, {"N":"6"} does not compare to {"NS":["6",
* "2", "1"]}.
-
NOT_NULL : The
* attribute exists.
-
NULL : The attribute does
* not exist.
-
CONTAINS : checks for a
* subsequence, or value in a set.
AttributeValueList can
* contain only one AttributeValue of type String, Number, or
* Binary (not a set). If the target attribute of the comparison is a
* String, then the operation checks for a substring match. If the target
* attribute of the comparison is Binary, then the operation looks for a
* subsequence of the target that matches the input. If the target
* attribute of the comparison is a set ("SS", "NS", or "BS"), then the
* operation checks for a member of the set (not as a substring).
* -
NOT_CONTAINS : checks for absence of a
* subsequence, or absence of a value in a set.
*
AttributeValueList can contain only one
* AttributeValue of type String, Number, or Binary (not a set).
* If the target attribute of the comparison is a String, then the
* operation checks for the absence of a substring match. If the target
* attribute of the comparison is Binary, then the operation checks for
* the absence of a subsequence of the target that matches the input. If
* the target attribute of the comparison is a set ("SS", "NS", or "BS"),
* then the operation checks for the absence of a member of the set (not
* as a substring).
-
BEGINS_WITH : checks for a
* prefix.
AttributeValueList can contain only one
* AttributeValue of type String or Binary (not a Number or a
* set). The target attribute of the comparison must be a String or
* Binary (not a Number or a set).
-
IN :
* checks for exact matches.
AttributeValueList can contain
* more than one AttributeValue of type String, Number, or Binary
* (not a set). The target attribute of the comparison must be of the
* same type and exact value to match. A String never matches a String
* set.
-
BETWEEN : Greater than or equal to the
* first value, and less than or equal to the second value.
*
AttributeValueList must contain two AttributeValue
* elements of the same type, either String, Number, or Binary (not a
* set). A target attribute matches if the target value is greater than,
* or equal to, the first element and less than, or equal to, the second
* element. If an item contains an AttributeValue of a different
* type than the one specified in the request, the value does not match.
* For example, {"S":"6"} does not compare to
* {"N":"6"}. Also, {"N":"6"} does not compare
* to {"NS":["6", "2", "1"]}
*
* Constraints:
* Allowed Values: EQ, NE, IN, LE, LT, GE, GT, BETWEEN, NOT_NULL, NULL, CONTAINS, NOT_CONTAINS, BEGINS_WITH
*
* @param comparisonOperator A comparator for evaluating attributes. For example, equals, greater
* than, less than, etc.
Valid comparison operators for Query:
*
EQ | LE | LT | GE | GT | BEGINS_WITH | BETWEEN
*
Valid comparison operators for Scan:
EQ | NE | LE | LT |
* GE | GT | NOT_NULL | NULL | CONTAINS | NOT_CONTAINS | BEGINS_WITH | IN
* | BETWEEN
For information on specifying data types in JSON,
* see JSON
* Data Format in the Amazon DynamoDB Developer Guide.
The
* following are descriptions of each comparison operator.
-
*
EQ : Equal.
AttributeValueList can contain
* only one AttributeValue of type String, Number, or Binary (not
* a set). If an item contains an AttributeValue of a different
* type than the one specified in the request, the value does not match.
* For example, {"S":"6"} does not equal
* {"N":"6"}. Also, {"N":"6"} does not equal
* {"NS":["6", "2", "1"]}.
-
*
NE : Not equal.
AttributeValueList can
* contain only one AttributeValue of type String, Number, or
* Binary (not a set). If an item contains an AttributeValue of a
* different type than the one specified in the request, the value does
* not match. For example, {"S":"6"} does not equal
* {"N":"6"}. Also, {"N":"6"} does not equal
* {"NS":["6", "2", "1"]}.
-
*
LE : Less than or equal.
AttributeValueList
* can contain only one AttributeValue of type String, Number, or
* Binary (not a set). If an item contains an AttributeValue of a
* different type than the one specified in the request, the value does
* not match. For example, {"S":"6"} does not equal
* {"N":"6"}. Also, {"N":"6"} does not compare
* to {"NS":["6", "2", "1"]}.
-
*
LT : Less than.
AttributeValueList can
* contain only one AttributeValue of type String, Number, or
* Binary (not a set). If an item contains an AttributeValue of a
* different type than the one specified in the request, the value does
* not match. For example, {"S":"6"} does not equal
* {"N":"6"}. Also, {"N":"6"} does not compare
* to {"NS":["6", "2", "1"]}.
-
*
GE : Greater than or equal.
*
AttributeValueList can contain only one
* AttributeValue of type String, Number, or Binary (not a set).
* If an item contains an AttributeValue of a different type than
* the one specified in the request, the value does not match. For
* example, {"S":"6"} does not equal {"N":"6"}.
* Also, {"N":"6"} does not compare to {"NS":["6",
* "2", "1"]}.
-
GT : Greater than.
*
AttributeValueList can contain only one
* AttributeValue of type String, Number, or Binary (not a set).
* If an item contains an AttributeValue of a different type than
* the one specified in the request, the value does not match. For
* example, {"S":"6"} does not equal {"N":"6"}.
* Also, {"N":"6"} does not compare to {"NS":["6",
* "2", "1"]}.
-
NOT_NULL : The
* attribute exists.
-
NULL : The attribute does
* not exist.
-
CONTAINS : checks for a
* subsequence, or value in a set.
AttributeValueList can
* contain only one AttributeValue of type String, Number, or
* Binary (not a set). If the target attribute of the comparison is a
* String, then the operation checks for a substring match. If the target
* attribute of the comparison is Binary, then the operation looks for a
* subsequence of the target that matches the input. If the target
* attribute of the comparison is a set ("SS", "NS", or "BS"), then the
* operation checks for a member of the set (not as a substring).
* -
NOT_CONTAINS : checks for absence of a
* subsequence, or absence of a value in a set.
*
AttributeValueList can contain only one
* AttributeValue of type String, Number, or Binary (not a set).
* If the target attribute of the comparison is a String, then the
* operation checks for the absence of a substring match. If the target
* attribute of the comparison is Binary, then the operation checks for
* the absence of a subsequence of the target that matches the input. If
* the target attribute of the comparison is a set ("SS", "NS", or "BS"),
* then the operation checks for the absence of a member of the set (not
* as a substring).
-
BEGINS_WITH : checks for a
* prefix.
AttributeValueList can contain only one
* AttributeValue of type String or Binary (not a Number or a
* set). The target attribute of the comparison must be a String or
* Binary (not a Number or a set).
-
IN :
* checks for exact matches.
AttributeValueList can contain
* more than one AttributeValue of type String, Number, or Binary
* (not a set). The target attribute of the comparison must be of the
* same type and exact value to match. A String never matches a String
* set.
-
BETWEEN : Greater than or equal to the
* first value, and less than or equal to the second value.
*
AttributeValueList must contain two AttributeValue
* elements of the same type, either String, Number, or Binary (not a
* set). A target attribute matches if the target value is greater than,
* or equal to, the first element and less than, or equal to, the second
* element. If an item contains an AttributeValue of a different
* type than the one specified in the request, the value does not match.
* For example, {"S":"6"} does not compare to
* {"N":"6"}. Also, {"N":"6"} does not compare
* to {"NS":["6", "2", "1"]}
*
* @see ComparisonOperator
*/
public void setComparisonOperator(ComparisonOperator comparisonOperator) {
this.comparisonOperator = comparisonOperator.toString();
}
/**
* A comparator for evaluating attributes. For example, equals, greater
* than, less than, etc. Valid comparison operators for Query:
*
EQ | LE | LT | GE | GT | BEGINS_WITH | BETWEEN
*
Valid comparison operators for Scan:
EQ | NE | LE | LT |
* GE | GT | NOT_NULL | NULL | CONTAINS | NOT_CONTAINS | BEGINS_WITH | IN
* | BETWEEN
For information on specifying data types in JSON,
* see JSON
* Data Format in the Amazon DynamoDB Developer Guide.
The
* following are descriptions of each comparison operator.
-
*
EQ : Equal.
AttributeValueList can contain
* only one AttributeValue of type String, Number, or Binary (not
* a set). If an item contains an AttributeValue of a different
* type than the one specified in the request, the value does not match.
* For example, {"S":"6"} does not equal
* {"N":"6"}. Also, {"N":"6"} does not equal
* {"NS":["6", "2", "1"]}.
-
*
NE : Not equal.
AttributeValueList can
* contain only one AttributeValue of type String, Number, or
* Binary (not a set). If an item contains an AttributeValue of a
* different type than the one specified in the request, the value does
* not match. For example, {"S":"6"} does not equal
* {"N":"6"}. Also, {"N":"6"} does not equal
* {"NS":["6", "2", "1"]}.
-
*
LE : Less than or equal.
AttributeValueList
* can contain only one AttributeValue of type String, Number, or
* Binary (not a set). If an item contains an AttributeValue of a
* different type than the one specified in the request, the value does
* not match. For example, {"S":"6"} does not equal
* {"N":"6"}. Also, {"N":"6"} does not compare
* to {"NS":["6", "2", "1"]}.
-
*
LT : Less than.
AttributeValueList can
* contain only one AttributeValue of type String, Number, or
* Binary (not a set). If an item contains an AttributeValue of a
* different type than the one specified in the request, the value does
* not match. For example, {"S":"6"} does not equal
* {"N":"6"}. Also, {"N":"6"} does not compare
* to {"NS":["6", "2", "1"]}.
-
*
GE : Greater than or equal.
*
AttributeValueList can contain only one
* AttributeValue of type String, Number, or Binary (not a set).
* If an item contains an AttributeValue of a different type than
* the one specified in the request, the value does not match. For
* example, {"S":"6"} does not equal {"N":"6"}.
* Also, {"N":"6"} does not compare to {"NS":["6",
* "2", "1"]}.
-
GT : Greater than.
*
AttributeValueList can contain only one
* AttributeValue of type String, Number, or Binary (not a set).
* If an item contains an AttributeValue of a different type than
* the one specified in the request, the value does not match. For
* example, {"S":"6"} does not equal {"N":"6"}.
* Also, {"N":"6"} does not compare to {"NS":["6",
* "2", "1"]}.
-
NOT_NULL : The
* attribute exists.
-
NULL : The attribute does
* not exist.
-
CONTAINS : checks for a
* subsequence, or value in a set.
AttributeValueList can
* contain only one AttributeValue of type String, Number, or
* Binary (not a set). If the target attribute of the comparison is a
* String, then the operation checks for a substring match. If the target
* attribute of the comparison is Binary, then the operation looks for a
* subsequence of the target that matches the input. If the target
* attribute of the comparison is a set ("SS", "NS", or "BS"), then the
* operation checks for a member of the set (not as a substring).
* -
NOT_CONTAINS : checks for absence of a
* subsequence, or absence of a value in a set.
*
AttributeValueList can contain only one
* AttributeValue of type String, Number, or Binary (not a set).
* If the target attribute of the comparison is a String, then the
* operation checks for the absence of a substring match. If the target
* attribute of the comparison is Binary, then the operation checks for
* the absence of a subsequence of the target that matches the input. If
* the target attribute of the comparison is a set ("SS", "NS", or "BS"),
* then the operation checks for the absence of a member of the set (not
* as a substring).
-
BEGINS_WITH : checks for a
* prefix.
AttributeValueList can contain only one
* AttributeValue of type String or Binary (not a Number or a
* set). The target attribute of the comparison must be a String or
* Binary (not a Number or a set).
-
IN :
* checks for exact matches.
AttributeValueList can contain
* more than one AttributeValue of type String, Number, or Binary
* (not a set). The target attribute of the comparison must be of the
* same type and exact value to match. A String never matches a String
* set.
-
BETWEEN : Greater than or equal to the
* first value, and less than or equal to the second value.
*
AttributeValueList must contain two AttributeValue
* elements of the same type, either String, Number, or Binary (not a
* set). A target attribute matches if the target value is greater than,
* or equal to, the first element and less than, or equal to, the second
* element. If an item contains an AttributeValue of a different
* type than the one specified in the request, the value does not match.
* For example, {"S":"6"} does not compare to
* {"N":"6"}. Also, {"N":"6"} does not compare
* to {"NS":["6", "2", "1"]}
*
* Returns a reference to this object so that method calls can be chained together.
*
* Constraints:
* Allowed Values: EQ, NE, IN, LE, LT, GE, GT, BETWEEN, NOT_NULL, NULL, CONTAINS, NOT_CONTAINS, BEGINS_WITH
*
* @param comparisonOperator A comparator for evaluating attributes. For example, equals, greater
* than, less than, etc.
Valid comparison operators for Query:
*
EQ | LE | LT | GE | GT | BEGINS_WITH | BETWEEN
*
Valid comparison operators for Scan:
EQ | NE | LE | LT |
* GE | GT | NOT_NULL | NULL | CONTAINS | NOT_CONTAINS | BEGINS_WITH | IN
* | BETWEEN
For information on specifying data types in JSON,
* see JSON
* Data Format in the Amazon DynamoDB Developer Guide.
The
* following are descriptions of each comparison operator.
-
*
EQ : Equal.
AttributeValueList can contain
* only one AttributeValue of type String, Number, or Binary (not
* a set). If an item contains an AttributeValue of a different
* type than the one specified in the request, the value does not match.
* For example, {"S":"6"} does not equal
* {"N":"6"}. Also, {"N":"6"} does not equal
* {"NS":["6", "2", "1"]}.
-
*
NE : Not equal.
AttributeValueList can
* contain only one AttributeValue of type String, Number, or
* Binary (not a set). If an item contains an AttributeValue of a
* different type than the one specified in the request, the value does
* not match. For example, {"S":"6"} does not equal
* {"N":"6"}. Also, {"N":"6"} does not equal
* {"NS":["6", "2", "1"]}.
-
*
LE : Less than or equal.
AttributeValueList
* can contain only one AttributeValue of type String, Number, or
* Binary (not a set). If an item contains an AttributeValue of a
* different type than the one specified in the request, the value does
* not match. For example, {"S":"6"} does not equal
* {"N":"6"}. Also, {"N":"6"} does not compare
* to {"NS":["6", "2", "1"]}.
-
*
LT : Less than.
AttributeValueList can
* contain only one AttributeValue of type String, Number, or
* Binary (not a set). If an item contains an AttributeValue of a
* different type than the one specified in the request, the value does
* not match. For example, {"S":"6"} does not equal
* {"N":"6"}. Also, {"N":"6"} does not compare
* to {"NS":["6", "2", "1"]}.
-
*
GE : Greater than or equal.
*
AttributeValueList can contain only one
* AttributeValue of type String, Number, or Binary (not a set).
* If an item contains an AttributeValue of a different type than
* the one specified in the request, the value does not match. For
* example, {"S":"6"} does not equal {"N":"6"}.
* Also, {"N":"6"} does not compare to {"NS":["6",
* "2", "1"]}.
-
GT : Greater than.
*
AttributeValueList can contain only one
* AttributeValue of type String, Number, or Binary (not a set).
* If an item contains an AttributeValue of a different type than
* the one specified in the request, the value does not match. For
* example, {"S":"6"} does not equal {"N":"6"}.
* Also, {"N":"6"} does not compare to {"NS":["6",
* "2", "1"]}.
-
NOT_NULL : The
* attribute exists.
-
NULL : The attribute does
* not exist.
-
CONTAINS : checks for a
* subsequence, or value in a set.
AttributeValueList can
* contain only one AttributeValue of type String, Number, or
* Binary (not a set). If the target attribute of the comparison is a
* String, then the operation checks for a substring match. If the target
* attribute of the comparison is Binary, then the operation looks for a
* subsequence of the target that matches the input. If the target
* attribute of the comparison is a set ("SS", "NS", or "BS"), then the
* operation checks for a member of the set (not as a substring).
* -
NOT_CONTAINS : checks for absence of a
* subsequence, or absence of a value in a set.
*
AttributeValueList can contain only one
* AttributeValue of type String, Number, or Binary (not a set).
* If the target attribute of the comparison is a String, then the
* operation checks for the absence of a substring match. If the target
* attribute of the comparison is Binary, then the operation checks for
* the absence of a subsequence of the target that matches the input. If
* the target attribute of the comparison is a set ("SS", "NS", or "BS"),
* then the operation checks for the absence of a member of the set (not
* as a substring).
-
BEGINS_WITH : checks for a
* prefix.
AttributeValueList can contain only one
* AttributeValue of type String or Binary (not a Number or a
* set). The target attribute of the comparison must be a String or
* Binary (not a Number or a set).
-
IN :
* checks for exact matches.
AttributeValueList can contain
* more than one AttributeValue of type String, Number, or Binary
* (not a set). The target attribute of the comparison must be of the
* same type and exact value to match. A String never matches a String
* set.
-
BETWEEN : Greater than or equal to the
* first value, and less than or equal to the second value.
*
AttributeValueList must contain two AttributeValue
* elements of the same type, either String, Number, or Binary (not a
* set). A target attribute matches if the target value is greater than,
* or equal to, the first element and less than, or equal to, the second
* element. If an item contains an AttributeValue of a different
* type than the one specified in the request, the value does not match.
* For example, {"S":"6"} does not compare to
* {"N":"6"}. Also, {"N":"6"} does not compare
* to {"NS":["6", "2", "1"]}
*
* @return A reference to this updated object so that method calls can be chained
* together.
*
* @see ComparisonOperator
*/
public Condition withComparisonOperator(ComparisonOperator comparisonOperator) {
this.comparisonOperator = comparisonOperator.toString();
return this;
}
/**
* Returns a string representation of this object; useful for testing and
* debugging.
*
* @return A string representation of this object.
*
* @see java.lang.Object#toString()
*/
@Override
public String toString() {
StringBuilder sb = new StringBuilder();
sb.append("{");
if (getAttributeValueList() != null) sb.append("AttributeValueList: " + getAttributeValueList() + ",");
if (getComparisonOperator() != null) sb.append("ComparisonOperator: " + getComparisonOperator() );
sb.append("}");
return sb.toString();
}
@Override
public int hashCode() {
final int prime = 31;
int hashCode = 1;
hashCode = prime * hashCode + ((getAttributeValueList() == null) ? 0 : getAttributeValueList().hashCode());
hashCode = prime * hashCode + ((getComparisonOperator() == null) ? 0 : getComparisonOperator().hashCode());
return hashCode;
}
@Override
public boolean equals(Object obj) {
if (this == obj) return true;
if (obj == null) return false;
if (obj instanceof Condition == false) return false;
Condition other = (Condition)obj;
if (other.getAttributeValueList() == null ^ this.getAttributeValueList() == null) return false;
if (other.getAttributeValueList() != null && other.getAttributeValueList().equals(this.getAttributeValueList()) == false) return false;
if (other.getComparisonOperator() == null ^ this.getComparisonOperator() == null) return false;
if (other.getComparisonOperator() != null && other.getComparisonOperator().equals(this.getComparisonOperator()) == false) return false;
return true;
}
}