Create article comment

Kotlin + http4k codebase containing real world examples (CRUD, auth, advanced patterns, etc) that adheres to the RealWorld spec and API.

This codebase was created to demonstrate a fully fledged fullstack application built with Kotlin + http4k + Exposed including CRUD operations, authentication, routing, pagination, and more.

For more information on how to this works with other frontends/backends, head over to the RealWorld repo.

How it works

The application was made mainly to demo the functionality of http4k framework together with exposed.

Tech stack

The application was built with:

Kotlin as programming language.
http4k as web framework.
h2, an embedded lightweight database, as data storage. Although the application can support all the databases supported by exposed.
exposed to access database and build typesafe SQL queries.
jsonwebtoken to handle JSON Web Tokens for request authorization.
log4j for proper logging in the application.
kotest as testing framework for kotlin.
mockk as mocking library for Kotlin.

Application structure

Basically, the application has four main parts:

main function which instantiates all the services and handlers and connects them together, then starts the server.
Router class which handles the translation of 1. http requests to request handler calls and 2. handler results to http responses. Authorization logic is also implemented in this class.
handler package which contains a class for every request handler. Handlers are classes with one method (invoke) which handles the request. This package contains the whole business logic of the application. Handlers have access to data layer.
ConduitRepository class which is responsible for building database queries. In order to communicate to database, a class called ConduitTransactionManagerImpl is needed. this class has one method (tx) which connects to database and opens a transaction to communicate with database. tx accepts an anonymous function while provides an instance of ConduitRepository as a receiver.

+ config/
    Application config as simple data classes
+ handler/
    All handler classes which describe business logic of the application
+ model/
    domain model and dtos
+ repository/
    table definitions, typesafe database creation scripts and classes to communicate with database
+ util/
    utility classes such as request filters, serialization/deserialization functions and jwt utility functions
+ Main.kt
    File containing main function
+ Router.kt
    File containing Router class responsible for handling http server communication

Database

The application currently uses H2 embedded database. The connection is defined in config/local.kt. If you want to change the database you need to provide the correct dependency for the driver and change the configuration.

Tests

You can run ./gradlew test to run all the tests. A test logger gradle plugin (com.adarshr.test-logger) has used to render the test beautifully in console. There are a couple of unit tests for handlers but not for all of them (contributions welcome!). There are integration tests to cover all the cases of the postman test file.

Getting started

You need Java 11 installed.

Build and run tests:

./gradlew clean build

Start the server:

./gradlew run

The server will be available on http://localhost:9000

Contribution

There are various ways to contribute to this project. Some of them are:

