Add topLevel validation for @MCElement annotations and update license headers. (#2491)

Author: christiangoerdes

annot/src/main/java/com/predic8/membrane/annot/SpringConfigurationXSDGeneratingAnnotationProcessor.java

@@ -215,6 +215,9 @@ public boolean process(Set<? extends TypeElement> annotations, RoundEnvironment
 
                     scan(main, ii);
 
+                    if (ii.getAnnotation().component() && ii.getAnnotation().topLevel())
+                        throw new ProcessingException("@MCElement(topLevel=true) cannot be a component.", ii.getElement());
+
                     if (ii.getAnnotation().component())
                         main.getComponents().put(ii.getAnnotation().name(), ii);
 

annot/src/main/java/com/predic8/membrane/annot/generator/ComponentClassGenerator.java

@@ -36,7 +36,7 @@ protected String getClassImpl() {
                 
                 import java.util.Map;
                 
-                @MCElement(name = "components", topLevel = true)
+                @MCElement(name = "components", topLevel = true, component=false)
                 public class Components {
                 
                     Map<String, Object> components;

annot/src/main/java/com/predic8/membrane/annot/generator/kubernetes/Grammar.java

@@ -146,7 +146,7 @@ private String assembleElementMapping(MainInfo main) {
         return concat(
                 // global
                 main.getIis().stream()
-                        .filter(ei -> ei.getAnnotation().component())
+                        .filter(ei -> ei.getAnnotation().component() || ei.getAnnotation().topLevel())
                         .map(generateElementMappingString()),
                 // non-global
                 main.getIis().stream()

core/src/main/java/com/predic8/membrane/core/ExitException.java

@@ -1,3 +1,17 @@
+/* Copyright 2025 predic8 GmbH, www.predic8.com
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License. */
+
 package com.predic8.membrane.core;
 
 /**

core/src/main/java/com/predic8/membrane/core/interceptor/lang/SetBodyInterceptor.java

@@ -1,3 +1,17 @@
+/* Copyright 2025 predic8 GmbH, www.predic8.com
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License. */
+
 package com.predic8.membrane.core.interceptor.lang;
 
 import com.predic8.membrane.annot.*;

core/src/main/java/com/predic8/membrane/core/lang/spel/DollarTemplateParserContext.java

@@ -1,3 +1,17 @@
+/* Copyright 2025 predic8 GmbH, www.predic8.com
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License. */
+
 package com.predic8.membrane.core.lang.spel;
 
 import org.springframework.expression.common.*;

core/src/main/java/com/predic8/membrane/core/openapi/serviceproxy/APIProxy.java

@@ -44,7 +44,7 @@
  * @description The api proxy extends the serviceProxy with API related functions like OpenAPI support and path parameters.
  * @topic 1. Proxies and Flow
  */
-@MCElement(name = "api", topLevel = true)
+@MCElement(name = "api", topLevel = true, component = false)
 public class APIProxy extends ServiceProxy implements Polyglot, XMLSupport {
 
     private static final Logger log = LoggerFactory.getLogger(APIProxy.class.getName());

core/src/main/java/com/predic8/membrane/core/router/hotdeploy/DefaultHotDeployer.java

@@ -1,3 +1,17 @@
+/* Copyright 2025 predic8 GmbH, www.predic8.com
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License. */
+
 package com.predic8.membrane.core.router.hotdeploy;
 
 import com.predic8.membrane.core.*;

core/src/main/java/com/predic8/membrane/core/router/hotdeploy/HotDeployer.java

@@ -1,3 +1,17 @@
+/* Copyright 2025 predic8 GmbH, www.predic8.com
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License. */
+
 package com.predic8.membrane.core.router.hotdeploy;
 
 import com.predic8.membrane.core.*;

core/src/main/java/com/predic8/membrane/core/router/hotdeploy/NullHotDeployer.java

@@ -1,3 +1,17 @@
+/* Copyright 2025 predic8 GmbH, www.predic8.com
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License. */
+
 package com.predic8.membrane.core.router.hotdeploy;
 
 public class NullHotDeployer implements HotDeployer {