Cursor Iterator

A cursor iterator implements for batch build cursor data

License

License

The Artistic License 2.0
Categories

Categories

Ant Build Tools
GroupId

GroupId

com.github.phantomthief
ArtifactId

ArtifactId

cursor-iterator
Last Version

Last Version

1.0.13
Release Date

Release Date

Type

Type

jar
Description

Description

Cursor Iterator
A cursor iterator implements for batch build cursor data
Project URL

Project URL

https://github.com/PhantomThief/cursor-iterator
Source Code Management

Source Code Management

https://github.com/PhantomThief/cursor-iterator.git

Download cursor-iterator

How to add to project

<!-- https://jarcasting.com/artifacts/com.github.phantomthief/cursor-iterator/ -->
<dependency>
    <groupId>com.github.phantomthief</groupId>
    <artifactId>cursor-iterator</artifactId>
    <version>1.0.13</version>
</dependency>
// https://jarcasting.com/artifacts/com.github.phantomthief/cursor-iterator/
implementation 'com.github.phantomthief:cursor-iterator:1.0.13'
// https://jarcasting.com/artifacts/com.github.phantomthief/cursor-iterator/
implementation ("com.github.phantomthief:cursor-iterator:1.0.13")
'com.github.phantomthief:cursor-iterator:jar:1.0.13'
<dependency org="com.github.phantomthief" name="cursor-iterator" rev="1.0.13">
  <artifact name="cursor-iterator" type="jar" />
</dependency>
@Grapes(
@Grab(group='com.github.phantomthief', module='cursor-iterator', version='1.0.13')
)
libraryDependencies += "com.github.phantomthief" % "cursor-iterator" % "1.0.13"
[com.github.phantomthief/cursor-iterator "1.0.13"]

Dependencies

compile (2)

Group / Artifact Type Version
com.google.guava : guava jar 28.1-jre
com.google.code.findbugs : jsr305 Optional jar 1.3.9

test (3)

Group / Artifact Type Version
org.junit.jupiter : junit-jupiter-api jar
org.junit.jupiter : junit-jupiter-engine jar
ch.qos.logback : logback-classic jar 1.1.8

Project Modules

There are no modules declared in this project.

Cursor Iterator

Build Status Coverage Status Total alerts Language grade: Java Maven Central

一个简单的适合移动端无限下拉构建数据的后端支持组件

使用方法

public class UserDAO {

    private static final int MAX_USER_ID = 938;

    // A fake DAO for test
    public static List<User> getUsersAscById(Integer startId, int limit) {
        if (startId == null) {
            startId = 0;
        }
        List<User> result = IntStream.range(startId, Math.min(startId + limit, MAX_USER_ID))
                .mapToObj(User::new)
                .collect(Collectors.toList());
        System.out.println("get users asc by id, startId:" + startId + ", limit:" + limit
                + ", result:" + result);
        return result;
    }
}

// 声明
CursorIterator<Integer, User> users = CursorIterator.newGenericBuilder()
        .start(startId)
        .cursorExtractor(User::getId)
        .bufferSize(countPerFetch)
        .buildEx(UserDAO::getUsersAscById);

// jdk1.8 Stream方式
List<User> collect = users.stream()
		.filter(user -> user.getId() % 11 == 0)
		.limit(5)
        .collect(Collectors.toList());
        
// 传统迭代器模式
List<User> finalResult = new ArrayList<>();
for (User user : users) {
    if (user.getId() % 11 == 0) { // filter
        System.out.println("add to final result:" + user);
        finalResult.add(user);
    } else {
        System.out.println("ignore add user:" + user);
    }
    if (finalResult.size() == 50) {
        break;
    }
}

注意事项

  • GetByCursorDAO返回的元素不能有null,因为如果结尾的元素是null,CursorIterator将无法根据null计算下一次迭代滑动窗口时的起始位置

Versions

Version
1.0.13
1.0.12
1.0.11
1.0.10
1.0.9
1.0.8
1.0.7
1.0.5
1.0.4
1.0.3
1.0.2
1.0.1
1.0.0