优化下单流程
This commit is contained in:
245
docs/ORDER_FRONTEND_IMPLEMENTATION.md
Normal file
245
docs/ORDER_FRONTEND_IMPLEMENTATION.md
Normal file
@@ -0,0 +1,245 @@
|
||||
# 前端订单提交实现文档
|
||||
|
||||
## 概述
|
||||
|
||||
本文档描述了前端订单提交的完整实现,包括单商品下单、购物车批量下单等场景。
|
||||
|
||||
## 核心改进
|
||||
|
||||
### 1. 统一的API接口
|
||||
|
||||
**新的订单创建接口:**
|
||||
```typescript
|
||||
// 订单商品项
|
||||
interface OrderGoodsItem {
|
||||
goodsId: number;
|
||||
quantity: number;
|
||||
skuId?: number;
|
||||
specInfo?: string;
|
||||
}
|
||||
|
||||
// 创建订单请求
|
||||
interface OrderCreateRequest {
|
||||
goodsItems: OrderGoodsItem[];
|
||||
addressId?: number;
|
||||
payType: number;
|
||||
couponId?: number;
|
||||
comments?: string;
|
||||
deliveryType?: number;
|
||||
selfTakeMerchantId?: number;
|
||||
title?: string;
|
||||
}
|
||||
|
||||
// 微信支付返回数据
|
||||
interface WxPayResult {
|
||||
prepayId: string;
|
||||
orderNo: string;
|
||||
timeStamp: string;
|
||||
nonceStr: string;
|
||||
package: string;
|
||||
signType: string;
|
||||
paySign: string;
|
||||
}
|
||||
```
|
||||
|
||||
### 2. 标题长度限制
|
||||
|
||||
**工具函数:**
|
||||
```typescript
|
||||
// 截取文本,限制长度
|
||||
export function truncateText(text: string, maxLength: number = 30): string {
|
||||
if (!text) return '';
|
||||
if (text.length <= maxLength) return text;
|
||||
return text.substring(0, maxLength);
|
||||
}
|
||||
|
||||
// 生成订单标题
|
||||
export function generateOrderTitle(goodsNames: string[], maxLength: number = 30): string {
|
||||
if (!goodsNames || goodsNames.length === 0) return '商品订单';
|
||||
|
||||
let title = goodsNames.length === 1
|
||||
? goodsNames[0]
|
||||
: `${goodsNames[0]}等${goodsNames.length}件商品`;
|
||||
|
||||
return truncateText(title, maxLength);
|
||||
}
|
||||
```
|
||||
|
||||
## 实现细节
|
||||
|
||||
### 1. 单商品下单
|
||||
|
||||
**文件:** `src/shop/orderConfirm/index.tsx`
|
||||
|
||||
**核心逻辑:**
|
||||
```typescript
|
||||
const onWxPay = async (goods: ShopGoods) => {
|
||||
// 1. 校验收货地址
|
||||
if (!address) {
|
||||
Taro.showToast({ title: '请选择收货地址', icon: 'error' });
|
||||
return;
|
||||
}
|
||||
|
||||
Taro.showLoading({title: '支付中...'});
|
||||
|
||||
try {
|
||||
// 2. 构建订单数据
|
||||
const orderData: OrderCreateRequest = {
|
||||
goodsItems: [{ goodsId: goods.goodsId!, quantity: 1 }],
|
||||
addressId: address.id,
|
||||
payType: 1,
|
||||
comments: goods.name,
|
||||
deliveryType: 0
|
||||
};
|
||||
|
||||
// 3. 创建订单
|
||||
const result = await createOrder(orderData);
|
||||
|
||||
// 4. 微信支付
|
||||
if (result && result.prepayId) {
|
||||
await Taro.requestPayment({
|
||||
timeStamp: result.timeStamp,
|
||||
nonceStr: result.nonceStr,
|
||||
package: result.package,
|
||||
signType: result.signType,
|
||||
paySign: result.paySign,
|
||||
});
|
||||
|
||||
// 5. 支付成功处理
|
||||
Taro.showToast({ title: '支付成功', icon: 'success' });
|
||||
setTimeout(() => {
|
||||
Taro.switchTab({url: '/pages/order/order'});
|
||||
}, 2000);
|
||||
}
|
||||
} catch (error: any) {
|
||||
Taro.showToast({ title: error.message || '下单失败', icon: 'error' });
|
||||
} finally {
|
||||
Taro.hideLoading();
|
||||
}
|
||||
};
|
||||
```
|
||||
|
||||
### 2. 购物车批量下单
|
||||
|
||||
**文件:** `src/shop/orderConfirmCart/index.tsx`
|
||||
|
||||
**核心逻辑:**
|
||||
```typescript
|
||||
const onCartPay = async () => {
|
||||
// 1. 校验
|
||||
if (!address || !cartItems || cartItems.length === 0) {
|
||||
// 错误处理
|
||||
return;
|
||||
}
|
||||
|
||||
try {
|
||||
// 2. 构建批量商品数据
|
||||
const orderData: OrderCreateRequest = {
|
||||
goodsItems: cartItems.map(item => ({
|
||||
goodsId: item.goodsId!,
|
||||
quantity: item.quantity || 1
|
||||
})),
|
||||
addressId: address.id,
|
||||
payType: 1,
|
||||
comments: '购物车下单',
|
||||
deliveryType: 0
|
||||
};
|
||||
|
||||
// 3. 创建订单并支付
|
||||
const result = await createOrder(orderData);
|
||||
// ... 支付逻辑
|
||||
} catch (error) {
|
||||
// 错误处理
|
||||
}
|
||||
};
|
||||
```
|
||||
|
||||
## 数据流程
|
||||
|
||||
### 1. 前端提交流程
|
||||
|
||||
```
|
||||
用户点击支付
|
||||
↓
|
||||
校验地址和商品
|
||||
↓
|
||||
构建OrderCreateRequest
|
||||
↓
|
||||
调用createOrder API
|
||||
↓
|
||||
后端返回WxPayResult
|
||||
↓
|
||||
调用微信支付
|
||||
↓
|
||||
支付成功跳转
|
||||
```
|
||||
|
||||
### 2. 后端处理流程
|
||||
|
||||
```
|
||||
接收OrderCreateRequest
|
||||
↓
|
||||
参数校验
|
||||
↓
|
||||
构建订单主表
|
||||
↓
|
||||
保存订单商品明细
|
||||
↓
|
||||
库存扣减
|
||||
↓
|
||||
生成订单标题(≤30字)
|
||||
↓
|
||||
创建微信支付
|
||||
↓
|
||||
返回支付参数
|
||||
```
|
||||
|
||||
## 关键特性
|
||||
|
||||
### 1. 数据安全
|
||||
- 前端只传递商品ID和数量
|
||||
- 价格、库存等敏感信息由后端实时获取
|
||||
- 防止前端数据篡改
|
||||
|
||||
### 2. 业务完整性
|
||||
- 统一的订单创建流程
|
||||
- 完整的错误处理机制
|
||||
- 支持多种下单场景
|
||||
|
||||
### 3. 用户体验
|
||||
- 清晰的加载状态
|
||||
- 友好的错误提示
|
||||
- 自动跳转到订单页面
|
||||
|
||||
## 扩展功能
|
||||
|
||||
### 1. 支持的下单类型
|
||||
- 单商品立即购买
|
||||
- 购物车批量下单
|
||||
- 自提订单
|
||||
- 使用优惠券下单
|
||||
|
||||
### 2. 支持的配送方式
|
||||
- 快递配送 (deliveryType: 0)
|
||||
- 到店自提 (deliveryType: 1)
|
||||
|
||||
### 3. 支持的支付方式
|
||||
- 微信支付 (payType: 1)
|
||||
- 余额支付 (payType: 0)
|
||||
- 其他支付方式...
|
||||
|
||||
## 注意事项
|
||||
|
||||
1. **标题长度限制**:订单标题最多30个汉字,超过自动截取
|
||||
2. **库存校验**:后端会实时校验商品库存
|
||||
3. **地址校验**:确保收货地址属于当前用户
|
||||
4. **错误处理**:完善的异常捕获和用户提示
|
||||
5. **支付安全**:支付参数由后端生成,前端不可篡改
|
||||
|
||||
## 测试建议
|
||||
|
||||
1. 测试单商品下单流程
|
||||
2. 测试购物车批量下单
|
||||
3. 测试各种异常情况(库存不足、地址无效等)
|
||||
4. 测试支付成功和失败的处理
|
||||
5. 测试订单标题长度限制功能
|
||||
264
docs/PAYMENT_REFACTOR_GUIDE.md
Normal file
264
docs/PAYMENT_REFACTOR_GUIDE.md
Normal file
@@ -0,0 +1,264 @@
|
||||
# 支付逻辑重构指南
|
||||
|
||||
## 概述
|
||||
|
||||
本文档描述了支付逻辑的重构过程,将原本分散的支付代码统一整合,提高了代码的可维护性和复用性。
|
||||
|
||||
## 重构前后对比
|
||||
|
||||
### 重构前的问题
|
||||
|
||||
1. **代码重复**:每个支付方式都有重复的订单构建逻辑
|
||||
2. **维护困难**:支付逻辑分散在多个方法中
|
||||
3. **扩展性差**:添加新的支付方式需要修改多处代码
|
||||
|
||||
### 重构后的优势
|
||||
|
||||
1. **统一入口**:所有支付都通过 `onPay` 方法处理
|
||||
2. **代码复用**:订单构建逻辑统一封装
|
||||
3. **易于扩展**:新增支付方式只需在工具类中添加
|
||||
4. **错误处理统一**:所有支付的错误处理逻辑一致
|
||||
|
||||
## 核心改进
|
||||
|
||||
### 1. 统一的支付工具类
|
||||
|
||||
**文件:** `src/utils/payment.ts`
|
||||
|
||||
```typescript
|
||||
// 支付类型枚举
|
||||
export enum PaymentType {
|
||||
BALANCE = 0, // 余额支付
|
||||
WECHAT = 1, // 微信支付
|
||||
ALIPAY = 3, // 支付宝支付
|
||||
}
|
||||
|
||||
// 统一支付处理类
|
||||
export class PaymentHandler {
|
||||
static async pay(
|
||||
orderData: OrderCreateRequest,
|
||||
paymentType: PaymentType,
|
||||
callback?: PaymentCallback
|
||||
): Promise<void> {
|
||||
// 统一的支付处理逻辑
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 2. 订单数据构建函数
|
||||
|
||||
```typescript
|
||||
// 单商品订单
|
||||
export function buildSingleGoodsOrder(
|
||||
goodsId: number,
|
||||
quantity: number = 1,
|
||||
addressId?: number,
|
||||
options?: {
|
||||
comments?: string;
|
||||
deliveryType?: number;
|
||||
couponId?: number;
|
||||
}
|
||||
): OrderCreateRequest
|
||||
|
||||
// 购物车订单
|
||||
export function buildCartOrder(
|
||||
cartItems: Array<{ goodsId: number; quantity: number }>,
|
||||
addressId?: number,
|
||||
options?: { ... }
|
||||
): OrderCreateRequest
|
||||
```
|
||||
|
||||
### 3. 简化的支付入口
|
||||
|
||||
**重构前:**
|
||||
```typescript
|
||||
const onWxPay = async (goods: ShopGoods) => {
|
||||
// 校验逻辑
|
||||
// 构建订单数据
|
||||
// 调用创建订单API
|
||||
// 处理微信支付
|
||||
// 错误处理
|
||||
}
|
||||
|
||||
const onBalancePay = async (goods: ShopGoods) => {
|
||||
// 重复的校验逻辑
|
||||
// 重复的订单构建逻辑
|
||||
// 处理余额支付
|
||||
// 重复的错误处理
|
||||
}
|
||||
|
||||
const onPay = async (goods: ShopGoods) => {
|
||||
if (payment?.type == 0) {
|
||||
await onBalancePay(goods)
|
||||
}
|
||||
if (payment?.type == 1) {
|
||||
await onWxPay(goods)
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**重构后:**
|
||||
```typescript
|
||||
const onPay = async (goods: ShopGoods) => {
|
||||
// 基础校验
|
||||
if (!address || !payment) {
|
||||
// 错误提示
|
||||
return;
|
||||
}
|
||||
|
||||
// 构建订单数据
|
||||
const orderData = buildSingleGoodsOrder(
|
||||
goods.goodsId!,
|
||||
1,
|
||||
address.id,
|
||||
{ comments: goods.name }
|
||||
);
|
||||
|
||||
// 选择支付类型
|
||||
const paymentType = payment.type === 0 ? PaymentType.BALANCE : PaymentType.WECHAT;
|
||||
|
||||
// 执行支付
|
||||
await PaymentHandler.pay(orderData, paymentType);
|
||||
};
|
||||
```
|
||||
|
||||
## 使用示例
|
||||
|
||||
### 1. 单商品下单
|
||||
|
||||
```typescript
|
||||
// 在 orderConfirm/index.tsx 中
|
||||
const onPay = async (goods: ShopGoods) => {
|
||||
if (!address || !payment) return;
|
||||
|
||||
const orderData = buildSingleGoodsOrder(
|
||||
goods.goodsId!,
|
||||
1,
|
||||
address.id,
|
||||
{
|
||||
comments: goods.name,
|
||||
deliveryType: 0
|
||||
}
|
||||
);
|
||||
|
||||
const paymentType = payment.type === 0 ? PaymentType.BALANCE : PaymentType.WECHAT;
|
||||
await PaymentHandler.pay(orderData, paymentType);
|
||||
};
|
||||
```
|
||||
|
||||
### 2. 购物车批量下单
|
||||
|
||||
```typescript
|
||||
// 在 orderConfirmCart/index.tsx 中
|
||||
const onPay = async () => {
|
||||
if (!address || !cartItems?.length) return;
|
||||
|
||||
const orderData = buildCartOrder(
|
||||
cartItems.map(item => ({
|
||||
goodsId: item.goodsId!,
|
||||
quantity: item.quantity || 1
|
||||
})),
|
||||
address.id,
|
||||
{
|
||||
comments: '购物车下单',
|
||||
deliveryType: 0
|
||||
}
|
||||
);
|
||||
|
||||
const paymentType = payment?.type === 0 ? PaymentType.BALANCE : PaymentType.WECHAT;
|
||||
await PaymentHandler.pay(orderData, paymentType);
|
||||
};
|
||||
```
|
||||
|
||||
### 3. 使用优惠券下单
|
||||
|
||||
```typescript
|
||||
const onPayWithCoupon = async (goods: ShopGoods, couponId: number) => {
|
||||
const orderData = buildSingleGoodsOrder(
|
||||
goods.goodsId!,
|
||||
1,
|
||||
address.id,
|
||||
{
|
||||
comments: `使用优惠券购买${goods.name}`,
|
||||
couponId: couponId
|
||||
}
|
||||
);
|
||||
|
||||
await PaymentHandler.pay(orderData, PaymentType.WECHAT);
|
||||
};
|
||||
```
|
||||
|
||||
### 4. 自提订单
|
||||
|
||||
```typescript
|
||||
const onSelfPickupOrder = async (goods: ShopGoods, merchantId: number) => {
|
||||
const orderData = buildSingleGoodsOrder(
|
||||
goods.goodsId!,
|
||||
1,
|
||||
address.id,
|
||||
{
|
||||
comments: `自提订单 - ${goods.name}`,
|
||||
deliveryType: 1,
|
||||
selfTakeMerchantId: merchantId
|
||||
}
|
||||
);
|
||||
|
||||
await PaymentHandler.pay(orderData, PaymentType.WECHAT);
|
||||
};
|
||||
```
|
||||
|
||||
## 扩展新的支付方式
|
||||
|
||||
### 1. 添加支付类型
|
||||
|
||||
```typescript
|
||||
// 在 PaymentType 枚举中添加
|
||||
export enum PaymentType {
|
||||
BALANCE = 0,
|
||||
WECHAT = 1,
|
||||
ALIPAY = 3,
|
||||
UNIONPAY = 4, // 新增银联支付
|
||||
}
|
||||
```
|
||||
|
||||
### 2. 实现支付处理方法
|
||||
|
||||
```typescript
|
||||
// 在 PaymentHandler 类中添加
|
||||
private static async handleUnionPay(result: any): Promise<void> {
|
||||
// 银联支付逻辑
|
||||
}
|
||||
```
|
||||
|
||||
### 3. 在支付分发中添加
|
||||
|
||||
```typescript
|
||||
// 在 PaymentHandler.pay 方法中添加
|
||||
switch (paymentType) {
|
||||
case PaymentType.WECHAT:
|
||||
await this.handleWechatPay(result);
|
||||
break;
|
||||
case PaymentType.BALANCE:
|
||||
await this.handleBalancePay(result);
|
||||
break;
|
||||
case PaymentType.UNIONPAY: // 新增
|
||||
await this.handleUnionPay(result);
|
||||
break;
|
||||
// ...
|
||||
}
|
||||
```
|
||||
|
||||
## 优势总结
|
||||
|
||||
1. **代码简洁**:支付入口方法从 50+ 行减少到 20+ 行
|
||||
2. **逻辑清晰**:订单构建、支付处理、错误处理分离
|
||||
3. **易于测试**:每个功能模块独立,便于单元测试
|
||||
4. **维护性强**:修改支付逻辑只需在工具类中修改
|
||||
5. **扩展性好**:新增支付方式无需修改业务代码
|
||||
|
||||
## 注意事项
|
||||
|
||||
1. **向后兼容**:确保重构后的接口与原有调用方式兼容
|
||||
2. **错误处理**:统一的错误处理机制,确保用户体验一致
|
||||
3. **类型安全**:使用 TypeScript 枚举确保支付类型的类型安全
|
||||
4. **测试覆盖**:对重构后的代码进行充分的测试
|
||||
248
docs/backend-order-service-example.java
Normal file
248
docs/backend-order-service-example.java
Normal file
@@ -0,0 +1,248 @@
|
||||
/**
|
||||
* 订单服务实现类示例
|
||||
* 展示如何保存订单商品信息的业务逻辑
|
||||
*/
|
||||
@Service
|
||||
@Transactional(rollbackFor = Exception.class)
|
||||
public class ShopOrderServiceImpl implements ShopOrderService {
|
||||
|
||||
@Autowired
|
||||
private ShopOrderMapper shopOrderMapper;
|
||||
|
||||
@Autowired
|
||||
private OrderGoodsMapper orderGoodsMapper;
|
||||
|
||||
@Autowired
|
||||
private ShopGoodsService shopGoodsService;
|
||||
|
||||
@Autowired
|
||||
private ShopUserAddressService addressService;
|
||||
|
||||
@Autowired
|
||||
private WxPayService wxPayService;
|
||||
|
||||
/**
|
||||
* 创建订单
|
||||
*/
|
||||
@Override
|
||||
@Transactional(rollbackFor = Exception.class)
|
||||
public Map<String, String> createOrder(OrderCreateRequest request, User loginUser) {
|
||||
// 1. 参数校验
|
||||
validateOrderRequest(request, loginUser);
|
||||
|
||||
// 2. 构建订单对象
|
||||
ShopOrder shopOrder = buildShopOrder(request, loginUser);
|
||||
|
||||
// 3. 应用业务规则
|
||||
applyBusinessRules(shopOrder, loginUser);
|
||||
|
||||
// 4. 保存订单主表
|
||||
boolean saved = shopOrderMapper.insert(shopOrder) > 0;
|
||||
if (!saved) {
|
||||
throw new BusinessException("订单保存失败");
|
||||
}
|
||||
|
||||
// 5. 保存订单商品明细 - 核心业务逻辑
|
||||
saveOrderGoods(shopOrder, request.getGoodsItems());
|
||||
|
||||
// 6. 创建微信支付订单
|
||||
try {
|
||||
return wxPayService.createWxOrder(shopOrder);
|
||||
} catch (Exception e) {
|
||||
log.error("创建微信支付订单失败,订单号:{}", shopOrder.getOrderNo(), e);
|
||||
throw new BusinessException("创建支付订单失败:" + e.getMessage());
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 保存订单商品明细 - 核心实现
|
||||
*/
|
||||
private void saveOrderGoods(ShopOrder shopOrder, List<OrderGoodsItem> goodsItems) {
|
||||
List<OrderGoods> orderGoodsList = new ArrayList<>();
|
||||
BigDecimal totalPrice = BigDecimal.ZERO;
|
||||
int totalQuantity = 0;
|
||||
List<String> goodsNames = new ArrayList<>();
|
||||
|
||||
for (OrderGoodsItem item : goodsItems) {
|
||||
// 1. 获取商品最新信息进行校验
|
||||
ShopGoods goods = shopGoodsService.getById(item.getGoodsId());
|
||||
if (goods == null) {
|
||||
throw new BusinessException("商品不存在:" + item.getGoodsId());
|
||||
}
|
||||
|
||||
// 2. 商品状态校验
|
||||
if (goods.getIsShow() != 1) {
|
||||
throw new BusinessException("商品已下架:" + goods.getName());
|
||||
}
|
||||
|
||||
// 3. 库存校验
|
||||
if (goods.getStock() < item.getQuantity()) {
|
||||
throw new BusinessException("商品库存不足:" + goods.getName());
|
||||
}
|
||||
|
||||
// 4. 价格计算(以数据库中的价格为准)
|
||||
BigDecimal itemPrice = new BigDecimal(goods.getPrice());
|
||||
BigDecimal itemTotalPrice = itemPrice.multiply(new BigDecimal(item.getQuantity()));
|
||||
|
||||
// 5. 构建订单商品记录
|
||||
OrderGoods orderGoods = new OrderGoods();
|
||||
orderGoods.setOrderId(shopOrder.getOrderId());
|
||||
orderGoods.setGoodsId(item.getGoodsId());
|
||||
orderGoods.setTotalNum(item.getQuantity());
|
||||
orderGoods.setPayPrice(itemTotalPrice.toString());
|
||||
orderGoods.setType(0); // 0商城
|
||||
orderGoods.setPayStatus("0"); // 0未付款
|
||||
orderGoods.setOrderStatus(0); // 0未完成
|
||||
orderGoods.setUserId(shopOrder.getUserId());
|
||||
orderGoods.setTenantId(shopOrder.getTenantId());
|
||||
orderGoods.setCreateTime(LocalDateTime.now());
|
||||
|
||||
// 6. SKU信息处理(如果有规格)
|
||||
if (item.getSkuId() != null) {
|
||||
// 处理SKU相关逻辑
|
||||
// orderGoods.setSkuId(item.getSkuId());
|
||||
// orderGoods.setSpecInfo(item.getSpecInfo());
|
||||
}
|
||||
|
||||
orderGoodsList.add(orderGoods);
|
||||
|
||||
// 7. 累计计算
|
||||
totalPrice = totalPrice.add(itemTotalPrice);
|
||||
totalQuantity += item.getQuantity();
|
||||
goodsNames.add(goods.getName());
|
||||
|
||||
// 8. 扣减库存(根据业务需求,可能在支付成功后扣减)
|
||||
if (goods.getDeductStockType() == 10) { // 10下单减库存
|
||||
goods.setStock(goods.getStock() - item.getQuantity());
|
||||
shopGoodsService.updateById(goods);
|
||||
}
|
||||
}
|
||||
|
||||
// 9. 批量保存订单商品
|
||||
if (!orderGoodsList.isEmpty()) {
|
||||
orderGoodsMapper.insertBatch(orderGoodsList);
|
||||
}
|
||||
|
||||
// 10. 更新订单总价和数量
|
||||
shopOrder.setTotalPrice(totalPrice.toString());
|
||||
shopOrder.setPayPrice(totalPrice.toString()); // 暂时不考虑优惠
|
||||
shopOrder.setTotalNum(totalQuantity);
|
||||
|
||||
// 11. 生成订单标题(限制30个汉字)
|
||||
String title = generateOrderTitle(goodsNames);
|
||||
shopOrder.setTitle(title);
|
||||
|
||||
// 12. 更新订单主表
|
||||
shopOrderMapper.updateById(shopOrder);
|
||||
}
|
||||
|
||||
/**
|
||||
* 生成订单标题,限制长度不超过30个汉字
|
||||
*/
|
||||
private String generateOrderTitle(List<String> goodsNames) {
|
||||
if (goodsNames.isEmpty()) {
|
||||
return "商品订单";
|
||||
}
|
||||
|
||||
String title;
|
||||
if (goodsNames.size() == 1) {
|
||||
title = goodsNames.get(0);
|
||||
} else {
|
||||
title = goodsNames.get(0) + "等" + goodsNames.size() + "件商品";
|
||||
}
|
||||
|
||||
// 限制标题长度最多30个汉字
|
||||
if (title.length() > 30) {
|
||||
title = title.substring(0, 30);
|
||||
}
|
||||
|
||||
return title;
|
||||
}
|
||||
|
||||
/**
|
||||
* 参数校验
|
||||
*/
|
||||
private void validateOrderRequest(OrderCreateRequest request, User loginUser) {
|
||||
if (request.getGoodsItems() == null || request.getGoodsItems().isEmpty()) {
|
||||
throw new BusinessException("商品信息不能为空");
|
||||
}
|
||||
|
||||
if (request.getAddressId() == null) {
|
||||
throw new BusinessException("收货地址不能为空");
|
||||
}
|
||||
|
||||
// 校验收货地址是否属于当前用户
|
||||
ShopUserAddress address = addressService.getById(request.getAddressId());
|
||||
if (address == null || !address.getUserId().equals(loginUser.getUserId())) {
|
||||
throw new BusinessException("收货地址不存在或不属于当前用户");
|
||||
}
|
||||
|
||||
// 校验商品数量
|
||||
for (OrderGoodsItem item : request.getGoodsItems()) {
|
||||
if (item.getGoodsId() == null || item.getQuantity() <= 0) {
|
||||
throw new BusinessException("商品信息不正确");
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 构建订单对象
|
||||
*/
|
||||
private ShopOrder buildShopOrder(OrderCreateRequest request, User loginUser) {
|
||||
ShopOrder shopOrder = new ShopOrder();
|
||||
|
||||
// 基础信息
|
||||
shopOrder.setOrderNo(generateOrderNo());
|
||||
shopOrder.setType(0); // 0商城订单
|
||||
shopOrder.setChannel(0); // 0小程序
|
||||
shopOrder.setUserId(loginUser.getUserId());
|
||||
shopOrder.setTenantId(loginUser.getTenantId());
|
||||
|
||||
// 用户信息
|
||||
shopOrder.setRealName(loginUser.getRealName());
|
||||
shopOrder.setPhone(loginUser.getPhone());
|
||||
|
||||
// 地址信息
|
||||
ShopUserAddress address = addressService.getById(request.getAddressId());
|
||||
shopOrder.setAddressId(request.getAddressId());
|
||||
shopOrder.setAddress(address.getProvince() + address.getCity() +
|
||||
address.getRegion() + address.getAddress());
|
||||
|
||||
// 支付信息
|
||||
shopOrder.setPayType(request.getPayType());
|
||||
shopOrder.setPayStatus(0); // 0未付款
|
||||
shopOrder.setOrderStatus(0); // 0未使用
|
||||
|
||||
// 配送信息
|
||||
shopOrder.setDeliveryType(request.getDeliveryType());
|
||||
if (request.getSelfTakeMerchantId() != null) {
|
||||
shopOrder.setSelfTakeMerchantId(request.getSelfTakeMerchantId());
|
||||
}
|
||||
|
||||
// 其他信息
|
||||
shopOrder.setComments(request.getComments());
|
||||
shopOrder.setCreateTime(LocalDateTime.now());
|
||||
|
||||
return shopOrder;
|
||||
}
|
||||
|
||||
/**
|
||||
* 应用业务规则
|
||||
*/
|
||||
private void applyBusinessRules(ShopOrder shopOrder, User loginUser) {
|
||||
// 设置默认标题(如果没有设置)
|
||||
if (shopOrder.getTitle() == null) {
|
||||
shopOrder.setTitle("商品订单");
|
||||
}
|
||||
|
||||
// 其他业务规则...
|
||||
}
|
||||
|
||||
/**
|
||||
* 生成订单号
|
||||
*/
|
||||
private String generateOrderNo() {
|
||||
return "SO" + System.currentTimeMillis() +
|
||||
String.format("%04d", new Random().nextInt(10000));
|
||||
}
|
||||
}
|
||||
317
docs/frontend-order-example.tsx
Normal file
317
docs/frontend-order-example.tsx
Normal file
@@ -0,0 +1,317 @@
|
||||
/**
|
||||
* 前端订单提交完整示例
|
||||
* 展示如何使用新的订单API进行下单
|
||||
*/
|
||||
import React, { useState, useEffect } from 'react';
|
||||
import Taro from '@tarojs/taro';
|
||||
import { Button } from '@nutui/nutui-react-taro';
|
||||
import { createOrder } from '@/api/shop/shopOrder';
|
||||
import { OrderCreateRequest, OrderGoodsItem } from '@/api/shop/shopOrder/model';
|
||||
import { ShopGoods } from '@/api/shop/shopGoods/model';
|
||||
import { ShopUserAddress } from '@/api/shop/shopUserAddress/model';
|
||||
import { generateOrderTitle } from '@/utils/common';
|
||||
|
||||
interface OrderExampleProps {
|
||||
goods: ShopGoods;
|
||||
address: ShopUserAddress;
|
||||
quantity?: number;
|
||||
}
|
||||
|
||||
const OrderExample: React.FC<OrderExampleProps> = ({
|
||||
goods,
|
||||
address,
|
||||
quantity = 1
|
||||
}) => {
|
||||
const [loading, setLoading] = useState(false);
|
||||
|
||||
/**
|
||||
* 单商品下单示例
|
||||
*/
|
||||
const handleSingleGoodsOrder = async () => {
|
||||
if (!address) {
|
||||
Taro.showToast({
|
||||
title: '请选择收货地址',
|
||||
icon: 'error'
|
||||
});
|
||||
return;
|
||||
}
|
||||
|
||||
setLoading(true);
|
||||
|
||||
try {
|
||||
// 1. 构建订单请求数据
|
||||
const orderData: OrderCreateRequest = {
|
||||
goodsItems: [
|
||||
{
|
||||
goodsId: goods.goodsId!,
|
||||
quantity: quantity
|
||||
}
|
||||
],
|
||||
addressId: address.id,
|
||||
payType: 1, // 微信支付
|
||||
comments: `购买${goods.name}`,
|
||||
deliveryType: 0, // 快递配送
|
||||
// 可选:自定义订单标题
|
||||
title: generateOrderTitle([goods.name!])
|
||||
};
|
||||
|
||||
// 2. 调用创建订单API
|
||||
const result = await createOrder(orderData);
|
||||
|
||||
if (result && result.prepayId) {
|
||||
// 3. 调用微信支付
|
||||
await Taro.requestPayment({
|
||||
timeStamp: result.timeStamp,
|
||||
nonceStr: result.nonceStr,
|
||||
package: result.package,
|
||||
signType: result.signType,
|
||||
paySign: result.paySign,
|
||||
});
|
||||
|
||||
// 4. 支付成功处理
|
||||
Taro.showToast({
|
||||
title: '支付成功',
|
||||
icon: 'success'
|
||||
});
|
||||
|
||||
setTimeout(() => {
|
||||
Taro.switchTab({url: '/pages/order/order'});
|
||||
}, 2000);
|
||||
}
|
||||
} catch (error: any) {
|
||||
console.error('下单失败:', error);
|
||||
Taro.showToast({
|
||||
title: error.message || '下单失败',
|
||||
icon: 'error'
|
||||
});
|
||||
} finally {
|
||||
setLoading(false);
|
||||
}
|
||||
};
|
||||
|
||||
/**
|
||||
* 购物车批量下单示例
|
||||
*/
|
||||
const handleCartOrder = async (cartItems: Array<{goodsId: number, quantity: number, goodsName: string}>) => {
|
||||
if (!address) {
|
||||
Taro.showToast({
|
||||
title: '请选择收货地址',
|
||||
icon: 'error'
|
||||
});
|
||||
return;
|
||||
}
|
||||
|
||||
if (!cartItems || cartItems.length === 0) {
|
||||
Taro.showToast({
|
||||
title: '购物车为空',
|
||||
icon: 'error'
|
||||
});
|
||||
return;
|
||||
}
|
||||
|
||||
setLoading(true);
|
||||
|
||||
try {
|
||||
// 1. 构建订单商品列表
|
||||
const goodsItems: OrderGoodsItem[] = cartItems.map(item => ({
|
||||
goodsId: item.goodsId,
|
||||
quantity: item.quantity
|
||||
}));
|
||||
|
||||
// 2. 生成订单标题
|
||||
const goodsNames = cartItems.map(item => item.goodsName);
|
||||
const orderTitle = generateOrderTitle(goodsNames);
|
||||
|
||||
// 3. 构建订单请求数据
|
||||
const orderData: OrderCreateRequest = {
|
||||
goodsItems,
|
||||
addressId: address.id,
|
||||
payType: 1, // 微信支付
|
||||
comments: '购物车下单',
|
||||
deliveryType: 0, // 快递配送
|
||||
title: orderTitle
|
||||
};
|
||||
|
||||
// 4. 调用创建订单API
|
||||
const result = await createOrder(orderData);
|
||||
|
||||
if (result && result.prepayId) {
|
||||
// 5. 调用微信支付
|
||||
await Taro.requestPayment({
|
||||
timeStamp: result.timeStamp,
|
||||
nonceStr: result.nonceStr,
|
||||
package: result.package,
|
||||
signType: result.signType,
|
||||
paySign: result.paySign,
|
||||
});
|
||||
|
||||
// 6. 支付成功处理
|
||||
Taro.showToast({
|
||||
title: '支付成功',
|
||||
icon: 'success'
|
||||
});
|
||||
|
||||
// 7. 清空购物车(可选)
|
||||
// clearCart();
|
||||
|
||||
setTimeout(() => {
|
||||
Taro.switchTab({url: '/pages/order/order'});
|
||||
}, 2000);
|
||||
}
|
||||
} catch (error: any) {
|
||||
console.error('下单失败:', error);
|
||||
Taro.showToast({
|
||||
title: error.message || '下单失败',
|
||||
icon: 'error'
|
||||
});
|
||||
} finally {
|
||||
setLoading(false);
|
||||
}
|
||||
};
|
||||
|
||||
/**
|
||||
* 自提订单示例
|
||||
*/
|
||||
const handleSelfPickupOrder = async (merchantId: number) => {
|
||||
setLoading(true);
|
||||
|
||||
try {
|
||||
const orderData: OrderCreateRequest = {
|
||||
goodsItems: [
|
||||
{
|
||||
goodsId: goods.goodsId!,
|
||||
quantity: quantity
|
||||
}
|
||||
],
|
||||
addressId: address.id,
|
||||
payType: 1,
|
||||
deliveryType: 1, // 自提
|
||||
selfTakeMerchantId: merchantId,
|
||||
comments: `自提订单 - ${goods.name}`,
|
||||
title: generateOrderTitle([goods.name!])
|
||||
};
|
||||
|
||||
const result = await createOrder(orderData);
|
||||
|
||||
if (result && result.prepayId) {
|
||||
await Taro.requestPayment({
|
||||
timeStamp: result.timeStamp,
|
||||
nonceStr: result.nonceStr,
|
||||
package: result.package,
|
||||
signType: result.signType,
|
||||
paySign: result.paySign,
|
||||
});
|
||||
|
||||
Taro.showToast({
|
||||
title: '下单成功,请到店自提',
|
||||
icon: 'success'
|
||||
});
|
||||
|
||||
setTimeout(() => {
|
||||
Taro.switchTab({url: '/pages/order/order'});
|
||||
}, 2000);
|
||||
}
|
||||
} catch (error: any) {
|
||||
console.error('下单失败:', error);
|
||||
Taro.showToast({
|
||||
title: error.message || '下单失败',
|
||||
icon: 'error'
|
||||
});
|
||||
} finally {
|
||||
setLoading(false);
|
||||
}
|
||||
};
|
||||
|
||||
/**
|
||||
* 使用优惠券下单示例
|
||||
*/
|
||||
const handleOrderWithCoupon = async (couponId: number) => {
|
||||
setLoading(true);
|
||||
|
||||
try {
|
||||
const orderData: OrderCreateRequest = {
|
||||
goodsItems: [
|
||||
{
|
||||
goodsId: goods.goodsId!,
|
||||
quantity: quantity
|
||||
}
|
||||
],
|
||||
addressId: address.id,
|
||||
payType: 1,
|
||||
couponId: couponId, // 使用优惠券
|
||||
deliveryType: 0,
|
||||
comments: `使用优惠券购买${goods.name}`,
|
||||
title: generateOrderTitle([goods.name!])
|
||||
};
|
||||
|
||||
const result = await createOrder(orderData);
|
||||
|
||||
if (result && result.prepayId) {
|
||||
await Taro.requestPayment({
|
||||
timeStamp: result.timeStamp,
|
||||
nonceStr: result.nonceStr,
|
||||
package: result.package,
|
||||
signType: result.signType,
|
||||
paySign: result.paySign,
|
||||
});
|
||||
|
||||
Taro.showToast({
|
||||
title: '支付成功',
|
||||
icon: 'success'
|
||||
});
|
||||
|
||||
setTimeout(() => {
|
||||
Taro.switchTab({url: '/pages/order/order'});
|
||||
}, 2000);
|
||||
}
|
||||
} catch (error: any) {
|
||||
console.error('下单失败:', error);
|
||||
Taro.showToast({
|
||||
title: error.message || '下单失败',
|
||||
icon: 'error'
|
||||
});
|
||||
} finally {
|
||||
setLoading(false);
|
||||
}
|
||||
};
|
||||
|
||||
return (
|
||||
<div>
|
||||
<Button
|
||||
type="primary"
|
||||
loading={loading}
|
||||
onClick={handleSingleGoodsOrder}
|
||||
>
|
||||
立即购买
|
||||
</Button>
|
||||
|
||||
<Button
|
||||
type="success"
|
||||
loading={loading}
|
||||
onClick={() => handleCartOrder([
|
||||
{goodsId: goods.goodsId!, quantity: 1, goodsName: goods.name!}
|
||||
])}
|
||||
>
|
||||
购物车下单
|
||||
</Button>
|
||||
|
||||
<Button
|
||||
type="warning"
|
||||
loading={loading}
|
||||
onClick={() => handleSelfPickupOrder(1)}
|
||||
>
|
||||
自提下单
|
||||
</Button>
|
||||
|
||||
<Button
|
||||
type="info"
|
||||
loading={loading}
|
||||
onClick={() => handleOrderWithCoupon(123)}
|
||||
>
|
||||
使用优惠券下单
|
||||
</Button>
|
||||
</div>
|
||||
);
|
||||
};
|
||||
|
||||
export default OrderExample;
|
||||
Reference in New Issue
Block a user