How geoserver/geoserver works
GeoServer is a Java geospatial server for sharing and editing spatial data through OGC and related standards. A client requests a service operation; service handlers use the catalog and configured data sources to find or retrieve geospatial resources, then return a standards-format response. The tree also shows REST catalog management and security services as distinct capabilities. Source excerpts directly show the OGC API Coverages handler delegating coverage retrieval to WCS 2.0; other service-to-catalog relationships are documented only at product level in the README, so those edges are marked accordingly.
Main entry points: Catalog.java Catalog index · CoveragesService.java OGC API Coverages · DefaultWebCoverageService20.java Web Coverage Service · CoverageController.java Coverage REST API
Components 21
OGC Services
- Web Map Service
src/wms-core/src/main/java/org/geoserver/wms/DefaultWebMapService.java - Web Feature Service
src/wfs-core/src/main/java/org/geoserver/wfs/DefaultWebFeatureService.java - Web Coverage Service
src/wcs2_0/src/main/java/org/geoserver/wcs2_0/DefaultWebCoverageService20.java - OGC API Coverages
src/community/ogcapi/ogcapi-coverages/src/main/java/org/geoserver/ogcapi/v1/coverages/CoveragesService.java - OGC API Features
src/extension/ogcapi/ogcapi-features/src/main/java/org/geoserver/ogcapi/v1/features/FeatureService.java - Catalog Service
src/extension/csw/core/src/main/java/org/geoserver/csw/DefaultWebCatalogService.java - Processing Service
src/community/wps-openai/src/main/java/org/geoserver/llm/cache/LlmCacheManager.java - Earth Observation
src/community/oseo/oseo-service/src/main/java/org/geoserver/opensearch/eo/DefaultOpenSearchEoService.java - CoverageJSON encoder
src/community/cov-json/src/main/java/org/geoserver/wcs/responses/covjson/Coverage.java
Catalog and Data
- Catalog index
src/main/src/main/java/org/geoserver/catalog/Catalog.java - Coverage metadata
src/main/src/main/java/org/geoserver/catalog/CoverageInfo.java - Layer metadata
src/main/src/main/java/org/geoserver/catalog/LayerInfo.java - Coverage store
src/main/src/main/java/org/geoserver/catalog/CoverageStoreInfo.java - Server configuration
src/main/src/main/java/org/geoserver/config/GeoServer.java
Management APIs
- Coverage REST API
src/restconfig/src/main/java/org/geoserver/rest/catalog/CoverageController.java - Coverage file API
src/restconfig/src/main/java/org/geoserver/rest/catalog/CoverageStoreFileController.java - REST framework
src/rest/src/main/java/org/geoserver/rest/RestBaseController.java
Security
- User group service
src/main/src/main/java/org/geoserver/security/GeoServerUserGroupService.java - Authorized user groups
src/main/src/main/java/org/geoserver/security/AuthorizingUserGroupService.java - Authorized roles
src/main/src/main/java/org/geoserver/security/AuthorizingRoleService.java
Other components
- Geospatial client
Connections 28
- Geospatial client → Web Map Service: requests maps
README.md - Geospatial client → Web Feature Service: requests features
README.md - Geospatial client → Web Coverage Service: requests coverages
README.md - Geospatial client → OGC API Coverages: requests coverages
README.md - Geospatial client → OGC API Features: requests features
README.md - Geospatial client → Catalog Service: searches catalog
README.md - Geospatial client → Processing Service: requests processing
README.md - Geospatial client → Earth Observation: searches products
- Web Map Service → Geospatial client: publishes maps
README.md - Web Feature Service → Geospatial client: publishes features
README.md - Web Coverage Service → Geospatial client: publishes coverages
README.md - OGC API Features → Geospatial client: publishes features
README.md - Catalog Service → Geospatial client: publishes catalog
README.md - Processing Service → Geospatial client: returns results
README.md - Earth Observation → Geospatial client: returns products
src/community/oseo/oseo-service/src/main/java/org/geoserver/opensearch/eo/DefaultOpenSearchEoService.java - OGC API Coverages → Web Coverage Service: delegates retrieval
src/community/ogcapi/ogcapi-coverages/src/main/java/org/geoserver/ogcapi/v1/coverages/CoveragesService.java - OGC API Coverages → CoverageJSON encoder: formats response
- OGC API Coverages → Catalog index: looks up catalog
src/community/ogcapi/ogcapi-coverages/src/main/java/org/geoserver/ogcapi/v1/coverages/CoveragesService.java - Coverage REST API → Catalog index: reads catalog
src/restconfig/src/main/java/org/geoserver/rest/catalog/CoverageController.java - Coverage file API → Catalog index: updates catalog
src/restconfig/src/main/java/org/geoserver/rest/catalog/CoverageStoreFileController.java - Coverage REST API → REST framework: extends framework
src/restconfig/src/main/java/org/geoserver/rest/catalog/CoverageController.java - Coverage file API → REST framework: extends framework
src/restconfig/src/main/java/org/geoserver/rest/catalog/CoverageStoreFileController.java - Catalog index → Coverage metadata: indexes coverage
src/main/src/main/java/org/geoserver/catalog/Catalog.java - Coverage metadata → Coverage store: uses store
src/main/src/main/java/org/geoserver/catalog/CoverageInfo.java - Catalog index → Layer metadata: indexes layers
src/main/src/main/java/org/geoserver/catalog/Catalog.java - Server configuration → Catalog index: holds catalog
src/main/src/main/java/org/geoserver/config/GeoServer.java - User group service → Authorized user groups: wrapped by
src/main/src/main/java/org/geoserver/security/AuthorizingUserGroupService.java - Authorized user groups → User group service: delegates operations
src/main/src/main/java/org/geoserver/security/AuthorizingUserGroupService.java