org.http4k:http4k-graphql
Advanced tools
http4k is a lightweight but fully-featured HTTP toolkit written in pure Kotlin that enables the serving and consuming of HTTP services in a functional and consistent way. http4k applications are just Kotlin functions. For example, here's a simple echo server:
val app: HttpHandler = { request: Request -> Response(OK).body(request.body) }
val server = app.asServer(SunHttp(8000)).start()
http4k consists of a lightweight core library, http4k-core, providing a base HTTP implementation and Server/Client implementations based on the JDK classes. Further servers, clients, serverless, templating, websockets capabilities are then implemented in add-on modules. http4k apps can be simply mounted into a running Server, Serverless platform, or compiled to GraalVM and run as a super-lightweight binary.
The principles of http4k are:
(Request) -> Response - provides a remote call for processing a Request.(HttpHandler) -> HttpHandler - adds Request/Response pre/post-processing. These filters are composed to make stacks of reusable behaviour that can
then be applied to an HttpHandler.HttpHandler interface is identical for both HTTP services and clients. This allows for simple offline testability of applications, as well as
plugging together of services without HTTP container being required.http4k-core module has ZERO dependencies and weighs in at ~1mb. Add-on modules only have dependencies required for specific implementation.Bored with reading already and just want to get coding? For the impatient, visit the http4k toolbox to generate a complete project from the wide variety of http4k modules.
Alternatively, read the quickstart or take a look at the examples repo, which showcases a variety of http4k use-cases and features.
http4k-core)http4k-core)HttpHandler and FnHandler types.HttpHandler into the AWS v2 SDKs. This massively simplifies testing and allows for sniffing of the exact traffic going to AWS - brilliant for debugging and building fakes.HttpHandler into the Azure Java SDKs.Servirtium Markdown format. Includes Servirtium MiTM server and simple JUnit extensions.
This quick example is designed to convey the simplicity & features of http4k . See also the quickstart for the simplest possible starting point and demonstrates how to serve and consume HTTP services with dynamic routing.
To install, add these dependencies to your Gradle file:
dependencies {
implementation(platform("org.http4k:http4k-bom:5.32.4.0"))
implementation("org.http4k:http4k-core")
implementation("org.http4k:http4k-server-jetty")
implementation("org.http4k:http4k-client-okhttp")
}
package guide.howto.readme
import org.http4k.client.OkHttp
import org.http4k.core.Filter
import org.http4k.core.HttpHandler
import org.http4k.core.Method.GET
import org.http4k.core.Request
import org.http4k.core.Response
import org.http4k.core.Status.Companion.OK
import org.http4k.core.then
import org.http4k.filter.CachingFilters
import org.http4k.routing.bind
import org.http4k.routing.path
import org.http4k.routing.routes
import org.http4k.server.Jetty
import org.http4k.server.asServer
fun main() {
// we can bind HttpHandlers (which are just functions from Request -> Response) to paths/methods to create a Route,
// then combine many Routes together to make another HttpHandler
val app: HttpHandler = routes(
"/ping" bind GET to { _: Request -> Response(OK).body("pong!") },
"/greet/{name}" bind GET to { req: Request ->
val name: String? = req.path("name")
Response(OK).body("hello ${name ?: "anon!"}")
}
)
// call the handler in-memory without spinning up a server
val inMemoryResponse: Response = app(Request(GET, "/greet/Bob"))
println(inMemoryResponse)
// Produces:
// HTTP/1.1 200 OK
//
//
// hello Bob
// this is a Filter - it performs pre/post processing on a request or response
val timingFilter = Filter {
next: HttpHandler ->
{
request: Request ->
val start = System.currentTimeMillis()
val response = next(request)
val latency = System.currentTimeMillis() - start
println("Request to ${request.uri} took ${latency}ms")
response
}
}
// we can "stack" filters to create reusable units, and then apply them to an HttpHandler
val compositeFilter = CachingFilters.Response.NoCache().then(timingFilter)
val filteredApp: HttpHandler = compositeFilter.then(app)
// only 1 LOC to mount an app and start it in a container
filteredApp.asServer(Jetty(9000)).start()
// HTTP clients are also HttpHandlers!
val client: HttpHandler = OkHttp()
val networkResponse: Response = client(Request(GET, "http://localhost:9000/greet/Bob"))
println(networkResponse)
// Produces:
// Request to /api/greet/Bob took 1ms
// HTTP/1.1 200
// cache-control: private, must-revalidate
// content-length: 9
// date: Thu, 08 Jun 2017 13:01:13 GMT
// expires: 0
// server: Jetty(9.3.16.v20170120)
//
// hello Bob
}
This project exists thanks to all the people who contribute.
FAQs
Http4k GraphQL support
We found that org.http4k:http4k-graphql demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 0 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Research
An advanced npm supply chain attack is leveraging Ethereum smart contracts for decentralized, persistent malware control, evading traditional defenses.
Security News
Research
Attackers are impersonating Sindre Sorhus on npm with a fake 'chalk-node' package containing a malicious backdoor to compromise developers' projects.
Security News
The npm package for the LottieFiles Player web component was hit with a supply chain attack after a software engineer's npmjs credentials were compromised.