El AWS SDK para móviles de Xamarin ahora está incluido en AWS SDK for .NET. Esta guía hace referencia a la versión archivada del SDK para móviles para Xamarin.

Uso del modelo de persistencia de objetos

AWS Mobile SDK para .NET y Xamarin proporciona un modelo de persistencia de objetos que le permite mapear las clases en el cliente a una tabla de DynamoDB. A continuación, cada instancia de objeto se mapea a un elemento de la tabla correspondiente. Para guardar los objetos de cliente en una tabla, el modelo de persistencia de objetos proporciona la clase DynamoDBContext, un punto de entrada a DynamoDB. Esta categoría le ofrece una conexión a DynamoDB y le permite obtener acceso a tablas, realizar diversas operaciones CRUD y ejecutar consultas.

El modelo de persistencia de objetos no proporciona una API para crear, actualizar o eliminar tablas. Solo ofrece operaciones de datos. Para crear, actualizar y eliminar las tablas, debe utilizar la API de bajo nivel. Para obtener instrucciones sobre cómo utilizar la API de bajo nivel, consulte Uso de las API de nivel de servicio de DynamoDB.

Información general

El modelo de persistencia de objetos proporciona un conjunto de atributos para mapear las clases de cliente a tablas, y propiedades/campos a atributos de tabla. El modelo de persistencia de objetos admite el mapeo explícito y predeterminado entre las propiedades de clase y los atributos de tabla.

No tiene que mapear cada propiedad de clase. Puede identificar estas propiedades agregando el atributo DynamoDBIgnore. Al guardar y recuperar una instancia de un objeto se podría omitir cualquier propiedad marcada con este atributo.

Tipos de datos admitidos

El modelo de persistencia de objetos admite un conjunto de tipos de datos, colecciones y tipos de datos arbitrarios de .NET primitivos. El modelo admite los siguientes tipos de datos primitivos.

El modelo de persistencia de objetos también admite los tipos de colecciones .NET con las limitaciones siguientes:

Para obtener más información sobre el modelo de persistencia de objetos, consulte Modelo de persistencia de objetos de .NET.

Creación de un cliente de DynamoDB

Para crear un cliente de DynamoDB:

var client = new AmazonDynamoDBClient(credentials,region);
DynamoDBContext context = new DynamoDBContext(client);

Operaciones de CRUD

Guardar un objeto

Crear un objeto:

[DynamoDBTable("Books")]
public class Book {
  [DynamoDBHashKey] // Hash key.
  public string Id {
    get;
    set;
  }

  [DynamoDBGlobalSecondaryIndexHashKey]
  public string Author {
    get;
    set;
  }

  [DynamoDBGlobalSecondaryIndexRangeKey]
  public string Title {
    get;
    set;
  }
  public string ISBN {
    get;
    set;
  }
  public int Price {
    get;
    set;
  }
  public string PageCount {
    get;
    set;
  }
}

Book myBook = new Book
{
    Id = id,
    Author = "Charles Dickens",
    Title = "Oliver Twist",
    ISBN = "111-1111111001",
    Price = 10,
    PageCount = 300
};

Guardar un objeto en una tabla de DynamoDB:

context.Save(myBook);

Recuperar un objeto

Para recuperar un objeto:

Book retrievedBook = context.Load<Book>(1);

Actualizar un objeto

Para actualizar un objeto:

Book retrievedBook = context.Load<Book>(1);
retrievedBook.ISBN = "111-1111111001";
context.Save(retrievedBook);

Eliminar un objeto

Para eliminar un objeto:

Book retrievedBook = context.Load<Book>(1);
context.Delete(retrievedBook);

Consulta y examen

Para consultar y recuperar todos los libros cuyo autor sea "Charles Dickens":

public async Task QueryAsync(AWSCredentials credentials, RegionEndpoint region) {
  var client = new AmazonDynamoDBClient(credentials, region);
  DynamoDBContext context = new DynamoDBContext(client);

  var search = context.FromQueryAsync < Book > (new Amazon.DynamoDBv2.DocumentModel.QueryOperationConfig() {
    IndexName = "Author-Title-index",
    Filter = new Amazon.DynamoDBv2.DocumentModel.QueryFilter("Author", Amazon.DynamoDBv2.DocumentModel.QueryOperator.Equal, "Charles Dickens")
  });

  Console.WriteLine("items retrieved");

  var searchResponse = await search.GetRemainingAsync();
  searchResponse.ForEach((s) = > {
    Console.WriteLine(s.ToString());
  });
}

El código de ejemplo de examen que se muestra a continuación devuelve todos los libros de la tabla:

public async Task ScanAsync(AWSCredentials credentials, RegionEndpoint region) {
  var client = new AmazonDynamoDBClient(credentials, region);
  DynamoDBContext context = new DynamoDBContext(client);

  var search = context.FromScanAsync < Book > (new Amazon.DynamoDBv2.DocumentModel.ScanOperationConfig() {
   ConsistentRead = true
  });

  Console.WriteLine("items retrieved");

  var searchResponse = await search.GetRemainingAsync();
  searchResponse.ForEach((s) = > {
   Console.WriteLine(s.ToString());
  });
}