/* * Copyright 2010-2019 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 the selection criteria for a Query or * Scan operation: *

* */ public class Condition implements Serializable { /** *

* 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 a 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. *

*/ private java.util.List attributeValueList; /** *

* A comparator for evaluating attributes. 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. *

* *

* For usage examples of AttributeValueList and * ComparisonOperator, see Legacy Conditional Parameters in the Amazon DynamoDB Developer * Guide. *

*

* 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 a 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. *

* * @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 a * 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. *

*/ 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 a 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. *

* * @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 * a 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. *

*/ public void setAttributeValueList(java.util.Collection attributeValueList) { if (attributeValueList == null) { this.attributeValueList = null; return; } this.attributeValueList = new java.util.ArrayList(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 a 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. *

*

* 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 * a 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. *

* @return A reference to this updated object so that method calls can be * chained together. */ public Condition withAttributeValueList(AttributeValue... attributeValueList) { if (getAttributeValueList() == null) { this.attributeValueList = new java.util.ArrayList( attributeValueList.length); } for (AttributeValue value : attributeValueList) { this.attributeValueList.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 a 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. *

*

* 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 * a 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. *

* @return A reference to this updated object so that method calls can be * chained together. */ public Condition withAttributeValueList(java.util.Collection attributeValueList) { setAttributeValueList(attributeValueList); return this; } /** *

* A comparator for evaluating attributes. 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. EQ is supported for all data types, * including lists and maps. *

    *

    * AttributeValueList can contain only one * AttributeValue element of type String, Number, Binary, * String Set, Number Set, or Binary Set. If an item contains an * AttributeValue element of a different type than the one * provided 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. NE is supported for all data * types, including lists and maps. *

    *

    * 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 provided 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 element of type String, Number, or Binary * (not a set type). If an item contains an AttributeValue * element of a different type than the one provided 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 * type). If an item contains an AttributeValue element of a * different type than the one provided 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 element of type String, Number, or Binary * (not a set type). If an item contains an AttributeValue * element of a different type than the one provided 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 element of type String, Number, or Binary * (not a set type). If an item contains an AttributeValue * element of a different type than the one provided 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. NOT_NULL is * supported for all data types, including lists and maps. *

    * *

    * This operator tests for the existence of an attribute, not its data type. * If the data type of attribute "a" is null, and you evaluate * it using NOT_NULL, the result is a Boolean true * . This result is because the attribute "a" exists; its data * type is not relevant to the NOT_NULL comparison operator. *

    *
    • *
  • *

    * NULL : The attribute does not exist. NULL is * supported for all data types, including lists and maps. *

    * *

    * This operator tests for the nonexistence of an attribute, not its data * type. If the data type of attribute "a" is null, and you * evaluate it using NULL, the result is a Boolean * false. This is because the attribute "a" * exists; its data type is not relevant to the NULL comparison * operator. *

    *
    • *
  • *

    * CONTAINS : Checks for a subsequence, or value in a set. *

    *

    * AttributeValueList can contain only one * AttributeValue element of type String, Number, or Binary * (not a set type). If the target attribute of the comparison is of type * String, then the operator checks for a substring match. If the target * attribute of the comparison is of type Binary, then the operator 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 operator evaluates to true if it finds * an exact match with any member of the set. *

    *

    * CONTAINS is supported for lists: When evaluating " * a CONTAINS b", "a" can be a list; however, " * b" cannot be a set, a map, or a list. *

    *
    • *
  • *

    * NOT_CONTAINS : Checks for absence of a subsequence, or * absence of a value in a set. *

    *

    * AttributeValueList can contain only one * AttributeValue element of type String, Number, or Binary * (not a set type). If the target attribute of the comparison is a String, * then the operator checks for the absence of a substring match. If the * target attribute of the comparison is Binary, then the operator 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 operator evaluates to * true if it does not find an exact match with any member of the * set. *

    *

    * NOT_CONTAINS is supported for lists: When evaluating " * a NOT CONTAINS b", "a * " can be a list; however, "b" cannot be a set, a map, or a * list. *

    *
    • *
  • *

    * BEGINS_WITH : Checks for a prefix. *

    *

    * AttributeValueList can contain only one * AttributeValue of type String or Binary (not a Number or a * set type). The target attribute of the comparison must be of type String * or Binary (not a Number or a set type). *

    *

    • *
  • *

    * IN : Checks for matching elements in a list. *

    *

    * AttributeValueList can contain one or more * AttributeValue elements of type String, Number, or Binary. * These attributes are compared against an existing attribute of an item. * If any elements of the input are equal to the item attribute, the * expression evaluates to true. *

    *
    • *
  • *

    * 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 type). 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 element of a different type than the one * provided 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"]} *

    *
    • *
*

* For usage examples of AttributeValueList and * ComparisonOperator, see Legacy Conditional Parameters in the Amazon DynamoDB Developer * Guide. *

*

* 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. *

*

* 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. EQ is supported for all * data types, including lists and maps. *

    *

    * AttributeValueList can contain only one * AttributeValue element of type String, Number, * Binary, String Set, Number Set, or Binary Set. If an item * contains an AttributeValue element of a different * type than the one provided 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. NE is supported for all * data types, including lists and maps. *

    *

    * 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 * provided 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 element of type String, Number, or * Binary (not a set type). If an item contains an * AttributeValue element of a different type than the * one provided 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 type). If an item contains an * AttributeValue element of a different type than the * one provided 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 element of type String, Number, or * Binary (not a set type). If an item contains an * AttributeValue element of a different type than the * one provided 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 element of type String, Number, or * Binary (not a set type). If an item contains an * AttributeValue element of a different type than the * one provided 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. * NOT_NULL is supported for all data types, including * lists and maps. *

    * *

    * This operator tests for the existence of an attribute, not its * data type. If the data type of attribute "a" is * null, and you evaluate it using NOT_NULL, the result * is a Boolean true. This result is because the * attribute "a" exists; its data type is not relevant * to the NOT_NULL comparison operator. *

    *
    • *
  • *

    * NULL : The attribute does not exist. * NULL is supported for all data types, including * lists and maps. *

    * *

    * This operator tests for the nonexistence of an attribute, not its * data type. If the data type of attribute "a" is * null, and you evaluate it using NULL, the result is * a Boolean false. This is because the attribute " * a" exists; its data type is not relevant to the * NULL comparison operator. *

    *
    • *
  • *

    * CONTAINS : Checks for a subsequence, or value in a * set. *

    *

    * AttributeValueList can contain only one * AttributeValue element of type String, Number, or * Binary (not a set type). If the target attribute of the * comparison is of type String, then the operator checks for a * substring match. If the target attribute of the comparison is of * type Binary, then the operator 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 operator evaluates to true if it * finds an exact match with any member of the set. *

    *

    * CONTAINS is supported for lists: When evaluating " * a CONTAINS b", "a * " can be a list; however, "b" cannot be a set, a * map, or a list. *

    *
    • *
  • *

    * NOT_CONTAINS : Checks for absence of a subsequence, * or absence of a value in a set. *

    *

    * AttributeValueList can contain only one * AttributeValue element of type String, Number, or * Binary (not a set type). If the target attribute of the * comparison is a String, then the operator checks for the absence * of a substring match. If the target attribute of the comparison * is Binary, then the operator 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 operator * evaluates to true if it does not find an exact match with * any member of the set. *

    *

    * NOT_CONTAINS is supported for lists: When evaluating " * a NOT CONTAINS b", "a * " can be a list; however, "b" cannot be a set, a * map, or a list. *

    *
    • *
  • *

    * BEGINS_WITH : Checks for a prefix. *

    *

    * AttributeValueList can contain only one * AttributeValue of type String or Binary (not a * Number or a set type). The target attribute of the comparison * must be of type String or Binary (not a Number or a set type). *

    *

    • *
  • *

    * IN : Checks for matching elements in a list. *

    *

    * AttributeValueList can contain one or more * AttributeValue elements of type String, Number, or * Binary. These attributes are compared against an existing * attribute of an item. If any elements of the input are equal to * the item attribute, the expression evaluates to true. *

    *
    • *
  • *

    * 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 type). 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 element of a * different type than the one provided 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"]} *

    *
    • *
*

* For usage examples of AttributeValueList and * ComparisonOperator, see Legacy Conditional Parameters in the Amazon DynamoDB * Developer Guide. *

* @see ComparisonOperator */ public String getComparisonOperator() { return comparisonOperator; } /** *

* A comparator for evaluating attributes. 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. EQ is supported for all data types, * including lists and maps. *

    *

    * AttributeValueList can contain only one * AttributeValue element of type String, Number, Binary, * String Set, Number Set, or Binary Set. If an item contains an * AttributeValue element of a different type than the one * provided 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. NE is supported for all data * types, including lists and maps. *

    *

    * 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 provided 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 element of type String, Number, or Binary * (not a set type). If an item contains an AttributeValue * element of a different type than the one provided 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 * type). If an item contains an AttributeValue element of a * different type than the one provided 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 element of type String, Number, or Binary * (not a set type). If an item contains an AttributeValue * element of a different type than the one provided 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 element of type String, Number, or Binary * (not a set type). If an item contains an AttributeValue * element of a different type than the one provided 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. NOT_NULL is * supported for all data types, including lists and maps. *

    * *

    * This operator tests for the existence of an attribute, not its data type. * If the data type of attribute "a" is null, and you evaluate * it using NOT_NULL, the result is a Boolean true * . This result is because the attribute "a" exists; its data * type is not relevant to the NOT_NULL comparison operator. *

    *
    • *
  • *

    * NULL : The attribute does not exist. NULL is * supported for all data types, including lists and maps. *

    * *

    * This operator tests for the nonexistence of an attribute, not its data * type. If the data type of attribute "a" is null, and you * evaluate it using NULL, the result is a Boolean * false. This is because the attribute "a" * exists; its data type is not relevant to the NULL comparison * operator. *

    *
    • *
  • *

    * CONTAINS : Checks for a subsequence, or value in a set. *

    *

    * AttributeValueList can contain only one * AttributeValue element of type String, Number, or Binary * (not a set type). If the target attribute of the comparison is of type * String, then the operator checks for a substring match. If the target * attribute of the comparison is of type Binary, then the operator 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 operator evaluates to true if it finds * an exact match with any member of the set. *

    *

    * CONTAINS is supported for lists: When evaluating " * a CONTAINS b", "a" can be a list; however, " * b" cannot be a set, a map, or a list. *

    *
    • *
  • *

    * NOT_CONTAINS : Checks for absence of a subsequence, or * absence of a value in a set. *

    *

    * AttributeValueList can contain only one * AttributeValue element of type String, Number, or Binary * (not a set type). If the target attribute of the comparison is a String, * then the operator checks for the absence of a substring match. If the * target attribute of the comparison is Binary, then the operator 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 operator evaluates to * true if it does not find an exact match with any member of the * set. *

    *

    * NOT_CONTAINS is supported for lists: When evaluating " * a NOT CONTAINS b", "a * " can be a list; however, "b" cannot be a set, a map, or a * list. *

    *
    • *
  • *

    * BEGINS_WITH : Checks for a prefix. *

    *

    * AttributeValueList can contain only one * AttributeValue of type String or Binary (not a Number or a * set type). The target attribute of the comparison must be of type String * or Binary (not a Number or a set type). *

    *

    • *
  • *

    * IN : Checks for matching elements in a list. *

    *

    * AttributeValueList can contain one or more * AttributeValue elements of type String, Number, or Binary. * These attributes are compared against an existing attribute of an item. * If any elements of the input are equal to the item attribute, the * expression evaluates to true. *

    *
    • *
  • *

    * 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 type). 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 element of a different type than the one * provided 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"]} *

    *
    • *
*

* For usage examples of AttributeValueList and * ComparisonOperator, see Legacy Conditional Parameters in the Amazon DynamoDB Developer * Guide. *

*

* 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. *

*

* 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. EQ is supported for all * data types, including lists and maps. *

    *

    * AttributeValueList can contain only one * AttributeValue element of type String, Number, * Binary, String Set, Number Set, or Binary Set. If an item * contains an AttributeValue element of a different * type than the one provided 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. NE is supported for * all data types, including lists and maps. *

    *

    * 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 * provided 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 element of type String, Number, or * Binary (not a set type). If an item contains an * AttributeValue element of a different type than * the one provided 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 type). If an item contains an * AttributeValue element of a different type than * the one provided 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 element of type String, Number, or * Binary (not a set type). If an item contains an * AttributeValue element of a different type than * the one provided 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 element of type String, Number, or * Binary (not a set type). If an item contains an * AttributeValue element of a different type than * the one provided 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. * NOT_NULL is supported for all data types, * including lists and maps. *

    * *

    * This operator tests for the existence of an attribute, not its * data type. If the data type of attribute "a" is * null, and you evaluate it using NOT_NULL, the * result is a Boolean true. This result is because * the attribute "a" exists; its data type is not * relevant to the NOT_NULL comparison operator. *

    *
    • *
  • *

    * NULL : The attribute does not exist. * NULL is supported for all data types, including * lists and maps. *

    * *

    * This operator tests for the nonexistence of an attribute, not * its data type. If the data type of attribute "a" * is null, and you evaluate it using NULL, the * result is a Boolean false. This is because the * attribute "a" exists; its data type is not * relevant to the NULL comparison operator. *

    *
    • *
  • *

    * CONTAINS : Checks for a subsequence, or value in * a set. *

    *

    * AttributeValueList can contain only one * AttributeValue element of type String, Number, or * Binary (not a set type). If the target attribute of the * comparison is of type String, then the operator checks for a * substring match. If the target attribute of the comparison is * of type Binary, then the operator 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 operator evaluates to true * if it finds an exact match with any member of the set. *

    *

    * CONTAINS is supported for lists: When evaluating " * a CONTAINS b", "a * " can be a list; however, "b" cannot be a set, a * map, or a list. *

    *
    • *
  • *

    * NOT_CONTAINS : Checks for absence of a * subsequence, or absence of a value in a set. *

    *

    * AttributeValueList can contain only one * AttributeValue element of type String, Number, or * Binary (not a set type). If the target attribute of the * comparison is a String, then the operator checks for the * absence of a substring match. If the target attribute of the * comparison is Binary, then the operator 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 operator * evaluates to true if it does not find an exact match * with any member of the set. *

    *

    * NOT_CONTAINS is supported for lists: When evaluating " * a NOT CONTAINS b", "a * " can be a list; however, "b" cannot be a set, a * map, or a list. *

    *
    • *
  • *

    * BEGINS_WITH : Checks for a prefix. *

    *

    * AttributeValueList can contain only one * AttributeValue of type String or Binary (not a * Number or a set type). The target attribute of the comparison * must be of type String or Binary (not a Number or a set type). *

    *

    • *
  • *

    * IN : Checks for matching elements in a list. *

    *

    * AttributeValueList can contain one or more * AttributeValue elements of type String, Number, * or Binary. These attributes are compared against an existing * attribute of an item. If any elements of the input are equal * to the item attribute, the expression evaluates to true. *

    *
    • *
  • *

    * 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 type). 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 element of * a different type than the one provided 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"]} *

    *
    • *
*

* For usage examples of AttributeValueList and * ComparisonOperator, see Legacy Conditional Parameters in the Amazon DynamoDB * Developer Guide. *

* @see ComparisonOperator */ public void setComparisonOperator(String comparisonOperator) { this.comparisonOperator = comparisonOperator; } /** *

* A comparator for evaluating attributes. 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. EQ is supported for all data types, * including lists and maps. *

    *

    * AttributeValueList can contain only one * AttributeValue element of type String, Number, Binary, * String Set, Number Set, or Binary Set. If an item contains an * AttributeValue element of a different type than the one * provided 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. NE is supported for all data * types, including lists and maps. *

    *

    * 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 provided 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 element of type String, Number, or Binary * (not a set type). If an item contains an AttributeValue * element of a different type than the one provided 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 * type). If an item contains an AttributeValue element of a * different type than the one provided 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 element of type String, Number, or Binary * (not a set type). If an item contains an AttributeValue * element of a different type than the one provided 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 element of type String, Number, or Binary * (not a set type). If an item contains an AttributeValue * element of a different type than the one provided 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. NOT_NULL is * supported for all data types, including lists and maps. *

    * *

    * This operator tests for the existence of an attribute, not its data type. * If the data type of attribute "a" is null, and you evaluate * it using NOT_NULL, the result is a Boolean true * . This result is because the attribute "a" exists; its data * type is not relevant to the NOT_NULL comparison operator. *

    *
    • *
  • *

    * NULL : The attribute does not exist. NULL is * supported for all data types, including lists and maps. *

    * *

    * This operator tests for the nonexistence of an attribute, not its data * type. If the data type of attribute "a" is null, and you * evaluate it using NULL, the result is a Boolean * false. This is because the attribute "a" * exists; its data type is not relevant to the NULL comparison * operator. *

    *
    • *
  • *

    * CONTAINS : Checks for a subsequence, or value in a set. *

    *

    * AttributeValueList can contain only one * AttributeValue element of type String, Number, or Binary * (not a set type). If the target attribute of the comparison is of type * String, then the operator checks for a substring match. If the target * attribute of the comparison is of type Binary, then the operator 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 operator evaluates to true if it finds * an exact match with any member of the set. *

    *

    * CONTAINS is supported for lists: When evaluating " * a CONTAINS b", "a" can be a list; however, " * b" cannot be a set, a map, or a list. *

    *
    • *
  • *

    * NOT_CONTAINS : Checks for absence of a subsequence, or * absence of a value in a set. *

    *

    * AttributeValueList can contain only one * AttributeValue element of type String, Number, or Binary * (not a set type). If the target attribute of the comparison is a String, * then the operator checks for the absence of a substring match. If the * target attribute of the comparison is Binary, then the operator 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 operator evaluates to * true if it does not find an exact match with any member of the * set. *

    *

    * NOT_CONTAINS is supported for lists: When evaluating " * a NOT CONTAINS b", "a * " can be a list; however, "b" cannot be a set, a map, or a * list. *

    *
    • *
  • *

    * BEGINS_WITH : Checks for a prefix. *

    *

    * AttributeValueList can contain only one * AttributeValue of type String or Binary (not a Number or a * set type). The target attribute of the comparison must be of type String * or Binary (not a Number or a set type). *

    *

    • *
  • *

    * IN : Checks for matching elements in a list. *

    *

    * AttributeValueList can contain one or more * AttributeValue elements of type String, Number, or Binary. * These attributes are compared against an existing attribute of an item. * If any elements of the input are equal to the item attribute, the * expression evaluates to true. *

    *
    • *
  • *

    * 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 type). 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 element of a different type than the one * provided 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"]} *

    *
    • *
*

* For usage examples of AttributeValueList and * ComparisonOperator, see Legacy Conditional Parameters in the Amazon DynamoDB Developer * Guide. *

*

* 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. *

*

* 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. EQ is supported for all * data types, including lists and maps. *

    *

    * AttributeValueList can contain only one * AttributeValue element of type String, Number, * Binary, String Set, Number Set, or Binary Set. If an item * contains an AttributeValue element of a different * type than the one provided 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. NE is supported for * all data types, including lists and maps. *

    *

    * 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 * provided 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 element of type String, Number, or * Binary (not a set type). If an item contains an * AttributeValue element of a different type than * the one provided 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 type). If an item contains an * AttributeValue element of a different type than * the one provided 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 element of type String, Number, or * Binary (not a set type). If an item contains an * AttributeValue element of a different type than * the one provided 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 element of type String, Number, or * Binary (not a set type). If an item contains an * AttributeValue element of a different type than * the one provided 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. * NOT_NULL is supported for all data types, * including lists and maps. *

    * *

    * This operator tests for the existence of an attribute, not its * data type. If the data type of attribute "a" is * null, and you evaluate it using NOT_NULL, the * result is a Boolean true. This result is because * the attribute "a" exists; its data type is not * relevant to the NOT_NULL comparison operator. *

    *
    • *
  • *

    * NULL : The attribute does not exist. * NULL is supported for all data types, including * lists and maps. *

    * *

    * This operator tests for the nonexistence of an attribute, not * its data type. If the data type of attribute "a" * is null, and you evaluate it using NULL, the * result is a Boolean false. This is because the * attribute "a" exists; its data type is not * relevant to the NULL comparison operator. *

    *
    • *
  • *

    * CONTAINS : Checks for a subsequence, or value in * a set. *

    *

    * AttributeValueList can contain only one * AttributeValue element of type String, Number, or * Binary (not a set type). If the target attribute of the * comparison is of type String, then the operator checks for a * substring match. If the target attribute of the comparison is * of type Binary, then the operator 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 operator evaluates to true * if it finds an exact match with any member of the set. *

    *

    * CONTAINS is supported for lists: When evaluating " * a CONTAINS b", "a * " can be a list; however, "b" cannot be a set, a * map, or a list. *

    *
    • *
  • *

    * NOT_CONTAINS : Checks for absence of a * subsequence, or absence of a value in a set. *

    *

    * AttributeValueList can contain only one * AttributeValue element of type String, Number, or * Binary (not a set type). If the target attribute of the * comparison is a String, then the operator checks for the * absence of a substring match. If the target attribute of the * comparison is Binary, then the operator 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 operator * evaluates to true if it does not find an exact match * with any member of the set. *

    *

    * NOT_CONTAINS is supported for lists: When evaluating " * a NOT CONTAINS b", "a * " can be a list; however, "b" cannot be a set, a * map, or a list. *

    *
    • *
  • *

    * BEGINS_WITH : Checks for a prefix. *

    *

    * AttributeValueList can contain only one * AttributeValue of type String or Binary (not a * Number or a set type). The target attribute of the comparison * must be of type String or Binary (not a Number or a set type). *

    *

    • *
  • *

    * IN : Checks for matching elements in a list. *

    *

    * AttributeValueList can contain one or more * AttributeValue elements of type String, Number, * or Binary. These attributes are compared against an existing * attribute of an item. If any elements of the input are equal * to the item attribute, the expression evaluates to true. *

    *
    • *
  • *

    * 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 type). 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 element of * a different type than the one provided 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"]} *

    *
    • *
*

* For usage examples of AttributeValueList and * ComparisonOperator, see Legacy Conditional Parameters in the Amazon DynamoDB * Developer Guide. *

* @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. *

*

* 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. EQ is supported for all data types, * including lists and maps. *

    *

    * AttributeValueList can contain only one * AttributeValue element of type String, Number, Binary, * String Set, Number Set, or Binary Set. If an item contains an * AttributeValue element of a different type than the one * provided 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. NE is supported for all data * types, including lists and maps. *

    *

    * 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 provided 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 element of type String, Number, or Binary * (not a set type). If an item contains an AttributeValue * element of a different type than the one provided 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 * type). If an item contains an AttributeValue element of a * different type than the one provided 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 element of type String, Number, or Binary * (not a set type). If an item contains an AttributeValue * element of a different type than the one provided 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 element of type String, Number, or Binary * (not a set type). If an item contains an AttributeValue * element of a different type than the one provided 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. NOT_NULL is * supported for all data types, including lists and maps. *

    * *

    * This operator tests for the existence of an attribute, not its data type. * If the data type of attribute "a" is null, and you evaluate * it using NOT_NULL, the result is a Boolean true * . This result is because the attribute "a" exists; its data * type is not relevant to the NOT_NULL comparison operator. *

    *
    • *
  • *

    * NULL : The attribute does not exist. NULL is * supported for all data types, including lists and maps. *

    * *

    * This operator tests for the nonexistence of an attribute, not its data * type. If the data type of attribute "a" is null, and you * evaluate it using NULL, the result is a Boolean * false. This is because the attribute "a" * exists; its data type is not relevant to the NULL comparison * operator. *

    *
    • *
  • *

    * CONTAINS : Checks for a subsequence, or value in a set. *

    *

    * AttributeValueList can contain only one * AttributeValue element of type String, Number, or Binary * (not a set type). If the target attribute of the comparison is of type * String, then the operator checks for a substring match. If the target * attribute of the comparison is of type Binary, then the operator 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 operator evaluates to true if it finds * an exact match with any member of the set. *

    *

    * CONTAINS is supported for lists: When evaluating " * a CONTAINS b", "a" can be a list; however, " * b" cannot be a set, a map, or a list. *

    *
    • *
  • *

    * NOT_CONTAINS : Checks for absence of a subsequence, or * absence of a value in a set. *

    *

    * AttributeValueList can contain only one * AttributeValue element of type String, Number, or Binary * (not a set type). If the target attribute of the comparison is a String, * then the operator checks for the absence of a substring match. If the * target attribute of the comparison is Binary, then the operator 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 operator evaluates to * true if it does not find an exact match with any member of the * set. *

    *

    * NOT_CONTAINS is supported for lists: When evaluating " * a NOT CONTAINS b", "a * " can be a list; however, "b" cannot be a set, a map, or a * list. *

    *
    • *
  • *

    * BEGINS_WITH : Checks for a prefix. *

    *

    * AttributeValueList can contain only one * AttributeValue of type String or Binary (not a Number or a * set type). The target attribute of the comparison must be of type String * or Binary (not a Number or a set type). *

    *

    • *
  • *

    * IN : Checks for matching elements in a list. *

    *

    * AttributeValueList can contain one or more * AttributeValue elements of type String, Number, or Binary. * These attributes are compared against an existing attribute of an item. * If any elements of the input are equal to the item attribute, the * expression evaluates to true. *

    *
    • *
  • *

    * 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 type). 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 element of a different type than the one * provided 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"]} *

    *
    • *
*

* For usage examples of AttributeValueList and * ComparisonOperator, see Legacy Conditional Parameters in the Amazon DynamoDB Developer * Guide. *

*

* 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. *

*

* 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. EQ is supported for all * data types, including lists and maps. *

    *

    * AttributeValueList can contain only one * AttributeValue element of type String, Number, * Binary, String Set, Number Set, or Binary Set. If an item * contains an AttributeValue element of a different * type than the one provided 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. NE is supported for * all data types, including lists and maps. *

    *

    * 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 * provided 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 element of type String, Number, or * Binary (not a set type). If an item contains an * AttributeValue element of a different type than * the one provided 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 type). If an item contains an * AttributeValue element of a different type than * the one provided 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 element of type String, Number, or * Binary (not a set type). If an item contains an * AttributeValue element of a different type than * the one provided 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 element of type String, Number, or * Binary (not a set type). If an item contains an * AttributeValue element of a different type than * the one provided 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. * NOT_NULL is supported for all data types, * including lists and maps. *

    * *

    * This operator tests for the existence of an attribute, not its * data type. If the data type of attribute "a" is * null, and you evaluate it using NOT_NULL, the * result is a Boolean true. This result is because * the attribute "a" exists; its data type is not * relevant to the NOT_NULL comparison operator. *

    *
    • *
  • *

    * NULL : The attribute does not exist. * NULL is supported for all data types, including * lists and maps. *

    * *

    * This operator tests for the nonexistence of an attribute, not * its data type. If the data type of attribute "a" * is null, and you evaluate it using NULL, the * result is a Boolean false. This is because the * attribute "a" exists; its data type is not * relevant to the NULL comparison operator. *

    *
    • *
  • *

    * CONTAINS : Checks for a subsequence, or value in * a set. *

    *

    * AttributeValueList can contain only one * AttributeValue element of type String, Number, or * Binary (not a set type). If the target attribute of the * comparison is of type String, then the operator checks for a * substring match. If the target attribute of the comparison is * of type Binary, then the operator 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 operator evaluates to true * if it finds an exact match with any member of the set. *

    *

    * CONTAINS is supported for lists: When evaluating " * a CONTAINS b", "a * " can be a list; however, "b" cannot be a set, a * map, or a list. *

    *
    • *
  • *

    * NOT_CONTAINS : Checks for absence of a * subsequence, or absence of a value in a set. *

    *

    * AttributeValueList can contain only one * AttributeValue element of type String, Number, or * Binary (not a set type). If the target attribute of the * comparison is a String, then the operator checks for the * absence of a substring match. If the target attribute of the * comparison is Binary, then the operator 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 operator * evaluates to true if it does not find an exact match * with any member of the set. *

    *

    * NOT_CONTAINS is supported for lists: When evaluating " * a NOT CONTAINS b", "a * " can be a list; however, "b" cannot be a set, a * map, or a list. *

    *
    • *
  • *

    * BEGINS_WITH : Checks for a prefix. *

    *

    * AttributeValueList can contain only one * AttributeValue of type String or Binary (not a * Number or a set type). The target attribute of the comparison * must be of type String or Binary (not a Number or a set type). *

    *

    • *
  • *

    * IN : Checks for matching elements in a list. *

    *

    * AttributeValueList can contain one or more * AttributeValue elements of type String, Number, * or Binary. These attributes are compared against an existing * attribute of an item. If any elements of the input are equal * to the item attribute, the expression evaluates to true. *

    *
    • *
  • *

    * 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 type). 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 element of * a different type than the one provided 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"]} *

    *
    • *
*

* For usage examples of AttributeValueList and * ComparisonOperator, see Legacy Conditional Parameters in the Amazon DynamoDB * Developer Guide. *

* @see ComparisonOperator */ public void setComparisonOperator(ComparisonOperator comparisonOperator) { this.comparisonOperator = comparisonOperator.toString(); } /** *

* A comparator for evaluating attributes. 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. EQ is supported for all data types, * including lists and maps. *

    *

    * AttributeValueList can contain only one * AttributeValue element of type String, Number, Binary, * String Set, Number Set, or Binary Set. If an item contains an * AttributeValue element of a different type than the one * provided 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. NE is supported for all data * types, including lists and maps. *

    *

    * 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 provided 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 element of type String, Number, or Binary * (not a set type). If an item contains an AttributeValue * element of a different type than the one provided 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 * type). If an item contains an AttributeValue element of a * different type than the one provided 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 element of type String, Number, or Binary * (not a set type). If an item contains an AttributeValue * element of a different type than the one provided 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 element of type String, Number, or Binary * (not a set type). If an item contains an AttributeValue * element of a different type than the one provided 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. NOT_NULL is * supported for all data types, including lists and maps. *

    * *

    * This operator tests for the existence of an attribute, not its data type. * If the data type of attribute "a" is null, and you evaluate * it using NOT_NULL, the result is a Boolean true * . This result is because the attribute "a" exists; its data * type is not relevant to the NOT_NULL comparison operator. *

    *
    • *
  • *

    * NULL : The attribute does not exist. NULL is * supported for all data types, including lists and maps. *

    * *

    * This operator tests for the nonexistence of an attribute, not its data * type. If the data type of attribute "a" is null, and you * evaluate it using NULL, the result is a Boolean * false. This is because the attribute "a" * exists; its data type is not relevant to the NULL comparison * operator. *

    *
    • *
  • *

    * CONTAINS : Checks for a subsequence, or value in a set. *

    *

    * AttributeValueList can contain only one * AttributeValue element of type String, Number, or Binary * (not a set type). If the target attribute of the comparison is of type * String, then the operator checks for a substring match. If the target * attribute of the comparison is of type Binary, then the operator 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 operator evaluates to true if it finds * an exact match with any member of the set. *

    *

    * CONTAINS is supported for lists: When evaluating " * a CONTAINS b", "a" can be a list; however, " * b" cannot be a set, a map, or a list. *

    *
    • *
  • *

    * NOT_CONTAINS : Checks for absence of a subsequence, or * absence of a value in a set. *

    *

    * AttributeValueList can contain only one * AttributeValue element of type String, Number, or Binary * (not a set type). If the target attribute of the comparison is a String, * then the operator checks for the absence of a substring match. If the * target attribute of the comparison is Binary, then the operator 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 operator evaluates to * true if it does not find an exact match with any member of the * set. *

    *

    * NOT_CONTAINS is supported for lists: When evaluating " * a NOT CONTAINS b", "a * " can be a list; however, "b" cannot be a set, a map, or a * list. *

    *
    • *
  • *

    * BEGINS_WITH : Checks for a prefix. *

    *

    * AttributeValueList can contain only one * AttributeValue of type String or Binary (not a Number or a * set type). The target attribute of the comparison must be of type String * or Binary (not a Number or a set type). *

    *

    • *
  • *

    * IN : Checks for matching elements in a list. *

    *

    * AttributeValueList can contain one or more * AttributeValue elements of type String, Number, or Binary. * These attributes are compared against an existing attribute of an item. * If any elements of the input are equal to the item attribute, the * expression evaluates to true. *

    *
    • *
  • *

    * 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 type). 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 element of a different type than the one * provided 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"]} *

    *
    • *
*

* For usage examples of AttributeValueList and * ComparisonOperator, see Legacy Conditional Parameters in the Amazon DynamoDB Developer * Guide. *

*

* 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. *

*

* 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. EQ is supported for all * data types, including lists and maps. *

    *

    * AttributeValueList can contain only one * AttributeValue element of type String, Number, * Binary, String Set, Number Set, or Binary Set. If an item * contains an AttributeValue element of a different * type than the one provided 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. NE is supported for * all data types, including lists and maps. *

    *

    * 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 * provided 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 element of type String, Number, or * Binary (not a set type). If an item contains an * AttributeValue element of a different type than * the one provided 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 type). If an item contains an * AttributeValue element of a different type than * the one provided 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 element of type String, Number, or * Binary (not a set type). If an item contains an * AttributeValue element of a different type than * the one provided 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 element of type String, Number, or * Binary (not a set type). If an item contains an * AttributeValue element of a different type than * the one provided 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. * NOT_NULL is supported for all data types, * including lists and maps. *

    * *

    * This operator tests for the existence of an attribute, not its * data type. If the data type of attribute "a" is * null, and you evaluate it using NOT_NULL, the * result is a Boolean true. This result is because * the attribute "a" exists; its data type is not * relevant to the NOT_NULL comparison operator. *

    *
    • *
  • *

    * NULL : The attribute does not exist. * NULL is supported for all data types, including * lists and maps. *

    * *

    * This operator tests for the nonexistence of an attribute, not * its data type. If the data type of attribute "a" * is null, and you evaluate it using NULL, the * result is a Boolean false. This is because the * attribute "a" exists; its data type is not * relevant to the NULL comparison operator. *

    *
    • *
  • *

    * CONTAINS : Checks for a subsequence, or value in * a set. *

    *

    * AttributeValueList can contain only one * AttributeValue element of type String, Number, or * Binary (not a set type). If the target attribute of the * comparison is of type String, then the operator checks for a * substring match. If the target attribute of the comparison is * of type Binary, then the operator 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 operator evaluates to true * if it finds an exact match with any member of the set. *

    *

    * CONTAINS is supported for lists: When evaluating " * a CONTAINS b", "a * " can be a list; however, "b" cannot be a set, a * map, or a list. *

    *
    • *
  • *

    * NOT_CONTAINS : Checks for absence of a * subsequence, or absence of a value in a set. *

    *

    * AttributeValueList can contain only one * AttributeValue element of type String, Number, or * Binary (not a set type). If the target attribute of the * comparison is a String, then the operator checks for the * absence of a substring match. If the target attribute of the * comparison is Binary, then the operator 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 operator * evaluates to true if it does not find an exact match * with any member of the set. *

    *

    * NOT_CONTAINS is supported for lists: When evaluating " * a NOT CONTAINS b", "a * " can be a list; however, "b" cannot be a set, a * map, or a list. *

    *
    • *
  • *

    * BEGINS_WITH : Checks for a prefix. *

    *

    * AttributeValueList can contain only one * AttributeValue of type String or Binary (not a * Number or a set type). The target attribute of the comparison * must be of type String or Binary (not a Number or a set type). *

    *

    • *
  • *

    * IN : Checks for matching elements in a list. *

    *

    * AttributeValueList can contain one or more * AttributeValue elements of type String, Number, * or Binary. These attributes are compared against an existing * attribute of an item. If any elements of the input are equal * to the item attribute, the expression evaluates to true. *

    *
    • *
  • *

    * 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 type). 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 element of * a different type than the one provided 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"]} *

    *
    • *
*

* For usage examples of AttributeValueList and * ComparisonOperator, see Legacy Conditional Parameters in the Amazon DynamoDB * Developer Guide. *

* @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; } }