Just clone the project and play with it! This is the purpose of this project.
Create an issue if you find a bug or you have suggestions.
Fix bugs, improve code or documentation.
Write more tests for the project to increase the code coverage.
Or look at the issue with help wanted label.

	"post": {
	"summary": "Create a comment for an article",
	"description": "Create a comment for an article. Auth is required",
	"tags": [
	"Comments"
	],
	"security": [
	{
	"Token": []
	}
	],
	"operationId": "CreateArticleComment",
	"parameters": [
	{
	"name": "slug",
	"in": "path",
	"required": true,
	"description": "Slug of the article that you want to create a comment for",
	"type": "string"
	},
	{
	"name": "comment",
	"in": "body",
	"required": true,
	"description": "Comment you want to create",
	"schema": {
	"$ref": "#/definitions/NewCommentRequest"
	}
	}
	],
	"responses": {
	"200": {
	"description": "OK",
	"schema": {
	"$ref": "#/definitions/SingleCommentResponse"
	}
	},
	"401": {
	"description": "Unauthorized"
	},
	"422": {
	"description": "Unexpected error",
	"schema": {
	"$ref": "#/definitions/GenericErrorModel"
	}
	}
	}
	}
	},

	"delete": {
	"summary": "Delete an article",
	"description": "Delete an article. Auth is required",
	"tags": [
	"Articles"
	],
	"security": [
	{
	"Token": []
	}
	],
	"operationId": "DeleteArticle",
	"parameters": [
	{
	"name": "slug",
	"in": "path",
	"required": true,
	"description": "Slug of the article to delete",
	"type": "string"
	}
	],
	"responses": {
	"200": {
	"description": "OK"
	},
	"401": {
	"description": "Unauthorized"
	},
	"422": {
	"description": "Unexpected error",
	"schema": {
	"$ref": "#/definitions/GenericErrorModel"
	}
	}
	}
	}
	},

	"/articles/{slug}/comments/{id}": {
	"delete": {
	"summary": "Delete a comment for an article",
	"description": "Delete a comment for an article. Auth is required",
	"tags": [
	"Comments"
	],
	"security": [
	{
	"Token": []
	}
	],
	"operationId": "DeleteArticleComment",
	"parameters": [
	{
	"name": "slug",
	"in": "path",
	"required": true,
	"description": "Slug of the article that you want to delete a comment for",
	"type": "string"
	},
	{
	"name": "id",
	"in": "path",
	"required": true,
	"description": "ID of the comment you want to delete",
	"type": "integer"
	}
	],
	"responses": {
	"200": {
	"description": "OK"
	},
	"401": {
	"description": "Unauthorized"
	},
	"422": {
	"description": "Unexpected error",
	"schema": {
	"$ref": "#/definitions/GenericErrorModel"
	}
	}
	}
	}
	},

	"/articles/feed": {
	"get": {
	"summary": "Get recent articles from users you follow",
	"description": "Get most recent articles from users you follow. Use query parameters to limit. Auth is required",
	"tags": [
	"Articles"
	],
	"security": [
	{
	"Token": []
	}
	],
	"operationId": "GetArticlesFeed",
	"parameters": [
	{
	"name": "limit",
	"in": "query",
	"description": "Limit number of articles returned (default is 20)",
	"required": false,
	"default": 20,
	"type": "integer"
	},
	{
	"name": "offset",
	"in": "query",
	"description": "Offset/skip number of articles (default is 0)",
	"required": false,
	"default": 0,
	"type": "integer"
	}
	],
	"responses": {
	"200": {
	"description": "OK",
	"schema": {
	"$ref": "#/definitions/MultipleArticlesResponse"
	}
	},
	"401": {
	"description": "Unauthorized"
	},
	"422": {
	"description": "Unexpected error",
	"schema": {
	"$ref": "#/definitions/GenericErrorModel"
	}
	}
	}
	}
	},

	"delete": {
	"summary": "Unfollow a user",
	"description": "Unfollow a user by username",
	"tags": [
	"Profile"
	],
	"security": [
	{
	"Token": []
	}
	],
	"operationId": "UnfollowUserByUsername",
	"parameters": [
	{
	"name": "username",
	"in": "path",
	"description": "Username of the profile you want to unfollow",
	"required": true,
	"type": "string"
	}
	],
	"responses": {
	"200": {
	"description": "OK",
	"schema": {
	"$ref": "#/definitions/ProfileResponse"
	}
	},
	"401": {
	"description": "Unauthorized"
	},
	"422": {
	"description": "Unexpected error",
	"schema": {
	"$ref": "#/definitions/GenericErrorModel"
	}
	}
	}
	}
	},

	"/articles/{slug}": {
	"get": {
	"summary": "Get an article",
	"description": "Get an article. Auth not required",
	"tags": [
	"Articles"
	],
	"operationId": "GetArticle",
	"parameters": [
	{
	"name": "slug",
	"in": "path",
	"required": true,
	"description": "Slug of the article to get",
	"type": "string"
	}
	],
	"responses": {
	"200": {
	"description": "OK",
	"schema": {
	"$ref": "#/definitions/SingleArticleResponse"
	}
	},
	"422": {
	"description": "Unexpected error",
	"schema": {
	"$ref": "#/definitions/GenericErrorModel"
	}
	}
	}
	},

	"post": {
	"summary": "Create an article",
	"description": "Create an article. Auth is required",
	"tags": [
	"Articles"
	],
	"security": [
	{
	"Token": []
	}
	],
	"operationId": "CreateArticle",
	"parameters": [
	{
	"name": "article",
	"in": "body",
	"required": true,
	"description": "Article to create",
	"schema": {
	"$ref": "#/definitions/NewArticleRequest"
	}
	}
	],
	"responses": {
	"201": {
	"description": "OK",
	"schema": {
	"$ref": "#/definitions/SingleArticleResponse"
	}
	},
	"401": {
	"description": "Unauthorized"
	},
	"422": {
	"description": "Unexpected error",
	"schema": {
	"$ref": "#/definitions/GenericErrorModel"
	}
	}
	}
	}
	},

	"delete": {
	"summary": "Unfavorite an article",
	"description": "Unfavorite an article. Auth is required",
	"tags": [
	"Favorites"
	],
	"security": [
	{
	"Token": []
	}
	],
	"operationId": "DeleteArticleFavorite",
	"parameters": [
	{
	"name": "slug",
	"in": "path",
	"required": true,
	"description": "Slug of the article that you want to unfavorite",
	"type": "string"
	}
	],
	"responses": {
	"200": {
	"description": "OK",
	"schema": {
	"$ref": "#/definitions/SingleArticleResponse"
	}
	},
	"401": {
	"description": "Unauthorized"
	},
	"422": {
	"description": "Unexpected error",
	"schema": {
	"$ref": "#/definitions/GenericErrorModel"
	}
	}
	}
	}
	},

	"/articles/{slug}/comments": {
	"get": {
	"summary": "Get comments for an article",
	"description": "Get the comments for an article. Auth is optional",
	"tags": [
	"Comments"
	],
	"operationId": "GetArticleComments",
	"parameters": [
	{
	"name": "slug",
	"in": "path",
	"required": true,
	"description": "Slug of the article that you want to get comments for",
	"type": "string"
	}
	],
	"responses": {
	"200": {
	"description": "OK",
	"schema": {
	"$ref": "#/definitions/MultipleCommentsResponse"
	}
	},
	"401": {
	"description": "Unauthorized"
	},
	"422": {
	"description": "Unexpected error",
	"schema": {
	"$ref": "#/definitions/GenericErrorModel"
	}
	}
	}
	},

	"/articles/{slug}/favorite": {
	"post": {
	"summary": "Favorite an article",
	"description": "Favorite an article. Auth is required",
	"tags": [
	"Favorites"
	],
	"security": [
	{
	"Token": []
	}
	],
	"operationId": "CreateArticleFavorite",
	"parameters": [
	{
	"name": "slug",
	"in": "path",
	"required": true,
	"description": "Slug of the article that you want to favorite",
	"type": "string"
	}
	],
	"responses": {
	"200": {
	"description": "OK",
	"schema": {
	"$ref": "#/definitions/SingleArticleResponse"
	}
	},
	"401": {
	"description": "Unauthorized"
	},
	"422": {
	"description": "Unexpected error",
	"schema": {
	"$ref": "#/definitions/GenericErrorModel"
	}
	}
	}
	},

	"/tags": {
	"get": {
	"summary": "Get tags",
	"description": "Get tags. Auth not required",
	"responses": {
	"200": {
	"description": "OK",
	"schema": {
	"$ref": "#/definitions/TagsResponse"
	}
	},
	"422": {
	"description": "Unexpected error",
	"schema": {
	"$ref": "#/definitions/GenericErrorModel"
	}
	}
	}
	}
	}
	},

	"/articles": {
	"get": {
	"summary": "Get recent articles globally",
	"description": "Get most recent articles globally. Use query parameters to filter results. Auth is optional",
	"tags": [
	"Articles"
	],
	"operationId": "GetArticles",
	"parameters": [
	{
	"name": "tag",
	"in": "query",
	"description": "Filter by tag",
	"required": false,
	"type": "string"
	},
	{
	"name": "author",
	"in": "query",
	"description": "Filter by author (username)",
	"required": false,
	"type": "string"
	},
	{
	"name": "favorited",
	"in": "query",
	"description": "Filter by favorites of a user (username)",
	"required": false,
	"type": "string"
	},
	{
	"name": "limit",
	"in": "query",
	"description": "Limit number of articles returned (default is 20)",
	"required": false,
	"default": 20,
	"type": "integer"
	},
	{
	"name": "offset",
	"in": "query",
	"description": "Offset/skip number of articles (default is 0)",
	"required": false,
	"default": 0,
	"type": "integer"
	}
	],
	"responses": {
	"200": {
	"description": "OK",
	"schema": {
	"$ref": "#/definitions/MultipleArticlesResponse"
	}
	},
	"401": {
	"description": "Unauthorized"
	},
	"422": {
	"description": "Unexpected error",
	"schema": {
	"$ref": "#/definitions/GenericErrorModel"
	}
	}
	}
	},

	"put": {
	"summary": "Update an article",
	"description": "Update an article. Auth is required",
	"tags": [
	"Articles"
	],
	"security": [
	{
	"Token": []
	}
	],
	"operationId": "UpdateArticle",
	"parameters": [
	{
	"name": "slug",
	"in": "path",
	"required": true,
	"description": "Slug of the article to update",
	"type": "string"
	},
	{
	"name": "article",
	"in": "body",
	"required": true,
	"description": "Article to update",
	"schema": {
	"$ref": "#/definitions/UpdateArticleRequest"
	}
	}
	],
	"responses": {
	"200": {
	"description": "OK",
	"schema": {
	"$ref": "#/definitions/SingleArticleResponse"
	}
	},
	"401": {
	"description": "Unauthorized"
	},
	"422": {
	"description": "Unexpected error",
	"schema": {
	"$ref": "#/definitions/GenericErrorModel"
	}
	}
	}
	},

alisabzevari / kotlin-http4k-realworld-example-app Goto Github PK

kotlin-http4k-realworld-example-app's Introduction

Kotlin + http4k codebase containing real world examples (CRUD, auth, advanced patterns, etc) that adheres to the RealWorld spec and API.

How it works

Tech stack

Application structure

Database

Tests

Getting started

Contribution

kotlin-http4k-realworld-example-app's People

Contributors

Stargazers

Watchers

Forkers

kotlin-http4k-realworld-example-app's Issues

Recommend Projects

Recommend Topics

Recommend Org