Skip to content

jcabi/jcabi-s3

Repository files navigation

EO principles respected here Managed by Zerocracy DevOps By Rultor.com

mvn PDD status Maven Central Javadoc codecov

More details are here: s3.jcabi.com.

Also, read this blog post: Object-Oriented Java Adapter of Amazon S3 SDK.

It's an object layer on top of Amazon S3 SDK:

import com.jcabi.s3.Bucket;
import com.jcabi.s3.Ocket;
import com.jcabi.s3.Region;
import com.jcabi.s3.cached.CdRegion;
public class Main {
  public static void main(String[] args) {
    Region region = new CdRegion(
      new Region.Simple("key", "secret")
    );
    Bucket bucket = region.bucket("my.example.com");
    Ocket.Text ocket = new Ocket.Text(bucket.ocket("test.txt"));
    String content = ocket.read();
    ocket.write("hello, world!");
  }
}

It is highly recommended to use CdRegion to avoid multiple duplicate reads from the same S3 object.

How to contribute?

Fork the repository, make changes, submit a pull request. We promise to review your changes same day and apply to the master branch, if they look correct.

Please run Maven build before submitting a pull request:

$ mvn clean install -Pqulice