如何无需遍历所有属性将包含嵌套集合的POJO对象插入DynamoDB？

我现在需要把MobileDevice类的实例插入DynamoDB，相关类定义如下：

public class MobileDevice { 
    private String name; 
    private String category; 
    private List<Sensor> allSensors; 
    // getters & setters 
}

public class Sensor { 
    private String sensorName; 
    private String sensorId; 
    private int millis; 
}

目前我是手动逐个指定属性来插入数据的，代码如下：

public void addDevice(MobileDevice device) { 
    devicesTable.putItem( 
        new Item() 
            .withPrimaryKey("Name", device.getName()) 
            .withString("Category", device.getCategory())
    ); 
}

这种方式不仅要逐个处理对象属性，像allSensors这种嵌套集合的处理更是繁琐。请问有没有不用遍历所有属性就能完成MobileDevice实例插入的方法？

解决方案：使用DynamoDBMapper自动映射实体类 #

当然有！AWS SDK提供的DynamoDBMapper就是专门解决这个问题的——它能自动将Java对象和DynamoDB条目做映射，完全不用你手动逐个处理属性，包括嵌套集合这种复杂类型也能轻松搞定。

第一步：给实体类添加DynamoDB注解 #

你需要给MobileDevice和Sensor类加上对应的注解，告诉DynamoDBMapper如何映射这些类：

import com.amazonaws.services.dynamodbv2.datamodeling.DynamoDBAttribute;
import com.amazonaws.services.dynamodbv2.datamodeling.DynamoDBHashKey;
import com.amazonaws.services.dynamodbv2.datamodeling.DynamoDBTable;
import com.amazonaws.services.dynamodbv2.datamodeling.DynamoDBDocument;

@DynamoDBTable(tableName = "YourDevicesTableName") // 替换成你的实际表名
public class MobileDevice { 
    private String name; 
    private String category; 
    private List<Sensor> allSensors; 

    @DynamoDBHashKey(attributeName = "Name") // 标记为主键属性
    public String getName() { return name; }
    public void setName(String name) { this.name = name; }

    @DynamoDBAttribute(attributeName = "Category")
    public String getCategory() { return category; }
    public void setCategory(String category) { this.category = category; }

    @DynamoDBAttribute(attributeName = "AllSensors")
    public List<Sensor> getAllSensors() { return allSensors; }
    public void setAllSensors(List<Sensor> allSensors) { this.allSensors = allSensors; }
}

@DynamoDBDocument // 标记这是一个嵌套文档类
public class Sensor { 
    private String sensorName; 
    private String sensorId; 
    private int millis; 

    @DynamoDBAttribute(attributeName = "SensorName")
    public String getSensorName() { return sensorName; }
    public void setSensorName(String sensorName) { this.sensorName = sensorName; }

    @DynamoDBAttribute(attributeName = "SensorId")
    public String getSensorId() { return sensorId; }
    public void setSensorId(String sensorId) { this.sensorId = sensorId; }

    @DynamoDBAttribute(attributeName = "Millis")
    public int getMillis() { return millis; }
    public void setMillis(int millis) { this.millis = millis; }
}

这里的关键注解说明：

• @DynamoDBTable：指定当前类对应的DynamoDB表名
• @DynamoDBHashKey：标记该属性为DynamoDB表的主键
• @DynamoDBAttribute：映射普通属性，如果Java属性名和DynamoDB字段名完全一致，attributeName参数可以省略
• @DynamoDBDocument：标记嵌套类，让Mapper识别为DynamoDB的嵌套文档类型

第二步：修改插入代码，使用DynamoDBMapper #

接下来只需要初始化DynamoDBMapper，然后调用save()方法就能完成插入，一行代码搞定所有属性：

import com.amazonaws.services.dynamodbv2.AmazonDynamoDB;
import com.amazonaws.services.dynamodbv2.datamodeling.DynamoDBMapper;

// 假设你已经初始化了AmazonDynamoDB客户端实例
private final AmazonDynamoDB dynamoDBClient;
private final DynamoDBMapper dynamoDBMapper;

// 在类的构造方法中初始化Mapper
public YourServiceClass(AmazonDynamoDB dynamoDBClient) {
    this.dynamoDBClient = dynamoDBClient;
    this.dynamoDBMapper = new DynamoDBMapper(dynamoDBClient);
}

public void addDevice(MobileDevice device) { 
    dynamoDBMapper.save(device); // 自动处理所有属性，包括嵌套的allSensors
}

额外补充 #

• DynamoDBMapper不止支持插入，查询、更新、删除等操作也都可以直接操作Java对象，非常便捷
• 对于List、Map这类集合类型，Mapper会自动转换为DynamoDB对应的集合类型，无需手动处理
• 如果有自定义类型需要映射，还可以通过实现DynamoDBTypeConverter接口来扩展映射逻辑

内容的提问来源于stack exchange，提问作者nicholas