How gisaia/arlas-server works
ARLAS-server exposes REST APIs for exploring Elasticsearch-backed collections and managing collection metadata. The main workflow is a client search request, parsed and validated by REST handlers, executed through exploration services, and returned as hits or aggregations; collection metadata and field permissions shape that workflow. Separate protocol branches provide OpenSearch, STAC, CSW, and WFS capabilities, with raster-tile support as another product feature. Source excerpts establish only some runtime links; undocumented protocol-to-service wiring is omitted or marked unverified.
Main entry points: ExploreService.java Explore service · CollectionReferenceService.java Collection metadata · SearchRESTService.java Search endpoints · OGCRESTService.java OGC common
Components 20
REST exploration
- Search endpoints
arlas-rest/src/main/java/io/arlas/server/rest/explore/search/SearchRESTService.java - Geo search
arlas-rest/src/main/java/io/arlas/server/rest/explore/search/GeoSearchRESTService.java - Collection API
arlas-rest/src/main/java/io/arlas/server/rest/collections/CollectionRESTServices.java - Raster tiles
arlas-rest/src/main/java/io/arlas/server/rest/plugins/eo/TileRESTService.java
Search and metadata
- Explore service
arlas-core/src/main/java/io/arlas/server/core/services/ExploreService.java - Fluid search
arlas-core/src/main/java/io/arlas/server/core/services/FluidSearchService.java - Collection metadata
arlas-core/src/main/java/io/arlas/server/core/services/CollectionReferenceService.java - Parameter parsing
arlas-core/src/main/java/io/arlas/server/core/utils/ParamsParser.java - Request validation
arlas-core/src/main/java/io/arlas/server/core/utils/CheckParams.java - Field permissions
arlas-core/src/main/java/io/arlas/server/core/utils/ColumnFilterUtil.java
Geospatial protocols
- OpenSearch descriptors
arlas-opensearch/src/main/java/io/arlas/server/opensearch/rest/explore/OpenSearchDescriptorService.java - STAC API
stac-api/src/main/java/io/arlas/server/stac/api/StacSearchRESTService.java - CSW services
ogc-csw/src/main/java/io/arlas/server/ogc/csw/CSWRESTService.java - WFS services
ogc-wfs/src/main/java/io/arlas/server/ogc/wfs/WFSRESTService.java - OGC common
ogc-common/src/main/java/io/arlas/server/ogc/common/OGCRESTService.java
Runtime and access
- Server configuration
arlas-core/src/main/java/io/arlas/server/core/app/ArlasServerConfiguration.java - Policy enforcement
arlas-commons/src/main/java/io/arlas/filter/core/PolicyEnforcer.java - Response cache
arlas-core/src/main/java/io/arlas/server/core/utils/ResponseCacheManager.java
Other components
- API client
- Elasticsearch
Connections 22
- API client → Search endpoints: requests
- API client → Geo search: requests
- Search endpoints → Explore service: calls
arlas-rest/src/main/java/io/arlas/server/rest/explore/search/SearchRESTService.java - Geo search → Explore service: calls
arlas-rest/src/main/java/io/arlas/server/rest/explore/search/GeoSearchRESTService.java - Search endpoints → Parameter parsing: parses
arlas-rest/src/main/java/io/arlas/server/rest/explore/search/SearchRESTService.java - Search endpoints → Request validation: validates
arlas-rest/src/main/java/io/arlas/server/rest/explore/search/SearchRESTService.java - Search endpoints → Field permissions: checks fields
arlas-rest/src/main/java/io/arlas/server/rest/explore/search/SearchRESTService.java - Explore service → Collection metadata: uses metadata
arlas-core/src/main/java/io/arlas/server/core/services/ExploreService.java - Explore service → Fluid search: builds queries
arlas-core/src/main/java/io/arlas/server/core/services/ExploreService.java - Fluid search → Collection metadata: reads fields
arlas-core/src/main/java/io/arlas/server/core/services/FluidSearchService.java - Explore service → Elasticsearch: queries
- Collection API → Collection metadata: manages
- Collection metadata → Elasticsearch: reads mappings
- OpenSearch descriptors → Explore service: uses search
arlas-opensearch/src/main/java/io/arlas/server/opensearch/rest/explore/OpenSearchDescriptorService.java - STAC API → Explore service: searches
stac-api/src/main/java/io/arlas/server/stac/api/StacSearchRESTService.java - STAC API → Collection metadata: reads collections
stac-api/src/main/java/io/arlas/server/stac/api/StacSearchRESTService.java - CSW services → OGC common: uses common
ogc-csw/src/main/java/io/arlas/server/ogc/csw/CSWRESTService.java - WFS services → OGC common: uses common
ogc-wfs/src/main/java/io/arlas/server/ogc/wfs/WFSRESTService.java - OGC common → Collection metadata: accesses metadata
ogc-common/src/main/java/io/arlas/server/ogc/common/OGCRESTService.java - Raster tiles → Elasticsearch: serves imagery
- Server configuration → Policy enforcement: configures
- Explore service → Response cache: caches responses
arlas-core/src/main/java/io/arlas/server/core/services/ExploreService.java