Add batch JSON-RPC request handling to example app

Introduces a new route and controller action to handle batch JSON-RPC requests in the Rails single-file routing example. Updates the README with documentation and usage examples for batch requests, alongside individual 'echo' and 'ping' methods.

Author: wilsonsilva

examples/rails-single-file-routing/README.md

@@ -10,6 +10,10 @@ Uses constraints to route JSON-RPC requests to different Rails controller action
 class App < Rails::Application
   # ...
   routes.append do
+    # Handle batch requests
+    post '/', to: 'jsonrpc#ping_or_echo', constraints: JSONRPC::BatchConstraint.new
+
+    # Handle individual method requests
     post '/', to: 'jsonrpc#echo', constraints: JSONRPC::MethodConstraint.new('echo')
     post '/', to: 'jsonrpc#ping', constraints: JSONRPC::MethodConstraint.new('ping')
   end
@@ -25,6 +29,20 @@ class JsonrpcController < ActionController::Base
   def ping
     render jsonrpc: 'pong'
   end
+
+  # POST /
+  def ping_or_echo
+    results = jsonrpc_batch.process_each do |request_or_notification|
+      case request_or_notification.method
+      when 'echo'
+        request_or_notification.params
+      when 'ping'
+        'pong'
+      end
+    end
+
+    render jsonrpc: results
+  end
 end
 ```
 
@@ -36,18 +54,35 @@ bundle exec rackup
 
 ## API
 
-The server implements an echo API with these procedures:
+The server implements these procedures:
 
 - `echo` - Returns the input message
-- `ping` - Returns "pong"
+- `ping` - Returns `'pong'`
 
 ## Example Requests
 
+Echo request:
 ```sh
 curl -X POST http://localhost:9292 \
   -H "Content-Type: application/json" \
   -d '{"jsonrpc": "2.0", "method": "echo", "params": {"message": "Hello, World!"}, "id": 1}'
+```
+
+Ping request:
+```sh
+curl -X POST http://localhost:9292 \
+  -H "Content-Type: application/json" \
+  -d '{"jsonrpc": "2.0", "method": "ping", "params": {}, "id": 2}'
+```
+
+Batch request with multiple methods:
+```sh
+# Batch request with multiple methods
 curl -X POST http://localhost:9292 \
   -H "Content-Type: application/json" \
-  -d '{"jsonrpc": "2.0""method": "ping", "params": {}, "id": 2}'
+  -d '[
+    {"jsonrpc": "2.0", "method": "echo", "params": {"message": "Hello from batch!"}, "id": 1},
+    {"jsonrpc": "2.0", "method": "ping", "params": {}, "id": 2},
+    {"jsonrpc": "2.0", "method": "echo", "params": {"message": "Another echo"}, "id": 3}
+  ]'
 ```

examples/rails-single-file-routing/config.ru

@@ -37,6 +37,10 @@ class App < Rails::Application
   config.hosts.clear
 
   routes.append do
+    # Handle batch requests
+    post '/', to: 'jsonrpc#ping_or_echo', constraints: JSONRPC::BatchConstraint.new
+
+    # Handle individual method requests
     post '/', to: 'jsonrpc#echo', constraints: JSONRPC::MethodConstraint.new('echo')
     post '/', to: 'jsonrpc#ping', constraints: JSONRPC::MethodConstraint.new('ping')
   end
@@ -51,6 +55,19 @@ class JsonrpcController < ActionController::Base
   def ping
     render jsonrpc: 'pong'
   end
+
+  def ping_or_echo
+    results = jsonrpc_batch.process_each do |request_or_notification|
+      case request_or_notification.method
+      when 'echo'
+        request_or_notification.params
+      when 'ping'
+        'pong'
+      end
+    end
+
+    render jsonrpc: results
+  end
 end
 
 App.initialize!