Skip to content

mnlipp/jdrupes-httpcodec

Repository files navigation

JDrupes non-blocking HTTP Codec

Build Status Codacy Badge Code Climate Release Maven Central Javadocs

The goal of this package is to provide easy to use HTTP encoders and decoders for non-blocking I/O that use Java Buffers for handling the data.

I'm well aware that such libraries already exist (searching easily reveals implementations such as the Apache Codecs or the Netty Codes). However, I found all of them to be too closely integrated with their respective frameworks, which didn't go well with my intention to write my own event driven framework. An implementation that comes very close to what I needed is HTTP Kit, which has, however, dependencies on Clojure, which prohibit its usage for my purpose.

This library requires Java 17 SE. Binaries are currently made available at maven central.

repositories {
	mavenCentral()
}

dependencies {
	compile 'org.jdrupes.httpcodec:httpcodec:X.Y.Z'
}

(See badge above for the latest version.)

The best starting point for using the library is to have a look at the Javadoc (either properly versioned or close to master). Make sure to read the "Overview" section first. It provides a good overview of the library's architecture. In addition, have a look at the source code in the demo folder.

Contributions and bug reports are welcome. Please provide them as GitHub issues.