com.amazonaws.services.dynamodbv2.model.ExpectedAttributeValue Maven / Gradle / Ivy
Show all versions of aws-sdk-android Show documentation
/*
* Copyright 2010-2015 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 condition to be compared with an attribute value. This
* condition can be used with DeleteItem ,
* PutItem or UpdateItem operations; if
* the comparison evaluates to true, the operation succeeds; if not the
* operation fails. You can use ExpectedAttributeValue in one of
* two different ways:
*
*
*
* -
* Use AttributeValueList to specify one or more values to compare
* against an attribute. Use ComparisonOperator to specify how you
* want to perform the comparison. If the comparison evaluates to true,
* then the conditional operation succeeds.
*
*
* -
* Use Value to specify a value that DynamoDB will compare against
* an attribute. If the values match, then ExpectedAttributeValue
* evaluates to true and the conditional operation succeeds. Optionally,
* you can also set Exists to false, indicating that you do
* not expect to find the attribute value in the table. In this case,
* the conditional operation succeeds only if the comparison evaluates to
* false.
*
*
*
*
*
* Value and Exists are incompatible with
* AttributeValueList and ComparisonOperator . If you
* attempt to use both sets of parameters at once, DynamoDB will throw a
* ValidationException .
*
*
* IMPORTANT: The Value and Exists parameters are deprecated. Even
* though DynamoDB will continue to support these parameters, we
* recommend that you use AttributeValueList and ComparisonOperator
* instead. AttributeValueList and ComparisonOperator let you construct a
* much wider range of conditions than is possible with Value and Exists.
*
*/
public class ExpectedAttributeValue implements Serializable {
/**
* Represents the data for an attribute. You can set one, and only one,
* of the elements.
*/
private AttributeValue value;
/**
* Causes DynamoDB to evaluate the value before attempting a conditional
* operation: -
If Exists is true
,
* DynamoDB will check to see if that attribute value already exists in
* the table. If it is found, then the operation succeeds. If it is not
* found, the operation fails with a
* ConditionalCheckFailedException.
-
If Exists
* is false
, DynamoDB assumes that the attribute value does
* not exist in the table. If in fact the value does not exist,
* then the assumption is valid and the operation succeeds. If the value
* is found, despite the assumption that it does not exist, the operation
* fails with a ConditionalCheckFailedException.
* The default setting for Exists is true
. If you
* supply a Value all by itself, DynamoDB assumes the attribute
* exists: You don't have to set Exists to true
,
* because it is implied.
DynamoDB returns a
* ValidationException if:
-
Exists is
* true
but there is no Value to check. (You expect a
* value to exist, but don't specify what that value is.)
-
*
Exists is false
but you also specify a
* Value. (You cannot expect an attribute to have a value, while
* also expecting it not to exist.)
*/
private Boolean exists;
/**
* A comparator for evaluating attributes in the
* AttributeValueList. For example, equals, greater than, less
* than, etc. The following comparison operators are available:
*
EQ | NE | LE | LT | GE | GT | NOT_NULL | NULL | CONTAINS |
* NOT_CONTAINS | BEGINS_WITH | IN | BETWEEN
The following are
* descriptions of each comparison operator.
-
EQ
* : Equal.
AttributeValueList can contain only one
* AttributeValue of type String, Number, Binary, String Set,
* Number Set, or Binary 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, Binary, String Set,
* Number Set, or Binary 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;
/**
* One or more values to evaluate against the supplied attribute. The
* number of values in the list depends on the ComparisonOperator
* being used.
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.
For information on specifying data types in
* JSON, see JSON
* Data Format in the Amazon DynamoDB Developer Guide.
*/
private com.amazonaws.internal.ListWithAutoConstructFlag attributeValueList;
/**
* Default constructor for a new ExpectedAttributeValue object. Callers should use the
* setter or fluent setter (with...) methods to initialize this object after creating it.
*/
public ExpectedAttributeValue() {}
/**
* Constructs a new ExpectedAttributeValue object.
* Callers should use the setter or fluent setter (with...) methods to
* initialize any additional object members.
*
* @param value Represents the data for an attribute. You can set one,
* and only one, of the elements.
*/
public ExpectedAttributeValue(AttributeValue value) {
setValue(value);
}
/**
* Constructs a new ExpectedAttributeValue object.
* Callers should use the setter or fluent setter (with...) methods to
* initialize any additional object members.
*
* @param exists Causes DynamoDB to evaluate the value before attempting
* a conditional operation: -
If Exists is
* true
, DynamoDB will check to see if that attribute value
* already exists in the table. If it is found, then the operation
* succeeds. If it is not found, the operation fails with a
* ConditionalCheckFailedException.
-
If Exists
* is false
, DynamoDB assumes that the attribute value does
* not exist in the table. If in fact the value does not exist,
* then the assumption is valid and the operation succeeds. If the value
* is found, despite the assumption that it does not exist, the operation
* fails with a ConditionalCheckFailedException.
* The default setting for Exists is true
. If you
* supply a Value all by itself, DynamoDB assumes the attribute
* exists: You don't have to set Exists to true
,
* because it is implied.
DynamoDB returns a
* ValidationException if:
-
Exists is
* true
but there is no Value to check. (You expect a
* value to exist, but don't specify what that value is.)
-
*
Exists is false
but you also specify a
* Value. (You cannot expect an attribute to have a value, while
* also expecting it not to exist.)
*/
public ExpectedAttributeValue(Boolean exists) {
setExists(exists);
}
/**
* Represents the data for an attribute. You can set one, and only one,
* of the elements.
*
* @return Represents the data for an attribute. You can set one, and only one,
* of the elements.
*/
public AttributeValue getValue() {
return value;
}
/**
* Represents the data for an attribute. You can set one, and only one,
* of the elements.
*
* @param value Represents the data for an attribute. You can set one, and only one,
* of the elements.
*/
public void setValue(AttributeValue value) {
this.value = value;
}
/**
* Represents the data for an attribute. You can set one, and only one,
* of the elements.
*
* Returns a reference to this object so that method calls can be chained together.
*
* @param value Represents the data for an attribute. You can set one, and only one,
* of the elements.
*
* @return A reference to this updated object so that method calls can be chained
* together.
*/
public ExpectedAttributeValue withValue(AttributeValue value) {
this.value = value;
return this;
}
/**
* Causes DynamoDB to evaluate the value before attempting a conditional
* operation:
-
If Exists is true
,
* DynamoDB will check to see if that attribute value already exists in
* the table. If it is found, then the operation succeeds. If it is not
* found, the operation fails with a
* ConditionalCheckFailedException.
-
If Exists
* is false
, DynamoDB assumes that the attribute value does
* not exist in the table. If in fact the value does not exist,
* then the assumption is valid and the operation succeeds. If the value
* is found, despite the assumption that it does not exist, the operation
* fails with a ConditionalCheckFailedException.
* The default setting for Exists is true
. If you
* supply a Value all by itself, DynamoDB assumes the attribute
* exists: You don't have to set Exists to true
,
* because it is implied.
DynamoDB returns a
* ValidationException if:
-
Exists is
* true
but there is no Value to check. (You expect a
* value to exist, but don't specify what that value is.)
-
*
Exists is false
but you also specify a
* Value. (You cannot expect an attribute to have a value, while
* also expecting it not to exist.)
*
* @return Causes DynamoDB to evaluate the value before attempting a conditional
* operation: -
If Exists is true
,
* DynamoDB will check to see if that attribute value already exists in
* the table. If it is found, then the operation succeeds. If it is not
* found, the operation fails with a
* ConditionalCheckFailedException.
-
If Exists
* is false
, DynamoDB assumes that the attribute value does
* not exist in the table. If in fact the value does not exist,
* then the assumption is valid and the operation succeeds. If the value
* is found, despite the assumption that it does not exist, the operation
* fails with a ConditionalCheckFailedException.
* The default setting for Exists is true
. If you
* supply a Value all by itself, DynamoDB assumes the attribute
* exists: You don't have to set Exists to true
,
* because it is implied.
DynamoDB returns a
* ValidationException if:
-
Exists is
* true
but there is no Value to check. (You expect a
* value to exist, but don't specify what that value is.)
-
*
Exists is false
but you also specify a
* Value. (You cannot expect an attribute to have a value, while
* also expecting it not to exist.)
*/
public Boolean isExists() {
return exists;
}
/**
* Causes DynamoDB to evaluate the value before attempting a conditional
* operation: -
If Exists is true
,
* DynamoDB will check to see if that attribute value already exists in
* the table. If it is found, then the operation succeeds. If it is not
* found, the operation fails with a
* ConditionalCheckFailedException.
-
If Exists
* is false
, DynamoDB assumes that the attribute value does
* not exist in the table. If in fact the value does not exist,
* then the assumption is valid and the operation succeeds. If the value
* is found, despite the assumption that it does not exist, the operation
* fails with a ConditionalCheckFailedException.
* The default setting for Exists is true
. If you
* supply a Value all by itself, DynamoDB assumes the attribute
* exists: You don't have to set Exists to true
,
* because it is implied.
DynamoDB returns a
* ValidationException if:
-
Exists is
* true
but there is no Value to check. (You expect a
* value to exist, but don't specify what that value is.)
-
*
Exists is false
but you also specify a
* Value. (You cannot expect an attribute to have a value, while
* also expecting it not to exist.)
*
* @param exists Causes DynamoDB to evaluate the value before attempting a conditional
* operation: -
If Exists is true
,
* DynamoDB will check to see if that attribute value already exists in
* the table. If it is found, then the operation succeeds. If it is not
* found, the operation fails with a
* ConditionalCheckFailedException.
-
If Exists
* is false
, DynamoDB assumes that the attribute value does
* not exist in the table. If in fact the value does not exist,
* then the assumption is valid and the operation succeeds. If the value
* is found, despite the assumption that it does not exist, the operation
* fails with a ConditionalCheckFailedException.
* The default setting for Exists is true
. If you
* supply a Value all by itself, DynamoDB assumes the attribute
* exists: You don't have to set Exists to true
,
* because it is implied.
DynamoDB returns a
* ValidationException if:
-
Exists is
* true
but there is no Value to check. (You expect a
* value to exist, but don't specify what that value is.)
-
*
Exists is false
but you also specify a
* Value. (You cannot expect an attribute to have a value, while
* also expecting it not to exist.)
*/
public void setExists(Boolean exists) {
this.exists = exists;
}
/**
* Causes DynamoDB to evaluate the value before attempting a conditional
* operation: -
If Exists is true
,
* DynamoDB will check to see if that attribute value already exists in
* the table. If it is found, then the operation succeeds. If it is not
* found, the operation fails with a
* ConditionalCheckFailedException.
-
If Exists
* is false
, DynamoDB assumes that the attribute value does
* not exist in the table. If in fact the value does not exist,
* then the assumption is valid and the operation succeeds. If the value
* is found, despite the assumption that it does not exist, the operation
* fails with a ConditionalCheckFailedException.
* The default setting for Exists is true
. If you
* supply a Value all by itself, DynamoDB assumes the attribute
* exists: You don't have to set Exists to true
,
* because it is implied.
DynamoDB returns a
* ValidationException if:
-
Exists is
* true
but there is no Value to check. (You expect a
* value to exist, but don't specify what that value is.)
-
*
Exists is false
but you also specify a
* Value. (You cannot expect an attribute to have a value, while
* also expecting it not to exist.)
*
* Returns a reference to this object so that method calls can be chained together.
*
* @param exists Causes DynamoDB to evaluate the value before attempting a conditional
* operation:
-
If Exists is true
,
* DynamoDB will check to see if that attribute value already exists in
* the table. If it is found, then the operation succeeds. If it is not
* found, the operation fails with a
* ConditionalCheckFailedException.
-
If Exists
* is false
, DynamoDB assumes that the attribute value does
* not exist in the table. If in fact the value does not exist,
* then the assumption is valid and the operation succeeds. If the value
* is found, despite the assumption that it does not exist, the operation
* fails with a ConditionalCheckFailedException.
* The default setting for Exists is true
. If you
* supply a Value all by itself, DynamoDB assumes the attribute
* exists: You don't have to set Exists to true
,
* because it is implied.
DynamoDB returns a
* ValidationException if:
-
Exists is
* true
but there is no Value to check. (You expect a
* value to exist, but don't specify what that value is.)
-
*
Exists is false
but you also specify a
* Value. (You cannot expect an attribute to have a value, while
* also expecting it not to exist.)
*
* @return A reference to this updated object so that method calls can be chained
* together.
*/
public ExpectedAttributeValue withExists(Boolean exists) {
this.exists = exists;
return this;
}
/**
* Causes DynamoDB to evaluate the value before attempting a conditional
* operation: -
If Exists is true
,
* DynamoDB will check to see if that attribute value already exists in
* the table. If it is found, then the operation succeeds. If it is not
* found, the operation fails with a
* ConditionalCheckFailedException.
-
If Exists
* is false
, DynamoDB assumes that the attribute value does
* not exist in the table. If in fact the value does not exist,
* then the assumption is valid and the operation succeeds. If the value
* is found, despite the assumption that it does not exist, the operation
* fails with a ConditionalCheckFailedException.
* The default setting for Exists is true
. If you
* supply a Value all by itself, DynamoDB assumes the attribute
* exists: You don't have to set Exists to true
,
* because it is implied.
DynamoDB returns a
* ValidationException if:
-
Exists is
* true
but there is no Value to check. (You expect a
* value to exist, but don't specify what that value is.)
-
*
Exists is false
but you also specify a
* Value. (You cannot expect an attribute to have a value, while
* also expecting it not to exist.)
*
* @return Causes DynamoDB to evaluate the value before attempting a conditional
* operation: -
If Exists is true
,
* DynamoDB will check to see if that attribute value already exists in
* the table. If it is found, then the operation succeeds. If it is not
* found, the operation fails with a
* ConditionalCheckFailedException.
-
If Exists
* is false
, DynamoDB assumes that the attribute value does
* not exist in the table. If in fact the value does not exist,
* then the assumption is valid and the operation succeeds. If the value
* is found, despite the assumption that it does not exist, the operation
* fails with a ConditionalCheckFailedException.
* The default setting for Exists is true
. If you
* supply a Value all by itself, DynamoDB assumes the attribute
* exists: You don't have to set Exists to true
,
* because it is implied.
DynamoDB returns a
* ValidationException if:
-
Exists is
* true
but there is no Value to check. (You expect a
* value to exist, but don't specify what that value is.)
-
*
Exists is false
but you also specify a
* Value. (You cannot expect an attribute to have a value, while
* also expecting it not to exist.)
*/
public Boolean getExists() {
return exists;
}
/**
* A comparator for evaluating attributes in the
* AttributeValueList. For example, equals, greater than, less
* than, etc. The following comparison operators are available:
*
EQ | NE | LE | LT | GE | GT | NOT_NULL | NULL | CONTAINS |
* NOT_CONTAINS | BEGINS_WITH | IN | BETWEEN
The following are
* descriptions of each comparison operator.
-
EQ
* : Equal.
AttributeValueList can contain only one
* AttributeValue of type String, Number, Binary, String Set,
* Number Set, or Binary 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, Binary, String Set,
* Number Set, or Binary 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 in the
* AttributeValueList. For example, equals, greater than, less
* than, etc.
The following comparison operators are available:
*
EQ | NE | LE | LT | GE | GT | NOT_NULL | NULL | CONTAINS |
* NOT_CONTAINS | BEGINS_WITH | IN | BETWEEN
The following are
* descriptions of each comparison operator.
-
EQ
* : Equal.
AttributeValueList can contain only one
* AttributeValue of type String, Number, Binary, String Set,
* Number Set, or Binary 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, Binary, String Set,
* Number Set, or Binary 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 in the
* AttributeValueList. For example, equals, greater than, less
* than, etc. The following comparison operators are available:
*
EQ | NE | LE | LT | GE | GT | NOT_NULL | NULL | CONTAINS |
* NOT_CONTAINS | BEGINS_WITH | IN | BETWEEN
The following are
* descriptions of each comparison operator.
-
EQ
* : Equal.
AttributeValueList can contain only one
* AttributeValue of type String, Number, Binary, String Set,
* Number Set, or Binary 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, Binary, String Set,
* Number Set, or Binary 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 in the
* AttributeValueList. For example, equals, greater than, less
* than, etc.
The following comparison operators are available:
*
EQ | NE | LE | LT | GE | GT | NOT_NULL | NULL | CONTAINS |
* NOT_CONTAINS | BEGINS_WITH | IN | BETWEEN
The following are
* descriptions of each comparison operator.
-
EQ
* : Equal.
AttributeValueList can contain only one
* AttributeValue of type String, Number, Binary, String Set,
* Number Set, or Binary 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, Binary, String Set,
* Number Set, or Binary 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 in the
* AttributeValueList. For example, equals, greater than, less
* than, etc. The following comparison operators are available:
*
EQ | NE | LE | LT | GE | GT | NOT_NULL | NULL | CONTAINS |
* NOT_CONTAINS | BEGINS_WITH | IN | BETWEEN
The following are
* descriptions of each comparison operator.
-
EQ
* : Equal.
AttributeValueList can contain only one
* AttributeValue of type String, Number, Binary, String Set,
* Number Set, or Binary 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, Binary, String Set,
* Number Set, or Binary 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 in the
* AttributeValueList. For example, equals, greater than, less
* than, etc.
The following comparison operators are available:
*
EQ | NE | LE | LT | GE | GT | NOT_NULL | NULL | CONTAINS |
* NOT_CONTAINS | BEGINS_WITH | IN | BETWEEN
The following are
* descriptions of each comparison operator.
-
EQ
* : Equal.
AttributeValueList can contain only one
* AttributeValue of type String, Number, Binary, String Set,
* Number Set, or Binary 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, Binary, String Set,
* Number Set, or Binary 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 ExpectedAttributeValue withComparisonOperator(String comparisonOperator) {
this.comparisonOperator = comparisonOperator;
return this;
}
/**
* A comparator for evaluating attributes in the
* AttributeValueList. For example, equals, greater than, less
* than, etc. The following comparison operators are available:
*
EQ | NE | LE | LT | GE | GT | NOT_NULL | NULL | CONTAINS |
* NOT_CONTAINS | BEGINS_WITH | IN | BETWEEN
The following are
* descriptions of each comparison operator.
-
EQ
* : Equal.
AttributeValueList can contain only one
* AttributeValue of type String, Number, Binary, String Set,
* Number Set, or Binary 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, Binary, String Set,
* Number Set, or Binary 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 in the
* AttributeValueList. For example, equals, greater than, less
* than, etc.
The following comparison operators are available:
*
EQ | NE | LE | LT | GE | GT | NOT_NULL | NULL | CONTAINS |
* NOT_CONTAINS | BEGINS_WITH | IN | BETWEEN
The following are
* descriptions of each comparison operator.
-
EQ
* : Equal.
AttributeValueList can contain only one
* AttributeValue of type String, Number, Binary, String Set,
* Number Set, or Binary 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, Binary, String Set,
* Number Set, or Binary 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 in the
* AttributeValueList. For example, equals, greater than, less
* than, etc. The following comparison operators are available:
*
EQ | NE | LE | LT | GE | GT | NOT_NULL | NULL | CONTAINS |
* NOT_CONTAINS | BEGINS_WITH | IN | BETWEEN
The following are
* descriptions of each comparison operator.
-
EQ
* : Equal.
AttributeValueList can contain only one
* AttributeValue of type String, Number, Binary, String Set,
* Number Set, or Binary 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, Binary, String Set,
* Number Set, or Binary 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 in the
* AttributeValueList. For example, equals, greater than, less
* than, etc.
The following comparison operators are available:
*
EQ | NE | LE | LT | GE | GT | NOT_NULL | NULL | CONTAINS |
* NOT_CONTAINS | BEGINS_WITH | IN | BETWEEN
The following are
* descriptions of each comparison operator.
-
EQ
* : Equal.
AttributeValueList can contain only one
* AttributeValue of type String, Number, Binary, String Set,
* Number Set, or Binary 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, Binary, String Set,
* Number Set, or Binary 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 ExpectedAttributeValue withComparisonOperator(ComparisonOperator comparisonOperator) {
this.comparisonOperator = comparisonOperator.toString();
return this;
}
/**
* One or more values to evaluate against the supplied attribute. The
* number of values in the list depends on the ComparisonOperator
* being used. 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.
For information on specifying data types in
* JSON, see JSON
* Data Format in the Amazon DynamoDB Developer Guide.
*
* @return One or more values to evaluate against the supplied attribute. The
* number of values in the list depends on the ComparisonOperator
* being used.
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.
For information on specifying data types in
* JSON, see JSON
* Data Format in the Amazon DynamoDB Developer Guide.
*/
public java.util.List getAttributeValueList() {
return attributeValueList;
}
/**
* One or more values to evaluate against the supplied attribute. The
* number of values in the list depends on the ComparisonOperator
* being used. 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.
For information on specifying data types in
* JSON, see JSON
* Data Format in the Amazon DynamoDB Developer Guide.
*
* @param attributeValueList One or more values to evaluate against the supplied attribute. The
* number of values in the list depends on the ComparisonOperator
* being used.
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.
For information on specifying data types in
* JSON, see JSON
* Data Format in the Amazon DynamoDB Developer Guide.
*/
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. The
* number of values in the list depends on the ComparisonOperator
* being used. 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.
For information on specifying data types in
* JSON, see JSON
* Data Format in the Amazon DynamoDB Developer Guide.
*
* 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. The
* number of values in the list depends on the ComparisonOperator
* being used.
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.
For information on specifying data types in
* JSON, see JSON
* Data Format in the Amazon DynamoDB Developer Guide.
*
* @return A reference to this updated object so that method calls can be chained
* together.
*/
public ExpectedAttributeValue 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. The
* number of values in the list depends on the ComparisonOperator
* being used. 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.
For information on specifying data types in
* JSON, see JSON
* Data Format in the Amazon DynamoDB Developer Guide.
*
* 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. The
* number of values in the list depends on the ComparisonOperator
* being used.
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.
For information on specifying data types in
* JSON, see JSON
* Data Format in the Amazon DynamoDB Developer Guide.
*
* @return A reference to this updated object so that method calls can be chained
* together.
*/
public ExpectedAttributeValue 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;
}
/**
* 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 (getValue() != null) sb.append("Value: " + getValue() + ",");
if (isExists() != null) sb.append("Exists: " + isExists() + ",");
if (getComparisonOperator() != null) sb.append("ComparisonOperator: " + getComparisonOperator() + ",");
if (getAttributeValueList() != null) sb.append("AttributeValueList: " + getAttributeValueList() );
sb.append("}");
return sb.toString();
}
@Override
public int hashCode() {
final int prime = 31;
int hashCode = 1;
hashCode = prime * hashCode + ((getValue() == null) ? 0 : getValue().hashCode());
hashCode = prime * hashCode + ((isExists() == null) ? 0 : isExists().hashCode());
hashCode = prime * hashCode + ((getComparisonOperator() == null) ? 0 : getComparisonOperator().hashCode());
hashCode = prime * hashCode + ((getAttributeValueList() == null) ? 0 : getAttributeValueList().hashCode());
return hashCode;
}
@Override
public boolean equals(Object obj) {
if (this == obj) return true;
if (obj == null) return false;
if (obj instanceof ExpectedAttributeValue == false) return false;
ExpectedAttributeValue other = (ExpectedAttributeValue)obj;
if (other.getValue() == null ^ this.getValue() == null) return false;
if (other.getValue() != null && other.getValue().equals(this.getValue()) == false) return false;
if (other.isExists() == null ^ this.isExists() == null) return false;
if (other.isExists() != null && other.isExists().equals(this.isExists()) == false) return false;
if (other.getComparisonOperator() == null ^ this.getComparisonOperator() == null) return false;
if (other.getComparisonOperator() != null && other.getComparisonOperator().equals(this.getComparisonOperator()) == false) return false;
if (other.getAttributeValueList() == null ^ this.getAttributeValueList() == null) return false;
if (other.getAttributeValueList() != null && other.getAttributeValueList().equals(this.getAttributeValueList()) == false) return false;
return true;
}
}