KISS Java Libraries

KissServer

Tiny zero-dependency Java 17+ HTTP/1.1 server library for simple REST-style applications, explicit routing, bounded parsing, and predictable shutdown.

Latest stable: 0.1.0 Java 17+ Apache-2.0

Getting Started API Reference GitHub

Maven

<dependency>
  <groupId>io.github.arthurhoch</groupId>
  <artifactId>kiss-server</artifactId>
  <version>0.1.0</version>
</dependency>

Small Surface

KissServer keeps HTTP routes and runtime behavior explicit. It is intended for small services that need a direct Java API without servlet containers or web frameworks.

Quick Example

KissServer server = KissServer.create();
server.get("/health", ctx -> ctx.text("OK"));
server.start(8080).await();

KISS Principles

Bounded Input

Request line, header, body, connection, and keep-alive limits are explicit.

Direct Routing

Exact and dynamic routes use small public types with predictable request and response behavior.

Simple Runtime

The core artifact targets Java 17 and keeps optional Java 21 virtual-thread usage application-provided.

Documentation

Getting StartedInstall and create the first route. API ReferencePublic server, routing, HTTP, and runtime types. AI SkillsVersioned Markdown skill files for AI-assisted usage. ConfigurationServerConfig options and limits. ExamplesCopyable route examples. HTTP/1.1Protocol scope and parser behavior. RoutingExact routes, dynamic routes, and matching. Executor ModelUser and owned executor behavior. PerformancePerformance philosophy and measured paths. BenchmarkingManual benchmark plan and commands. SecurityLimits and safe defaults. Security HardeningRepository hardening and local quality commands. Safe Code CleanupDeletion policy and quality gates. DeploymentReverse proxy recommendation. Native ImageGraalVM friendliness notes. ReleaseRelease process and Maven Central flow. Testing ReportCurrent verification state.