CSSTUDIO-3392 Introduce separate syntax for aliasing.

Author: abrahamwolk

app/display/model/src/main/java/org/csstudio/display/builder/model/persist/NamedWidgetColors.java

@@ -138,7 +138,7 @@ void define(final NamedWidgetColor color)
      *  @param name Name of the color
      *  @param color Named color
      */
-    void define(String name, final NamedWidgetColor color)
+    void defineAlias(String name, final NamedWidgetColor color)
     {
         colors.put(name, color);
     }
@@ -152,6 +152,46 @@ public Optional<NamedWidgetColor> getColor(final String name)
         return Optional.ofNullable(colors.get(name));
     }
 
+    sealed interface ColorDefinition permits RGBA, FromNamedWidgetColor, Alias {}
+    private record RGBA (int red, int green, int blue, int alpha) implements ColorDefinition { }
+    private record FromNamedWidgetColor(NamedWidgetColor namedWidgetColor) implements ColorDefinition { };
+    private record Alias (NamedWidgetColor color) implements ColorDefinition { };
+
+    /** Parse the color definition
+     *  @param colorDefinitionString Color definition
+     *  @return Optionally (when successful), an instance of ColorDefinition representing the result of parsing
+     */
+    public Optional<ColorDefinition> parseColorDefinition(final String colorDefinitionString)
+    {
+        String colorDefinitionStringTrimmed = colorDefinitionString.trim();
+        if (colorDefinitionStringTrimmed.startsWith("alias(")) {
+            if (colorDefinitionStringTrimmed.endsWith(")")) {
+                String colorName = colorDefinitionStringTrimmed.substring(6,colorDefinitionStringTrimmed.length()-1).trim();
+                NamedWidgetColor color = colors.get(colorName);
+                return Optional.of(new Alias(color));
+            }
+            else {
+                return Optional.empty();
+            }
+        }
+        else if (colors.containsKey(colorDefinitionStringTrimmed)) {
+            NamedWidgetColor color = colors.get(colorDefinitionStringTrimmed);
+            return Optional.of(new FromNamedWidgetColor(color));
+        }
+        else {
+            final StringTokenizer tokenizer = new StringTokenizer(colorDefinitionString, ",");
+            try {
+                final int red = Integer.parseInt(tokenizer.nextToken().trim());
+                final int green = Integer.parseInt(tokenizer.nextToken().trim());
+                final int blue = Integer.parseInt(tokenizer.nextToken().trim());
+                final int alpha = tokenizer.hasMoreTokens() ? Integer.parseInt(tokenizer.nextToken().trim()) : 255;
+                return Optional.of(new RGBA(red, green, blue, alpha));
+            } catch (Throwable throwable) {
+                return Optional.empty();
+            }
+        }
+    }
+
     /** Resolve a named color
      *  @param color Predefined color
      *  @return Color as provided unless it was redefined
@@ -171,30 +211,21 @@ public Collection<NamedWidgetColor> getColors()
 
     @Override
     protected void parse ( final String name, final String value ) throws Exception {
+        Optional<ColorDefinition> optionalColorDefinition = parseColorDefinition(value);
 
-        Optional<NamedWidgetColor> optionalColor = getColor(value);
-
-        if ( optionalColor.isPresent() ) {
-
-            NamedWidgetColor namedColor = optionalColor.get();
-
-            define(name, namedColor);
-
+        if (optionalColorDefinition.isEmpty()) {
+            throw new Exception("Cannot parse color '" + name + "' from '" + value + "'");
         } else {
-
-            final StringTokenizer tokenizer = new StringTokenizer(value, ",");
-
-            try {
-
-                final int red = Integer.parseInt(tokenizer.nextToken().trim());
-                final int green = Integer.parseInt(tokenizer.nextToken().trim());
-                final int blue = Integer.parseInt(tokenizer.nextToken().trim());
-                final int alpha = tokenizer.hasMoreTokens() ? Integer.parseInt(tokenizer.nextToken().trim()) : 255;
-
-                define(new NamedWidgetColor(name, red, green, blue, alpha));
-
-            } catch ( Throwable ex ) {
-                throw new Exception("Cannot parse color '" + name + "' from '" + value + "'", ex);
+            ColorDefinition colorDefinition = optionalColorDefinition.get();
+            if (colorDefinition instanceof RGBA rgba) {
+                define(new NamedWidgetColor(name, rgba.red, rgba.green, rgba.blue, rgba.alpha));
+            } else if (colorDefinition instanceof FromNamedWidgetColor fromNamedWidgetColor) {
+                NamedWidgetColor namedWidgetColor = fromNamedWidgetColor.namedWidgetColor;
+                define(new NamedWidgetColor(name, namedWidgetColor.getRed(), namedWidgetColor.getGreen(), namedWidgetColor.getBlue(), namedWidgetColor.getAlpha()));
+            } else if (colorDefinition instanceof Alias alias) {
+                defineAlias(name, alias.color);
+            } else {
+                throw new Exception("Unhandled case: " + colorDefinition.toString()); // This should never happen.
             }
 
         }