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 and Description
static class	DeprecationSupport.ObjectType Type of object, setting, feature, etc.

Field Summary

Fields

Modifier and Type	Field and Description
private static 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 and Description
private	DeprecationSupport() Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
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 Logger LOG

Class logger.

WARNED_SET

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

Tracks issued warnings.

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

clearWarningState

public static void clearWarningState()

Clear the previously warned state.