Support nested context paths.

core/src/main/java/com/linecorp/armeria/server/AbstractContextPathServicesBuilder.java

@@ -409,4 +409,12 @@ public T and() {
     final Set<String> contextPaths() {
         return contextPaths;
     }
+
+    VirtualHostBuilder virtualHostBuilder() {
+        return this.virtualHostBuilder;
+    }
+
+    T parent() {
+        return parent;
+    }
 }

core/src/main/java/com/linecorp/armeria/server/ContextPathServicesBuilder.java

@@ -100,4 +100,12 @@ public ContextPathServicesBuilder annotatedService(
     public ContextPathAnnotatedServiceConfigSetters annotatedService() {
         return new ContextPathAnnotatedServiceConfigSetters(this);
     }
+
+    /**
+     * TBD.
+     *
+     */
+    public NestedContextPathServicesBuilder nestedContext() {
+        return new NestedContextPathServicesBuilder(parent(), virtualHostBuilder(), contextPaths());
+    }
 }

core/src/main/java/com/linecorp/armeria/server/NestedContextPathAnnotatedServiceConfigSetters.java

@@ -0,0 +1,32 @@
+/*
+ * Copyright 2024 LINE Corporation
+ *
+ * LINE Corporation licenses this file to you 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:
+ *
+ *   https://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.linecorp.armeria.server;
+
+/**
+ * TBD.
+ */
+public final class NestedContextPathAnnotatedServiceConfigSetters extends
+      AbstractContextPathAnnotatedServiceConfigSetters
+              <NestedContextPathAnnotatedServiceConfigSetters,
+                      NestedContextPathServicesBuilder> {
+    /**
+     * TBD.
+     */
+    public NestedContextPathAnnotatedServiceConfigSetters(NestedContextPathServicesBuilder builder) {
+        super(builder);
+    }
+}

core/src/main/java/com/linecorp/armeria/server/NestedContextPathDecoratingBindingBuilder.java

@@ -0,0 +1,33 @@
+/*
+ * Copyright 2024 LINE Corporation
+ *
+ * LINE Corporation licenses this file to you 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:
+ *
+ *   https://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.linecorp.armeria.server;
+
+/**
+ * TBD.
+ */
+public final class NestedContextPathDecoratingBindingBuilder
+        extends AbstractContextPathDecoratingBindingBuilder<NestedContextPathDecoratingBindingBuilder,
+        NestedContextPathServicesBuilder> {
+
+    /**
+     * TBD.
+     * @param builder TBD.
+     */
+    NestedContextPathDecoratingBindingBuilder(NestedContextPathServicesBuilder builder) {
+        super(builder);
+    }
+}

core/src/main/java/com/linecorp/armeria/server/NestedContextPathServiceBindingBuilder.java

@@ -0,0 +1,32 @@
+/*
+ * Copyright 2024 LINE Corporation
+ *
+ * LINE Corporation licenses this file to you 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:
+ *
+ *   https://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.linecorp.armeria.server;
+
+/**
+ * TBD.
+ */
+public final class NestedContextPathServiceBindingBuilder
+        extends AbstractContextPathServiceBindingBuilder<NestedContextPathServiceBindingBuilder,
+        NestedContextPathServicesBuilder> {
+
+    /**
+     * TBD.
+     */
+    public NestedContextPathServiceBindingBuilder(NestedContextPathServicesBuilder builder) {
+        super(builder);
+    }
+}

core/src/main/java/com/linecorp/armeria/server/NestedContextPathServicesBuilder.java

