Interface DeprecationHandler
-
public interface DeprecationHandler
Callback for notifying the creator of theXContentParser
that parsing hit a deprecated field.
-
-
Field Summary
Fields Modifier and Type Field Description static DeprecationHandler
THROW_UNSUPPORTED_OPERATION
Throws anUnsupportedOperationException
when parsing hits a deprecated field.
-
Method Summary
Modifier and Type Method Description void
usedDeprecatedField(java.lang.String usedName, java.lang.String replacedWith)
Called when the provided field name matches the current field but the entire field has been marked as deprecated.void
usedDeprecatedName(java.lang.String usedName, java.lang.String modernName)
Called when the provided field name matches a deprecated name for the field.
-
-
-
Field Detail
-
THROW_UNSUPPORTED_OPERATION
static final DeprecationHandler THROW_UNSUPPORTED_OPERATION
Throws anUnsupportedOperationException
when parsing hits a deprecated field. Use this when creating anXContentParser
that won't interact with deprecation logic at all or when you want to fail fast when parsing deprecated fields.
-
-
Method Detail
-
usedDeprecatedName
void usedDeprecatedName(java.lang.String usedName, java.lang.String modernName)
Called when the provided field name matches a deprecated name for the field.- Parameters:
usedName
- the provided field namemodernName
- the modern name for the field
-
usedDeprecatedField
void usedDeprecatedField(java.lang.String usedName, java.lang.String replacedWith)
Called when the provided field name matches the current field but the entire field has been marked as deprecated.- Parameters:
usedName
- the provided field namereplacedWith
- the name of the field that replaced this field
-
-