ucar.unidata.io.s3

Class S3RandomAccessFile

java.lang.Object

ucar.unidata.io.RandomAccessFile

ucar.unidata.io.RemoteRandomAccessFile

ucar.unidata.io.s3.S3RandomAccessFile

All Implemented Interfaces:

java.io.Closeable, java.io.DataInput, java.io.DataOutput, java.lang.AutoCloseable, FileCacheable, ReadableRemoteFile

public final class S3RandomAccessFile
extends RemoteRandomAccessFile
implements ReadableRemoteFile, java.io.Closeable

Manage random access file level access to objects stored on AWS S3 compatible Object Stores. Extensions to RandomAccessFile and RemoteRandomAccessFile for objects stored on AWS S3 compatible Object Stores.

Since:

5.3.2

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	S3RandomAccessFile.Provider Hook into service provider interface to RandomAccessFileProvider.

Field Summary

Fields inherited from class ucar.unidata.io.RemoteRandomAccessFile

defaultMaxReadCacheSize, defaultRemoteFileBufferSize, defaultRemoteFileTimeout, url

Fields inherited from class ucar.unidata.io.RandomAccessFile

allFiles, BIG_ENDIAN, bigEndian, buffer, bufferModified, bufferStart, dataEnd, dataSize, debugAccess, debugLeaks, defaultBufferSize, endOfFile, file, fileChannel, filePosition, LITTLE_ENDIAN, location, openFiles, readonly, showOpen, showRead

Method Summary

Modifier and Type	Method and Description
void	closeRemote() Close any resources used to enable remote reading.
long	getLastModified() Returns the time that the underlying file(s) were last modified.
java.lang.String	getLocation() Get the file location, or name.
java.lang.String	getObjectName()
long	length() Get the length of the file.
int	readRemote(long pos, byte[] buff, int offset, int len) Read directly from the remote service All reading goes through here or readToByteChannel; 1.

Methods inherited from class ucar.unidata.io.RemoteRandomAccessFile

close, read_, readToByteChannel

Methods inherited from class ucar.unidata.io.RandomAccessFile

acquire, acquire, eject, enableDefaultGlobalFileCache, flush, getAllFiles, getBufferSize, getDebugLeaks, getDebugNbytes, getDebugNseeks, getFilePointer, getGlobalFileCache, getMaxOpenFileCount, getOpenFileCount, getOpenFiles, getRandomAccessFile, isAtEndOfFile, isDirectory, order, order, reacquire, read, read, read, readBoolean, readBuffer, readByte, readBytes, readBytes, readChar, readDouble, readDouble, readFloat, readFloat, readFully, readFully, readInt, readInt, readIntUnbuffered, readLine, readLine, readLong, readLong, readShort, readShort, readString, readString, readStringMax, readStringMax, readUnsignedByte, readUnsignedShort, readUTF, release, searchForward, seek, setBufferSize, setDebugAccess, setDebugLeaks, setExtendMode, setFileCache, setGlobalFileCache, setMinLength, shutdown, skipBytes, skipBytes, toString, unread, write, write, write, writeBoolean, writeBoolean, writeByte, writeBytes, writeBytes, writeBytes, writeChar, writeChar, writeChar, writeChar, writeChar, writeChar, writeChars, writeChars, writeChars, writeDouble, writeDouble, writeDouble, writeDouble, writeDouble, writeDouble, writeFloat, writeFloat, writeFloat, writeFloat, writeFloat, writeFloat, writeInt, writeInt, writeInt, writeInt, writeInt, writeInt, writeLong, writeLong, writeLong, writeLong, writeLong, writeLong, writeShort, writeShort, writeShort, writeShort, writeShort, writeShort, writeUTF

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.io.Closeable

close

Method Detail

closeRemote

public void closeRemote()

Description copied from interface: ReadableRemoteFile

Close any resources used to enable remote reading. For example, HTTPSession from httpservices, or S3Client from the AWS SDK

Specified by:

closeRemote in interface ReadableRemoteFile

readRemote

public int readRemote(long pos,
                      byte[] buff,
                      int offset,
                      int len)
               throws java.io.IOException

Read directly from the remote service All reading goes through here or readToByteChannel; 1. https://docs.aws.amazon.com/AmazonS3/latest/dev/RetrievingObjectUsingJava.html

Specified by:

readRemote in interface ReadableRemoteFile

Parameters:

pos - start here in the file

buff - put data into this buffer

offset - buffer offset

len - this number of bytes

Returns:

actual number of bytes read

Throws:

java.io.IOException - on io error

length

public long length()

Description copied from class: RandomAccessFile

Get the length of the file. The data in the buffer (which may not have been written the disk yet) is taken into account.

Overrides:

length in class RandomAccessFile

Returns:

the length of the file in bytes.

getLastModified

public long getLastModified()

Description copied from interface: FileCacheable

Returns the time that the underlying file(s) were last modified. If they've changed since they were stored in the cache, they will be closed and reopened with FileFactory.

Specified by:

getLastModified in interface FileCacheable

Overrides:

getLastModified in class RandomAccessFile

Returns:

a long value representing the time the file(s) were last modified or 0L if the last-modified time couldn't be determined for any reason.

getLocation

public java.lang.String getLocation()

Description copied from class: RandomAccessFile

Get the file location, or name.

Specified by:

getLocation in interface FileCacheable

Overrides:

getLocation in class RandomAccessFile

Returns:

file location

getObjectName

public java.lang.String getObjectName()