@@ -0,0 +1,110 @@
+/*
+ * Copyright 2024 LINE Corporation
+ *
+ * LINE Corporation licenses this file to you 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:
+ *
+ *   https://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.linecorp.armeria.server;
+
+import static java.util.Objects.requireNonNull;
+
+import java.util.HashSet;
+import java.util.Set;
+import java.util.function.Consumer;
+import java.util.function.Function;
+
+import com.linecorp.armeria.server.annotation.ExceptionHandlerFunction;
+import com.linecorp.armeria.server.annotation.RequestConverterFunction;
+import com.linecorp.armeria.server.annotation.ResponseConverterFunction;
+
+/**
+ * TBD.
+ */
+public final class NestedContextPathServicesBuilder
+        extends AbstractContextPathServicesBuilder<NestedContextPathServicesBuilder, ServerBuilder> {
+
+    /**
+     * TBD.
+     * @param parent : TBD.
+     * @param virtualHostBuilder : TBD.
+     * @param contextPaths : TBD.
+     */
+    public NestedContextPathServicesBuilder(ServerBuilder parent, VirtualHostBuilder virtualHostBuilder,
+                                            Set<String> contextPaths) {
+        super(parent, virtualHostBuilder, contextPaths);
+    }
+
+    @Override
+    public NestedContextPathServiceBindingBuilder route() {
+        return new NestedContextPathServiceBindingBuilder(this);
+    }
+
+    @Override
+    public NestedContextPathDecoratingBindingBuilder routeDecorator() {
+        return new NestedContextPathDecoratingBindingBuilder(this);
+    }
+
+    @Override
+    public NestedContextPathServicesBuilder annotatedService(
+            String pathPrefix,
+            Object service,
+            Function<? super HttpService, ? extends HttpService> decorator,
+            Iterable<? extends ExceptionHandlerFunction> exceptionHandlerFunctions,
+            Iterable<? extends RequestConverterFunction> requestConverterFunctions,
+            Iterable<? extends ResponseConverterFunction> responseConverterFunctions) {
+        requireNonNull(pathPrefix, "pathPrefix");
+        requireNonNull(service, "service");
+        requireNonNull(decorator, "decorator");
+        requireNonNull(exceptionHandlerFunctions, "exceptionHandlerFunctions");
+        requireNonNull(requestConverterFunctions, "requestConverterFunctions");
+        requireNonNull(responseConverterFunctions, "responseConverterFunctions");
+        return annotatedService().pathPrefix(pathPrefix)
+                                 .decorator(decorator)
+                                 .exceptionHandlers(exceptionHandlerFunctions)
+                                 .requestConverters(requestConverterFunctions)
+                                 .responseConverters(responseConverterFunctions)
+                                 .build(service);
+    }
+
+    @Override
+    public NestedContextPathAnnotatedServiceConfigSetters annotatedService() {
+        return new NestedContextPathAnnotatedServiceConfigSetters(this);
+    }
+
+    /**
+     * TBD.
+     * @param paths : TBD.
+     * @param context : TBD.
+     * @return : TBD.
+     */
+    public NestedContextPathServicesBuilder contextPaths(Set<String> paths,
+                                                         Consumer<NestedContextPathServicesBuilder> context) {
+        final NestedContextPathServicesBuilder child = new NestedContextPathServicesBuilder(
+                parent(),
+                virtualHostBuilder(),
+                mergedContextPaths(paths));
+        context.accept(child);
+        return this;
+    }
+
+    private Set<String> mergedContextPaths(Set<String> paths) {
+        final Set<String> mergedContextPaths = new HashSet<>();
+        for (String currentContextPath : contextPaths()) {
+            for (String childContextPath : paths) {
+                final String mergedContextPath = currentContextPath + childContextPath;
+                mergedContextPaths.add(mergedContextPath);
+            }
+        }
+        return mergedContextPaths;
+    }
+}

core/src/main/java/com/linecorp/armeria/server/NestedVirtualHostContextPathAnnotatedServiceConfigSetters.java

@@ -0,0 +1,35 @@
+/*
+ * Copyright 2024 LINE Corporation
+ *
+ * LINE Corporation licenses this file to you 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:
+ *
+ *   https://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.linecorp.armeria.server;
+
+/**
+ * TBD.
+ */
+public final class NestedVirtualHostContextPathAnnotatedServiceConfigSetters
+        extends AbstractContextPathAnnotatedServiceConfigSetters<
+        NestedVirtualHostContextPathAnnotatedServiceConfigSetters,
+        NestedVirtualHostContextPathServicesBuilder> {
+
+    /**
+     * TBD.
+     * @param builder : TBD.
+     */
+    public NestedVirtualHostContextPathAnnotatedServiceConfigSetters(
+            NestedVirtualHostContextPathServicesBuilder builder) {
+        super(builder);
+    }
+}

core/src/main/java/com/linecorp/armeria/server/NestedVirtualHostContextPathDecoratingBindingBuilder.java

@@ -0,0 +1,34 @@
+/*
+ * Copyright 2024 LINE Corporation
+ *
+ * LINE Corporation licenses this file to you 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:
+ *
+ *   https://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.linecorp.armeria.server;
+
+/**
+ * TBD.
+ */
+public final class NestedVirtualHostContextPathDecoratingBindingBuilder
+        extends AbstractContextPathDecoratingBindingBuilder<
+        NestedVirtualHostContextPathDecoratingBindingBuilder,
+        NestedVirtualHostContextPathServicesBuilder> {
+    /**
+     * TBD.
+     * @param builder TBD.
+     */
+    NestedVirtualHostContextPathDecoratingBindingBuilder(
+            NestedVirtualHostContextPathServicesBuilder builder) {
+        super(builder);
+    }
+}

core/src/main/java/com/linecorp/armeria/server/NestedVirtualHostContextPathServiceBindingBuilder.java

@@ -0,0 +1,35 @@
+/*
+ * Copyright 2024 LINE Corporation
+ *
+ * LINE Corporation licenses this file to you 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:
+ *
+ *   https://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.linecorp.armeria.server;
+
+/**
+ * TBD.
+ */
+public final class NestedVirtualHostContextPathServiceBindingBuilder
+        extends AbstractContextPathServiceBindingBuilder<
+        NestedVirtualHostContextPathServiceBindingBuilder,
+        NestedVirtualHostContextPathServicesBuilder
+        > {
+    /**
+     * TBD.
+     * @param builder TBD.
+     */
+    public NestedVirtualHostContextPathServiceBindingBuilder(
+            NestedVirtualHostContextPathServicesBuilder builder) {
+        super(builder);
+    }
+}