Package com.ultikits.ultitools.utils

Class CredentialStore.ReadResult

java.lang.Object

com.ultikits.ultitools.utils.CredentialStore.ReadResult

Enclosing class:

CredentialStore

public static final class CredentialStore.ReadResult
extends Object

The outcome of a CredentialStore.read() call. Deliberately has no isEmpty()-style method that a caller could use to conflate isAbsent() with isParseFailure() -- the two are structurally distinct outcomes and must be checked separately.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static enum	CredentialStore.ReadResult.Outcome

Field Summary

Fields

Modifier and Type	Field	Description
private final Map<String,Object>	data
private final CredentialStore.ReadResult.Outcome	outcome

Constructor Summary

Constructors

Modifier	Constructor	Description
private	ReadResult(CredentialStore.ReadResult.Outcome outcome, Map<String,Object> data)

Method Summary

Modifier and Type	Method	Description
private static CredentialStore.ReadResult	absent()
Map<String,Object>	data()	The parsed content.
boolean	isAbsent()
boolean	isParsed()
boolean	isParseFailure()
private static CredentialStore.ReadResult	parsed(Map<String,Object> data)
private static CredentialStore.ReadResult	parseFailure()

Methods inherited from class java.lang.Object

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

Field Details

outcome

private final CredentialStore.ReadResult.Outcome outcome

data

private final Map<String,Object> data

Constructor Details

ReadResult

private ReadResult(CredentialStore.ReadResult.Outcome outcome,
 Map<String,Object> data)

Method Details

absent

private static CredentialStore.ReadResult absent()

parsed

private static CredentialStore.ReadResult parsed(Map<String,Object> data)

parseFailure

private static CredentialStore.ReadResult parseFailure()

isAbsent

public boolean isAbsent()

Returns:

true if data.json did not exist at read time

isParsed

public boolean isParsed()

Returns:

true if data.json existed and parsed successfully

isParseFailure

public boolean isParseFailure()

Returns:

true if data.json existed but did not parse as valid JSON -- a torn file, distinguishable from isAbsent()

data

public Map<String,Object> data()

The parsed content. An absent file yields an empty map, by definition.

Returns:

the parsed document

Throws:

IllegalStateException - if this result isParseFailure() -- there is no empty-map fallback for a torn file; the caller must check the outcome first