EvaluationReason (launchdarkly-java-server-sdk 5.0.0 API)

java.lang.Object
- com.launchdarkly.sdk.EvaluationReason

All Implemented Interfaces:

JsonSerializable
```
public final class EvaluationReason
extends java.lang.Object
implements JsonSerializable
```
Describes the reason that a flag evaluation produced a particular value.
This is returned within EvaluationDetail by the SDK's "variation detail" methods such as boolVariationDetail.
Note that while EvaluationReason has subclasses as an implementation detail, the subclasses are not public and may be removed in the future. Always use methods of the base class such as getKind() or getRuleIndex() to inspect the reason.
LaunchDarkly defines a standard JSON encoding for evaluation reasons, used in analytics events. EvaluationReason can be converted to and from JSON in any of these ways:
1. With JsonSerialization.
2. With Gson, if and only if you configure your Gson instance with LDGson.
3. With Jackson, if and only if you configure your ObjectMapper instance with LDJackson.

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`EvaluationReason.ErrorKind` Enumerated type defining the possible values of `getErrorKind()`.
`static class`	`EvaluationReason.Kind` Enumerated type defining the possible values of `getKind()`.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`boolean`	`equals(java.lang.Object other)`
`static EvaluationReason`	`error(EvaluationReason.ErrorKind errorKind)` Returns an instance whose `kind` is `EvaluationReason.Kind.ERROR`.
`static EvaluationReason`	`exception(java.lang.Exception exception)` Returns an instance whose `kind` is `EvaluationReason.Kind.ERROR`, with an exception instance.
`static EvaluationReason`	`fallthrough()` Returns an instance whose `kind` is `EvaluationReason.Kind.FALLTHROUGH`.
`EvaluationReason.ErrorKind`	`getErrorKind()` An enumeration value indicating the general category of error, if the `kind` is `EvaluationReason.Kind.PREREQUISITE_FAILED`.
`java.lang.Exception`	`getException()` The exception that caused the error condition, if the `kind` is `EvaluationReason.Kind.ERROR` and the `errorKind` is `EvaluationReason.ErrorKind.EXCEPTION`.
`EvaluationReason.Kind`	`getKind()` Returns an enum indicating the general category of the reason.
`java.lang.String`	`getPrerequisiteKey()` The key of the prerequisite flag that did not return the desired variation, if the `kind` is `EvaluationReason.Kind.PREREQUISITE_FAILED`.
`java.lang.String`	`getRuleId()` The unique identifier of the rule that was matched, if the `kind` is `EvaluationReason.Kind.RULE_MATCH`.
`int`	`getRuleIndex()` The index of the rule that was matched (0 for the first rule in the feature flag), if the `kind` is `EvaluationReason.Kind.RULE_MATCH`.
`int`	`hashCode()`
`static EvaluationReason`	`off()` Returns an instance whose `kind` is `EvaluationReason.Kind.OFF`.
`static EvaluationReason`	`prerequisiteFailed(java.lang.String prerequisiteKey)` Returns an instance whose `kind` is `EvaluationReason.Kind.PREREQUISITE_FAILED`.
`static EvaluationReason`	`ruleMatch(int ruleIndex, java.lang.String ruleId)` Returns an instance whose `kind` is `EvaluationReason.Kind.RULE_MATCH`.
`static EvaluationReason`	`targetMatch()` Returns an instance whose `kind` is `EvaluationReason.Kind.TARGET_MATCH`.
`java.lang.String`	`toString()` Returns a simple string representation of the reason.

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Method Detail
  - getKind
```
public EvaluationReason.Kind getKind()
```
    Returns an enum indicating the general category of the reason.
    
    Returns:
    
    a EvaluationReason.Kind value
  - getRuleIndex
```
public int getRuleIndex()
```
    The index of the rule that was matched (0 for the first rule in the feature flag), if the kind is EvaluationReason.Kind.RULE_MATCH. Otherwise this returns -1.
    
    Returns:
    
    the rule index or -1
  - getRuleId
