swagger: Document schema in TmfConfigurationSourceType

Signed-off-by: Bernd Hufmann <[email protected]>

trace-server/org.eclipse.tracecompass.incubator.trace.server.jersey.rest.core/src/org/eclipse/tracecompass/incubator/internal/trace/server/jersey/rest/core/model/ConfigurationSourceType.java

@@ -46,6 +46,25 @@ public interface ConfigurationSourceType {
      *          configuration instance of this type. Use 'path' key for file
      *          URIs.
      */
-    @Schema(description = "A list of configuration parameter descriptors to be passed when creating or updating a configuration instance of this type.")
+    @Schema(description = "A list of configuration parameter descriptors to be "
+            + "passed when creating or updating a configuration instance of this "
+            + "type. Use this instead of schema. Omit if not used.")
     List<ConfigurationParameterDescriptor> getParameterDescriptors();
+
+    /**
+     * @return a JSON schema that describes the parameters that the front-end
+     *         needs to provide with corresponding values. Use this for complex
+     *         parameter descriptions instead of parameterDescriptors.
+     */
+    @Schema(description = "A JSON object that describes a schema for parameters that "
+            + "the front-end needs to provide with corresponding values. "
+            + "Use this for complex parameter descriptions instead of parameterDescriptors. "
+            + "Omit if not used.")
+    OptionalSchema getSchema();
+
+    /**
+     * A JSON Object defining a schema.
+     */
+    interface OptionalSchema {
+    }
 }