org.eclipse.aether.spi.connector

Class ArtifactTransfer

java.lang.Object

org.eclipse.aether.spi.connector.Transfer

org.eclipse.aether.spi.connector.ArtifactTransfer

Direct Known Subclasses:

ArtifactDownload, ArtifactUpload

public abstract class ArtifactTransfer
extends Transfer

A download/upload of an artifact.

Field Summary

Fields

Modifier and Type	Field and Description
private Artifact	artifact
private ArtifactTransferException	exception
private java.io.File	file

Constructor Summary

Constructors

Constructor and Description
ArtifactTransfer()

Method Summary

Modifier and Type	Method and Description
Artifact	getArtifact() Gets the artifact being transferred.
ArtifactTransferException	getException() Gets the exception that occurred during the transfer (if any).
java.io.File	getFile() Gets the local file the artifact is downloaded to or uploaded from.
ArtifactTransfer	setArtifact(Artifact artifact) Sets the artifact to transfer.
ArtifactTransfer	setException(ArtifactTransferException exception) Sets the exception that occurred during the transfer.
ArtifactTransfer	setFile(java.io.File file) Sets the local file the artifact is downloaded to or uploaded from.

Methods inherited from class org.eclipse.aether.spi.connector.Transfer

getListener, getTrace, setListener, setTrace

Methods inherited from class java.lang.Object

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

Field Detail

artifact

private Artifact artifact

file

private java.io.File file

exception

private ArtifactTransferException exception

Constructor Detail

ArtifactTransfer

ArtifactTransfer()

Method Detail

getArtifact

public Artifact getArtifact()

Gets the artifact being transferred.

Returns:

The artifact being transferred or null if not set.

setArtifact

public ArtifactTransfer setArtifact(Artifact artifact)

Sets the artifact to transfer.

Parameters:

artifact - The artifact, may be null.

Returns:

This transfer for chaining, never null.

getFile

public java.io.File getFile()

Gets the local file the artifact is downloaded to or uploaded from. In case of a download, a connector should first transfer the bytes to a temporary file and only overwrite the target file once the entire download is completed such that an interrupted/failed download does not corrupt the current file contents.

Returns:

The local file or null if not set.

setFile

public ArtifactTransfer setFile(java.io.File file)

Sets the local file the artifact is downloaded to or uploaded from.

Parameters:

file - The local file, may be null.

Returns:

This transfer for chaining, never null.

getException

public ArtifactTransferException getException()

Gets the exception that occurred during the transfer (if any).

Specified by:

getException in class Transfer

Returns:

The exception or null if the transfer was successful.

setException

public ArtifactTransfer setException(ArtifactTransferException exception)

Sets the exception that occurred during the transfer.

Parameters:

exception - The exception, may be null to denote a successful transfer.

Returns:

This transfer for chaining, never null.