Class Mappings.Builder

java.lang.Object

org.openehealth.ipf.commons.map.Mappings.Builder

Enclosing interface:

Mappings

public static class Mappings.Builder
extends Object

Assembles a Mappings instance from mapping sources and named functions. Sources are dispatched to a MappingLoader by file extension, or by a format id where the caller names one, so formats may be mixed freely; load order is the order in which they are declared here. A builder is spent once build() has been called, so what it returns cannot be changed afterwards.

Since:

6.0

Method Summary

Modifier and Type	Method	Description
Mappings.Builder	allowOverride(boolean allowOverride)	Allows a later mapping source to silently replace a mapping of the same name loaded earlier.
Mappings.Builder	allowReverseCollisions(boolean allowReverseCollisions)
Mappings	build()
Mappings.Builder	function(String name, Function<String,String> function)	Registers a function that an Unmatched.Computed fallback can refer to.
Mappings.Builder	load(String location)	Loads a mapping source, in whichever format its file extension identifies.
Mappings.Builder	load(String location, String format)	Loads a mapping source in a format named explicitly, for a source whose name does not identify one:
Mappings.Builder	load(URI uri)
Mappings.Builder	load(URI uri, String format)
Mappings.Builder	load(URL url)
Mappings.Builder	load(URL url, String format)
Mappings.Builder	load(URL url, MappingLoader loader)	Loads a mapping source with a loader the caller provides, which need not be one the ServiceLoader can see.
Mappings.Builder	mapping(Mapping mapping)	Registers an already assembled mapping, for programmatic use and for tests.

Methods inherited from class Object

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

Method Details

function

public Mappings.Builder function(String name,
 Function<String,String> function)

Registers a function that an Unmatched.Computed fallback can refer to. Functions must be registered before the source that refers to them is loaded.

allowOverride

public Mappings.Builder allowOverride(boolean allowOverride)

Allows a later mapping source to silently replace a mapping of the same name loaded earlier. Off by default: a duplicate mapping name is a load-time error.

allowReverseCollisions

public Mappings.Builder allowReverseCollisions(boolean allowReverseCollisions)

See Also:

• DefaultMappings.setAllowReverseCollisions(boolean)

load

public Mappings.Builder load(String location)

Loads a mapping source, in whichever format its file extension identifies.

Parameters:

location - a URL, or a classpath: location such as classpath:/META-INF/map/atna2fhir.mapping.xml

load

public Mappings.Builder load(String location,
 String format)

Loads a mapping source in a format named explicitly, for a source whose name does not identify one:

Mappings.builder()
    .load("https://tx.example.org/ConceptMap/gender", "conceptmap-r4-json")
    .build();

Parameters:

location - a URL, or a classpath: location

format - a format id such as xml, yaml or conceptmap-r4-json, or null to dispatch by file extension

load

public Mappings.Builder load(URL url)

load

public Mappings.Builder load(URL url,
 String format)

See Also:

• load(String, String)

load

public Mappings.Builder load(URL url,
 MappingLoader loader)

Loads a mapping source with a loader the caller provides, which need not be one the ServiceLoader can see.

load

public Mappings.Builder load(URI uri)

load

public Mappings.Builder load(URI uri,
 String format)

See Also:

• load(String, String)

mapping

public Mappings.Builder mapping(Mapping mapping)

Registers an already assembled mapping, for programmatic use and for tests.

build

public Mappings build()