org.geolatte.geom.crs.CrsRegistry Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of geolatte-geom Show documentation
Show all versions of geolatte-geom Show documentation
This geoLatte-geom library offers a geometry model that conforms to the OGC Simple Features for SQL
specification.
The newest version!
/*
* This file is part of the GeoLatte project.
*
* GeoLatte is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* GeoLatte is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with GeoLatte. If not, see CoordinateReferenceSystems.
*
* Currently, the registry is limited to EPSG-defined coordinate reference systems.
*
* @author Karel Maesen, Geovise BVBA
*/
public class CrsRegistry {
final private static Logger LOGGER = LoggerFactory.getLogger(CrsRegistry.class);
final private static ConcurrentHashMap> crsMap =
new ConcurrentHashMap<>(4000);
final private static String DELIM = "\\|";
static {
try {
loadCRS();
} catch (IOException e) {
throw new RuntimeException("Can't read spatial ref system definitions.");
}
}
private static void loadCRS() throws IOException {
BufferedReader reader = createReader();
try {
String line = reader.readLine();
CrsWktDecoder decoder = new CrsWktDecoder();
while (line != null) {
addDefinition(line, decoder);
line = reader.readLine();
}
} finally {
reader.close();
}
}
private static BufferedReader createReader() {
InputStream in = CrsRegistry.class.getClassLoader().getResourceAsStream("spatial_ref_sys.txt");
if (in == null) {
throw new IllegalStateException("Can't find spatial_ref_sys definitions.");
}
return new BufferedReader(new InputStreamReader(in));
}
private static void addDefinition(String line, CrsWktDecoder decoder) {
String[] tokens = line.split(DELIM);
if (!"EPSG".equals(tokens[0])) {
LOGGER.debug(String.format("Non-EPSG CRS ignored: %s", tokens[2]));
return;
}
int srid = Integer.parseInt(tokens[1]);
try {
CoordinateReferenceSystem crs = decoder.decode(tokens[2], srid);
crsMap.put(CrsId.valueOf(srid), crs);
} catch (WktDecodeException e) {
LOGGER.warn(String.format("Can't parse srid %d (%s). \n%s", srid, tokens[2], e.getMessage()));
} catch (RuntimeException e) {
LOGGER.warn(String.format("Can't parse srid %d (%s) -- inconsistent coordinate system. \n%s", srid, tokens[2], e.getMessage()));
}
}
/**
* returns the CoordinateReferenceSystem for the specified EPSG code.
*
* @param epsgCode the EPSG code
* @param fallback the coordinate
* @return the CoordinateReferenceSystem corresponding to the specified EPSG code, or null if
* no such system is registered.
*/
public static CoordinateReferenceSystem getCoordinateReferenceSystemForEPSG(int epsgCode,
CoordinateReferenceSystem
fallback) {
return getCoordinateReferenceSystem(CrsId.valueOf(epsgCode), fallback);
}
/**
* returns the CoordinateReferenceSystem for the specified {@code CrsId}
*
* @param crsId the identifier for the Coordinate Reference System
* @param fallback the coordinate reference system to use, if the specified crsId is registered
* @return the CoordinateReferenceSystem corresponding to the specified EPSG code, or null if
* no such system is registered.
*/
public static CoordinateReferenceSystem getCoordinateReferenceSystem(CrsId crsId,
CoordinateReferenceSystem
fallback) {
CoordinateReferenceSystem crs = crsMap.get(crsId);
return crs != null ? crs : fallback;
}
/**
* Returns the registered coordinate reference system, or when unavailable in the registry, create a new Projected 2D system and register
* this on-the-fly.
*
* @param epsgCode the code to look up
* @return a CoordinateReferenceSystem with the specified epsg code
*/
public static CoordinateReferenceSystem ifAbsentReturnProjected2D(int epsgCode) {
return computeIfAbsent(CrsId.valueOf(epsgCode), key -> CoordinateReferenceSystems.mkProjected(key, LinearUnit.METER));
}
/**
* Returns the registered coordinate reference system, or when unavailable in the registry, create a new Geographic 2D system and register
* this on-the-fly.
*
* @param epsgCode the code to look up
* @return a CoordinateReferenceSystem with the specified epsg code
*/
public static CoordinateReferenceSystem ifAbsentReturnGeographic2D(int epsgCode) {
return computeIfAbsent(CrsId.valueOf(epsgCode), key -> CoordinateReferenceSystems.mkGeographic(key, AngularUnit.RADIAN));
}
/**
* Returns the registered coordinate reference system, or when unavailable in the registry, create a new reference system and register
* it on-the-fly.
*
* @param crsId the {@code CrsId} for the Coordinate reference system
* @param buildCrs the function that builds a new Coordinate Reference System, if none is available in this Registry
* @return the current (existing or computed) coordinate reference system identified by the specified {@code CrsId} identifier
*/
public static CoordinateReferenceSystem computeIfAbsent(CrsId crsId, Function> buildCrs) {
return crsMap.computeIfAbsent(crsId, buildCrs);
}
/**
* Registers a {@code CoordinateReferenceSystem} in the registry.
*
* @param crs the {@code CoordinateReferenceSystem} to register
*/
public static void registerCoordinateReferenceSystem(CoordinateReferenceSystem crs) {
crsMap.put(crs.getCrsId(), crs);
}
/**
* Registers a {@code CoordinateReferenceSystem} in the registry under the specified (pseudo-)EPSG code.
*
* @param id the {@code CrsId} under which to register this CoordinateReferenceSystem
* @param crs the {@code CoordinateReferenceSystem} to register
*/
public static void registerCoordinateReferenceSystem(CrsId id, CoordinateReferenceSystem crs) {
crsMap.put(id, crs);
}
/**
* Determine if the registry contains the {@code CoordinateReferenceSystem} identified by its SRID
*
* @param epsgCode the SRID to look up
* @return true iff the registry has a corresponding {@code CoordinateReferenceSystem}
*/
public static boolean hasCoordinateReferenceSystemForEPSG(int epsgCode) {
return crsMap.containsKey(CrsId.valueOf(epsgCode));
}
/**
* Returns the Geographic Coordinate Reference System for the specified EPSG
* @param epsgCode the EPSG code for the reference system
* @return the requested system, or null when not found
* @throws RuntimeException when the system is not geographic
*/
public static Geographic2DCoordinateReferenceSystem getGeographicCoordinateReferenceSystemForEPSG(int epsgCode) {
CoordinateReferenceSystem crs = crsMap.get(CrsId.valueOf(epsgCode));
if (crs == null) return null;
if (crs.getPositionClass().equals(G2D.class)) {
return (Geographic2DCoordinateReferenceSystem) crs;
}
throw new RuntimeException(String.format("EPSG code %d doesn't refer to geographic projection system", epsgCode));
}
/**
* Returns the Projected Coordinate Reference System for the specified EPSG
* @param epsgCode the EPSG code for the reference system
* @return the requested system, or null when not found
* @throws RuntimeException when the system is not projected
*/
public static ProjectedCoordinateReferenceSystem getProjectedCoordinateReferenceSystemForEPSG(int epsgCode) {
CoordinateReferenceSystem crs = crsMap.get(CrsId.valueOf(epsgCode));
if (crs == null) return null;
if (crs.getPositionClass().equals(C2D.class)) {
return (ProjectedCoordinateReferenceSystem) crs;
}
throw new RuntimeException(String.format("EPSG code %d doesn't refer to geographic projection system", epsgCode));
}
/**
* Returns the {@code CrsId} for the specified EPSG Code.
*
* @param epsgCode the EPSG code
* @return the CrsId corresponding to the specified EPSG code, or null if
* no such system is registered.
*/
public static CrsId getCrsIdForEPSG(int epsgCode) {
CrsId crsId = CrsId.valueOf(epsgCode);
return crsMap.containsKey(crsId) ? crsId : null;
}
}