This is a sample Clojure web api that will:
- Display a swagger page.
- Validate or reject http requests based on a schema.
- Do an async http request to resolve the client's IP address.
- Map the request to a Kafka proto message.
- Enqueue and publish that message.
- Integration tests, relying on testcontainers.
$ lein protodeps generate
$ lein uberjar
$ java -jar sample-donkey-api-0.1.0-standalone.jar
The configuration is loaded using walmartlabs/dyn-edn.
These parts are configurable:
export CHANNEL_SIZE_PER_CORE=250
export KAFKA_BROKERS=my-broker:9093
export IP_STACK_ACCESS_KEY=CHANGE ME
export INTERNAL_PORT=8081
export EXTERNAL_PORT=8080- AppsFlyer/Donkey as the http server.
- clj-test-containers for integration tests.
- Metosin/malli for request validation.
- Metosin/reitit for routing requests.
- Integrant for state management.
- walmartlabs/dyn-edn for dynamic configuration.
- AppsFlyer/Ketu as the Kafka library.
- AppsFlyer/lein-protodeps to generate java classes from .proto files.
- AppsFlyer/pronto to use protobuf simply in Clojure.
$ export KAFKA_BROKERS=my-broker:9092
$ lein uberjar
$ java -jar target/uberjar/sample-donkey-api-0.1.0-SNAPSHOT-standalone.jar
.. in another terminal session
$ curl --location --request POST 'http://localhost:8080/api/v1.0/stocks/order/AAPL' \
--header 'Content-Type: application/json' \
--data-raw '{
"amount_usd": 3.47,
"request_id": "71dad7da-7926-40d8-9b15-b94a6d46e15a",
"ip": "35.244.183.10",
"direction": "buy"
}'
lein test- To run all unit & integration tests.
Copyright © 2021 Yevgeni Tsodikov
This program and the accompanying materials are made available under the terms of the Eclipse Public License 2.0 which is available at http://www.eclipse.org/legal/epl-2.0.
This Source Code may also be made available under the following Secondary Licenses when the conditions for such availability set forth in the Eclipse Public License, v. 2.0 are satisfied: GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version, with the GNU Classpath Exception which is available at https://www.gnu.org/software/classpath/license.html.