com.jcabi.dynamo

Interface Item

@Immutable
public interface Item

Immutable Amazon DynamoDB item.

The class is immutable, which means that every call to put(String,AttributeValue) or #put(Attributes) changes data in Amazon, but doesn't change the object. The object will contain dirty data right after PUT operation, and should not be used any more.

Version:

$Id$

Author:

Yegor Bugayenko (yegor@tpc2.com)

Method Summary

Methods

Modifier and Type	Method and Description
Frame	frame() Get back to the frame it is from.
com.amazonaws.services.dynamodbv2.model.AttributeValue	get(String name) Get one attribute, fetching directly from AWS (runtime exception if the attribute is absent, use has(String) first).
boolean	has(String name) Does this attribute exist?
void	put(Map<String,com.amazonaws.services.dynamodbv2.model.AttributeValue> attrs) Change all attributes in one call.
void	put(String name, com.amazonaws.services.dynamodbv2.model.AttributeValue value) Change one attribute, immediately saving it to AWS (all other attributes will be set to NULL, except primary keys).

Method Detail

get

@NotNull(message="attribute value is never NULL")
com.amazonaws.services.dynamodbv2.model.AttributeValue get(@NotNull(message="attribute name can\'t be NULL")
                                                                        String name)

Get one attribute, fetching directly from AWS (runtime exception if the attribute is absent, use has(String) first).

Parameters:

name - Attribute name

Returns:

Value

has

boolean has(@NotNull(message="attribute name can\'t be NULL")
          String name)

Does this attribute exist?

Parameters:

name - Attribute name

Returns:

TRUE if it exists

put

void put(@NotNull(message="attribute name can\'t be NULL")
       String name,
       @NotNull(message="value can\'t be NULL")
       com.amazonaws.services.dynamodbv2.model.AttributeValue value)

Change one attribute, immediately saving it to AWS (all other attributes will be set to NULL, except primary keys).

Data in memory will become out of sync right after a successful execution of the method.

Parameters:

name - Attribute name

value - Value to save

put

void put(@NotNull(message="map attributes can\'t be NULL")
       Map<String,com.amazonaws.services.dynamodbv2.model.AttributeValue> attrs)

Change all attributes in one call.

Data in memory will become out of sync right after a successful execution of the method.

Parameters:

attrs - Attributes

frame

@NotNull(message="frame is never NULL")
Frame frame()

Get back to the frame it is from.

Returns:

Frame