Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mattbertolini/liquibase-slf4j

Liquibase SLF4J Logger.
https://github.com/mattbertolini/liquibase-slf4j

java jvm liquibase liquibase-logger liquibase-slf4j log4j log4j2 logback logger logging slf4j

Last synced: 6 days ago
JSON representation

Liquibase SLF4J Logger.

Awesome Lists containing this project

README 

        
# liquibase-slf4j

Version 5.1.0


Written by Matt Bertolini



[![Maven Central](https://img.shields.io/maven-central/v/com.mattbertolini/liquibase-slf4j.svg?label=Maven%20Central)](https://central.sonatype.com/artifact/com.mattbertolini/liquibase-slf4j)

[![javadoc](https://javadoc.io/badge2/com.mattbertolini/liquibase-slf4j/javadoc.svg)](https://javadoc.io/doc/com.mattbertolini/liquibase-slf4j)

[![Build Status](https://github.com/mattbertolini/liquibase-slf4j/actions/workflows/build.yml/badge.svg)](https://github.com/mattbertolini/liquibase-slf4j/actions/workflows/build.yml)



An implementation of the Liquibase logger that delegates directly to SLF4J.



Liquibase has a logging mechanism that delegates to `java.util.logging`. It works great with SLF4J out of the box if 

you use `jul-to-slf4j` library. Unfortunately, there is a known 

[performance impact](https://www.slf4j.org/legacy.html#jul-to-slf4j) when bridging `java.util.logging` to SLF4J. This 

library helps to eliminate that performance impact by logging Liquibase directly to SLF4J. 



## How to Use

Grab the library from Maven Central and place it in your classpath.



**Maven:**



```xml



    com.mattbertolini

    liquibase-slf4j

    5.1.0

    runtime



```



**Gradle:**



Groovy DSL:

```groovy

runtimeOnly 'com.mattbertolini:liquibase-slf4j:5.1.0'

```



Kotlin DSL:

```kotlin

runtimeOnly("com.mattbertolini:liquibase-slf4j:5.1.0")

```



**Ivy**



```xml



```



## License

liquibase-slf4j is licensed under the [MIT License](https://opensource.org/licenses/MIT)



## Notes

This logger has a priority number of 5. If there is more than one Liquibase logger on the classpath the one with the

highest priority will be used. The priority number can be changed by setting the system property 

`com.mattbertolini.liquibase.logging.slf4j.Slf4jLogService.priority` to an integer value of your choice.



Version 4 of Liquibase introduced a new plugin loading mechanism based on the Java 

[ServiceLoader](https://docs.oracle.com/javase/8/docs/api/java/util/ServiceLoader.html). Version 3.0.0 of this logger 

conforms to this new loader mechanism. If you are using Liquibase versions lower than 4, continue to use version 2.0.0 

of this library.



Liquibase version 3.4.0 had an issue loading third party loggers in some situations. This logger may not work on that 

version. It is recommended to upgrade to Liquibase 3.4.1 which addresses this issue.



### Log Level Mappings



    

        Liquibase Level

        SLF4J Level

    

    

        Debug (Deprecated)

        Debug

    

    

        Fine

        Debug

    

    

        Config

        Info

    

    

        Info

        Info

    

    

        Warning

        Warn

    

    

        Severe

        Error

    



## Build and Test

### Requirements

* [Apache Ant](https://ant.apache.org/) - Version 1.10.6 or higher.

* JDK 11 or higher (Compiled with 1.8 source and target).



### Build

To build this project, clone the repo and run the ```ant``` command:

```

git clone https://github.com/mattbertolini/liquibase-slf4j.git

cd liquibase-slf4j

ant

```



The distributable jar files will be located in the ```dist``` folder. The build reports (unit test, coverage, etc.) 

will be located in the ```build/reports``` dir.



To list all available tasks:

```

ant -p

```



## Bugs

Please report any bugs in the issue tracker above. Please be as detailed as possible in the report, so I can create

unit tests to verify the problem is fixed.



## Release Notes



**5.2.0-SNAPSHOT - TBD**



- Update to Ivy 2.5.3



**5.1.0 - 2024-11-19**



- Fix issue with JUL `Level.OFF` logging a message when no message should be logged ([#20](https://github.com/mattbertolini/liquibase-slf4j/issues/20)).

- Update to Liquibase 4.30.0.

- Update SLF4J to 2.0.16.

- Update build to Ivy 2.5.2.



**5.0.0 - 2023-03-20**



- Add JPMS module-info file to support Java 9+ modules.

- Build now requires Java 11 or higher. The source is still compiled to Java 8 bytecode.

- Upgraded to SLF4J 2.x (2.0.7)

- Upgrade to Liquibase 4.19.0

- Remove deprecated logging filter support.

- Switched from TravisCI to GitHub Actions.



**4.1.0 - 2022-03-30**



- Generated OSGi metadata making the jar a OSGi fragment where Liquibase is the host bundle. This was tested with 

Liquibase 4.9.1. This fixes issue [#12](https://github.com/mattbertolini/liquibase-slf4j/issues/12) 

([Pull Request](https://github.com/mattbertolini/liquibase-slf4j/pull/14))

- Upgraded to SLF4J 1.7.36

- Upgraded to Liquibase 4.9.1. The library should still work with Liquibase 4.1.0 and above when not using OSGi.



**4.0.0 - 2020-09-30**



- Upgraded Liquibase to version 4.1.0. This is a breaking change as the logging API introduced a new filter class and 

changed constructors. ([Pull Request](https://github.com/mattbertolini/liquibase-slf4j/pull/10))



**3.0.0 - 2020-07-23**



- Upgraded to Liquibase version 4.0.0. This is a breaking change as the logging API changed significantly. Use version 

2.x if you are using Liquibase versions lower than 4.0.0.

- Upgraded to SLF4J 1.7.30.

- Added the ability to change the priority number of the logger by setting a Java property. To change the priority, set 

  the `com.mattbertolini.liquibase.logging.slf4j.Slf4jLogService.priority` property to an integer value.

- Repackaged logger now that package name is no longer used for locating third-party loggers.

- Java 8 is now the minimum supported JDK version.

- Added an `Automatic-Module-Name` to support the Java 9+ module system. The module name is `com.mattbertolini.liquibase.logging.slf4j`.

- Overhauled build files.



**2.0.0 - 2015-12-16**



- Switched the dependency scope of SLF4J and Liquibase to `provided`. This is because most users are already including 

  their own versions of these libraries and the versions are often much newer than what is defined in this library. By 

  marking them as `provided` it helps prevent version conflicts and extra exclusions in project files. For an example of 

  this, check out the POM file from [Dropwizard](https://github.com/dropwizard/dropwizard/blob/a0bdb73053872e73762af4f940b893f78a363c2e/dropwizard-bom/pom.xml#L145-L159)

- The minimum required Liquibase version is now 3.2.0. This is done to take advantage of updates to `AbstractLogger`.



**1.2.1 - 2013-10-12**



- Only printing the changeLogName and changeSetName if they are provided. This gets rid of the annoying nulls printed

in logs.



**1.2.0 - 2013-09-30**



- Upgrading to Liquibase version 3.0.5 to add new required methods.



**1.1.0 - 2013-08-10**



- Upgrade Liquibase version to 3.0.x.

- Backward-compatible with previous version.



**1.0.0 - 2012-04-04**



- Initial release.

- Supports Liquibase 2.0.x.