Class PaymentController

java.lang.Object

io.github.ravocode.avoonce.sample.PaymentController

@RestController
@RequestMapping("/api/payments")
public class PaymentController
extends Object

Sample REST controller demonstrating selective idempotency protection for payment endpoints.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	PaymentController.PaymentRequest	Incoming payment request payload used by the controller.
static class	PaymentController.PaymentResponse	Response payload returned after processing a payment request.

Constructor Summary

Constructors

Constructor	Description
PaymentController()

Method Summary

Modifier and Type	Method	Description
int	getProcessCount()	Returns the number of processed payment requests seen by this sample controller.
org.springframework.http.ResponseEntity<PaymentController.PaymentResponse>	processPayment(PaymentController.PaymentRequest request)	Protected endpoint: annotated with Idempotent.
org.springframework.http.ResponseEntity<PaymentController.PaymentResponse>	processUnprotectedPayment(PaymentController.PaymentRequest request)	Unprotected endpoint: NOT annotated with Idempotent.
org.springframework.http.ResponseEntity<Void>	resetCount()	Resets the sample controller's processing counter.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

PaymentController

public PaymentController()

Method Details

processPayment

@PostMapping
@Idempotent
public org.springframework.http.ResponseEntity<PaymentController.PaymentResponse> processPayment(@RequestBody
 PaymentController.PaymentRequest request)

Protected endpoint: annotated with Idempotent. Deduplicated and cached in both GLOBAL mode and ANNOTATION mode.

Parameters:

request - the payment request payload

Returns:

a response entity containing the processing outcome

processUnprotectedPayment

@PostMapping("/unprotected")
public org.springframework.http.ResponseEntity<PaymentController.PaymentResponse> processUnprotectedPayment(@RequestBody
 PaymentController.PaymentRequest request)

Unprotected endpoint: NOT annotated with Idempotent. In ANNOTATION mode, requests to this endpoint bypass the idempotency filter.

Parameters:

request - the payment request payload

Returns:

a response entity containing the processing outcome

getProcessCount

@GetMapping("/count")
public int getProcessCount()

Returns the number of processed payment requests seen by this sample controller.

Returns:

the current process count

resetCount

@PostMapping("/reset")
public org.springframework.http.ResponseEntity<Void> resetCount()

Resets the sample controller's processing counter.

Returns:

an empty success response