Package net.jonathangiles.tools.teenyhttpd

Class TeenyHttpd

java.lang.Object
net.jonathangiles.tools.teenyhttpd.TeenyHttpd
public class TeenyHttpd extends Object
The TeenyHttpd server itself - instantiating an instance of this class and calling 'start()' is all that is required to begin serving requests.

  • Constructor Summary

    Constructors
    Constructor
    Description
    TeenyHttpd(int port)
    Creates a single-threaded server that will work on the given port, although the server does not start until 'stort()' is called.
    TeenyHttpd(int port, Supplier<? extends ExecutorService> executorSupplier)
    Creates a server that will work on the given port, although the server does not start until 'stort()' is called.

  • Method Summary

    Modifier and Type
    Method
    Description
    Response
    serve(Request request)
    This method is called on every request, and allows for responses to be generated as appropriate.
    void
    setWebroot(File webroot)
    Sets the root directory to look for requested files.
    void
    start()
    Starts the server instance.
    void
    stop()
    Requests that the server instance stop serving requests.

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • Constructor Details

    • TeenyHttpd

      public TeenyHttpd(int port)
      Creates a single-threaded server that will work on the given port, although the server does not start until 'stort()' is called.
      Parameters:
      port - The port for the server to listen to.

    • TeenyHttpd

      public TeenyHttpd(int port, Supplier<? extends ExecutorService> executorSupplier)
      Creates a server that will work on the given port, although the server does not start until 'stort()' is called. The executor supplier enables creating ExecutorService instances that can handle requests with a range of different threading models.
      Parameters:
      port - The port for the server to listen to.
      executorSupplier - A ExecutorService instances that can handle requests with a range of different threading models.

  • Method Details

    • setWebroot

      public void setWebroot(File webroot)
      Sets the root directory to look for requested files.
      Parameters:
      webroot - A path on the local file system for serving requested files from.

    • start

      public void start()
      Starts the server instance.

    • stop

      public void stop()
      Requests that the server instance stop serving requests.

    • serve

      public Response serve(Request request)
      This method is called on every request, and allows for responses to be generated as appropriate.
      Parameters:
      request - The incoming request that must be responded to.
      Returns:
      The response that will be given to the requestor.