June 13, 2024 | Fern Documentation

0.10.1

(feat): 添加对游标和偏移分页的支持。

新功能

添加对游标和偏移分页的支持。

例如，考虑以下 /users 端点：

1 types:
2   User:
3     properties:
4       name: string
5 
6   ListUserResponse:
7     properties:
8       next: optional<string>
9       data: list<User>
10 
11 service:
12   auth: false
13   base-path: /users
14   endpoints:
15     list:
16       path: ""
17       method: GET
18       pagination:
19         cursor: $request.starting_after
20         next_cursor: $response.next
21         results: $response.data
22       request:
23         name: ListUsersRequest
24         query-parameters:
25           starting_after: optional<string>
26       response: ListUsersResponse

生成的 SyncPagingIterable<User> 可用于遍历 User 对象：

1 for (User user : client.users.list(...)) {
2     System.out.println(user);
3 }

或流式处理：

1 client.users.list(...).streamItems().map(user -> ...);

或静态调用 nextPage() 手动执行分页：

1 SyncPagingIterable<User> pager = client.users.list(...);
2 // 第一页
3 System.out.println(pager.getItems());
4 // 第二页
5 pager = pager.nextPage();
6 System.out.println(pager.getItems());