```
public java.lang.String getRuleId()
```
    The unique identifier of the rule that was matched, if the kind is EvaluationReason.Kind.RULE_MATCH. Otherwise null.
    Unlike the rule index, this identifier will not change if other rules are added or deleted.
    
    Returns:
    
    the rule identifier or null
  - getPrerequisiteKey
```
public java.lang.String getPrerequisiteKey()
```
    The key of the prerequisite flag that did not return the desired variation, if the kind is EvaluationReason.Kind.PREREQUISITE_FAILED. Otherwise null.
    
    Returns:
    
    the prerequisite flag key or null
  - getErrorKind
```
public EvaluationReason.ErrorKind getErrorKind()
```
    An enumeration value indicating the general category of error, if the kind is EvaluationReason.Kind.PREREQUISITE_FAILED. Otherwise null.
    
    Returns:
    
    the error kind or null
  - getException
```
public java.lang.Exception getException()
```
    The exception that caused the error condition, if the kind is EvaluationReason.Kind.ERROR and the errorKind is EvaluationReason.ErrorKind.EXCEPTION. Otherwise null.
    Note that the exception will not be included in the JSON serialization of the reason when it appears in analytics events; it is only provided informationally for use by application code.
    
    Returns:
    
    the exception instance
  - toString
```
public java.lang.String toString()
```
    Returns a simple string representation of the reason.
    This is a convenience method for debugging and any other use cases where a human-readable string is helpful. The exact format of the string is subject to change; if you need to make programmatic decisions based on the reason properties, use other methods like getKind().
    
    Overrides:
    
    toString in class java.lang.Object
  - equals
```
public boolean equals(java.lang.Object other)
```
    Overrides:
    
    equals in class java.lang.Object
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class java.lang.Object
  - off
```
public static EvaluationReason off()
```
    Returns an instance whose kind is EvaluationReason.Kind.OFF.
    
    Returns:
    
    a reason object
  - fallthrough
```
public static EvaluationReason fallthrough()
```
    Returns an instance whose kind is EvaluationReason.Kind.FALLTHROUGH.
    
    Returns:
    
    a reason object
  - targetMatch
```
public static EvaluationReason targetMatch()
```
    Returns an instance whose kind is EvaluationReason.Kind.TARGET_MATCH.
    
    Returns:
    
    a reason object
  - ruleMatch
```
public static EvaluationReason ruleMatch(int ruleIndex,
                                         java.lang.String ruleId)
```
    Returns an instance whose kind is EvaluationReason.Kind.RULE_MATCH.
    
    Parameters:
    
    ruleIndex - the rule index
    
    ruleId - the rule identifier
    
    Returns:
    
    a reason object
  - prerequisiteFailed
```
public static EvaluationReason prerequisiteFailed(java.lang.String prerequisiteKey)
```
    Returns an instance whose kind is EvaluationReason.Kind.PREREQUISITE_FAILED.
    
    Parameters:
    
    prerequisiteKey - the flag key of the prerequisite that failed
    
    Returns:
    
    a reason object
  - error
```
public static EvaluationReason error(EvaluationReason.ErrorKind errorKind)
```
    Returns an instance whose kind is EvaluationReason.Kind.ERROR.
    
    Parameters:
    
    errorKind - describes the type of error
    
    Returns:
    
    a reason object
  - exception
```
public static EvaluationReason exception(java.lang.Exception exception)
```
    Returns an instance whose kind is EvaluationReason.Kind.ERROR, with an exception instance.
    Note that the exception will not be included in the JSON serialization of the reason when it appears in analytics events; it is only provided informationally for use by application code.
    
    Parameters:
    
    exception - the exception that caused the error
    
    Returns:
    
    a reason object

Class EvaluationReason

Nested Class Summary

Method Summary

Methods inherited from class java.lang.Object

Method Detail

getKind

getRuleIndex

getRuleId

getPrerequisiteKey

getErrorKind

getException

toString

equals

hashCode

off

fallthrough

targetMatch

ruleMatch

prerequisiteFailed

error

exception