Package dev.enola.thing.repo

Interface ThingProvider

All Superinterfaces:

Provider<String,Thing>, ProviderFromIRI<Thing>

All Known Subinterfaces:

ThingRepository, ThingRepositoryStore, ThingsRepository

All Known Implementing Classes:

AlwaysThingProvider, AlwaysThingProviderAdapter, AlwaysThingRepositoryStore, EmptyThingsRepository, MetaThingProvider, ProtoToThingRepository, StackedThingProvider, TemplateThingRepository, ThingMemoryRepositoryROBuilder, ThingMemoryRepositoryRW, ThingProviderAdapter

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@FunctionalInterface
public interface ThingProvider
extends ProviderFromIRI<Thing>

Provides Things.

Intentionally named a *Provider and not a *Repository, because implementations may or may not "fetch from" a "data store" (which *Repository often implies); as some might indeed, but others may well not, and just "conjure up" new Things out of thin air, based solely on the IRI!

See ProtoThingProvider for a Proto Thing variant (this is for the Java Thing).

See AlwaysThingProvider for a NonNull variant.

Field Summary

Fields

Modifier and Type	Field	Description
static final ThingProvider	CTX	ThingProvider which is looked up in the TLC.

Method Summary

Modifier and Type	Method	Description
default <T extends Thing, B extends Thing.Builder<T>> Iterable<T>	get(Iterable<Object> iris, Class<T> thingClass, Class<B> thingBuilderClass)
default <T extends Thing> Iterable<T>	get(Iterable<String> iris, Class<T> thingClass)	Deprecated.
@Nullable Thing	get(String iri)	Get the Thing.
default <T extends Thing> @Nullable T	get(String iri, Class<T> thingClass)	Deprecated.
default <T extends Thing, B extends Thing.Builder<T>> T	get(String iri, Class<T> thingClass, Class<B> thingBuilderClass)
default Thing.Builder<?>	getBuilder(String iri)
default <T extends Thing, B extends Thing.Builder<T>> B	getBuilder(String iri, Class<T> thingClass, Class<B> thingBuilderClass)
default Thing.Builder<?>	getBuilder(String iri, String typeIRI)
default Optional<Thing>	getOptional(String iri)

Field Details

CTX

static final ThingProvider CTX

ThingProvider which is looked up in the TLC.

Consider possibly using AlwaysThingProvider.CTX instead.

Method Details

getBuilder

default Thing.Builder<?> getBuilder(String iri,
 String typeIRI)

getBuilder

default Thing.Builder<?> getBuilder(String iri)

get

@Nullable Thing get(String iri)
             throws UncheckedIOException,
ConversionException

Get the Thing.

Specified by:

get in interface Provider<String,Thing>

Specified by:

get in interface ProviderFromIRI<Thing>

Parameters:

iri - an IRI

Returns:

a Thing [TODO: never null; but may be an empty Thing for an unknown IRI]

Throws:

UncheckedIOException - if there was something at that IRI, but it could not be read

ConversionException - if there was a problem converting what was at the IRI to a Thing

getOptional

default Optional<Thing> getOptional(String iri)
                             throws UncheckedIOException,
ConversionException

Throws:

UncheckedIOException

ConversionException

get

@Deprecated
default <T extends Thing> @Nullable T get(String iri,
 Class<T> thingClass)
                                   throws UncheckedIOException,
ConversionException

Deprecated.

Throws:

UncheckedIOException

ConversionException

getBuilder

default <T extends Thing,
B extends Thing.Builder<T>>
B getBuilder(String iri,
 Class<T> thingClass,
 Class<B> thingBuilderClass)

get

default <T extends Thing,
B extends Thing.Builder<T>>
T get(String iri,
 Class<T> thingClass,
 Class<B> thingBuilderClass)

get

default <T extends Thing,
B extends Thing.Builder<T>>
Iterable<T> get(Iterable<Object> iris,
 Class<T> thingClass,
 Class<B> thingBuilderClass)

get

@Deprecated
default <T extends Thing> Iterable<T> get(Iterable<String> iris,
 Class<T> thingClass)

Deprecated.