Status (instrumentation-java-core 0.4.3 API)

java.lang.Object
- com.google.instrumentation.trace.Status

```
@Immutable
public final class Status
extends Object
```
Defines the status of a Span by providing a standard Status.CanonicalCode in conjunction with an optional descriptive message. Instances of Status are created by starting with the template for the appropriate Status.CanonicalCode and supplementing it with additional information: Status.NOT_FOUND.withDescription("Could not find 'important_file.txt'");

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class Status.CanonicalCode
The set of canonical status codes.

Nested Classes
Modifier and Type	Class and Description
`static class`	`Status.CanonicalCode` The set of canonical status codes.

Field Summary

Fields
Modifier and Type	Field and Description
`static Status`	`ABORTED` The operation was aborted, typically due to a concurrency issue like sequencer check failures, transaction aborts, etc.
`static Status`	`ALREADY_EXISTS` Some entity that we attempted to create (e.g., file or directory) already exists.
`static Status`	`CANCELLED` The operation was cancelled (typically by the caller).
`static Status`	`DATA_LOSS` Unrecoverable data loss or corruption.
`static Status`	`DEADLINE_EXCEEDED` Deadline expired before operation could complete.
`static Status`	`FAILED_PRECONDITION` Operation was rejected because the system is not in a state required for the operation's execution.
`static Status`	`INTERNAL` Internal errors.
`static Status`	`INVALID_ARGUMENT` Client specified an invalid argument.
`static Status`	`NOT_FOUND` Some requested entity (e.g., file or directory) was not found.
`static Status`	`OK` The operation completed successfully.
`static Status`	`OUT_OF_RANGE` Operation was attempted past the valid range.
`static Status`	`PERMISSION_DENIED` The caller does not have permission to execute the specified operation.
`static Status`	`RESOURCE_EXHAUSTED` Some resource has been exhausted, perhaps a per-user quota, or perhaps the entire file system is out of space.
`static Status`	`UNAUTHENTICATED` The request does not have valid authentication credentials for the operation.
`static Status`	`UNAVAILABLE` The service is currently unavailable.
`static Status`	`UNIMPLEMENTED` Operation is not implemented or not supported/enabled in this service.
`static Status`	`UNKNOWN` Unknown error.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`boolean`	`equals(Object obj)` Equality on Statuses is not well defined.
`Status.CanonicalCode`	`getCanonicalCode()` Returns the canonical status code.
`String`	`getDescription()` Returns the description of this `Status` for human consumption.
`int`	`hashCode()` Hash codes on Statuses are not well defined.
`boolean`	`isOk()` Returns `true` if this `Status` is OK, i.e., not an error.
`String`	`toString()`
`Status`	`withDescription(String description)` Creates a derived instance of `Status` with the given description.

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

- Field Detail
  - OK
```
public static final Status OK
```
    The operation completed successfully.
  - CANCELLED
```
public static final Status CANCELLED
```
    The operation was cancelled (typically by the caller).
  - UNKNOWN
```
public static final Status UNKNOWN
```
    Unknown error. See Status.CanonicalCode.UNKNOWN.
  - INVALID_ARGUMENT
```
public static final Status INVALID_ARGUMENT
```
    Client specified an invalid argument. See Status.CanonicalCode.INVALID_ARGUMENT.
  - DEADLINE_EXCEEDED
```
public static final Status DEADLINE_EXCEEDED
```
    Deadline expired before operation could complete. See Status.CanonicalCode.DEADLINE_EXCEEDED.
  - NOT_FOUND
```
public static final Status NOT_FOUND
```
    Some requested entity (e.g., file or directory) was not found.
  - ALREADY_EXISTS
```
public static final Status ALREADY_EXISTS
```
    Some entity that we attempted to create (e.g., file or directory) already exists.
  - PERMISSION_DENIED
```
public static final Status PERMISSION_DENIED
```
    The caller does not have permission to execute the specified operation. See Status.CanonicalCode.PERMISSION_DENIED.
  - UNAUTHENTICATED
```
public static final Status UNAUTHENTICATED
```
    The request does not have valid authentication credentials for the operation.
  - RESOURCE_EXHAUSTED
```
public static final Status RESOURCE_EXHAUSTED
```
    Some resource has been exhausted, perhaps a per-user quota, or perhaps the entire file system is out of space.
  - FAILED_PRECONDITION
```
public static final Status FAILED_PRECONDITION
```
    Operation was rejected because the system is not in a state required for the operation's execution. See Status.CanonicalCode.FAILED_PRECONDITION.
  - ABORTED
```
public static final Status ABORTED
```
    The operation was aborted, typically due to a concurrency issue like sequencer check failures, transaction aborts, etc. See Status.CanonicalCode.ABORTED.
  - OUT_OF_RANGE
```
public static final Status OUT_OF_RANGE
```
    Operation was attempted past the valid range. See Status.CanonicalCode.OUT_OF_RANGE.
  - UNIMPLEMENTED
```
public static final Status UNIMPLEMENTED
```
    Operation is not implemented or not supported/enabled in this service.
  - INTERNAL
```
public static final Status INTERNAL
```
    Internal errors. See Status.CanonicalCode.INTERNAL.
  - UNAVAILABLE
```
public static final Status UNAVAILABLE
```
    The service is currently unavailable. See Status.CanonicalCode.UNAVAILABLE.
  - DATA_LOSS
```
public static final Status DATA_LOSS
```
    Unrecoverable data loss or corruption.
- Method Detail
  - withDescription
```
public Status withDescription(String description)
```
    Creates a derived instance of Status with the given description.
    
    Parameters:
    
    description - the new description of the Status.
    
    Returns:
    
    The newly created Status with the given description.
  - getCanonicalCode
```
public Status.CanonicalCode getCanonicalCode()
```
    Returns the canonical status code.
    
    Returns:
    
    the canonical status code.
  - getDescription
```
@Nullable
public String getDescription()
```
    Returns the description of this Status for human consumption.
    
    Returns:
    
    the description of this Status.
  - isOk
```
public boolean isOk()
```
    Returns true if this Status is OK, i.e., not an error.
    
    Returns:
    
    true if this Status is OK.
  - equals
```
public boolean equals(Object obj)
```
    Equality on Statuses is not well defined. Instead, do comparison based on their CanonicalCode with getCanonicalCode(). The description of the Status is unlikely to be stable, and additional fields may be added to Status in the future.
    
    Overrides:
    
    equals in class Object
  - hashCode
```
public int hashCode()
```
    Hash codes on Statuses are not well defined.
    
    Overrides:
    
    hashCode in class Object
    
    See Also:
    
    equals(java.lang.Object)
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object

Class Status

Nested Class Summary

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

OK

CANCELLED

UNKNOWN

INVALID_ARGUMENT

DEADLINE_EXCEEDED

NOT_FOUND

ALREADY_EXISTS

PERMISSION_DENIED

UNAUTHENTICATED

RESOURCE_EXHAUSTED

FAILED_PRECONDITION

ABORTED

OUT_OF_RANGE

UNIMPLEMENTED

INTERNAL

UNAVAILABLE

DATA_LOSS

Method Detail

withDescription

getCanonicalCode

getDescription

isOk

equals

hashCode

toString