Skip to content

Further details

Database🔗

Liquibase is used to manage Chutney RDBMS schema.
You can find corresponding changelog here.

Note

  • Chutney is tested with SQLite, H2 and PostgreSQL databases.
  • You can find complete examples in maven module chutny/packaging/local-dev, for all three database types.

To configure your datasource, use the property spring.datasource

1
2
3
spring:
    datasource:
        url: jdbc:sqlite:.chutney/data/chutney.db

1
2
3
spring:
    datasource:
        url: jdbc:h2:mem:dbName

1
2
3
4
spring:
    datasource:
        url: jdbc:postgresql://host:port/dbName?ssl=true&sslmode=verify-ca&sslfactory=org.postgresql.ssl.DefaultJavaSSLFactory&currentSchema=mySchema
        username: user

Logs🔗

Chutney depends on SLF4J API logging library.

At runtime, the Chutney server use the Logback SLF4J implementation and bridges all legacy APIs (JCL, LOG4J and JUL).

Warning

Since the server bridges all legacy APIs, you must be careful to not include any of the following libraries :

  • jcl-over-slf4j
  • log4j-over-slf4j and slf4j-reload4j
  • jul-to-slf4j

Read Bridging legacy APIs for further details.

A Logback configuration must be package in the packaging project, in classpath root.

Logback configuration examples 
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
<configuration>
    <appender name="stdout" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>

    <root level="WARN">
        <appender-ref ref="stdout"/>
    </root>
</configuration>

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
<configuration>
    <appender name="total" class="ch.qos.logback.core.rolling.RollingFileAppender"> 
        <file>total.log</file>
        <encoder>
            <pattern>%d | %logger{16} | %level | %msg%n</pattern>
        </encoder>
        <rollingPolicy class="ch.qos.logback.core.rolling.FixedWindowRollingPolicy">
            <fileNamePattern>total.%i.log</fileNamePattern>
            <minIndex>1</minIndex>
            <maxIndex>50</maxIndex>
        </rollingPolicy>
        <triggeringPolicy class="ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy">
            <maxFileSize>50MB</maxFileSize>
        </triggeringPolicy>
    </appender>

    <root level="WARN">
        <appender-ref ref="total"/>
    </root>
</configuration>

Server (TLS/SSL)🔗

Chutney server enforces the use of secure calls on any incoming requests.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
!!! note "Server HTTPS configuration"
``` yaml
server:
    port: 443
    ssl:
        keystore: # keystore path
        key-store-password: # keystore password
        key-password: # key password
        trust-store: # truststore path
        trust-store-password: # truststore password
```

Chutney Server provides undertow-https-redirect Spring profile to redirect unsecured request to the right secured port.

Using undertow-https-redirect Spring profile
  • Activate the profile
1
2
3
4
spring:
    profiles:
        active:
          - undertow-https-redirect
  • Configure the HTTP listener
1
2
3
4
server:
    http:
        port: 80 # (1)
        interface: 0.0.0.0 # (2)
  1. HTTP port to use
  2. Interface to bind to