docs(springboot openfeign): add an example to springboot-examples

this example can redirect order request to producer-app. It needs producer-app to run properly.

Signed-off-by: lony2003 <zhangke200377@outlook.com>

Author: lony2003

sdk-tests/src/test/java/io/dapr/it/spring/feign/PostgreBindingClient.java

@@ -2,11 +2,23 @@
 
 import io.dapr.spring.openfeign.annotation.UseDaprClient;
 import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestHeader;
+
+import java.util.List;
 
 import static io.dapr.it.spring.feign.DaprFeignIT.BINDING_NAME;
 
 @FeignClient(value = "postgres-binding", url = "http://binding." + BINDING_NAME)
 @UseDaprClient
 public interface PostgreBindingClient {
 
+  @PostMapping("/exec")
+  void exec(@RequestHeader("sql") String sql, @RequestHeader("params") List<String> params);
+
+  @PostMapping("/exec")
+  void exec(@RequestHeader("sql") String sql, @RequestHeader("params") String params);
+
+  @PostMapping("/query")
+  String query(@RequestHeader("sql") String sql, @RequestHeader("params") List<String> params);
 }

spring-boot-examples/README.md

@@ -1,12 +1,14 @@
 # Dapr Spring Boot and Testcontainers integration Example
 
-This example consists of two applications:
+This example consists of three applications:
 - Producer App: 
   - Publish messages using a Spring Messaging approach 
   - Store and retrieve information using Spring Data CrudRepository 
   - Implements a Workflow with Dapr Workflows
 - Consumer App:
   - Subscribe to messages
+- OpenFeign App:
+  - A proxy to Producer App Order API
 
 ## Running these examples from source code
 
@@ -68,6 +70,29 @@ cd consumer-app/
 <!-- END_STEP -->
 The `consumer-app` starts in port `8081` by default.
 
+And then run in a different terminal:
+
+<!-- STEP
+name: Run Demo OpenFeign Service
+match_order: none
+output_match_mode: substring
+expected_stdout_lines:
+- 'Started OpenFeignApplication'
+background: true
+expected_return_code: 143
+sleep: 30
+timeout_seconds: 45
+-->
+<!-- Timeout for above service must be more than sleep + timeout for the client-->
+
+```sh
+cd openfeign-app/
+../../mvnw -Dspring-boot.run.arguments="--reuse=true" spring-boot:test-run
+```
+
+<!-- END_STEP -->
+The `openfeign-app` starts in port `8083` by default.
+
 ## Interacting with the applications
 
 Now that both applications are up you can place an order by sending a POST request to `:8080/orders/`
@@ -92,6 +117,26 @@ curl -X POST localhost:8080/orders -H 'Content-Type: application/json' -d '{ "it
 
 <!-- END_STEP -->
 
+You can also send POST request to the `openfeign-app`, which redirect the request to the `producer-app`:
+
+<!-- STEP
+name: Send POST request to Producer App from OpenFeign App
+match_order: none
+output_match_mode: substring
+expected_stdout_lines:
+- 'Order Stored and Event Published'
+background: true
+sleep: 1
+timeout_seconds: 2
+-->
+<!-- Timeout for above service must be more than sleep + timeout for the client-->
+
+```sh
+curl -X POST localhost:8083/rpc/producer/orders -H 'Content-Type: application/json' -d '{ "item": "the mars volta EP", "amount": 1 }'
+```
+
+<!-- END_STEP -->
+
 
 If you check the `producer-app` logs you should see the following lines: 
 

spring-boot-examples/kubernetes/README.md

@@ -1,7 +1,7 @@
 # Running this example on Kubernetes
 
 To run this example on Kubernetes, you can use any Kubernetes distribution. 
-We install Dapr on a Kubernetes cluster and then we will deploy both the `producer-app` and `consumer-app`.
+We install Dapr on a Kubernetes cluster and then we will deploy the `producer-app`, `consumer-app` and `openfeign-app`.
 
 ## Creating a cluster and installing Dapr
 
@@ -77,6 +77,24 @@ docker push localhost:5001/sb-consumer-app
 podman push localhost:5001/sb-consumer-app --tls-verify=false
 ```
 
+From inside the `spring-boot-examples/openfeign-app` directory you can run the following command to create a container:
+```bash
+mvn spring-boot:build-image
+```
+
+Once we have the container image created, we need to tag and push to the local registry, so the image can be used from our local cluster.
+Alternatively, you can push the images to a public registry and update the Kubernetes manifests accordingly.
+
+```bash
+docker tag openfeign-app:0.15.0-SNAPSHOT localhost:5001/sb-openfeign-app
+docker push localhost:5001/sb-openfeign-app
+```
+
+**Note**: for Podman you need to run:
+```
+podman push localhost:5001/sb-openfeign-app --tls-verify=false
+```
+
 Now we are ready to install our application into the cluster.
 
 ## Installing and interacting with the application
@@ -107,7 +125,7 @@ Next you need to use `kubectl port-forward` to be able to send requests to the a
 kubectl port-forward svc/producer-app 8080:8080
 ```
 
