Package com.yahoo.vespa.hosted.controller.api.integration.deployment

Class ApplicationVersion

java.lang.Object

com.yahoo.vespa.hosted.controller.api.integration.deployment.ApplicationVersion

All Implemented Interfaces:

Comparable<ApplicationVersion>

public class ApplicationVersion
extends Object
implements Comparable<ApplicationVersion>

An application package version, identified by a source revision and a build number.

Author:

bratseth, mpolden, jonmv

Field Summary

Fields

Modifier and Type	Field	Description
static ApplicationVersion	unknown	Used in cases where application version cannot be determined, such as manual deployments (e.g.

Constructor Summary

Constructors

Constructor	Description
ApplicationVersion(Optional<SourceRevision> source, OptionalLong buildNumber, Optional<String> authorEmail, Optional<com.yahoo.component.Version> compileVersion, Optional<Instant> buildTime, Optional<String> sourceUrl, Optional<String> commit, boolean deployedDirectly)	Public for serialisation only.

Method Summary

Modifier and Type	Method	Description
Optional<String>	authorEmail()	Returns the email of the author of commit of this version, if known
OptionalLong	buildNumber()	Returns the build number that built this version
Optional<Instant>	buildTime()	Returns the time this package was built, if known.
Optional<String>	commit()	Returns the commit name of this application version.
int	compareTo(ApplicationVersion o)
Optional<com.yahoo.component.Version>	compileVersion()	Returns the Vespa version this package was compiled against, if known.
boolean	equals(Object o)
static ApplicationVersion	from(SourceRevision source, long buildNumber)	Create an application package version from a completed build, without an author email
static ApplicationVersion	from(SourceRevision source, long buildNumber, String authorEmail, com.yahoo.component.Version compileVersion, Instant buildTime)	Creates a version from a completed build, an author email, and build meta data.
static ApplicationVersion	from(Optional<SourceRevision> source, long buildNumber, Optional<String> authorEmail, Optional<com.yahoo.component.Version> compileVersion, Optional<Instant> buildTime, Optional<String> sourceUrl, Optional<String> commit, boolean deployedDirectly)	Creates a version from a completed build, an author email, and build meta data.
int	hashCode()
String	id()	Returns a unique identifier for this version or "unknown" if version is not known
boolean	isDeployedDirectly()	Returns whether the application package for this version was deployed directly to zone
boolean	isUnknown()	Returns whether this is unknown
Optional<SourceRevision>	source()	Returns information about the source of this revision, or empty if the source is not know/defined (which is the case for command-line deployment from developers, but never for deployment jobs)
Optional<String>	sourceUrl()	Returns the source URL for this application version.
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

unknown

public static final ApplicationVersion unknown

Used in cases where application version cannot be determined, such as manual deployments (e.g. in dev environment)

Constructor Detail

ApplicationVersion

public ApplicationVersion(Optional<SourceRevision> source,
                          OptionalLong buildNumber,
                          Optional<String> authorEmail,
                          Optional<com.yahoo.component.Version> compileVersion,
                          Optional<Instant> buildTime,
                          Optional<String> sourceUrl,
                          Optional<String> commit,
                          boolean deployedDirectly)

Public for serialisation only.

Method Detail

from

public static ApplicationVersion from(SourceRevision source,
                                      long buildNumber)

Create an application package version from a completed build, without an author email

from

public static ApplicationVersion from(SourceRevision source,
                                      long buildNumber,
                                      String authorEmail,
                                      com.yahoo.component.Version compileVersion,
                                      Instant buildTime)

Creates a version from a completed build, an author email, and build meta data.

from

public static ApplicationVersion from(Optional<SourceRevision> source,
                                      long buildNumber,
                                      Optional<String> authorEmail,
                                      Optional<com.yahoo.component.Version> compileVersion,
                                      Optional<Instant> buildTime,
                                      Optional<String> sourceUrl,
                                      Optional<String> commit,
                                      boolean deployedDirectly)

Creates a version from a completed build, an author email, and build meta data.

id

public String id()

Returns a unique identifier for this version or "unknown" if version is not known

source

public Optional<SourceRevision> source()

Returns information about the source of this revision, or empty if the source is not know/defined (which is the case for command-line deployment from developers, but never for deployment jobs)

buildNumber

public OptionalLong buildNumber()

Returns the build number that built this version

authorEmail

public Optional<String> authorEmail()

Returns the email of the author of commit of this version, if known

compileVersion

public Optional<com.yahoo.component.Version> compileVersion()

Returns the Vespa version this package was compiled against, if known.

buildTime

public Optional<Instant> buildTime()

Returns the time this package was built, if known.

sourceUrl

public Optional<String> sourceUrl()

Returns the source URL for this application version.

commit

public Optional<String> commit()

Returns the commit name of this application version.

isUnknown

public boolean isUnknown()

Returns whether this is unknown

isDeployedDirectly

public boolean isDeployedDirectly()

Returns whether the application package for this version was deployed directly to zone

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object

compareTo

public int compareTo(ApplicationVersion o)

Specified by:

compareTo in interface Comparable<ApplicationVersion>