de.adorsys.datasafe.directory.api.profile.dfs

Interface BucketAccessService

public interface BucketAccessService

Service that performs final resource location resolution and credentials binding. Runs just before accessing underlying filesystem. May perform additional resource resolution and enriches resource location with credentials necessary to access underlying filesystem. For example it can act as gateway transforming dfs://user/path into s3://user-1-bucket/root/path Or it can add credentials transforming: s3://user-1-bucket/root/path into s3://username:password@user-1-bucket/root/path

Method Summary

Modifier and Type	Method and Description
AbsoluteLocation<PrivateResource>	privateAccessFor(UserIDAuth user, PrivateResource resource) Gets credentials to access specified private resource location and may perform additional path resolution.
AbsoluteLocation<PublicResource>	publicAccessFor(UserID user, PublicResource resource) Gets credentials to access specified public resource location and may perform additional path resolution.
AbsoluteLocation	withSystemAccess(AbsoluteLocation resource) Gets credentials to access specified private resource as a system and may perform additional path resolution.

Method Detail

privateAccessFor

AbsoluteLocation<PrivateResource> privateAccessFor(UserIDAuth user,
                                                   PrivateResource resource)

Gets credentials to access specified private resource location and may perform additional path resolution.

Parameters:

user - Requesting user

resource - User-internal resource (private, either relative or absolute)

Returns:

Physical resource location with credentials required to access it.

publicAccessFor

AbsoluteLocation<PublicResource> publicAccessFor(UserID user,
                                                 PublicResource resource)

Gets credentials to access specified public resource location and may perform additional path resolution.

Parameters:

user - Requesting user

resource - User-external resource (shareable, either relative or absolute)

Returns:

Physical resource location with credentials required to access it.

withSystemAccess

AbsoluteLocation withSystemAccess(AbsoluteLocation resource)

Gets credentials to access specified private resource as a system and may perform additional path resolution. This is mostly for storing user metadata like his profile. Note that system should not have access to real user private/public resource.

Parameters:

resource - System-internal resource (private, either relative or absolute)

Returns:

Physical resource location with credentials required to access it.