CHANGELOG.md

1.6.9

• core: logger(name) is now accessible without a class instance context
• core: Any.logger() will now take the closest non-anonymous superclass
• server: errors.on(StatusCode) convenience reified function added
• server: AssetsHandler will now allow serving of SPA index.html even if requested directory in assets exists
• jdbc: BaseCrudRepository.list() and by() now both have the suffix parameter
• jdbc: handle Postgres "cached plan must not change result type" exception by enabling autosave=conservative by default

1.6.8

• server: ErrorHandler now supports finding of handlers using exception super classes
• jobs: fix deprecated schedule() method implementation

1.6.7

• core: Converter can now force initialize type arguments' companion objects
• core: Decimal.absoluteValue and Decimal.sign introduced, like other numeric types in Kotlin
• core: Registry and TypedHttpClient moved from server module, so that JsonHttpClient can be used without the server
• server: HttpExchange.path<>(), query<>(), and session<>() now allow for automatic String conversion into value types
• server: Browser class better detects various iOS browsers that run on Apple WebKit
• jobs: deprecated non-Duration schedule() methods
• oauth: support for missing first or last names or locale
• jdbc: initial support for Postgres listen/notify
• slf4j: fix length optimization of stack traces in StackTraceOptimizingLogger

1.6.6

• core: Converter will force initialize companion objects to better support init { Converter.use {...} }
• core: Converter now supports inline classes with multiple constructors automatically
• core: Converter now supports any static(String) method automatically, not only parse()
• core: Cache keepAlive function introduced to prolong external cache entries
• server: KeyCipher now uses base64UrlEncode() internally instead of plain base64
• jdbc: db.upsert() now uses excluded special table name for update part instead of setting values twice

1.6.5

• core: simple Cache with expiration timer implemented
• oauth: AppleOAuthClient updated and tested
• oauth: JWT helper class introduced
• jdbc: introduced db.upsertBatch()
• jobs: runOnce() introduced for convenience
• json: throw more descriptive errors from JsonNode.get() in case of missing keys

1.6.4

• core: added common value types for Email, Phone, and Password, also StringValue base class
• jdbc: introduced db.insertBatch()
• jdbc: deprecated Entity interface (UUID-based), which can be replaced with BaseEntity
• jdbc: support SqlComputed with other operators, e.g. where = "date" lte SqlComputed("currrent_date")
• server: added path to annotated(), to make paths more visible in one place
• server: make a few more Server properties public (sessionStore, notFoundHandler, etc)
• server: bugfix after 1.6.0: wrap notFoundHandler correctly to produce correct 404 response
• server: NotFoundRoute introduced to be easily distinguishable from normal routes
• oauth: new experimental OAuth 2.0 login module

1.6.3

• server: added support for SSE (Server-Side Events) to HttpExchange
• json: improve parsing of complex types with parameters
• jdbc: introduce NullableId for entities with null ids until they are persisted.
• jdbc: introduce UpdatableEntity for optimistic locking in BaseRepository.save

1.6.2

• server: fix check for requested assets being inside of assets directory
• server: introduced FormDataRenderer
• core/json: KClass.createFrom will report missing parameters in a nicer way
• core: conversion of enum values from string is now case-insensitive
• json: can convert number to a custom type using opts.values
• json: TSGenerator: better detection of types of inline classes with several computed properties
• jdbc: upsert() now has skipUpdateFields parameter

1.6.1

• jdbc: and() introduced in addition to or() for more convenient composition of where expressions
• Kotlin and other dependency updates

1.6.0

• server: notFoundHandler is now decorated separately in each context, so that decorators can intercept and handle missing routes (e.g. CorsHandler)
• server: ErrorHandler will now omit the default message thrown by first() function ("List/Collection is empty.") and generate a standard 404 NotFound response
• server: ThrowableHandler now has HttpExchange as receiver for cleaner code, as it is not used in most handlers anyway
• server: ThrowableHandler returning null will now proceed with next handler, eventually producing error 500 if not handled
• server: Route is now a KAnnotatedElement, so that findAnnotation/hasAnnotation() functions from kotlin-reflect should be used on it (not backwards-compatible)
• jdbc: startDevDB() will now throw an exception if docker-compose returns a non-zero exit code
• jdbc: deprecated 1.4.x functions removed, please upgrade from 1.4.x to 1.5.0 first, fix deprecations, and then to 1.6.x
• openapi: new module that can generate OpenAPI json spec file for all routes in a context

1.5.6

• jdbc: DB_READONLY=true env var can be used to make the whole app read-only (e.g. when migrating the DB, instead of Heroku maintenance mode)
• jdbc: CrudRepository.get() now has optional forUpdate parameter
• HttpExchange.fileName() added for setting of Content-Disposition
• json bugfix: json within json (and '') are now properly escaped
• json bugfix: render Any type as 'any' instead of 'string' in TSGenerator
• csv: new module for CSV parsing/generation

1.5.5

• jdbc: support reading of collections of Decimal from DB array columns
• jdbc: db.upsert() now has an optional "where" parameter
• server: AssetsHandler.headerModifier now gets file parameter to make decisions based on it
• server: allow having annotations on AssetsHandler for e.g. access checks

1.5.4

• json: ValueConverter can now be used to transform strings into types
• json: JsonNode.getList() signature fixed
• json: improve error message when trying to parse an empty stream
• json: JsonParser.readArray can now be used to stream json arrays without loading them into memory
• jdbc: close connection (return to pool) even if autoCommit/commit/rollback fails
• server: support for boolean query parameters without values, e.g. ?flag
• server: support for anonymous handler annotations (fixed in Kotlin 1.8)

