com.xebialabs.deployit.engine.spi.artifact.resolution

Interface ArtifactResolver

public interface ArtifactResolver

A resolver for Artifact files. In order for it to be found by XL Deploy it should be annotated with the enclosed ArtifactResolver.Resolver annotation.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	ArtifactResolver.Resolver Denote which protocols the ArtifactResolver supports.

Method Summary

Modifier and Type	Method and Description
ResolvedArtifactFile	resolveLocation(com.xebialabs.deployit.plugin.api.udm.artifact.SourceArtifact artifact) This method is only called with a SourceArtifact that has a SourceArtifact.getFileUri() URI that contains (one of) the URI schemes that the ArtifactResolver.Resolver annotation specifies.
boolean	validateCorrectness(com.xebialabs.deployit.plugin.api.udm.artifact.SourceArtifact artifact) Validate whether the SourceArtifact.getFileUri() URI is correct with regards to the scheme specific part of the defined scheme.

Method Detail

resolveLocation

ResolvedArtifactFile resolveLocation(com.xebialabs.deployit.plugin.api.udm.artifact.SourceArtifact artifact)

This method is only called with a SourceArtifact that has a SourceArtifact.getFileUri() URI that contains (one of) the URI schemes that the ArtifactResolver.Resolver annotation specifies.

Parameters:

artifact - The SourceArtifact for which we need to resolve a ResolvedArtifactFile against its SourceArtifact.getFileUri().

Returns:

The ResolvedArtifactFile from which you can obtain the InputStream.

Throws:

CannotLocateArtifactException - when the file pointed to by the artifact could not be found at the indicated URI.

validateCorrectness

boolean validateCorrectness(com.xebialabs.deployit.plugin.api.udm.artifact.SourceArtifact artifact)

Validate whether the SourceArtifact.getFileUri() URI is correct with regards to the scheme specific part of the defined scheme. Only the resolver that "knows about" this scheme is able to do this. NOTE: There is no guarantee that when this method returns

true

, that the location actually resolves to a file, or the file is present. It is implementation specific whether this is checked with this call.

Parameters:

artifact - The SourceArtifact which needs to be validated with regards to its SourceArtifact.getFileUri().

Returns:

true

iff the URI has a valid scheme specific part, i.e. this ArtifactResolver would be able to resolve it.