com.upplication.s3fs.util

Class S3Utils

java.lang.Object

com.upplication.s3fs.util.S3Utils

public class S3Utils
extends Object

Utilities to work with Amazon S3 Objects.

Constructor Summary

Constructors

Constructor and Description
S3Utils()

Method Summary

Modifier and Type	Method and Description
S3BasicFileAttributes	getS3FileAttributes(S3Path s3Path) getS3FileAttributes for the s3Path
com.amazonaws.services.s3.model.S3ObjectSummary	getS3ObjectSummary(S3Path s3Path) Get the S3ObjectSummary that represent this Path or her first child if this path not exists
S3PosixFileAttributes	getS3PosixFileAttributes(S3Path s3Path) get the S3PosixFileAttributes for a S3Path
Set<PosixFilePermission>	toPosixFilePermission(com.amazonaws.services.s3.model.Permission permission) transform a com.amazonaws.services.s3.model.Permission to a java.nio.file.attribute.PosixFilePermission We use the follow rules: - transform only to the Owner permission, S3 doesnt have concepts like owner, group or other so we map only to owner.
Set<PosixFilePermission>	toPosixFilePermissions(List<com.amazonaws.services.s3.model.Grant> grants) transform com.amazonaws.services.s3.model.Grant to java.nio.file.attribute.PosixFilePermission
S3BasicFileAttributes	toS3FileAttributes(com.amazonaws.services.s3.model.S3ObjectSummary objectSummary, String key) transform S3ObjectSummary to S3FileAttributes

Methods inherited from class java.lang.Object

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

Constructor Detail

S3Utils

public S3Utils()

Method Detail

getS3ObjectSummary

public com.amazonaws.services.s3.model.S3ObjectSummary getS3ObjectSummary(S3Path s3Path)
                                                                   throws NoSuchFileException

Get the S3ObjectSummary that represent this Path or her first child if this path not exists

Parameters:

s3Path - S3Path

Returns:

S3ObjectSummary

Throws:

NoSuchFileException - if not found the path and any child

getS3FileAttributes

public S3BasicFileAttributes getS3FileAttributes(S3Path s3Path)
                                          throws NoSuchFileException

getS3FileAttributes for the s3Path

Parameters:

s3Path - S3Path mandatory not null

Returns:

S3FileAttributes never null

Throws:

NoSuchFileException

getS3PosixFileAttributes

public S3PosixFileAttributes getS3PosixFileAttributes(S3Path s3Path)
                                               throws NoSuchFileException

get the S3PosixFileAttributes for a S3Path

Parameters:

s3Path - Path mandatory not null

Returns:

S3PosixFileAttributes never null

Throws:

NoSuchFileException - if the Path doesnt exists

toPosixFilePermissions

public Set<PosixFilePermission> toPosixFilePermissions(List<com.amazonaws.services.s3.model.Grant> grants)

transform com.amazonaws.services.s3.model.Grant to java.nio.file.attribute.PosixFilePermission

Parameters:

grants - Set grants mandatory, must be not null

Returns:

Set PosixFilePermission never null

See Also:

toPosixFilePermission(Permission)

toPosixFilePermission

public Set<PosixFilePermission> toPosixFilePermission(com.amazonaws.services.s3.model.Permission permission)

transform a com.amazonaws.services.s3.model.Permission to a java.nio.file.attribute.PosixFilePermission We use the follow rules: - transform only to the Owner permission, S3 doesnt have concepts like owner, group or other so we map only to owner. - ACP is a special permission: WriteAcp are mapped to Owner execute permission and ReadAcp are mapped to owner read

Parameters:

permission - Permission to map, mandatory must be not null

Returns:

Set PosixFilePermission never null

toS3FileAttributes

public S3BasicFileAttributes toS3FileAttributes(com.amazonaws.services.s3.model.S3ObjectSummary objectSummary,
                                                String key)

transform S3ObjectSummary to S3FileAttributes

Parameters:

objectSummary - S3ObjectSummary mandatory not null, the real objectSummary with exactly the same key than the key param or the immediate descendant if it is a virtual directory

key - String the real key that can be exactly equal than the objectSummary or

Returns:

S3FileAttributes