Ebean @WhenCreated注解详解及示例

import io.ebean.annotation.WhenCreated;

@WhenCreated
private Instant createdAt;

这段代码是Java语言中的一部分，使用了Ebean ORM（Object-Relational Mapping，对象关系映射）框架的注解来自动管理数据库实体的创建时间。

### 代码解释：

1. `import io.ebean.annotation.WhenCreated;`：这一行代码是导入Ebean ORM框架中的`WhenCreated`注解。这个注解用于标记实体类中的某个字段，以便在实体被创建时自动设置该字段的值。

2. `@WhenCreated`：这是一个注解，它被放置在实体类的字段声明之前。当实体被创建并保存到数据库时，Ebean会自动将当前的时间戳赋值给被此注解标记的字段。

3. `private Instant createdAt;`：这是实体类中的一个私有字段，类型为`Instant`。`Instant`是Java 8引入的一个类，用于表示一个时间点，通常用于表示日期和时间，但不包含时区信息。这个字段被`@WhenCreated`注解标记，意味着每当这个实体被创建时，`createdAt`字段会自动被设置为创建那一刻的时间。

### 举例说明：

假设你有一个用户实体类`User`，你想在用户注册时自动记录注册时间。你可以这样定义这个类：

import io.ebean.annotation.WhenCreated;
import java.time.Instant;

public class User {
    private Long id;
    private String username;
    private String email;

    @WhenCreated
    private Instant createdAt;

    // 省略构造函数、getter和setter方法

    public Long getId() {
        return id;
    }

    public void setId(Long id) {
        this.id = id;
    }

    public String getUsername() {
        return username;
    }

    public void setUsername(String username) {
        this.username = username;
    }

    public String getEmail() {
        return email;
    }

    public void setEmail(String email) {
        this.email = email;
    }

    public Instant getCreatedAt() {
        return createdAt;
    }

    public void setCreatedAt(Instant createdAt) {
        this.createdAt = createdAt;
    }
}

在这个例子中，每当你创建一个新的`User`对象并通过Ebean保存到数据库时，`createdAt`字段会自动被设置为当前的时间戳。这样，你就可以在数据库中查询到每个用户的注册时间。

User newUser = new User();
newUser.setUsername("johndoe");
newUser.setEmail("johndoe@example.com");
// 保存用户到数据库，createdAt将自动设置
newUser.save();

在这个过程中，你不需要手动设置`createdAt`字段，Ebean会在后台为你处理这一切。