hi there - i’m having a go at writing my own contract renderer, but most of the fields/methods on ContractRoute are internal meaning you can’t really get the info from the routes. Is there a particular reason for this? is it possible to relax these?

The dance music fan in me wants to ban anyone else from giving us a star on github... 🙂

There a GitHub issue that says you don't support coroutines. That's not that one shouldn't use coroutines with HTTP4K it's just, HTTP4K isn't built with them right?

In production should I just be using the Apache client?

Hey y'all, just wanted to pop in and say that I'm enjoying the experience with Http4k so far! I've created a small tabletop service connected to a MongoDB and running and testing it has been pretty sane so far, great work! 🙂

@Tom Ellis this is pretty standard Jackson behaviour - when in doubt it does deserialise using Maps (we see the same with generic lists). It's nothing to do with http4k per-se, but about how you set up the Jackson mapper instance and annotate the classes for deserialisation with something like

@JsonTypeInfo

. TBH, I generally try to make DTO objects as dumb as possible as I hate all the annotations.

Oh looks like "stop" might do that?

This repo is empty FYI: https://github.com/http4k/http4k-examples

https://www.http4k.org/guide/modules/contracts/ Does the contracts module support custom extensions? I.e. https://swagger.io/docs/specification/openapi-extensions/

so, i’m writing a basic auth filter (which uses proprietary stuff to determine if a user is authed from this, i get a special object that represents the user’s auth state. i need to subsequently pass this around to every handler/request afterwards. what’s the best way to handle that? variable on the top-level

HTTPHandler

class? since all the handlers are functions, i’m not sure how to pass it to them from the

routes()

function call

i’m trying a simple echo handler basically that just returns the request it received as JSON in the body. I assume I need

.body

, not

.with

, but how can I convert the request to JSON? I could use a Jackson mapper manually, but I assume HTTP4k has a built-in way to do it

fun getRequestAsJson(): HttpHandler {
    return {
        Response(OK).body(it)
    }
}

Are there any examples of using http4k with an

AutoCloseable

thing like a database client that needs to be opened upon request and closed once the response is sent? Or using

try-with-resources

?

I have a header that needs to be passed on every single request. I’m using a

Filter

right now to validate it, but I also want to put it on the OpenAPI contract for each route. It looks like the only way for me to require that header on every route is to copy-paste the contract header checks?

Each contract block will current produce a single swagger file. Because of the setup of the DSL, you can't extract them as a sub contract block in the same way that you can with a standard routes block. But you can nest contract blocks inside standard routes blocks (and routes blocks can be composed) to create a tree structure where some of the routes are covered by a contract and some aren't / we do this in the example by combining the API contract with static routing and the website routes.

@Nezteb It should match the number of args ok. Can you post more of the code? (Including the full path)

in

http4k-by-example

, the contract module generates these random

object927961565

objects. is there a way to name those manually?

unrelated to the above: is this the correct way to conditionally add a filter in between other filters? in this case, if the DEV flag is set to true, i want to set up unsafe cors for testing purposes.

You probably want classpath instead of directory if you're deploying an app

You should be able to visit the root and it will redirect

i’m sure there is something simple i’m missing, but is there a way to combine a contract and other binded routes? so i don’t have to duplicate

/api/v1

three times here?

Unrelated to the above: Is there a way to set up a redirect? From one route to another?

It seems you can’t add routes in between two filters. In my case I want a certain filter to be skipped for a few routes. Is there a way to do that? Only apply a Filter to a couple routes out of many?

I’m serving this swagger folder via

static

. If I go to the static path

/swagger.json

, i see the pictured

swagger.json

file. If I go to

/swagger.yaml

though, I get a 404. I noticed

static

has an overload with a second argument called

extraPairs: Pair<String, ContentType>

. do I have to use that second arg?

i found a hacky way to do this for now, but don’t like it. i basically make a filter that runs before all the others, and if the request URI is exactly “/health”, then i return a

Response(OK)

, but that’s… meh

also, i know you can do

val spec = "/organization" / Path.of("id") meta {

but i can’t seem to be able to do:

val spec = "/organization" / Path.of("id") / "/workspaces" meta {

Is there a different way to do that?

Hello sorry for noob question. I notice this post at FaQ,

Q. Does http4k support an Async model? I need webscale!

A. Not at the moment. Adding Async support is a decision that we are thinking about carefully so that we don't end up complicating the API. When we do add it, it'll probably use co-routines and they're still marked as experimental which is another reason we are holding off. As for the scaling arguments, see the above answer relating to production usage.

But I'm seeing this library also support

- Apache sync + async HTTP
- Jetty HTTP (supports sync and async HTTP)
- OkHttp HTTP (supports sync and async HTTP)
- Java (bundled with http4k-core)

Which mean support async model, isnt it ?

When using

Path.of("something")

and a url is hit like

/api/users/<something>

when i receive the value is it already url decoded? i.e spaces changed from

%20

to just

Hey guys/girls! thanks a lot for giving me the option to join this channel! I actually just started working backend and with kotlin for first time a few days ago. I’m kind of happy I chose kotlin and http4k, the community already seems great 🙂 I ran into a small problem, and I was wondering if any of you can help me out with it: When using OpenApi3 with lenses and contracts, the reference format of the schema seems to not be RFC3986-compliant. schema: * $ref: ‘#/components/schemas/urnjsonschemaqweyzdxyz’* Error: “Semantic error at paths./api/v1/yyy.post.xxx.content.application/json.schema.$ref $ref values must be RFC3986-compliant percent-encoded URIs Jump to line 26” Am I not using it correctly? or is there a way to configure this in OpenApi3 of Http4k?

I've been meaning to contribute some/all of the code we did for one of the recent projects, where we integrated https://bitbucket.org/atlassian/swagger-request-validator with http4k, so that we could validate the responses from the app against an OPenApi spec in the functional tests. The benefit there is that the tests are then more about the functionality than validating the structure, headers, status etc, which is instead automatically handled by the library. It really makes the tests nice and clean, not full of json payload validation code. Would there be an interest in having that as an official module in the repo? It can also easily be used on the server side, to validate incoming requests against the spec, which is something that module could also provide.

@krtko not out of the box. We don't provide an API to do this because the options are to many and vary across the backends. But we do expect people to want to tweak the server settings, so we provide the ServerConfig interface (which gives you the to server extension function). You should copy the default version for Apache from our source and modify as required. The code to convert the HttpHandler should be reusable from our code (but let us know if it's not good enough/requires loads of duplication).