-In a different terminals you can check the logs of the `producer-app` and `consumer-app`:
+In a different terminals you can check the logs of the `producer-app`, `consumer-app` and `openfeign-app`:
 
 ```bash
 kubectl logs -f producer-app-<POD_ID>
@@ -117,5 +135,8 @@ and
 ```bash
 kubectl logs -f consumer-app-<POD_ID>
 ```
+and
 
-
+```bash
+kubectl logs -f openfeign-app-<POD_ID>
+```

spring-boot-examples/kubernetes/openfeign-app.yaml

@@ -0,0 +1,45 @@
+apiVersion: v1
+kind: Service
+metadata:
+  labels:
+    app: openfeign-app
+  name: openfeign-app
+spec:
+  type: NodePort
+  ports:
+    - name: "openfeign-app"
+      port: 8083
+      targetPort: 8083
+      nodePort: 31003
+  selector:
+    app: openfeign-app
+
+---
+
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  labels:
+    app: openfeign-app
+  name: openfeign-app
+spec:
+  replicas: 1
+  selector:
+    matchLabels:
+      app: openfeign-app
+  template:
+    metadata:
+      annotations:
+        dapr.io/app-id: openfeign-app
+        dapr.io/app-port: "8083"
+        dapr.io/enabled: "true"
+      labels:
+        app: openfeign-app
+    spec:
+      containers:
+        - image: localhost:5001/sb-openfeign-app
+          name: openfeign-app
+          imagePullPolicy: Always
+          ports:
+            - containerPort: 8083
+              name: openfeign-app

spring-boot-examples/openfgien-app/pom.xml

@@ -0,0 +1,61 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <parent>
+        <groupId>io.dapr</groupId>
+        <artifactId>spring-boot-examples</artifactId>
+        <version>0.15.0-SNAPSHOT</version>
+    </parent>
+
+    <artifactId>openfgien-app</artifactId>
+    <name>openfgien-app</name>
+    <description>Spring Boot, Testcontainers and Dapr Integration Examples :: OpenFeign App</description>
+
+    <properties>
+        <maven.compiler.source>17</maven.compiler.source>
+        <maven.compiler.target>17</maven.compiler.target>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+    </properties>
+
+    <dependencies>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-web</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-actuator</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>io.dapr.spring</groupId>
+            <artifactId>dapr-spring-boot-starter</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.cloud</groupId>
+            <artifactId>spring-cloud-starter-openfeign</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>io.dapr.spring</groupId>
+            <artifactId>dapr-spring-openfeign</artifactId>
+            <version>${dapr.sdk.alpha.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>io.dapr.spring</groupId>
+            <artifactId>dapr-spring-boot-starter-test</artifactId>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.testcontainers</groupId>
+            <artifactId>junit-jupiter</artifactId>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>io.rest-assured</groupId>
+            <artifactId>rest-assured</artifactId>
+            <scope>test</scope>
+        </dependency>
+    </dependencies>
+
+</project>

spring-boot-examples/openfgien-app/src/main/java/io/dapr/springboot/examples/openfeign/OpenFeignApplication.java

@@ -0,0 +1,28 @@
+/*
+ * Copyright 2025 The Dapr Authors
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+package io.dapr.springboot.examples.openfeign;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+import org.springframework.cloud.openfeign.EnableFeignClients;
+
+@SpringBootApplication
+@EnableFeignClients
+public class OpenFeignApplication {
+
+  public static void main(String[] args) {
+    SpringApplication.run(OpenFeignApplication.class, args);
+  }
+
+}

spring-boot-examples/openfgien-app/src/main/java/io/dapr/springboot/examples/openfeign/Order.java

@@ -0,0 +1,52 @@
+/*
+ * Copyright 2025 The Dapr Authors
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+package io.dapr.springboot.examples.openfeign;
+
+public class Order {
+  private String id;
+  private String item;
+  private Integer amount;
+
+  public Order() {
+  }
+
+  public String getId() {
+    return id;
+  }
+
+  public void setId(String id) {
+    this.id = id;
+  }
+
+  public String getItem() {
+    return item;
+  }
+
+  public void setItem(String item) {
+    this.item = item;
+  }
+
+  public Integer getAmount() {
+    return amount;
+  }
+
+  public void setAmount(Integer amount) {
+    this.amount = amount;
+  }
+
+  @Override
+  public String toString() {
+    return "Order{" + "id='" + id + '\'' + ", item='" + item + '\'' + ", amount=" + amount + '}';
+  }
+}

spring-boot-examples/openfgien-app/src/main/java/io/dapr/springboot/examples/openfeign/ProducerClientRestController.java

@@ -0,0 +1,34 @@
+package io.dapr.springboot.examples.openfeign;
+
+import io.dapr.springboot.examples.openfeign.client.ProducerClient;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+@RestController
+@RequestMapping("/rpc/producer")
+public class ProducerClientRestController {
+  private final ProducerClient producerClient;
+
+  public ProducerClientRestController(ProducerClient producerClient) {
+    this.producerClient = producerClient;
+  }
+
+  @PostMapping("/orders")
+  public String storeOrder(@RequestBody Order order) {
+    return producerClient.storeOrder(order);
+  }
+
+  @GetMapping("/orders")
+  public Iterable<Order> getAll() {
+    return producerClient.getAll();
+  }
+
+  @GetMapping("/orders/byItem/")
+  public Iterable<Order> getAllByItem(@RequestParam("item") String item) {
+    return producerClient.getAllByItem(item);
+  }
+}

spring-boot-examples/openfgien-app/src/main/java/io/dapr/springboot/examples/openfeign/client/ProducerClient.java

@@ -0,0 +1,23 @@
+package io.dapr.springboot.examples.openfeign.client;
+
+import io.dapr.spring.openfeign.annotation.UseDaprClient;
+import io.dapr.springboot.examples.openfeign.Order;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestParam;
+
+@FeignClient(value = "producer-client", url = "http://method.producer-app/")
+@UseDaprClient
+public interface ProducerClient {
+
+  @PostMapping("/orders")
+  String storeOrder(@RequestBody Order order);
+
+  @GetMapping(value = "/orders", produces = "application/json")
+  Iterable<Order> getAll();
+
+  @GetMapping(value = "/orders/byItem/", produces = "application/json")
+  Iterable<Order> getAllByItem(@RequestParam("item") String item);
+}