Module org.apache.sis.cloud.aws
Package org.apache.sis.cloud.aws.s3
package org.apache.sis.cloud.aws.s3
Java NIO wrappers for Amazon Simple Storage Service (S3).
The wrapped framework is AWS SDK version 2.
URL syntax
The file system in this package accepts URIs of the following forms:
S3://bucket/key
S3://accessKey@bucket/key
(password not allowed)
Keys can be paths with components separated by the '/'
separator.
The password and the region can be specified at
file system initialization time.
The endpoint (e.g. "s3.eu-central-1.amazonaws.com"
) shall not be specified in the URI.
In particular the region ("eu-central-1"
in above example) can depend on the server location
instead of the data to access, and can be a global configuration for the server.
After a Path
instance has been created,
the following syntax can be used on Path
methods expecting a String
argument.
The key
can be a path with '/'
separators.
"S3://bucket/key"
(note that"accessKey@bucket"
is not accepted)"/bucket/key"
(absolute path)"key"
(relative path)
Thread safety
All classes provided by this package are safe of usage in multi-threading environment.- Since:
- 1.2
- See Also:
-
ClassDescriptionA provider of file system services as wrappers around Amazon Simple Storage Service (AWS S3).