jenkins.telemetry.impl.java11

Class MissingClassTelemetry

java.lang.Object

jenkins.telemetry.Telemetry

jenkins.telemetry.impl.java11.MissingClassTelemetry

All Implemented Interfaces:

ExtensionPoint

@Extension
 @Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public class MissingClassTelemetry
extends Telemetry

Telemetry class to gather information about missing classes when running on java 11. This class sends classes not found and in packages related with Java changes from Java 8 to Java 11. See MOVED_PACKAGES.

Nested Class Summary

Nested classes/interfaces inherited from class jenkins.telemetry.Telemetry

Telemetry.TelemetryReporter

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

ExtensionPoint.LegacyInstancesAreScopedToHudson

Constructor Summary

Constructors

Constructor and Description
MissingClassTelemetry()

Method Summary

Modifier and Type	Method and Description
net.sf.json.JSONObject	createContent() Returns the content to be sent to the telemetry service.
static boolean	enabled() This telemetry is only enabled when running on Java versions newer than Java 8.
String	getDisplayName() User friendly display name for this telemetry collector, ideally localized.
LocalDate	getEnd() End date for the collection.
LocalDate	getStart() Start date for the collection.
static void	reportException(String name, Throwable e) Store the exception if it's from a split package of Java.
static void	reportExceptionInside(Throwable e) Report the class not found if this exception or any of its causes or suppressed exceptions is related to missed classes.

Methods inherited from class jenkins.telemetry.Telemetry

all, getId, isActivePeriod, isDisabled

Methods inherited from class java.lang.Object

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

Constructor Detail

MissingClassTelemetry

public MissingClassTelemetry()

Method Detail

getDisplayName

@NonNull
public String getDisplayName()

Description copied from class: Telemetry

User friendly display name for this telemetry collector, ideally localized.

Specified by:

getDisplayName in class Telemetry

Returns:

display name, never null or empty

getStart

@NonNull
public LocalDate getStart()

Description copied from class: Telemetry

Start date for the collection. Will be checked in Jenkins to not collect outside the defined time span. This does not have to be precise enough for time zones to be a consideration.

Specified by:

getStart in class Telemetry

Returns:

collection start date

getEnd

@NonNull
public LocalDate getEnd()

Description copied from class: Telemetry

End date for the collection. Will be checked in Jenkins to not collect outside the defined time span. This does not have to be precise enough for time zones to be a consideration.

Specified by:

getEnd in class Telemetry

Returns:

collection end date

enabled

public static boolean enabled()

This telemetry is only enabled when running on Java versions newer than Java 8.

Returns:

true if running on a newer Java version than Java 8

createContent

@CheckForNull
public net.sf.json.JSONObject createContent()

Description copied from class: Telemetry

Returns the content to be sent to the telemetry service. This method is called periodically, once per content submission.

Specified by:

createContent in class Telemetry

Returns:

The JSON payload, or null if no content should be submitted.

reportException

public static void reportException(@NonNull
                                   String name,
                                   @NonNull
                                   Throwable e)

Store the exception if it's from a split package of Java. This method report this exception directly, it doesn't look into the causes or suppressed exceptions of the exception specified. This method tends to be used in the ClassLoader directly. Outside the class loaders is best to use reportExceptionInside(Throwable)

Parameters:

name - the name of the class

e - the throwable to report if needed

reportExceptionInside

public static void reportExceptionInside(@NonNull
                                         Throwable e)

Report the class not found if this exception or any of its causes or suppressed exceptions is related to missed classes.

Parameters:

e - the exception to look into