All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.amazonaws.services.dynamodbv2.model.ExpectedAttributeValue Maven / Gradle / Ivy

The newest version!
/*
 * 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; } }





© 2015 - 2024 Weber Informatics LLC | Privacy Policy