Route Attribute

The primary goal of the Route attribute is to target methods and add them to the Router.

Properties

/// <summary>
/// Method (GET, POST...)
/// </summary>
public string Method { get; protected set; }

/// <summary>
/// Host (optional)
/// </summary>
public string? Host { get; set; }

/// <summary>
/// Path
/// </summary>
public string Path { get; protected set; }

/// <summary>
/// IsAbsolutePath (optional)
/// </summary>
public bool IsAbsolutePath { get; set; }

/// <summary>
/// Description (optional)
/// </summary>
public string? Description { get; set; }

Method

/// <summary>
/// Initializes a new instance of the <see cref="RouteAttribute"/> class for Method.
/// </summary>
/// <param name="method">The method.</param>
/// <param name="path">The path.</param>
/// <exception cref="ArgumentException">The argument 'verb' must be specified.</exception>
/// <exception cref="ArgumentException">The argument 'path' must be specified.</exception>
public RouteAttribute(string method, string path)

For example, to have the Home() method of the TestController class be called when a client sends a request to http://localhost:2015/api/test/index:

using System;
using System.Net;
using SimpleW;
using SimpleW.Observability;

namespace Sample {

    class Program {
        static async Task Main() {
            Log.SetSink(Log.ConsoleWriteLine, LogLevel.Debug);
            var server = new SimpleWServer(IPAddress.Any, 2015);
            server.MapControllers<Controller>("/api");
            await server.RunAsync();
        }
    }

    public class TestController : Controller {

        // http://localhost:2015/api/test/index
        [Route("GET", "test/index")]
        public List<string> Index() {
            return new List<string>() {
                "foo", "bar"
            };
        }

        public object About() {
            return "about page";
        }

        private void Create() {
            // do stuff
        }

    }

}

Controller

/// <summary>
/// Route Attribute for Controller
/// </summary>
/// <param name="path">The path.</param>
/// <exception cref="ArgumentException">The argument 'path' must be specified.</exception>
RouteAttribute(string path)

For example, to give all callable methods of TestController the same prefix, such as /test :

using System;
using System.Net;
using SimpleW;
using SimpleW.Observability;

namespace Sample {

    class Program {
        static async Task Main() {
            Log.SetSink(Log.ConsoleWriteLine, LogLevel.Debug);
            var server = new SimpleWServer(IPAddress.Any, 2015);
            server.MapControllers<Controller>("/api");
            await server.RunAsync();
        }
    }

    [Route("test/")]
    public class TestController : Controller {

        // http://localhost:2015/api/test/index
        [Route("GET", "/index")]
        public List<string> Index() {
            return new List<string>() {
                "foo", "bar"
            };
        }

        // http://localhost:2015/api/test/about
        [Route("GET", "/about")]
        public object About() {
            return "about page";
        }

        private void Create() {
            // do stuff
        }

    }

}

SetPrefix

/// <summary>
/// Add prefix to Path
/// </summary>
/// <param name="prefix">The prefix.</param>
/// <exception cref="ArgumentException">The argument 'prefix' must be specified.</exception>
public void SetPrefix(string prefix)