Package org.openstreetmap.atlas.mutator.configuration.parsing.provider.file

Class AtlasFileAtlasProvider

  • All Implemented Interfaces:
    java.io.Serializable, java.util.function.BiFunction<java.lang.String,​org.openstreetmap.atlas.geography.sharding.Shard,​java.util.Optional<org.openstreetmap.atlas.geography.atlas.Atlas>>, AtlasProvider
    public class AtlasFileAtlasProvider
extends AbstractFileAtlasProvider
    The simplest default Atlas provider which takes a repository of serialized Atlas files to provide the Atlas objects.
    See Also:
    Serialized Form

    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      protected java.util.Optional<org.openstreetmap.atlas.streaming.resource.Resource> getResourceFromCache​(java.lang.String country, org.openstreetmap.atlas.geography.sharding.Shard shard)
      Use a ConcurrentResourceCache to get a remote resource from the country and shard.
      protected void invalidateCache​(java.lang.String country, org.openstreetmap.atlas.geography.sharding.Shard shard)
      Invalidate the cache for a specific country and shard, allowing for a retry.
      protected java.util.Optional<org.openstreetmap.atlas.geography.atlas.Atlas> resourceToAtlas​(org.openstreetmap.atlas.streaming.resource.Resource resource, java.lang.String country, org.openstreetmap.atlas.geography.sharding.Shard shard)
      The core of the AbstractFileAtlasProvider, in which a provided file becomes a resource which is then translated into an Atlas.
      void setAtlasProviderContext​(java.util.Map<java.lang.String,​java.lang.Object> context)
      Provide more generic runtime context to the AtlasProvider, this method to be used right before running the dependent mutation.

      • Methods inherited from class java.lang.Object

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

      • Methods inherited from interface java.util.function.BiFunction

        andThen

    • Constructor Detail

      • AtlasFileAtlasProvider

        public AtlasFileAtlasProvider​(java.lang.module.Configuration configuration)

      • AtlasFileAtlasProvider

        public AtlasFileAtlasProvider()

    • Method Detail

      • setAtlasProviderContext

        public void setAtlasProviderContext​(java.util.Map<java.lang.String,​java.lang.Object> context)
        Description copied from interface: AtlasProvider
        Provide more generic runtime context to the AtlasProvider, this method to be used right before running the dependent mutation.
        Specified by:
        setAtlasProviderContext in interface AtlasProvider
        Overrides:
        setAtlasProviderContext in class AbstractFileAtlasProvider
        Parameters:
        context - Generic context that is needed by the provider

      • getResourceFromCache

        protected java.util.Optional<org.openstreetmap.atlas.streaming.resource.Resource> getResourceFromCache​(java.lang.String country,
                                                                                                       org.openstreetmap.atlas.geography.sharding.Shard shard)
        Description copied from class: AbstractFileAtlasProvider
        Use a ConcurrentResourceCache to get a remote resource from the country and shard.
        Specified by:
        getResourceFromCache in class AbstractFileAtlasProvider
        Parameters:
        country - The country code
        shard - The provided shard
        Returns:
        If it exists, the resource associated with the country and shard.

      • invalidateCache

        protected void invalidateCache​(java.lang.String country,
                               org.openstreetmap.atlas.geography.sharding.Shard shard)
        Description copied from class: AbstractFileAtlasProvider
        Invalidate the cache for a specific country and shard, allowing for a retry.
        Specified by:
        invalidateCache in class AbstractFileAtlasProvider
        Parameters:
        country - The country code
        shard - The provided shard

      • resourceToAtlas

        protected java.util.Optional<org.openstreetmap.atlas.geography.atlas.Atlas> resourceToAtlas​(org.openstreetmap.atlas.streaming.resource.Resource resource,
                                                                                            java.lang.String country,
                                                                                            org.openstreetmap.atlas.geography.sharding.Shard shard)
        Description copied from class: AbstractFileAtlasProvider
        The core of the AbstractFileAtlasProvider, in which a provided file becomes a resource which is then translated into an Atlas.
        Specified by:
        resourceToAtlas in class AbstractFileAtlasProvider
        Parameters:
        resource - The resource to translate
        country - The country code
        shard - The provided shard
        Returns:
        The resulting Atlas.