net.quasardb.qdb.ts.Reader Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of jni Show documentation
API for the JNI components of the QuasarDB API for Java. Should not be included directly.
There is a newer version: 3.14.1
package net.quasardb.qdb.ts;

import java.io.IOException;
import java.lang.AutoCloseable;
import java.sql.Timestamp;
import java.time.LocalDateTime;

import java.nio.channels.SeekableByteChannel;
import java.util.Spliterator;
import java.util.*;
import java.util.stream.*;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import net.quasardb.qdb.exception.InvalidArgumentException;
import net.quasardb.qdb.exception.InvalidIteratorException;

import net.quasardb.qdb.*;
import net.quasardb.qdb.jni.*;

/**
 * High-performance bulk reader for a QuasarDB timeseries table. This class follows the
 * general Iterator pattern, and allows you to scan entire timeseries tables in bulk.
 */
public class Reader implements AutoCloseable, Iterator {
    private static final Logger logger = LoggerFactory.getLogger(Reader.class);
    Session session;
    Table table;
    long localTable;
    WritableRow next;

    protected Reader(Session session, Table table, TimeRange[] ranges) {
        logger.info("Initializing bulk reader for table {}", table.name);
        if (ranges.length <= 0) {
            throw new InvalidArgumentException("Reader requires at least one TimeRange to read");
        }

        this.session = session;
        this.table = table;
        this.next = null;

        this.localTable = qdb.ts_local_table_init(this.session.handle(),
                                                  table.getName(),
                                                  table.getColumns());
        assert (this.localTable > 0);

        qdb.ts_table_get_ranges(this.session.handle(), this.localTable, ranges);
    }

    /**
     * @return The underlying table that is being written to.
     */
    public Table getTable() {
        return this.table;
    }

    /**
     * Cleans up the internal representation of the local table.
     */
    @Override
    protected void finalize() throws Throwable {
        try {
            this.close();
        } finally {
            super.finalize();
        }
    }

    /**
     * Reads the next row from local table. Transparently updates the local
     * reference to the internal row.
     */
    private void readNext() {
        this.next = qdb.ts_table_next_row(this.session.handle(),
                                          this.localTable,
                                          this.table.getColumns());
    }

    /**
     * Reads the next row from local table when appropriate.
     */
    private void maybeReadNext() {
        if (this.next == null) {
            this.readNext();
        }
    }

    /**
     * Closes the timeseries table and local cache so that memory can be reclaimed.
     */
    public void close() throws IOException {
        qdb.ts_local_table_release(this.session.handle(), this.localTable);
        this.localTable = 0;
        this.next = null;
    }

    /**
     * Check whether there is another row available for reading or not. When this
     * function returns true, it is safe to call {@link #next}.
     *
     * @return Returns true when another row is available for reading.
     */
    @Override
    public boolean hasNext() {
        this.maybeReadNext();

        return this.next != null;
    }

    /**
     * Modifies internal state to move forward to the next row. Make sure to check
     * whether it is safe to read the next row using {@link #hasNext}.
     *
     * @throws InvalidIteratorException Thrown when the iterator has reached the end
     *                                  and no next row is available.
     * @return The next row.
     */
    @Override
    public WritableRow next() throws InvalidIteratorException {
        this.maybeReadNext();

        if (this.hasNext() == false) {
            throw new InvalidIteratorException("Attempted to read next but has no next rows");
        }

        WritableRow ret = this.next;
        this.next = null;
        return ret;
    }

    /**
     * Provides stream-based access.
     */
    public Stream stream() {
        return StreamSupport.stream(
            Spliterators.spliteratorUnknownSize(this, Spliterator.IMMUTABLE), false);
    }
}