├── .gitignore
├── buildSrc
    ├── build.gradle.kts
    └── src
    │   └── main
    │       └── kotlin
    │           ├── Sockets.java-application-conventions.gradle.kts
    │           ├── Sockets.java-common-conventions.gradle.kts
    │           └── Sockets.java-library-conventions.gradle.kts
├── functional-server-app
    ├── build.gradle.kts
    └── src
    │   └── main
    │       └── java
    │           └── app
    │               └── App.java
├── functional-server-library
    ├── build.gradle.kts
    └── src
    │   └── main
    │       └── java
    │           └── Sockets
    │               ├── Server.java
    │               ├── contract
    │                   ├── HttpMethod.java
    │                   └── RequestRunner.java
    │               ├── http
    │                   ├── HttpDecoder.java
    │                   └── HttpHandler.java
    │               ├── pojos
    │                   ├── HttpRequest.java
    │                   ├── HttpResponse.java
    │                   └── HttpStatusCode.java
    │               └── writers
    │                   └── ResponseWriter.java
├── gradlew
└── settings.gradle.kts


/.gitignore:
--------------------------------------------------------------------------------
1 | # Ignore Gradle project-specific cache directory
2 | .gradle
3 | 
4 | # Ignore Gradle build output directory
5 | build
6 | .idea/gradle.xml
7 | */build
8 | 


--------------------------------------------------------------------------------
/buildSrc/build.gradle.kts:
--------------------------------------------------------------------------------
 1 | /*
 2 |  * This file was generated by the Gradle 'init' task.
 3 |  *
 4 |  * This project uses @Incubating APIs which are subject to change.
 5 |  */
 6 | 
 7 | plugins {
 8 |     // Support convention plugins written in Kotlin. Convention plugins are build scripts in 'src/main' that automatically become available as plugins in the main build.
 9 |     `kotlin-dsl`
10 | }
11 | 
12 | repositories {
13 |     // Use the plugin portal to apply community plugins in convention plugins.
14 |     gradlePluginPortal()
15 | }
16 | 


--------------------------------------------------------------------------------
/buildSrc/src/main/kotlin/Sockets.java-application-conventions.gradle.kts:
--------------------------------------------------------------------------------
1 | plugins {
2 |     // Apply the common convention plugin for shared build configuration between library and application projects.
3 |     id("Sockets.java-common-conventions")
4 | 
5 |     // Apply the application plugin to add support for building a CLI application in Java.
6 |     application
7 | }
8 | 


--------------------------------------------------------------------------------
/buildSrc/src/main/kotlin/Sockets.java-common-conventions.gradle.kts:
--------------------------------------------------------------------------------
 1 | plugins {
 2 |     // Apply the java Plugin to add support for Java.
 3 |     java
 4 | }
 5 | 
 6 | repositories {
 7 |     mavenCentral()
 8 | }
 9 | 
10 | testing {
11 |     suites {
12 |         // Configure the built-in test suite
13 |         val test by getting(JvmTestSuite::class) {
14 |             // Use JUnit Jupiter test framework
15 |             useJUnitJupiter("5.7.2")
16 |         }
17 |     }
18 | }
19 | 


--------------------------------------------------------------------------------
/buildSrc/src/main/kotlin/Sockets.java-library-conventions.gradle.kts:
--------------------------------------------------------------------------------
 1 | /*
 2 |  * This file was generated by the Gradle 'init' task.
 3 |  *
 4 |  * This project uses @Incubating APIs which are subject to change.
 5 |  */
 6 | 
 7 | plugins {
 8 |     // Apply the common convention plugin for shared build configuration between library and application projects.
 9 |     id("Sockets.java-common-conventions")
10 | 
11 |     // Apply the java-library plugin for API and implementation separation.
12 |     `java-library`
13 | }
14 | 


--------------------------------------------------------------------------------
/functional-server-app/build.gradle.kts:
--------------------------------------------------------------------------------
 1 | plugins {
 2 |     id("Sockets.java-application-conventions")
 3 | }
 4 | 
 5 | dependencies {
 6 |     implementation(project(":functional-server-library"))
 7 |     implementation("org.apache.httpcomponents:httpclient:4.5.13")
 8 | }
 9 | 
