spring-commons

Spring Commons - Tools for Spring

License	The Apache Software License, Version 2.0
GroupId	org.r10r
ArtifactId	spring-commons
Last Version	1.0.0
Release Date	Dec 3, 2019
Type	pom
Description	spring-commons Spring Commons - Tools for Spring
Project URL	http://github.com/r10r-org/spring-commons
Source Code Management	https://github.com/r10r-org/spring-commons

Download spring-commons

Filename	Size
spring-commons-1.0.0.pom	9 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/org.r10r/spring-commons/ -->
<dependency>
    <groupId>org.r10r</groupId>
    <artifactId>spring-commons</artifactId>
    <version>1.0.0</version>
    <type>pom</type>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/org.r10r/spring-commons/
implementation 'org.r10r:spring-commons:1.0.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/org.r10r/spring-commons/
implementation ("org.r10r:spring-commons:1.0.0")

Apache Buildr

'org.r10r:spring-commons:pom:1.0.0'

Apache Ivy

<dependency org="org.r10r" name="spring-commons" rev="1.0.0">
  <artifact name="spring-commons" type="pom" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='org.r10r', module='spring-commons', version='1.0.0')
)

Scala SBT

libraryDependencies += "org.r10r" % "spring-commons" % "1.0.0"

Leiningen

[org.r10r/spring-commons "1.0.0"]

Dependencies

provided (3)

Group / Artifact	Type	Version
org.springframework.boot : spring-boot	jar	2.1.8.RELEASE
org.springframework.boot : spring-boot-starter-jdbc	jar	2.1.8.RELEASE
com.google.guava : guava	jar	28.1-jre

Project Modules

There are no modules declared in this project.

Spring Commons - Usability tools for Spring

TransactionHelper

The @Transaction annotation in Spring has two big shortcomings.

1. They only rollback if they are configured via (rollbackFor = Throwable.class). Otherwise checked exceptions won't roll back the exception. This might be really unexpected.
2. Transactions might be inactive if placed on "private" methods, or if methods are not executed from another bean. This is really error prone as transactions might not be active even though annotations are there. Spring won't warn about that. Nothing. Ouch.

The TransactionHelper might help you in that case as it makes it explicit that there's a transaction. And it is less magic as it always rolls back on any exception.

Your mileage may vary. Especially the forced definition of return types is not really nice (transactionHelper.runI...).

This TransactionHelper can be injected into your class and the simply used via:

transactionHelper.runInTransaction(() ->
  // ... your code
)};

If you want to throw checked exception it gets a bit ugly as you have to specify them like that:

transactionHelper.<MyException>runInTransactionAndThrow(() ->
  // ... your code
)};

Less error-prone and it is more clear what happens.

Note: There's also Spring's TransactionTemplate, but it does not have support for checked exceptions..

Releasing (committers only)

Make sure you got gpg installed on your machine. Gpg is as good as gpg2, so there's not much difference. But the gpg plugin in maven works better with gpg, so we go with that one

brew install gpg

Make sure to create a key

gpg --gen-key

Then list the keys and send the public key to a keyserver so that people can verify that it's you:

gpg --keyserver hkp://pool.sks-keyservers.net --send-keys YOUR_PUBLIC_KEY

Make sure to set

export GPG_TTY=$(tty)

... that way any input of gpg will be properly shown (entering your passphrase for instance)...

Make sure you set the sonatype credentials in your ~/.m2/settings.xml:

<settings>

  <servers>
    <server>
      <id>ossrh</id>
      <username>USERNAME</username>
      <password>PASSWORD</password>
    </server>
  </servers>

</settings>

Then you can create a new release like so:

mvn release:clean -Prelease
mvn release:prepare -Prelease
mvn release:perform -Prelease

r10r.org

Versions

Version
1.0.0 Dec 3, 2019