jcabi-s3

Object Layer on top of AWS S3 SDK

License

License

BSD
GroupId

GroupId

com.jcabi
ArtifactId

ArtifactId

jcabi-s3
Last Version

Last Version

0.18
Release Date

Release Date

Type

Type

jar
Description

Description

jcabi-s3
Object Layer on top of AWS S3 SDK
Project Organization

Project Organization

jcabi.com
Source Code Management

Source Code Management

https://github.com/jcabi/jcabi-s3

Download jcabi-s3

How to add to project

<!-- https://jarcasting.com/artifacts/com.jcabi/jcabi-s3/ -->
<dependency>
    <groupId>com.jcabi</groupId>
    <artifactId>jcabi-s3</artifactId>
    <version>0.18</version>
</dependency>
// https://jarcasting.com/artifacts/com.jcabi/jcabi-s3/
implementation 'com.jcabi:jcabi-s3:0.18'
// https://jarcasting.com/artifacts/com.jcabi/jcabi-s3/
implementation ("com.jcabi:jcabi-s3:0.18")
'com.jcabi:jcabi-s3:jar:0.18'
<dependency org="com.jcabi" name="jcabi-s3" rev="0.18">
  <artifact name="jcabi-s3" type="jar" />
</dependency>
@Grapes(
@Grab(group='com.jcabi', module='jcabi-s3', version='0.18')
)
libraryDependencies += "com.jcabi" % "jcabi-s3" % "0.18"
[com.jcabi/jcabi-s3 "0.18"]

Dependencies

compile (7)

Group / Artifact Type Version
com.jcabi : jcabi-aspects jar 0.22.5
com.jcabi : jcabi-log jar 0.17.2
com.amazonaws : aws-java-sdk-core jar 1.11.211
com.amazonaws : aws-java-sdk-s3 jar 1.11.211
com.google.guava : guava jar 20.0
commons-io : commons-io jar 2.5
org.apache.commons : commons-lang3 jar 3.5

provided (1)

Group / Artifact Type Version
org.projectlombok : lombok jar 1.16.10

runtime (1)

Group / Artifact Type Version
org.aspectj : aspectjrt jar 1.8.9

test (1)

Group / Artifact Type Version
javax.validation : validation-api jar 1.1.0.Final

Project Modules

There are no modules declared in this project.

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

Build Status PDD status Maven Central Javadoc Dependencies Coverage Status

jpeek report

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.Region;
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.

Questions?

If you have any questions about the framework, or something doesn't work as expected, please submit an issue here. If you want to discuss, please use our Google Group.

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
com.jcabi

jcabi.com

Small java components

Versions

Version
0.18
0.17.1
0.17
0.16
0.15.1
0.15
0.14
0.13
0.12
0.11.5
0.11.4
0.11.3
0.11.2
0.11.1
0.11
0.10
0.9
0.8.2
0.8.1
0.8
0.7
0.6.1
0.6
0.5
0.4.1
0.4
0.3
0.2
0.1