Class AppConfiguration


  • public final class AppConfiguration
    extends AbstractConfiguration<AppConfiguration>
    Configuration returned by an app indicating how it extends EDG.

    The fields are public, mutable, and nullable and there's a public nullary constructor in order to be compatible with JSON-B.

    Use the builder instead of assigning the fields directly.

    • Field Detail

      • apiVersion

        public String apiVersion
        Required string indicating the version of the API (including this configuration) the app supports.

        This version follows semantic version (https://semver.org/) conventions. It is checked to ensure major version compatibility between the proxy and an app.

        The API is versioned separately from the framework in order to adapt the API at a different pace. The framework version matches the current EDG server version.

      • baseUrl

        public String baseUrl
        Optional absolute or relative base URL. If not specified (null) it defaults to the URL used to retrieve /configuration e.g., http://localhost:8080/app-example/configuration. The base URL is used to infer other URLs in the app if they are not explicitly specified. For example, an importer "example" and a (relative) app base URL "/app-example" would have a default URL of "/app-example/importer/example". For apps deployed to the same servlet container as the EDG server, it can be useful to specify a relative baseUrl such as "/app-example". Then the baseUrl is independent of the host and port. The string can be empty.
      • id

        public String id
        Required short identifier for the application. Must follow identifier rules ([a-zA-Z_][a-zA-Z0-9_]*).
      • label

        public String label
        Required display label of the app, such as "Example app".
    • Constructor Detail

      • AppConfiguration

        public AppConfiguration()