Armazenar dados de campo de uma entidade

Os exemplos a seguir demonstram como armazenar (gravar no State Fabric) os dados de campo de uma entidade de propriedade do aplicativo. Esses exemplos usam a função a seguir:

AWS_WEAVERRUNTIME_API Result<void> StoreEntityField(
    Transaction& txn,
    const Entity& entity,
    TypeId keyTypeId,
    FieldIndex index,
    std::int8_t* src,
    std::size_t length) noexcept;

O parâmetro Api::TypeId keyTypeId representa o tipo de dados transmitidos.

O parâmetro Api::TypeId keyTypeId deve receber o correspondente Api::TypeId deApi::BuiltinTypeId. Se não houver uma conversão apropriada, você poderá usar Api::BuiltinTypeId::Dynamic.

Para tipos de dados complexos, use Api::BuiltInTypeId::Dynamic.

nota

O valor de FieldIndex index deve ser maior que 0. O valor 0 é reservado para a chave de índice (consulte StoreEntityIndexKey()).

exemplo Exemplo de uso de tipos de dados primitivos

namespace
{
    constexpr Api::FieldIndex k_isTrueFieldId { /* value */ 1 };
}

Result<void> SetEntityFields(
    Api::Entity& entity, 
    Transaction& transaction)
{
    bool value = true;
    
    auto* src = reinterpret_cast<std::int8_t*>(value);
    size_t length = sizeof(*value);
    
    WEAVERRUNTIME_TRY(Api::StoreEntityField(
        transaction,
        entity,
        Api::BuiltinTypeIdToTypeId(
            Aws::WeaverRuntime::Api::BuiltinTypeId::Bool),
        k_isTrueFieldId,
        src,
        length));
}

exemplo Exemplo de uso de um struct para armazenar os dados

namespace
{
    constexpr Api::FieldIndex k_dataFieldId { /* value */ 1 };
}

struct Data
{
    bool boolData;
    float floatData;
};

Result<void> SetEntityFields(
    Api::Entity& entity, 
    Transaction& transaction)
{
    Data data = { /* boolData */ false, /* floatData */ -25.93 };
    
    auto* src = reinterpret_cast<std::int8_t*>(data);
    size_t length = sizeof(*data);
    
    WEAVERRUNTIME_TRY(Api::StoreEntityField(
        transaction,
        entity,
        Api::BuiltinTypeIdToTypeId(
            Aws::WeaverRuntime::Api::BuiltinTypeId::Dynamic),
        k_dataFieldId,
        src,
        length));
}