使用 Restd

Restd 是RESTful Data API 的缩写,是 Leap 为简化数据 API 开发而提供的功能。

这一章节将快速演示如何使用 Restd 进行开发。

1. 启用 Restd

Global.java 类中修改一下代码:

    @Override
    protected void configure(WebConfigurator c) {
        apis.add("users", "/").enableRestd();
    }

加上 enableRestd() 的方法调用即可启用 Restd 功能。

2. 创建 Group 对象

src/main/java/hello/models 包中创建 Group.java 类:

package hello.models;

import leap.orm.annotation.Column;
import leap.orm.annotation.Id;
import leap.orm.annotation.Table;
import leap.orm.model.Model;

@Table(name = "groups", autoCreate = true)
public class Group extends Model {

    @Id(generator = "shortid")
    protected String id;

    @Column
    protected String name;

    public String getId() {
        return id;
    }

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

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }
}

autoCreate="true" 是 Leap ORM 模块的功能,如果表不存在将会自动创建。

完成这两步后,对 Group 模型对象的增删改查操作已经开发完成,和 User 一样:

Method Path Description
GET /group 查询所有群组
POST /group 创建新的群组
PATCH /group/{id} 更新某个群组
DELETE /group/{id} 删除某个群组
GET /group/{id} 查询某个群组

3. 运行测试

重新启动 Jetty:

**[terminal]
mvn jetty:run

浏览器访问 http://localhost:8080/group ,返回空的 JSON 数组:

[]

其他操作的测试和 User 一样,这里不再重复说明。

至此对于快速搭建 API 工程的介绍已经结束,如果希望对 Leap 有更进一步的了解,可以阅读后面的详细文档章节。

上一篇:运行测试 下一篇:工程配置

results matching ""

    No results matching ""