// Annotate the `HelloServer` module indicating that this is a web application containing discoverable HTTP endpoints
@WebApp

// Define a module named HelloServer
module HelloServer {
    // Mount the `web.xtclang.org` library into the module as `web`
    package web   import web.xtclang.org;
    // Mount the `xenia.xtclang.org` library into the module as `xenia`
    package xenia import xenia.xtclang.org;

    // Import specific classes for web functionality and HTTP handling
    import web.*;
    import web.http.*;
    
    // The run() method is the entry point for the `HelloServer` module
    // It creates a web server instance, configures it, and starts it
    void run() {
        // Initialize a Xenia web server on localhost with HTTP port 8080 and HTTPS port 8090
        xenia.createServer(this, new HostInfo("localhost", 8080, 8090));

        // Inject a dependency to console-related features, which print messages to the console
        @Inject Console console;
        console.print($|To access this server, open a browser on this machine and enter this URL:
                       |
                       |     http://localhost:8080/
                       |
                       | Or:
                       |
                       |     https://localhost:8090/
                       |
                       |Use Ctrl-C to stop.
                     );
    }
  

    // Annotate the `SiteRoot` service indicating this a web service mapped to the root path ("/")
    @WebService("/")
    service SiteRoot {
        // Declare a GET HTTP method, `sayHello`, which returns a string
        @Get
        String sayHello() = "Hello, World!";
    }
}

xec HelloServer

To access this server, open a browser on this machine and enter this URL:

     http://localhost:8080/

 Or:

     https://localhost:8090/

Use Ctrl-C to stop.

// Define a module named HelloClient
module HelloClient {
    // Mount the `web.xtclang.org` library into the module as `web`
    package web import web.xtclang.org;

    // Inject a dependency to console-related features, which print messages to the console
    @Inject Console console;

    // Import the HttpClient class for making HTTP requests
    import web.HttpClient;

    // Define the `HelloClient` entrypoint method that accepts an array of URL strings as arguments
    void run(String[] args=["http://localhost:8080"]) {
        // Initialize an instance of HttpClient for making HTTP requests
        HttpClient client = new HttpClient();

        // Extract the URI from the command-line arguments
        String uri = args[0];
        console.print($"Accessing: {uri.quoted()}");

        // Send an HTTP GET request to the specified URI using the get() method of the HttpClient instance
        // Convert the server response to a string and assert that the result is not null,
        // otherwise, an error message is displayed
        assert String result := client.get(uri).to(String) as $"Request to {uri.quoted()} failed";

        // Print the response received from the server
        console.print($"The server returned: {result}");
    }
}

xec HelloClient

Accessing: "http://localhost:8080"
The server returned: Hello, World!