Verrouillage optimiste avec numéro de version

Le verrouillage optimiste est une politique visant à garantir que l'élément côté client que vous mettez à jour (ou supprimez) est identique à l'élément dans Amazon DynamoDB. Si vous utilisez cette stratégie, les écritures de votre base de données ne peuvent pas être remplacées par les écritures d'autres, et vice versa.

Avec le verrouillage optimiste, chaque élément possède un attribut qui agit comme un numéro de version. Si vous récupérez un élément à partir d'une table, l'application enregistre le numéro de version de cet élément. Vous pouvez mettre à jour l'élément, mais uniquement si le numéro de version sur le côté serveur n'a pas changé. Si les versions ne correspondent pas, cela signifie que quelqu'un d'autre a modifié cet élément avant vous. La tentative de mise à jour échoue car vous possédez une version obsolète de l'élément. Dans ce cas, réessayez en récupérant l'élément puis en essayant de le mettre à jour. Le verrouillage optimiste vous empêche de remplacer accidentellement les modifications effectuées par les autres. Il empêche également que vos modifications soient remplacées.

Bien que vous puissiez mettre en œuvre votre propre stratégie de verrouillage optimiste, AWS SDK for Java elle fournit l'@DynamoDBVersionAttributeannotation. Dans la classe de mappage pour votre table, vous indiquez une propriété pour stocker le numéro de version et vous la marquez à l'aide de cette annotation. Lorsque vous enregistrez un objet, l'élément correspondant dans la table DynamoDB aura un attribut qui stocke le numéro de version. Le DynamoDBMapper attribue un numéro de version lors de l'enregistrement initial de l'objet, et il augmente automatiquement le numéro de version chaque fois que vous mettez à jour l'élément. Vos demandes de mise à jour ou de suppression aboutissent uniquement si la version d'objet côté client correspond au numéro de version de l'élément correspondant dans la table DynamoDB.

ConditionalCheckFailedException est émis si :

Par exemple, le code Java suivant définit une classe CatalogItem qui possède plusieurs propriétés. La propriété Version est balisée avec l'annotation @DynamoDBVersionAttribute.

@DynamoDBTable(tableName="ProductCatalog")
public class CatalogItem {

    private Integer id;
    private String title;
    private String ISBN;
    private Set<String> bookAuthors;
    private String someProp;
    private Long version;

    @DynamoDBHashKey(attributeName="Id")
    public Integer getId() { return id; }
    public void setId(Integer Id) { this.id = Id; }

    @DynamoDBAttribute(attributeName="Title")
    public String getTitle() { return title; }
    public void setTitle(String title) { this.title = title; }

    @DynamoDBAttribute(attributeName="ISBN")
    public String getISBN() { return ISBN; }
    public void setISBN(String ISBN) { this.ISBN = ISBN;}

    @DynamoDBAttribute(attributeName = "Authors")
    public Set<String> getBookAuthors() { return bookAuthors; }
    public void setBookAuthors(Set<String> bookAuthors) { this.bookAuthors = bookAuthors; }

    @DynamoDBIgnore
    public String getSomeProp() { return someProp;}
    public void setSomeProp(String someProp) {this.someProp = someProp;}

    @DynamoDBVersionAttribute
    public Long getVersion() { return version; }
    public void setVersion(Long version) { this.version = version;}
}

Vous pouvez appliquer l'annotation @DynamoDBVersionAttribute aux types Nullable proposés par les classes de wrappers primitifs qui fournissent un type Nullable, par exemple Long et Integer.

Le verrouillage optimiste a l'impact suivant sur ces méthodes DynamoDBMapper :

Désactivation du verrouillage optimiste

Pour désactiver le verrouillage optimiste, vous pouvez changer la valeur d'énumération DynamoDBMapperConfig.SaveBehavior de UPDATE à CLOBBER. Vous pouvez le faire en créant une instance DynamoDBMapperConfig qui ignore la vérification de version et utilise cette instance pour toutes vos demandes. Pour plus d'informations sur les paramètres DynamoDBMapperConfig.SaveBehavior et autres paramètres facultatifs DynamoDBMapper, consultez Paramètres de configuration facultatifs pour D ynamoDBMapper .

Vous pouvez également définir le comportement de verrouillage pour une opération spécifique uniquement. Par exemple, l'extrait de Java suivant utilise le DynamoDBMapper pour enregistrer un élément de catalogue. Il spécifie DynamoDBMapperConfig.SaveBehavior en ajoutant le paramètre DynamoDBMapperConfig facultatif à la méthode save.

DynamoDBMapper mapper = new DynamoDBMapper(client);

// Load a catalog item.
CatalogItem item = mapper.load(CatalogItem.class, 101);
item.setTitle("This is a new title for the item");
...
// Save the item.
mapper.save(item,
    new DynamoDBMapperConfig(
        DynamoDBMapperConfig.SaveBehavior.CLOBBER));