springboot支付宝沙箱环境demo

### Spring Boot 集成支付宝沙箱环境的演示示例

为了展示如何在Spring Boot项目中集成支付宝沙箱环境，下面提供了一个简单的例子来说明主要组件和流程。

#### 1. 添加依赖项
首先，在`pom.xml`文件里加入必要的Maven依赖：

<dependency>
    <groupId>com.alipay.sdk</groupId>
    <artifactId>alipay-sdk-java</artifactId>
    <version>LATEST_VERSION_HERE</version>
</dependency>

注意替换`LATEST_VERSION_HERE`为实际最新版本号[^1]。

#### 2. 创建配置类
创建名为`AlipayConfig.java`的Java配置类用于设置应用ID、私钥以及公钥等信息:

@Configuration
public class AlipayConfig {
    
    @Value("${alipay.app-id}")
    private String appId;
    
    @Value("${alipay.merchant-private-key}")
    private String merchantPrivateKey;

    @Bean(name="alipayClient")
    public AlipayClient alipayClient() throws Exception{
        return new DefaultAlipayClient(
            "https://openapi.alipaydev.com/gateway.do", 
            appId, 
            merchantPrivateKey,
            "json",
            "UTF-8",
            ALIPAY_PUBLIC_KEY, // 这里的常量应该被替换成真实的支付宝公钥字符串
            "RSA2"
        );
    }
}

此部分展示了如何初始化一个`AlipayClient`实例以便后续调用API服务。

#### 3. 实现支付请求处理逻辑
定义控制器`PaymentController.java`用来接收前端发起的付款请求并构建相应的参数发送给支付宝网关：

@RestController
@RequestMapping("/pay/alipay")
public class PaymentController {

    @Autowired
    private AlipayClient alipayClient;

    @PostMapping("/create-order")
    public ResponseEntity<String> createOrder(@RequestBody Map<String,Object> orderDetails){
        
        try {
            AlipayTradePagePayRequest request = new AlipayTradePagePayRequest();
            
            JSONObject bizContentJson = new JSONObject(orderDetails);
            request.setBizContent(bizContentJson.toJSONString());

            String form = alipayClient.pageExecute(request).getBody();

            return ResponseEntity.ok(form);

        } catch (Exception e) {
            log.error("Failed to process payment.",e);
            throw new RuntimeException(e.getMessage());
        }

    }
}

上述代码片段解释了怎样通过POST方式接受来自客户端的数据，并将其转换成适合支付宝接口的形式提交出去。

#### 4. 处理异步通知
对于支付完成后由支付宝服务器主动推送过来的状态更新消息，则需编写专门的服务端点如`NotifyService.java`来进行验证与业务逻辑处理：

@Service
@Slf4j
public class NotifyService {

    @Autowired
    private PayDemoOrderController payDemoOrderController;

    @Transactional(rollbackFor=Exception.class)
    public void handleNotification(Map<String,String[]> paramsMap)throws AlipayApiException{

        boolean verifyResult = AlipaySignature.rsaCheckV1(paramsMap, 
                ALIPAY_PUBLIC_KEY,"utf-8","RSA2");

        if (!verifyResult) {
            log.warn("Invalid signature from Alipay.");
            return ;
        }

        String tradeStatus = paramsMap.get("trade_status")[0];
        String out_trade_no = paramsMap.get("out_trade_no")[0];

        switch(tradeStatus){
            case "TRADE_SUCCESS":
            case "TRADE_FINISHED":

                // 更新订单状态至已支付
                payDemoOrderController.updateDemoOrderPaid(out_trade_no); 

                break;
                
            default:
                log.info("Received unknown status:{}",tradeStatus);
        }
    }
}

这里描述的是接收到异步回调后的签名校验过程及其对应的订单状态变更操作[^2]。

---