10 | application {
11 |     // Define the main class for the application.
12 |     mainClass.set("app.App")
13 | }
14 | 


--------------------------------------------------------------------------------
/functional-server-app/src/main/java/app/App.java:
--------------------------------------------------------------------------------
 1 | package app;
 2 | 
 3 | import Sockets.Server;
 4 | import Sockets.pojos.HttpResponse;
 5 | import java.io.IOException;
 6 | 
 7 | import static Sockets.contract.HttpMethod.GET;
 8 | 
 9 | /**
10 |  * Test functional server library.
11 |  */
12 | public class App {
13 |     public static void main(String[] args) throws IOException {
14 |         Server myServer = new Server(8080);
15 |         myServer.addRoute(GET, "/testOne",
16 |                 (req) -> new HttpResponse.Builder()
17 |                         .setStatusCode(200)
18 |                         .addHeader("Content-Type", "text/html")
19 |                         .setEntity("<HTML> <P> Hello There... </P> </HTML>")
20 |                         .build());
21 |         myServer.start();
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/functional-server-library/build.gradle.kts:
--------------------------------------------------------------------------------
1 | plugins {
2 |     id("Sockets.java-library-conventions")
3 | }
4 | 


--------------------------------------------------------------------------------
/functional-server-library/src/main/java/Sockets/Server.java:
--------------------------------------------------------------------------------
 1 | package Sockets;
 2 | 
 3 | import Sockets.contract.HttpMethod;
 4 | import Sockets.contract.RequestRunner;
 5 | import Sockets.http.HttpHandler;
 6 | 
 7 | import java.io.IOException;
 8 | import java.net.ServerSocket;
 9 | import java.net.Socket;
10 | import java.util.HashMap;
11 | import java.util.Map;
12 | import java.util.concurrent.Executor;
13 | import java.util.concurrent.Executors;
14 | 
15 | /*
16 |  * Simple Server: accepts HTTP connections and responds using
17 |  * the Java net socket library.
18 |  *  - Blocking approach ( 1 request per thread )
19 |  *  - Non-blocking ( Investigate Java NIO - new IO, Netty uses this? )
20 |  */
21 | public class Server {
22 | 
23 |     private final Map<String, RequestRunner> routes;
24 |     private final ServerSocket socket;
25 |     private final Executor threadPool;
26 |     private HttpHandler handler;
27 | 
28 |     public Server(int port) throws IOException {
29 |         routes = new HashMap<>();
30 |         threadPool = Executors.newFixedThreadPool(100);
31 |         socket = new ServerSocket(port);
32 |     }
33 | 
34 |     public void start() throws IOException {
35 |         handler = new HttpHandler(routes);
36 | 
37 |         while (true) {
38 |             Socket clientConnection = socket.accept();
39 |             handleConnection(clientConnection);
40 |         }
41 |     }
42 | 
43 |     /*
44 |      * Capture each Request / Response lifecycle in a thread
45 |      * executed on the threadPool.
46 |      */
47 |     private void handleConnection(Socket clientConnection) {
48 |         Runnable httpRequestRunner = () -> {
49 |             try {
50 |                 handler.handleConnection(clientConnection.getInputStream(), clientConnection.getOutputStream());
51 |             } catch (IOException ignored) {
52 |             }
53 |         };
54 |         threadPool.execute(httpRequestRunner);
55 |     }
56 | 
57 |     public void addRoute(final HttpMethod opCode, final String route, final RequestRunner runner) {
58 |         routes.put(opCode.name().concat(route), runner);
59 |     }
60 | }


--------------------------------------------------------------------------------
/functional-server-library/src/main/java/Sockets/contract/HttpMethod.java:
--------------------------------------------------------------------------------
1 | package Sockets.contract;
2 | 
3 | public enum HttpMethod {
4 |     GET,
5 |     PUT,
6 |     POST,
7 |     PATCH
8 | }
9 | 


--------------------------------------------------------------------------------
/functional-server-library/src/main/java/Sockets/contract/RequestRunner.java:
--------------------------------------------------------------------------------
1 | package Sockets.contract;
2 | 
3 | import Sockets.pojos.HttpRequest;
4 | import Sockets.pojos.HttpResponse;
5 | 
6 | public interface RequestRunner {
7 |     HttpResponse run(HttpRequest request);
8 | }
9 | 


--------------------------------------------------------------------------------
/functional-server-library/src/main/java/Sockets/http/HttpDecoder.java:
--------------------------------------------------------------------------------
  1 | package Sockets.http;
  2 | 
  3 | import Sockets.contract.HttpMethod;
  4 | import Sockets.pojos.HttpRequest;
  5 | import Sockets.pojos.HttpRequest.Builder;
  6 | 
  7 | import java.io.InputStream;
  8 | import java.io.InputStreamReader;
  9 | import java.net.URI;
 10 | import java.net.URISyntaxException;
 11 | import java.util.*;
 12 | 
 13 | /**
 14 |  * HttpDecoder:
 15 |  *          InputStreamReader -> bytes to characters ( decoded with certain Charset ( ascii ) )
 16 |  *          BufferedReader    -> character stream to text
 17 |  */
 18 | public class HttpDecoder {
 19 |     public static Optional<HttpRequest> decode(final InputStream inputStream) {
 20 |         return readMessage(inputStream).flatMap(HttpDecoder::buildRequest);
 21 |     }
 22 | 
 23 |     private static Optional<HttpRequest> buildRequest(List<String> message) {
 24 |         if (message.isEmpty()) {
 25 |             return Optional.empty();
 26 |         }
 27 | 
 28 |         String firstLine = message.get(0);
 29 |         String[] httpInfo = firstLine.split(" ");
 30 | 
 31 |         if (httpInfo.length != 3) {
 32 |             return Optional.empty();
 33 |         }
 34 | 
 35 |         String protocolVersion = httpInfo[2];
 36 |         if (!protocolVersion.equals("HTTP/1.1")) {
 37 |             return Optional.empty();
 38 |         }
 39 | 
 40 |         try {
 41 |             Builder requestBuilder = new Builder();
 42 |             requestBuilder.setHttpMethod(HttpMethod.valueOf(httpInfo[0]));
 43 |             requestBuilder.setUri(new URI(httpInfo[1]));
 44 |             return Optional.of(addRequestHeaders(message, requestBuilder));
 45 |         } catch (URISyntaxException | IllegalArgumentException e) {
 46 |             return Optional.empty();
 47 |         }
 48 |     }
 49 |     private static Optional<List<String>> readMessage(final InputStream inputStream) {
 50 |         try {
 51 |             if (!(inputStream.available() > 0)) {
 52 |                 return Optional.empty();
 53 |             }
 54 | 
 55 |             final char[] inBuffer = new char[inputStream.available()];
 56 |             final InputStreamReader inReader = new InputStreamReader(inputStream);
 57 |             final int read = inReader.read(inBuffer);
 58 | 
 59 |             List<String> message = new ArrayList<>();
 60 | 
 61 |             try (Scanner sc = new Scanner(new String(inBuffer))) {
 62 |                 while (sc.hasNextLine()) {
 63 |                     String line = sc.nextLine();
 64 |                     message.add(line);
 65 |                 }
 66 |             }
 67 | 
 68 |             return Optional.of(message);
 69 |         } catch (Exception ignored) {
 70 |             return Optional.empty();
 71 |         }
 72 |     }
 73 | 
 74 |     private static HttpRequest addRequestHeaders(final List<String> message, final Builder builder) {
 75 |         final Map<String, List<String>> requestHeaders = new HashMap<>();
 76 | 
 77 |         if (message.size() > 1) {
 78 |             for (int i = 1; i < message.size(); i++) {
 79 |                 String header = message.get(i);
 80 |                 int colonIndex = header.indexOf(':');
 81 | 
 82 |                 if (! (colonIndex > 0 && header.length() > colonIndex + 1)) {
 83 |                     break;
 84 |                 }
 85 | 
 86 |                 String headerName = header.substring(0, colonIndex);
 87 |                 String headerValue = header.substring(colonIndex + 1);
 88 | 
 89 |                 requestHeaders.compute(headerName, (key, values) -> {
 90 |                     if (values != null) {
 91 |                         values.add(headerValue);
 92 |                     } else {
 93 |                         values = new ArrayList<>();
 94 |                     }
 95 |                     return values;
 96 |                 });
 97 |             }
 98 |         }
 99 | 
100 |         builder.setRequestHeaders(requestHeaders);
101 |         return builder.build();
102 |     }
103 | }
104 | 


--------------------------------------------------------------------------------
/functional-server-library/src/main/java/Sockets/http/HttpHandler.java:
--------------------------------------------------------------------------------
 1 | package Sockets.http;
 2 | 
 3 | import Sockets.contract.RequestRunner;
 4 | import Sockets.pojos.HttpRequest;
 5 | import Sockets.pojos.HttpResponse;
 6 | import Sockets.writers.ResponseWriter;
 7 | 
 8 | import java.io.*;
 9 | import java.util.Map;
10 | import java.util.Optional;
11 | 
12 | /**
13 |  * Handle HTTP Request Response lifecycle.
14 |  */
15 | public class HttpHandler {
16 | 
17 |     private final Map<String, RequestRunner> routes;
18 | 
19 |     public HttpHandler(final Map<String, RequestRunner> routes) {
20 |         this.routes = routes;
21 |     }
22 |     public void handleConnection(final InputStream inputStream, final OutputStream outputStream) throws IOException {
23 |         final BufferedWriter bufferedWriter = new BufferedWriter(new OutputStreamWriter(outputStream));
24 | 
25 |         Optional<HttpRequest> request = HttpDecoder.decode(inputStream);
26 |         request.ifPresentOrElse((r) -> handleRequest(r, bufferedWriter), () -> handleInvalidRequest(bufferedWriter));
27 | 
28 |         bufferedWriter.close();
29 |         inputStream.close();
30 |     }
31 |     private void handleInvalidRequest(final BufferedWriter bufferedWriter) {
32 |         HttpResponse notFoundResponse = new HttpResponse.Builder().setStatusCode(400).setEntity("Invalid Request...").build();
33 |         ResponseWriter.writeResponse(bufferedWriter, notFoundResponse);
34 |     }
35 | 
36 |     private void handleRequest(final HttpRequest request, final BufferedWriter bufferedWriter) {
37 |         final String routeKey = request.getHttpMethod().name().concat(request.getUri().getRawPath());
38 | 
39 |         if (routes.containsKey(routeKey)) {
40 |             ResponseWriter.writeResponse(bufferedWriter, routes.get(routeKey).run(request));
41 |         } else {
42 |             // Not found
43 |             ResponseWriter.writeResponse(bufferedWriter, new HttpResponse.Builder().setStatusCode(404).setEntity("Route Not Found...").build());
44 |         }
45 |     }
46 | }
47 | 


--------------------------------------------------------------------------------
/functional-server-library/src/main/java/Sockets/pojos/HttpRequest.java:
--------------------------------------------------------------------------------
 1 | package Sockets.pojos;
 2 | 
 3 | import Sockets.contract.HttpMethod;
 4 | 
 5 | import java.net.URI;
 6 | import java.util.List;
 7 | import java.util.Map;
 8 | 
 9 | public class HttpRequest {
10 |     private final HttpMethod httpMethod;
11 |     private final URI uri;
12 |     private final Map<String, List<String>> requestHeaders;
13 |     private HttpRequest(HttpMethod opCode,
14 |                        URI uri,
15 |                        Map<String, List<String>> requestHeaders)
16 |     {
17 |         this.httpMethod = opCode;
18 |         this.uri = uri;
19 |         this.requestHeaders = requestHeaders;
20 |     }
21 | 
22 |     public URI getUri() {
23 |         return uri;
24 |     }
25 | 
26 |     public HttpMethod getHttpMethod() {
27 |         return httpMethod;
28 |     }
29 | 
30 |     public Map<String, List<String>> getRequestHeaders() {
31 |         return requestHeaders;
32 |     }
33 | 
34 |     public static class Builder {
35 |         private HttpMethod httpMethod;
36 |         private URI uri;
37 |         private Map<String, List<String>> requestHeaders;
38 | 
39 |        public Builder() {
40 |        }
41 | 
42 |        public void setHttpMethod(HttpMethod httpMethod) {
43 |            this.httpMethod = httpMethod;
44 |        }
45 | 
46 |        public void setUri(URI uri) {
47 |            this.uri = uri;
48 |        }
49 | 
50 |        public void setRequestHeaders(Map<String, List<String>> requestHeaders) {
51 |            this.requestHeaders = requestHeaders;
52 |        }
53 | 
54 |        public HttpRequest build() {
55 |            return new HttpRequest(httpMethod, uri, requestHeaders);
56 |        }
57 |     }
58 | }
59 | 


--------------------------------------------------------------------------------
/functional-server-library/src/main/java/Sockets/pojos/HttpResponse.java:
--------------------------------------------------------------------------------
 1 | package Sockets.pojos;
 2 | 
 3 | import java.time.ZoneOffset;
 4 | import java.time.ZonedDateTime;
 5 | import java.time.format.DateTimeFormatter;
 6 | import java.util.HashMap;
 7 | import java.util.List;
 8 | import java.util.Map;
 9 | import java.util.Optional;
10 | 
11 | public class HttpResponse {
12 |     private final Map<String, List<String>> responseHeaders;
13 |     private final int statusCode;
14 | 
15 |     private final Optional<Object> entity;
16 | 
17 |     /**
18 |      * Headers should contain the following:
19 |      * Date: < date >
20 |      * Server: < my server >
21 |      * Content-Type: text/plain, application/json etc...
22 |      * Content-Length: size of payload
23 |      */
24 |     private HttpResponse(final Map<String, List<String>> responseHeaders, final int statusCode, final Optional<Object> entity) {
25 |         this.responseHeaders = responseHeaders;
26 |         this.statusCode = statusCode;
27 |         this.entity = entity;
28 |     }
29 |     public Map<String, List<String>> getResponseHeaders() {
30 |         return responseHeaders;
31 |     }
32 |     public int getStatusCode() {
33 |         return statusCode;
34 |     }
35 | 
36 |     public Optional<Object> getEntity() {
37 |         return entity;
38 |     }
39 | 
40 |     public static class Builder {
41 |         private final Map<String, List<String>> responseHeaders;
42 |         private int statusCode;
43 | 
44 |         private Optional<Object> entity;
45 | 
46 |         public Builder() {
47 |             // Create default headers - server etc
48 |             responseHeaders = new HashMap<>();
49 |             responseHeaders.put("Server", List.of("MyServer"));
50 |             responseHeaders.put("Date", List.of(DateTimeFormatter.RFC_1123_DATE_TIME.format(ZonedDateTime.now(ZoneOffset.UTC))));
51 | 
52 |             entity = Optional.empty();
53 |         }
54 | 
55 |         public Builder setStatusCode(final int statusCode) {
56 |             this.statusCode = statusCode;
57 |             return this;
58 |         }
59 | 
60 |         public Builder addHeader(final String name, final String value) {
61 |             responseHeaders.put(name, List.of(value));
62 |             return this;
63 |         }
64 | 
65 |         public Builder setEntity(final Object entity) {
66 |             if (entity != null) {
67 |                 this.entity = Optional.of(entity);
68 |             }
69 |             return this;
70 |         }
71 | 
72 |         public HttpResponse build() {
73 |             return new HttpResponse(responseHeaders, statusCode, entity);
74 |         }
75 |     }
76 | }
77 | 


--------------------------------------------------------------------------------
/functional-server-library/src/main/java/Sockets/pojos/HttpStatusCode.java:
--------------------------------------------------------------------------------
 1 | package Sockets.pojos;
 2 | 
 3 | import java.util.Map;
 4 | 
 5 | /**
 6 |  * Map of status code values and meanings.
 7 |  */
 8 | public class HttpStatusCode {
 9 | 
10 |     public static final Map<Integer, String> STATUS_CODES = Map.of(
11 |         200, "OK",
12 |         400, "BAD_REQUEST",
13 |         404, "NOT_FOUND",
14 |         500, "INTERNAL_SERVER_ERROR"
15 |     );
16 | }
17 | 


--------------------------------------------------------------------------------
/functional-server-library/src/main/java/Sockets/writers/ResponseWriter.java:
--------------------------------------------------------------------------------
 1 | package Sockets.writers;
 2 | 
 3 | import Sockets.pojos.HttpResponse;
 4 | import Sockets.pojos.HttpStatusCode;
 5 | 
 6 | import java.io.BufferedWriter;
 7 | import java.nio.charset.StandardCharsets;
 8 | import java.util.ArrayList;
 9 | import java.util.List;
10 | import java.util.Map;
11 | import java.util.Optional;
12 | 
13 | /**
14 |  * Class used for writing a HTTPResponse objects to the outputstream.
15 |  * This will write responses as 'text/plain'.
16 |  */
17 | public class ResponseWriter {
18 | 
19 |     /**
20 |      * Write a HTTPResponse to an outputstream
21 |      * @param outputStream - the outputstream
22 |      * @param response - the HTTPResponse
23 |      */
24 |     public static void writeResponse(final BufferedWriter outputStream, final HttpResponse response) {
25 |         try {
26 |             final int statusCode = response.getStatusCode();
27 |             final String statusCodeMeaning = HttpStatusCode.STATUS_CODES.get(statusCode);
28 |             final List<String> responseHeaders = buildHeaderStrings(response.getResponseHeaders());
29 | 
30 |             outputStream.write("HTTP/1.1 " + statusCode + " " + statusCodeMeaning + "\r\n");
31 | 
32 |             for (String header : responseHeaders) {
33 |                 outputStream.write(header);
34 |             }
35 | 
36 |             final Optional<String> entityString = response.getEntity().flatMap(ResponseWriter::getResponseString);
37 |             if (entityString.isPresent()) {
38 |                 final String encodedString = new String(entityString.get().getBytes(StandardCharsets.UTF_8), StandardCharsets.UTF_8);
39 |                 outputStream.write("Content-Length: " + encodedString.getBytes().length + "\r\n");
40 |                 outputStream.write("\r\n");
41 |                 outputStream.write(encodedString);
42 |             } else {
43 |                 outputStream.write("\r\n");
44 |             }
45 |         } catch (Exception ignored) {
46 | 
47 |         }
48 |     }
49 | 
50 |     private static List<String> buildHeaderStrings(final Map<String, List<String>> responseHeaders) {
51 |         final List<String> responseHeadersList = new ArrayList<>();
52 | 
53 |         responseHeaders.forEach((name, values) -> {
54 |             final StringBuilder valuesCombined = new StringBuilder();
55 |             values.forEach(valuesCombined::append);
56 |             valuesCombined.append(";");
57 | 
58 |             responseHeadersList.add(name + ": " + valuesCombined + "\r\n");
59 |         });
60 | 
61 |         return responseHeadersList;
62 |     }
63 | 
64 |     private static Optional<String> getResponseString(final Object entity) {
65 |         // Currently only supporting Strings
66 |         if (entity instanceof String) {
67 |             try {
68 |                 return Optional.of(entity.toString());
69 |             } catch (Exception ignored) {
70 |             }
71 |         }
72 |         return Optional.empty();
73 |     }
74 | }
75 | 


--------------------------------------------------------------------------------
/gradlew:
--------------------------------------------------------------------------------
  1 | #!/bin/sh
  2 | 
  3 | #
  4 | # Copyright © 2015-2021 the original authors.
  5 | #
  6 | # Licensed under the Apache License, Version 2.0 (the "License");
  7 | # you may not use this file except in compliance with the License.
  8 | # You may obtain a copy of the License at
  9 | #
 10 | #      https://www.apache.org/licenses/LICENSE-2.0
 11 | #
 12 | # Unless required by applicable law or agreed to in writing, software
 13 | # distributed under the License is distributed on an "AS IS" BASIS,
 14 | # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 15 | # See the License for the specific language governing permissions and
 16 | # limitations under the License.
 17 | #
 18 | 
 19 | ##############################################################################
 20 | #
 21 | #   Gradle start up script for POSIX generated by Gradle.
 22 | #
 23 | #   Important for running:
 24 | #
 25 | #   (1) You need a POSIX-compliant shell to run this script. If your /bin/sh is
 26 | #       noncompliant, but you have some other compliant shell such as ksh or
 27 | #       bash, then to run this script, type that shell name before the whole
 28 | #       command line, like:
 29 | #
 30 | #           ksh Gradle
 31 | #
 32 | #       Busybox and similar reduced shells will NOT work, because this script
 33 | #       requires all of these POSIX shell features:
 34 | #         * functions;
 35 | #         * expansions «$var», «${var}», «${var:-default}», «${var+SET}»,
 36 | #           «${var#prefix}», «${var%suffix}», and «$( cmd )»;
 37 | #         * compound commands having a testable exit status, especially «case»;
 38 | #         * various built-in commands including «command», «set», and «ulimit».
 39 | #
 40 | #   Important for patching:
 41 | #
 42 | #   (2) This script targets any POSIX shell, so it avoids extensions provided
 43 | #       by Bash, Ksh, etc; in particular arrays are avoided.
 44 | #
 45 | #       The "traditional" practice of packing multiple parameters into a
 46 | #       space-separated string is a well documented source of bugs and security
 47 | #       problems, so this is (mostly) avoided, by progressively accumulating
 48 | #       options in "$@", and eventually passing that to Java.
 49 | #
 50 | #       Where the inherited environment variables (DEFAULT_JVM_OPTS, JAVA_OPTS,
 51 | #       and GRADLE_OPTS) rely on word-splitting, this is performed explicitly;
 52 | #       see the in-line comments for details.
 53 | #
 54 | #       There are tweaks for specific operating systems such as AIX, CygWin,
 55 | #       Darwin, MinGW, and NonStop.
 56 | #
 57 | #   (3) This script is generated from the Groovy template
 58 | #       https://github.com/gradle/gradle/blob/master/subprojects/plugins/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt
 59 | #       within the Gradle project.
 60 | #
 61 | #       You can find Gradle at https://github.com/gradle/gradle/.
 62 | #
 63 | ##############################################################################
 64 | 
 65 | # Attempt to set APP_HOME
 66 | 
 67 | # Resolve links: $0 may be a link
 68 | app_path=$0
 69 | 
 70 | # Need this for daisy-chained symlinks.
 71 | while
 72 |     APP_HOME=${app_path%"${app_path##*/}"}  # leaves a trailing /; empty if no leading path
 73 |     [ -h "$app_path" ]
 74 | do
 75 |     ls=$( ls -ld "$app_path" )
 76 |     link=${ls#*' -> '}
 77 |     case $link in             #(
 78 |       /*)   app_path=$link ;; #(
 79 |       *)    app_path=$APP_HOME$link ;;
 80 |     esac
 81 | done
 82 | 
 83 | APP_HOME=$( cd "${APP_HOME:-./}" && pwd -P ) || exit
 84 | 
 85 | APP_NAME="Gradle"
 86 | APP_BASE_NAME=${0##*/}
 87 | 
 88 | # Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
 89 | DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
 90 | 
 91 | # Use the maximum available, or set MAX_FD != -1 to use that value.
 92 | MAX_FD=maximum
 93 | 
 94 | warn () {
 95 |     echo "$*"
 96 | } >&2
 97 | 
 98 | die () {
 99 |     echo
100 |     echo "$*"
101 |     echo
102 |     exit 1
103 | } >&2
104 | 
105 | # OS specific support (must be 'true' or 'false').
106 | cygwin=false
107 | msys=false
108 | darwin=false
109 | nonstop=false
110 | case "$( uname )" in                #(
111 |   CYGWIN* )         cygwin=true  ;; #(
112 |   Darwin* )         darwin=true  ;; #(
113 |   MSYS* | MINGW* )  msys=true    ;; #(
114 |   NONSTOP* )        nonstop=true ;;
115 | esac
116 | 
117 | CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
118 | 
119 | 
120 | # Determine the Java command to use to start the JVM.
121 | if [ -n "$JAVA_HOME" ] ; then
122 |     if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
123 |         # IBM's JDK on AIX uses strange locations for the executables
124 |         JAVACMD=$JAVA_HOME/jre/sh/java
125 |     else
126 |         JAVACMD=$JAVA_HOME/bin/java
127 |     fi
128 |     if [ ! -x "$JAVACMD" ] ; then
129 |         die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
130 | 
131 | Please set the JAVA_HOME variable in your environment to match the
132 | location of your Java installation."
133 |     fi
134 | else
135 |     JAVACMD=java
136 |     which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
137 | 
138 | Please set the JAVA_HOME variable in your environment to match the
139 | location of your Java installation."
140 | fi
141 | 
142 | # Increase the maximum file descriptors if we can.
143 | if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then
144 |     case $MAX_FD in #(
145 |       max*)
146 |         MAX_FD=$( ulimit -H -n ) ||
147 |             warn "Could not query maximum file descriptor limit"
148 |     esac
149 |     case $MAX_FD in  #(
150 |       '' | soft) :;; #(
151 |       *)
152 |         ulimit -n "$MAX_FD" ||
153 |             warn "Could not set maximum file descriptor limit to $MAX_FD"
154 |     esac
155 | fi
156 | 
157 | # Collect all arguments for the java command, stacking in reverse order:
158 | #   * args from the command line
159 | #   * the main class name
160 | #   * -classpath
161 | #   * -D...appname settings
162 | #   * --module-path (only if needed)
163 | #   * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables.
164 | 
165 | # For Cygwin or MSYS, switch paths to Windows format before running java
166 | if "$cygwin" || "$msys" ; then
167 |     APP_HOME=$( cygpath --path --mixed "$APP_HOME" )
168 |     CLASSPATH=$( cygpath --path --mixed "$CLASSPATH" )
169 | 
170 |     JAVACMD=$( cygpath --unix "$JAVACMD" )
171 | 
172 |     # Now convert the arguments - kludge to limit ourselves to /bin/sh
173 |     for arg do
174 |         if
175 |             case $arg in                                #(
176 |               -*)   false ;;                            # don't mess with options #(
177 |               /?*)  t=${arg#/} t=/${t%%/*}              # looks like a POSIX filepath
178 |                     [ -e "$t" ] ;;                      #(
179 |               *)    false ;;
180 |             esac
181 |         then
182 |             arg=$( cygpath --path --ignore --mixed "$arg" )
183 |         fi
184 |         # Roll the args list around exactly as many times as the number of
185 |         # args, so each arg winds up back in the position where it started, but
186 |         # possibly modified.
187 |         #
188 |         # NB: a `for` loop captures its iteration list before it begins, so
189 |         # changing the positional parameters here affects neither the number of
190 |         # iterations, nor the values presented in `arg`.
191 |         shift                   # remove old arg
192 |         set -- "$@" "$arg"      # push replacement arg
193 |     done
194 | fi
195 | 
196 | # Collect all arguments for the java command;
197 | #   * $DEFAULT_JVM_OPTS, $JAVA_OPTS, and $GRADLE_OPTS can contain fragments of
198 | #     shell script including quotes and variable substitutions, so put them in
199 | #     double quotes to make sure that they get re-expanded; and
200 | #   * put everything else in single quotes, so that it's not re-expanded.
201 | 
202 | set -- \
203 |         "-Dorg.gradle.appname=$APP_BASE_NAME" \
204 |         -classpath "$CLASSPATH" \
205 |         org.gradle.wrapper.GradleWrapperMain \
206 |         "$@"
207 | 
208 | # Use "xargs" to parse quoted args.
209 | #
210 | # With -n1 it outputs one arg per line, with the quotes and backslashes removed.
211 | #
212 | # In Bash we could simply go:
213 | #
214 | #   readarray ARGS < <( xargs -n1 <<<"$var" ) &&
215 | #   set -- "${ARGS[@]}" "$@"
216 | #
217 | # but POSIX shell has neither arrays nor command substitution, so instead we
218 | # post-process each arg (as a line of input to sed) to backslash-escape any
219 | # character that might be a shell metacharacter, then use eval to reverse
220 | # that process (while maintaining the separation between arguments), and wrap
221 | # the whole thing up as a single "set" statement.
222 | #
223 | # This will of course break if any of these variables contains a newline or
224 | # an unmatched quote.
225 | #
226 | 
227 | eval "set -- $(
228 |         printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" |
229 |         xargs -n1 |
230 |         sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' |
231 |         tr '\n' ' '
232 |     )" '"$@"'
233 | 
234 | exec "$JAVACMD" "$@"
235 | 


--------------------------------------------------------------------------------
/settings.gradle.kts:
--------------------------------------------------------------------------------
1 | rootProject.name = "http-server-post"
2 | include(
3 |     "functional-server-library",
4 |     "functional-server-app"
5 | )
6 | 


--------------------------------------------------------------------------------