Package net.shibboleth.utilities.java.support.primitive

Class DeprecationSupport

java.lang.Object

net.shibboleth.utilities.java.support.primitive.DeprecationSupport

public final class DeprecationSupport
extends Object

Helper methods for reporting usage of deprecated features.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	DeprecationSupport.ObjectType	Type of object, setting, feature, etc.

Field Summary

Fields

Modifier and Type	Field	Description
private static Set<String>	AT_RISK_SET	Tracks issued at-risks.
private static org.slf4j.Logger	LOG	Class logger.
static String	LOG_CATEGORY	Log category name for warnings.
private static Set<String>	WARNED_SET	Tracks issued warnings.

Constructor Summary

Constructors

Modifier	Constructor	Description
private	DeprecationSupport()	Constructor.

Method Summary

Modifier and Type	Method	Description
static void	atRisk(DeprecationSupport.ObjectType type, String name, String context)	Emit an at-risk warning for an object or feature of the system.
static void	atRiskOnce(DeprecationSupport.ObjectType type, String name, String context)	Emit a deprecation warning for an object or feature of the system but limit to a single warning for the life of the process or until state is cleared.
static void	clearAtRiskState()	Clear the previously at-risk state.
static void	clearWarningState()	Clear the previously warned state.
static void	warn(DeprecationSupport.ObjectType type, String name, String context, String replacement)	Emit a deprecation warning for an object or feature of the system.
static void	warnOnce(DeprecationSupport.ObjectType type, String name, String context, String replacement)	Emit a deprecation warning for an object or feature of the system but limit to a single warning for the life of the process or until state is cleared.

Methods inherited from class java.lang.Object

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

Field Detail

LOG_CATEGORY

@Nonnull
@NotEmpty
public static final String LOG_CATEGORY

Log category name for warnings.

See Also:

Constant Field Values

LOG

@Nonnull
private static final org.slf4j.Logger LOG

Class logger.

WARNED_SET

@Nonnull
@NonnullElements
private static final Set<String> WARNED_SET

Tracks issued warnings.

AT_RISK_SET

@Nonnull
@NonnullElements
private static final Set<String> AT_RISK_SET

Tracks issued at-risks.

Constructor Detail

DeprecationSupport

private DeprecationSupport()

Constructor.

Method Detail

warn

public static void warn(@Nonnull
                        DeprecationSupport.ObjectType type,
                        @Nonnull @NotEmpty
                        String name,
                        @Nullable
                        String context,
                        @Nullable
                        String replacement)

Emit a deprecation warning for an object or feature of the system.

Parameters:

type - type of object or feature

name - name of object or feature

context - surrounding context for deprecation warning

replacement - the replacement for the deprecated feature

warnOnce

public static void warnOnce(@Nonnull
                            DeprecationSupport.ObjectType type,
                            @Nonnull @NotEmpty
                            String name,
                            @Nullable
                            String context,
                            @Nullable
                            String replacement)

Emit a deprecation warning for an object or feature of the system but limit to a single warning for the life of the process or until state is cleared.

Parameters:

type - type of object or feature

name - name of object or feature

context - surrounding context for deprecation warning

replacement - the replacement for the deprecated feature

atRisk

public static void atRisk(@Nonnull
                          DeprecationSupport.ObjectType type,
                          @Nonnull @NotEmpty
                          String name,
                          @Nullable
                          String context)

Emit an at-risk warning for an object or feature of the system.

Parameters:

type - type of object or feature

name - name of object or feature

context - surrounding context for at-risk warning

Since:

4.3.0

atRiskOnce

public static void atRiskOnce(@Nonnull
                              DeprecationSupport.ObjectType type,
                              @Nonnull @NotEmpty
                              String name,
                              @Nullable
                              String context)

Emit a deprecation warning for an object or feature of the system but limit to a single warning for the life of the process or until state is cleared.

Parameters:

type - type of object or feature

name - name of object or feature

context - surrounding context for deprecation warning

Since:

4.3.0

clearWarningState

public static void clearWarningState()

Clear the previously warned state.

clearAtRiskState

public static void clearAtRiskState()

Clear the previously at-risk state.

Since:

4.3.0