ByteInStream_URL.java

Go to the documentation of this file.

/**
 * Author: Sven Gothel <sgothel@jausoft.com>
 * Copyright (c) 2022-2023 Gothel Software e.K.
 *
 * Permission is hereby granted, free of charge, to any person obtaining
 * a copy of this software and associated documentation files (the
 * "Software"), to deal in the Software without restriction, including
 * without limitation the rights to use, copy, modify, merge, publish,
 * distribute, sublicense, and/or sell copies of the Software, and to
 * permit persons to whom the Software is furnished to do so, subject to
 * the following conditions:
 *
 * The above copyright notice and this permission notice shall be
 * included in all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
 * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
 * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
 * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 */
package org.jau.io;
 
import java.nio.ByteBuffer;
 
/**
 * Ringbuffer-Based byte input stream with a URL connection provisioned data feed.
 *
 * Instance uses the native C++ object `jau::io::ByteInStream_URL`.
 *
 * Standard implementation uses [curl](https://curl.se/),
 * hence all [*libcurl* network protocols](https://curl.se/docs/url-syntax.html) are supported,
 * jau::io::uri::supported_protocols().
 */
public final class ByteInStream_URL implements ByteInStream {
    private volatile long nativeInstance;
    /* pp */ long getNativeInstance() { return nativeInstance; }
 
    /**
     * Construct a ringbuffer backed Http byte input stream
     * @param url the URL of the data to read
     * @param timeout maximum duration in milliseconds to wait @ check_available() for next bytes, where zero waits infinitely
     */
    public ByteInStream_URL(final String url, final long timeoutMS) {
        try {
            nativeInstance = ctorImpl(url, timeoutMS);
        } catch (final Throwable t) {
            System.err.println("ByteInStream_URL.ctor: native ctor failed: "+t.getMessage());
            throw t;
        }
    }
    private native long ctorImpl(final String url, final long timeoutMS);
 
    @Override
    public native void closeStream();
 
    @Override
    public void close() {
        final long handle;
        synchronized( this ) {
            handle = nativeInstance;
            nativeInstance = 0;
        }
        if( 0 != handle ) {
            dtorImpl(handle);
        }
    }
    private static native void dtorImpl(final long nativeInstance);
 
    @Override
    public void finalize() {
        close();
    }
 
    @Override
    public native boolean is_open();
 
    @Override
    public void clear(final IOState state) {
        clearImpl( state.mask );
    }
    private native void clearImpl(int s);
 
    @Override
    public IOState rdState() {
        return new IOState( rdStateImpl() );
    }
    private native int rdStateImpl();
 
    @Override
    public void setState(final IOState state) {
        setStateImpl( state.mask );
    }
    private native void setStateImpl(int s);
 
    @Override
    public native boolean good();
 
    @Override
    public native boolean eof();
 
    @Override
    public native boolean fail();
 
    @Override
    public native boolean bad();
 
    @Override
    public native boolean timeout();
 
    @Override
    public native boolean available(final long n);
 
    @Override
    public native int read(final byte[] out, final int offset, final int length);
 
    @Override
    public int read(final ByteBuffer out) {
        if( !Buffers.isDirect(out) ) {
            throw new IllegalArgumentException("out buffer not direct");
        }
        final int res = read2Impl(out, (int)Buffers.getDirectBufferByteOffset(out));
        out.limit(out.position() + res);
        return res;
    }
    private native int read2Impl(Object out, int out_offset);
 
    @Override
    public native int peek(byte[] out, final int offset, final int length, final long peek_offset);
 
    @Override
    public native String id();
 
    @Override
    public native long discard_next(long N);
 
    @Override
    public native long tellg();
 
    @Override
    public native boolean has_content_size();
 
    @Override
    public native long content_size();
 
    @Override
    public native String toString();
}