4.5.7 release

Author: Alexander Furer

README.adoc

@@ -38,7 +38,7 @@ repositories {
 
 }
 dependencies {
-    compile 'io.github.lognet:grpc-spring-boot-starter:4.5.6'
+    compile 'io.github.lognet:grpc-spring-boot-starter:4.5.7'
 }
 
 
@@ -48,7 +48,7 @@ By default, starter pulls `io.grpc:grpc-netty-shaded`   as transitive dependency
 
 [source,groovy]
 ----
- compile ('io.github.lognet:grpc-spring-boot-starter:4.5.6') {
+ compile ('io.github.lognet:grpc-spring-boot-starter:4.5.7') {
   exclude group: 'io.grpc', module: 'grpc-netty-shaded'
  }
  compile 'io.grpc:grpc-netty:1.40.0' // <1>
@@ -327,7 +327,7 @@ you should see the `timer` named `grpc.server.calls`.
 ==== Custom tags support
 
 By defining `GRpcMetricsTagsContributor` bean in your application context, you can add custom tags to the `grpc.server.calls` timer. +
-You can also use `RequestAwareGRpcMetricsTagsContributor` bean to tag *unary* calls. +
+You can also use `RequestAwareGRpcMetricsTagsContributor` bean to tag *unary* and *streaming* calls. +
 Demo is https://github.com/LogNet/grpc-spring-boot-starter/blob/master/grpc-spring-boot-starter-demo/src/test/java/org/lognet/springboot/grpc/GrpcMeterTest.java[here]
 
 [TIP]
@@ -762,7 +762,6 @@ class MyClient{
 <3> Turn the binary format on/off: +
 * When `true`, the authentication header is sent with  `Authentication-bin` key using https://grpc.github.io/grpc-java/javadoc/io/grpc/Metadata.BinaryMarshaller.html[binary marshaller].
 * When `false`, the authentication header is sent with  `Authentication` key using https://grpc.github.io/grpc-java/javadoc/io/grpc/Metadata.AsciiMarshaller.html[ASCII marshaller].
-
 <4> Provide token generator function (Please refer to link:grpc-spring-boot-starter-demo/src/test/java/org/lognet/springboot/grpc/auth/JwtAuthBaseTest.java[for example].)
 
 Per-call::
@@ -798,6 +797,11 @@ class MyClient{
    .tokenSupplier(()->generateMyCustomToken())
 ----
 
+== Health check
+
+The starter registers the default implementation of https://github.com/grpc/grpc-java/blob/bab1fe38dc/services/src/main/java/io/grpc/protobuf/services/HealthServiceImpl.java[HealthServiceImpl]. +
+You can provide you own by registering link:./grpc-spring-boot-starter/src/main/java/org/lognet/springboot/grpc/health/ManagedHealthStatusService.java[ManagedHealthStatusService] bean in your application context.
+
 == Consul Integration
 
 Starting from version `3.3.0`, the starter will auto-register the running grpc server in Consul registry if `org.springframework.cloud:spring-cloud-starter-consul-discovery` is in classpath and
@@ -809,7 +813,26 @@ Setting `spring.cloud.consul.discovery.register-health-check` to true will regis
 
 Tags could be set by defining `spring.cloud.consul.discovery.tags` property.
 
-You can find the test that demonstrates the feature link:grpc-spring-boot-starter-demo/src/test/java/org/lognet/springboot/grpc/ConsulRegistrationTest.java[here].
+There are 3 supported registration  modes :
+
+. `SINGLE_SERVER_WITH_GLOBAL_CHECK` (default) +
+ In this mode the running grpc server is registered as single service with single `grpc` check with empty `serviceId`. +
+Please note that default implementation https://github.com/grpc/grpc-java/blob/bab1fe38dc50d4178955b79cfb1636afd2aa64df/services/src/main/java/io/grpc/protobuf/services/HealthServiceImpl.java#L64[does nothing] and simply returns `SERVING` status. You might want to provide  your custom <<Health check>> implementation for this mode.
+. `SINGLE_SERVER_WITH_CHECK_PER_SERVICE` +
+In this mode the running grpc server is registered as single service with check per each discovered `grpc` service.
+. `STANDALONE_SERVICES` +
+In this mode each discovered grpc service is  registered as single service with single check. Each registered service is tagged by its own service name.
+
+[source,yml]
+.You can control the desired mode from application.properties
+----
+grpc:
+  consule:
+    registration-mode: SINGLE_SERVER_WITH_CHECK_PER_SERVICE
+
+----
+
+
 
 == Eureka Integration
 

ReleaseNotes.md

@@ -1,5 +1,6 @@
 | Starter Version      | gRPC versions |Spring Boot version
 | -------------------- |:-------------:|:------------------:|
+| [4.5.7](#version-457)| 1.40.1        |2.5.0               |
 | [4.5.6](#version-456)| 1.40.0        |2.5.0               |
 | [4.5.5](#version-455)| 1.39.0        |2.5.0               |
 | [4.5.4](#version-454)| 1.38.0        |2.5.0               |
@@ -25,6 +26,23 @@
 | [4.0.0](#version-400)| 1.32.1        |2.3.3.RELEASE       |
 | [3.5.7](#version-357)| 1.31.1        |1.5.13.RELEASE      |
 
+# Version 4.5.7
+## :star: New Features
+
+- Support RequestAwareGRpcMetricsTagsContributor for Multiary Calls [#244](https://github.com/LogNet/grpc-spring-boot-starter/issues/244)
+- Custom service health check support [#242](https://github.com/LogNet/grpc-spring-boot-starter/issues/242)
+
+## :beetle: Bug Fixes
+
+- Interceptors do not block onHalfClose if they block the message [#240](https://github.com/LogNet/grpc-spring-boot-starter/issues/240)
+- Potential race condition when reporting running status of grpc server [#238](https://github.com/LogNet/grpc-spring-boot-starter/issues/238)
+
+## :hammer: Dependency Upgrades
+
+- Upgrade grpc to v1.40.1 [#243](https://github.com/LogNet/grpc-spring-boot-starter/issues/243)
+
+
+
 # Version 4.5.6
 ## :star: New Features
 

gradle.properties

@@ -5,7 +5,7 @@ gradleErrorPronePluginVersion=2.0.2
 errorProneVersion=2.7.1
 lombokVersion=1.18.20
 
-version=4.5.7-SNAPSHOT
+version=4.5.7
 group=io.github.lognet
 description=Spring Boot starter for Google RPC.
 gitHubUrl=https\://github.com/LogNet/grpc-spring-boot-starter

grpc-spring-boot-starter-gradle-plugin/README.adoc

@@ -23,7 +23,7 @@ Bootstraps the project with  `com.google.protobuf` gradle plugin (including `grp
 ----
 plugins {
     id 'java'
-    id "io.github.lognet.grpc-spring-boot" version '4.5.6'
+    id "io.github.lognet.grpc-spring-boot" version '4.5.7'
 }
 
 ----