# app-item-demo-java

**Repository Path**: alipayopendemo/app-item-demo-java

## Basic Information

- **Project Name**: app-item-demo-java
- **Description**: 支付宝小程序商品demo
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-05-30
- **Last Updated**: 2024-06-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## Alipay Demo

本demo演示了小程序商品服务端能力。

## 本地调试
#### 1.下载代码
下载代码至本地。
#### 2.替换变量
application.yaml中替换**公私钥、appid以及pid**等变量
#### 3.准备
请确保已完成 [本地生活商品插件](https://opendocs.alipay.com/mini/08cozf?pathHash=dd4c121f&ref=api#%E6%9C%AC%E5%9C%B0%E7%94%9F%E6%B4%BB%E5%95%86%E5%93%81%E6%8F%92%E4%BB%B6%E5%BC%80%E5%8F%91%E6%8E%A5%E5%85%A5) 开发接入 或 [商品详情页组件](https://opendocs.alipay.com/mini/0b23nk?pathHash=b5c1ebfb&ref=api) 开发接入
#### 4.启动
1）本地启动

入口：`src/main/java/com/alipay/demo/DemoApplication.java`

2）docker启动
```
docker build -t app-item-demo-java:v1 .
docker run -d -p 80:80 app-item-demo-java:v1
```

如果未安装，需要先下载docker，以mac为例：
```
brew install --cask --appdir=/Applications docker
```

停止docker：
```
docker stop <container_name_or_id>
```
#### 5.服务访问

http://localhost/doc.html


## 小程序云调试
在小程序云工作空间中打开右侧端口监听tab页，开通**公网访问**。选择的端口必须与application.yaml中配置的server.port一致。点击访问，获取访问的ip地址。

![img.png](img.png)

然后通过 **http://[ip]/doc.html** 即可访问。

## 目录结构说明

```
.
├── Dockerfile                      # Dockerfile文件
├── logs                            # 日志
├── LICENSE                         # LICENSE文件
├── README.md                       # README.md文件
├── pom.xml                         # pom文件
└── src                             # 源文件目录,包含mvc目录、文件
    └── main
        ├── java
        │   └── com
        │       └── alipay
        │           └── demo
        │               ├── config
        │               │   └── SwaggerConfig.java                      # swagger相关配置，用于生成文档和接口调试页面
        │               ├── controller
        │               │   ├── ImageController.java                    # 商家图片空间相关http接口
        │               │   ├── ItemController.java                     # 普通商品相关http接口
        │               │   ├── ItemDeliveryController.java             # 履约信息相关http接口
        │               │   ├── LocalItemController.java                # 本地生活商品相关http接口
        │               │   ├── LocalItemCalendarController.java        # 酒店日历房相关http接口
        │               │   └── MarketingCertificateController.java     # 凭证相关http接口
        │               ├── listener
        │               │   └── WebsocketListener.java                  # Websocket长链接通道，用于接收支付宝From蚂蚁消息
        │               ├── service
        │               │   ├── AntMerchantShopService.java             # 蚂蚁门店相关服务
        │               │   ├── ImageUploadService.java                 # 商家图片空间相关服务
        │               │   ├── ItemDeliveryService.java                # 履约信息相关服务
        │               │   ├── ItemService.java                        # 普通商品相关服务
        │               │   ├── LocalItemService.java                   # 本地商品相关服务
        │               │   ├── LocalItemCalendarService.java           # 酒店日历房相关服务
        │               │   └── MarketingCertificateService.java        # 凭证相关服务
        │               ├── spi
        │               │   └── MarketingCertificateSpiController.java  # 凭证相关的spi接口
        │               ├── util
        │               │   ├── AlipayApiCallback.java                  # API回调接口，供外部类实现以处理调用API时的具体逻辑
        │               │   ├── AlipayApiTemplate.java                  # 统一处理模板类，封装了API调用流程，统一处理API执行、结果获取、异常捕获和日志记录
        │               │   ├── AlipaySdkUtil.java                      # 支付宝工具类，用于初始化SDK的alipayClient等
        │               │   └── CacheConfig.java                        # 本地缓存配置类
        │               └── vo
        │                   ├── OpenResponse.java                       # 统一返回类
        │                   └── ......                                  # 业务VO
        └── resources
            ├── file                # 文件资源
            ├── application.yaml    # springboot配置文件
            └── log4j-spring.xml    # log4j日志配置文件
```

### LICENSE
MIT