1.5.3

• server: TypedHttpClient/JsonHttpClient uses a better logger name (from nearest user class)
• json/jackson: TypedHttpClient/JsonHttpClient now have overridable trimToLog property in case you need to process how requests/responses are logged
• jobs: JobRunner.schedule() now takes kotlin.time.Duration values
• jdbc: PooledDataSource - a simple and easy to configure connection pool (used in DBModule by default)
• jdbc: use HikariModule instead of DBModule if you still want to use Hikari (also add dependency on com.zaxxer:HikariCP)
• liquibase/serialization - dependencies updated

1.5.2

• core: experimental Decimal class to be used for monetary values, with numerical equality (unlike BigDecimal)
• core/json: use default values for explicitly passed nulls if property is not nullable
• core/json: unwrap InvocationTargetException, so that any validation exceptions thrown from data class constructors is propagated properly
• core/json: workaround for a bug in kotlin-reflect, which boxes null values even if nullable inline type is used: https://youtrack.jetbrains.com/issue/KT-57590
• json: TSGenerator can now receive additional library types to generate from command-line, e.g. klite.TSID
• i18n: do not trim translations by default (keep all whitespace)
• jdbc: support binding of Int values to data classes (DB usually returns integers as Long)
• jdbc: possibility to use table aliases when getting of columns from ResultSet with joins/using create (Postgres only)
• jdbc: allow whitespace between -- and keywords in changeset sql files
• server: default RequestLogFormatter will not log StatusCodeExceptions anymore
• server: useHashCodeAsETag() introduced to avoid sending of same responses
• server: run onStop handlers in reverse order of registration, so that e.g. connection pool is stopped after jobs are stopped
• jobs: do not start new jobs on shutdown while waiting for running jobs to finish

1.5.1

• json: ValueConverter.from() can now have access to the expected KType
• json: TSGenerator to generate TypeScript types for data classes/enums
• server: AppScope.async now is the standard async function that returns a Deferred. Use AppScope.launch if you want exceptions to be logged

1.5.0

• core: toValues() functions moved here from klite-jdbc
• core: TSID introduced as an alternative to UUID
• json: new lightweight json parser
• i18n: now uses the lightweight klite-json, not jackson
• jackson: package changed to klite.jackson to avoid conflicts with klite-json
• jackson: .parse extension function now passes type parameters to Jackson, not only the main class
• jdbc: fromValues() was renamed to create()
• jdbc: switched db.select() <-> db.query(), taking "where" as a list or varargs, to allow for duplicated columns

The release is not fully backwards-compatible, however most old functions are provided as @Deprecated.

This will migrate the most important parts: find -name '*.kt' -exec sed -ri 's/klite.json./klite.jackson./; s/mapOfNotNull/notNullValues/; /db\.(query|select)/{N; s/db\.query/db.xxxselect/g; s/db\.select/db.query/g; s/mapOf/listOf/g; s/emptyMap/emptyList/g};' {} \; -exec sed -ri 's/db\.xxxselect/db\.select/; s/(db.update\(.*, )mapOf\((.*?\)), (mapOf\(.*?\))\)/\1\3, \2/; s/(db.delete\(.*, )mapOf\((.*?)\)/\1\2/' {} \;

Beware: if you use the replacement above, then make sure that no deprecated query/select usages are left, i.e. check that all "where" maps are replaced with lists/varargs, which is done automatically only if on the same or next line.

You may also use IDEA migration of deprecations, but it will most likely break code formatting, etc. Also, you may need to add some imports manually.

1.4.5

• jdbc: allow using $${json}$$ in migration scripts without treating it as substitutions
• jobs: do not unlock already running jobs after failing to lock (a problem for 3 instances with jobs or more)

1.4.4

• jobs: locked jobs did not release DB connection (bug introduced in 1.4.2)

1.4.3

• core: the new core module, to make it possible to use jdbc module without the server
• core: mapOfNotNull() now accepts keys of any type
• core: Converter.supports() now finds supported converters automatically, even if not used previously
• jdbc: db.count() introduced
• jdbc: box @JvmInline classes when loading from DB
• jdbc: allow same column multiple times in or() and deprecate NullOrOp()
• server: do not wrap exceptions already containing parameter name in annotated routes
• server: TypedHttpClient introduced as a more generic foundation for JsonHttpClient
• jackson: JsonHttpClient now accepts KType as non-reified parameters instead of KClass<*> for better type parameter support

1.4.2

• server: fallback to docker compose without dash
• server: shorten json stack traces by cutting repeating class/package names
• jdbc: emptyArray literal support '{}' - replaces previous EmptyOf() handling in toValues()
• jdbc: jsonb() and stuff that should work for both insert and update must use SqlComputed() now
• jdbc: CrudRepository now skips null where tokens for easier conditionals
• jobs: do not allow running of same jobs in parallel by default - useful in case of multiple instances

1.4.1

• server: skip "broken pipe" and "connection reset" exceptions by default
• server: request log now contains exception name that caused the status code to change
• jdbc: orExpr() and or() functions for where expressions
• jackson: be able to override JavaTimeModule settings more easily

1.4.0

• server: MimeTypes is now a singleton object
• jdbc: DBMigrator introduced to replace Liquibase in most cases
• jdbc: ClosedRange and OpenRange support
• jdbc: SqlExpr implements equals for easier parameter-based mocking