Package dev.zarr.zarrjava.v2

Class Array

java.lang.Object

dev.zarr.zarrjava.core.AbstractNode

dev.zarr.zarrjava.core.Array

dev.zarr.zarrjava.v2.Array

All Implemented Interfaces:

Node, Node

public class Array
extends Array
implements Node

Nested Class Summary

Nested classes/interfaces inherited from class dev.zarr.zarrjava.core.Array

Array.ArrayAccessor

Field Summary

Fields inherited from class dev.zarr.zarrjava.core.Array

codecPipeline

Fields inherited from class dev.zarr.zarrjava.core.AbstractNode

storeHandle

Fields inherited from interface dev.zarr.zarrjava.core.Node

ZARR_JSON, ZARRAY, ZGROUP

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	Array(StoreHandle storeHandle, ArrayMetadata arrayMetadata)

Method Summary

Modifier and Type	Method	Description
static Array	create(StoreHandle storeHandle, ArrayMetadata arrayMetadata)	Creates a new Zarr array with the provided metadata at a specified storage location.
static Array	create(StoreHandle storeHandle, ArrayMetadata arrayMetadata, boolean existsOk)	Creates a new Zarr array with the provided metadata at a specified storage location.
static Array	create(StoreHandle storeHandle, Function<ArrayMetadataBuilder,ArrayMetadataBuilder> arrayMetadataBuilderMapper, boolean existsOk)
static Array	create(String path, ArrayMetadata arrayMetadata)	Creates a new Zarr array with the provided metadata at a specified storage location.
static Array	create(Path path, ArrayMetadata arrayMetadata)	Creates a new Zarr array with the provided metadata at a specified storage location.
ArrayMetadata	metadata()
static ArrayMetadataBuilder	metadataBuilder()
static ArrayMetadataBuilder	metadataBuilder(ArrayMetadata existingMetadata)
static Array	open(StoreHandle storeHandle)	Opens an existing Zarr array at a specified storage location.
static Array	open(String path)	Opens an existing Zarr array at a specified storage location.
static Array	open(Path path)	Opens an existing Zarr array at a specified storage location.
String	toString()

Methods inherited from class dev.zarr.zarrjava.core.Array

access, read, read, read, read, readChunk, write, write, write, write, writeChunk

Methods inherited from class java.lang.Object

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

Constructor Details

Array

protected Array(StoreHandle storeHandle,
 ArrayMetadata arrayMetadata)
         throws IOException,
ZarrException

Throws:

IOException

ZarrException

Method Details

metadata

public ArrayMetadata metadata()

Specified by:

metadata in class Array

open

public static Array open(StoreHandle storeHandle)
                  throws IOException,
ZarrException

Opens an existing Zarr array at a specified storage location.

Parameters:

storeHandle - the storage location of the Zarr array

Throws:

IOException - throws IOException if the metadata cannot be read

ZarrException - throws ZarrException if the Zarr array cannot be opened

open

public static Array open(Path path)
                  throws IOException,
ZarrException

Opens an existing Zarr array at a specified storage location.

Parameters:

path - the storage location of the Zarr array

Throws:

IOException - throws IOException if the metadata cannot be read

ZarrException - throws ZarrException if the Zarr array cannot be opened

open

public static Array open(String path)
                  throws IOException,
ZarrException

Opens an existing Zarr array at a specified storage location.

Parameters:

path - the storage location of the Zarr array

Throws:

IOException - throws IOException if the metadata cannot be read

ZarrException - throws ZarrException if the Zarr array cannot be opened

create

public static Array create(Path path,
 ArrayMetadata arrayMetadata)
                    throws IOException,
ZarrException

Creates a new Zarr array with the provided metadata at a specified storage location. This method will raise an exception if a Zarr array already exists at the specified storage location.

Parameters:

path - the storage location of the Zarr array

arrayMetadata - the metadata of the Zarr array

Throws:

IOException - if the metadata cannot be serialized

ZarrException - if the Zarr array cannot be created

create

public static Array create(String path,
 ArrayMetadata arrayMetadata)
                    throws IOException,
ZarrException

Creates a new Zarr array with the provided metadata at a specified storage location. This method will raise an exception if a Zarr array already exists at the specified storage location.

Parameters:

path - the storage location of the Zarr array

arrayMetadata - the metadata of the Zarr array

Throws:

IOException - if the metadata cannot be serialized

ZarrException - if the Zarr array cannot be created

create

public static Array create(StoreHandle storeHandle,
 ArrayMetadata arrayMetadata)
                    throws IOException,
ZarrException

Creates a new Zarr array with the provided metadata at a specified storage location. This method will raise an exception if a Zarr array already exists at the specified storage location.

Parameters:

storeHandle - the storage location of the Zarr array

arrayMetadata - the metadata of the Zarr array

Throws:

IOException - if the metadata cannot be serialized

ZarrException - if the Zarr array cannot be created

create

public static Array create(StoreHandle storeHandle,
 ArrayMetadata arrayMetadata,
 boolean existsOk)
                    throws IOException,
ZarrException

Creates a new Zarr array with the provided metadata at a specified storage location. If `existsOk` is false, this method will raise an exception if a Zarr array already exists at the specified storage location.

Parameters:

storeHandle - the storage location of the Zarr array

arrayMetadata - the metadata of the Zarr array

existsOk - if true, no exception is raised if the Zarr array already exists

Throws:

IOException - throws IOException if the metadata cannot be serialized

ZarrException - throws ZarrException if the Zarr array cannot be created

create

public static Array create(StoreHandle storeHandle,
 Function<ArrayMetadataBuilder,ArrayMetadataBuilder> arrayMetadataBuilderMapper,
 boolean existsOk)
                    throws IOException,
ZarrException

Throws:

IOException

ZarrException

metadataBuilder

@Nonnull
public static ArrayMetadataBuilder metadataBuilder()

metadataBuilder

@Nonnull
public static ArrayMetadataBuilder metadataBuilder(ArrayMetadata existingMetadata)

toString

public String toString()

Overrides:

toString in class Object