jenkins.model.lazy

Class BuildReference<R>

java.lang.Object

jenkins.model.lazy.BuildReference<R>

public final class BuildReference<R>
extends Object

Reference (by default a SoftReference) to a build object.

To be able to re-retrieve the referent in case it is lost, this class remembers its ID (the job name is provided by the context because a BuildReference belongs to one and only AbstractLazyLoadRunMap.)

We use this ID for equality/hashCode so that we can have a collection of BuildReference and find things in it.

Since:

1.485 (but as of 1.548 not a SoftReference)

Author:

Kohsuke Kawaguchi

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	BuildReference.DefaultHolderFactory Default factory if none other are installed.
static interface	BuildReference.Holder<R> An abstraction of Reference.
static interface	BuildReference.HolderFactory Extensible factory for creating build references.

Constructor Summary

Constructors

Constructor and Description
BuildReference(String id, R referent)

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object o)
R	get() Gets the build if still in memory.
int	hashCode()
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

BuildReference

public BuildReference(String id,
                      R referent)

Method Detail

get

@CheckForNull
public R get()

Gets the build if still in memory.

Returns:

the actual build, or null if it has been collected

See Also:

BuildReference.Holder.get()

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