【实战】7-1 商品管理模块接口定义

最新推荐文章于 2024-10-08 16:00:00 发布
最新推荐文章于 2024-10-08 16:00:00 发布
阅读量1.2k 收藏 2
点赞数 1
分类专栏： Java服务端实战
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/winxblast/article/details/78407217
版权

前言

商品模块是相对来说比较复杂的部分，这里会涉及到分页的设计，虽然说我们会使用相关的分页插件来辅助我们完成工作，但是学习其分页的写法也是非常重要的，知其然还要知其所以然~

商品模块跟用户模块一样，也分为前台展示部分接口和后台管理部分接口，后台管理会涉及到图片的上传操作，会将前面涉及的ftp服务器内容串联起来。

不得不说，模仿别人成熟的写法成长的速度还是很快的，这也就是看源码的重要性把~

功能介绍

同样分为前后台介绍

前台

  • 产品搜索
  • 动态排序列表 分页在此实现
  • 商品详情

后台

  • 商品列表
  • 商品搜索
  • 图片上传
  • 富文本上传 富文本中图片上传跟上一个图片上传功能不太一样，这个具体到代码了再看看有什么不同
    使用了SimEditor插件，需要按照插件官方文档进行接口编写
  • 商品详情
  • 商品上下架
  • 增加商品
  • 更新商品

学习目标

  • FTP服务的对接
  • SpringMVC文件上传
  • 流读取properties配置文件，静态块
  • 抽象POJO、BO、VO对象之间的转换关系及解决思路
  • joda-time快速入门
  • Mybatis-PageHelper高效准确地分页及动态排序
  • Mybatis对List遍历的实现方法
  • Mybatis对where语句动态拼装的几个版本演进

POJO、BO、VO

这个内容先拎出来讲解一下，具体还需要大家到真实场景中体会
这里写图片描述

POJO是java简单的对象，一般把POJO定义为和数据库中字段相同，里面不带业务逻辑

随着业务的复杂，会逐渐将value object拆分成business object和view object

数据表设计

不做过多介绍，之前已经有介绍了
主图会采用子图中的第一个作为主图
注意价格字段使用decimal类型，20位长，两位小数

接口设计

又到了最重要的接口设计，还是分为前后台，定义好接口，后面code就清晰容易多了

前台

1、产品搜索及动态排序List
这里其实是把之前提到的产品搜索、动态排序、分页合到一个接口中了
/product/list.do

http://localhost:8080/product/list.do?keyword=&categoryId=1&orderBy=price_desc
返回的产品list中会把无关紧要的信息去除，减少信息传输量，减轻服务器压力。

request
    categoryId
    keyword
    pageNum(default=1)
    pageSize(default=10)
    orderBy(default="") 排序参数：例如price_desc,price_asc
response
    success
    {
        "status":0,
        "data":{
            "pageNum":1,
            "pageSize":10,
            "size":2,
            "orderBy":null,
            "startRow":1,
            "endRow":2,
            "total":2,
            "pages":1,
            "list":{
                {
                    "id":1,
                    "categoryId":3,
                    "name":"iphone7",
                    "subtitle":"双十一促销"，
                    "mainImage":"mainimage.jpg",
                    "price":699900
                },
                {
                    "id":2,
                    "categoryId":2,
                    "name":"oppo R8",
                    "subtitle":"oppo促销进行中"，
                    "mainImage":"mainimage.jpg",
                    "price":177000
                }
            },
            "firstPage":1,
            "prePage":0,
            "nextPage":0,
            "lastPage":1,
            "isFirstPage":true,
            "isLastPage":true,
            "hasPreviousPage":false,
            "hasNextPage":false,
            "navigatePages":8,
            "navigatepageNums":{
                1
            }
        }
    }

2、产品detail
/product/detail.do
例如

http://localhost:8080/product/detail.do?productId=2

request
    productId
response
    success
    {
        "status":0,
        "data":{
            "id":2,
            "categoryId":2,
            "name":"oppo R8",
            "subtitle":"oppo促销进行中"，
            "mainImage":"mainimage.jpg",
            "subImages":"[\"mmall/aa.jpg\",\"mmall/bb.jpg\",\"mmall/cc.jpg\",\"mmall/dd.jpg\",\"mmall/ee.jpg\"]",
            "detail":"richtext",
            "price":2999.11,
            "stock":71,
            "status":1,
            "createTime":"2016-11-20 14:21:53",
            "updateTime":"2016-11-20 14:21:53"
        }
    }
    fail
    {
        "status":1,
        "msg":"该商品已经下架或删除"
    }

后台

1、产品list
基本功能和前台相同，同样为了区分前后台，命名空间加上manage
/manage/product/list.do
http://localhost:8080/manage/product/list.do

request
    pageNum(default=1)
    pageSize(default=10)
response
    success
    {
        "status":0,
        "data":{
            "pageNum":1,
            "pageSize":10,
            "size":2,
            "orderBy":null,
            "startRow":1,
            "endRow":2,
            "total":2,
            "pages":1,
            "list":{
                {
                    "id":1,
                    "categoryId":3,
                    "name":"iphone7",
                    "subtitle":"双十一促销"，
                    "mainImage":"mainimage.jpg",
                    "price":7199.22
                },
                {
                    "id":2,
                    "categoryId":2,
                    "name":"oppo R8",
                    "subtitle":"oppo促销进行中"，
                    "mainImage":"mainimage.jpg",
                    "price":2999.11
                }
            },
            "firstPage":1,
            "prePage":0,
            "nextPage":0,
            "lastPage":1,
            "isFirstPage":true,
            "isLastPage":true,
            "hasPreviousPage":false,
            "hasNextPage":false,
            "navigatePages":8,
            "navigatepageNums":{
                1
            }
        }
    }

    fail
    {
        "status":10,
        "msg":"用户未登录，请登录"
    }

2、产品搜索
可能跟用户使用的搜索不太一样了，而且这个项目可能就简化了搜索部分，直接使用数据库的搜索功能了
可以使用产品名称或产品id进行搜索
/manage/product/search.do
http://localhost:8080/manage/product/search.do?productName=p
http://localhost:8080/manage/product/search.do?productId=1

request
    productName
    productId
    pageNum(default=1)
    pageSize(default=10)
response
    success
    {
        "status":0,
        "data":{
            "pageNum":1,
            "pageSize":10,
            "size":2,
            "orderBy":null,
            "startRow":1,
            "endRow":2,
            "total":2,
            "pages":1,
            "list":{
                {
                    "id":1,
                    "categoryId":3,
                    "name":"iphone7",
                    "subtitle":"双十一促销"，
                    "mainImage":"mainimage.jpg",
                    "price":7199.22
                }
            },
            "firstPage":1,
            "prePage":0,
            "nextPage":0,
            "lastPage":1,
            "isFirstPage":true,
            "isLastPage":true,
            "hasPreviousPage":false,
            "hasNextPage":false,
            "navigatePages":8,
            "navigatepageNums":{
                1
            }
        }
    }

    fail
    {
        "status":10,
        "msg":"用户未登录，请登录"
    }

3、图片上传
使用了SpringMVC的上传功能
过程是上传图片用file流接收，存到ftp服务器上，然后和ftp的地址做一个拼接，然后给到前端。
/manage/product/upload.do

request
    <!--真实情况当然不是传这个，而是图片-->
    <form name="form2" action="/manage/product/upload.do" method="post" enctype="multipart/form-data">
      <input type="file" name="file"/>
      <input type="submit" value="upload"/>
    </form>

response
    success
    {
        "status":0,
        "data"{
            "uri":"e6604558-c0ff-41b9-b6e1-30787a1e3412.jpg",
            "url":"http://img.happymall.winxblast.top/e6604558-c0ff-41b9-b6e1-30787a1e3412.jpg"
        }
    }

    fail
    {
        status!=0的时候···
    }

4、产品详情
这一部分的实际内容跟前台是一样的
/manage/product/detail.do

http://localhost:8080/manage/product/detail.do?productId=2

request
    productId

response
    success
    {
        {
            "status":0,
            "data":{
                "id":2,
                "categoryId":2,
                "name":"oppo R8",
                "subtitle":"oppo促销进行中"，
                "mainImage":"mainimage.jpg",
                "subImages":"[\"mmall/aa.jpg\",\"mmall/bb.jpg\",\"mmall/cc.jpg\",\"mmall/dd.jpg\",\"mmall/ee.jpg\"]",
                "detail":"richtext",
                "price":2999.11,
                "stock":71,
                "status":1,
                "createTime":"2016-11-20 14:21:53",
                "updateTime":"2016-11-20 14:21:53"
            }
        }
    }

    fail
    {
        "status":1,
        "msg":"没有权限"
    }

5、产品上下架
当然啦，里面要验证管理员权限
/manage/product/set_sale_status.do

http://localhost:8080/manage/product/set_sale_status.do?productId=1&status=1

request
    productId
    status
response
    success
    {
        "staus":0,
        "data":"修改产品状态成功"
    }

    fail
    {
        "staus":1,
        "data":"修改产品状态失败"
    }

6、新增OR更新产品
/manage/product/save.do

新增 http://localhost:8080/manage/product/save.do?categoryId=1&name=三星洗衣机&subtitle=三星大促销&subImages=test.jpg,11.jpg,2.jpg,3.jpg&detail=detailtext&price=1000&stock=100&status=1

更新 http://localhost:8080/manage/product/save.do?categoryId=1&name=三星洗衣机&subtitle=三星大促销&subImages=test.jpg&detail=detailtext&price=1000&stock=100&status=1&id=3

request
    categoryId=1&name=三星洗衣机&subtitle=三星大促销&mainImage=sss.jpg&subImages=test.jpg&detail=detailtext&price=1000&stock=100&status=1&id=3

response
    success
    {
        "status":0,
        "data":"更新产品成功"
    }
    或
    {
        "status":0,
        "data":"新增产品成功"
    } 

    fail
    {
        "status":1,
        "data":"更新产品失败"
    }

7、富文本上传图片
/manage/product/richtext_img_upload.do
这里返回的格式不是很符合我们之前定义的serverResponse的格式，主要是这里要按照富文本的要求去返回，要符合Simditor关于图片上传成功后的返回要求

request
    <form name="form2" action="/manage/product/upload.do" method="post" enctype="multipart/form-data">
      <input type="file" name="file"/>
      <input type="submit" value="upload"/>
    </form>

response
    success
    {
        "file_path":"http://img.happymall.winxblast.top/5f239f2-0007-40c1-b8e6-0dc11b22779c.jpg",
        "msg":"上传成功"，
        "success":true
    }

    fail
    {
        "success":false,
        "msg":"error message",
        "file_path":"[real file path]"
    }

小结

至此，关于产品管理的前后台接口都已经给出了，这里主要的知识点应该就在分页的学习和图片的上传。这都是真实网站环境下非常常用的功能，要好好学习体会啦。

winxblast
关注
专栏目录
〖Python接口自动化测试实战篇④〗- 接口自动化测试详解
易编橙 · 终身成长社群，相遇已是上上签！
05-26 5万+
[接口测试] 是相对来说和我们的功能测试 [最为接近的一种自动化测试手段] ，所以我们首先来学习接口测试的内容。 实现接口的开发与接口的测试，在我们的思维上、想法上、面向的态度上都是不一样的。所以大家要有一个思维上的转换，要认识了解一下 接口测试到底是做什么的、它的功能、意义在哪里。...
J2-5《网上商店》商品管理模块
qq_62004976的博客
10-10 1833
《商品管理》模块的E-R 图如图2.5.1 所示，逻辑数据模型如图2.5.2 所示，物理数据模型如图2.5.3 所示，数据表字段名定义见表2.5.1。请按以下设计完成数据库创建、数据表创建和数据操作任务：
商品管理模块
weixin_44142032的博客
03-04 2051
目录功能介绍学习目标数据表设计及接口设计数据表设计接口设计 功能介绍 学习目标 数据表设计及接口设计 数据表设计 mmall_product 接口设计 前台商品接口设计 门户的产品接口（产品搜索和动态排序list和分页） 产品tedail 后台产品接口 产品list 产品的搜索 图片上传 产品详情 产品上下架 新增或更新产品 富文本上传图片 ...
电商后台管理系统-商品管理功能模块
最新发布
minzliii的博客
10-08 1658
本项目是以B2B电商平台为依据，基础的电商平台包括 商品管理、订单履约流程、售后管理、结算交易模块、发票管理、竞价模块、客户管理、库存管理等，其中 商品管理为最基础的模块，是商城交易的前提，本章节仅对 商品管理，以及具体的细节（新增、编辑）等操作进行说明，如果想了解其他模块的内容，后期会继续更新。商品类目最大三级，进入页面时仅展示1级类目，可增加、编辑、删除类目，若类目下已有商品，不可删除，可将类目下商品全部转移后进行删除操作。包括常见问题的解析说明、商品整体数据的统计、商品的上架/下架数据趋势分析。
3.商品管理模块
qq_28613081的博客
08-03 1421
商品管理1.添加商品管理1.1.添加数据表1.2.商品后台列表1.2.1.创建控制器1.2.2.添加菜单1.2.3.添加路由2.添加富文本组件2.1.修改控制器测试添加商品安装富文本组件 1.添加商品管理 1.1.添加数据表 CREATE TABLE `product_descriptions` ( `id` int unsigned NOT NULL AUTO_INCREMENT, `product_id` int DEFAULT NULL, `description` text CHARAC
商城管理模块之商品管理
08-01
之前一家公司的商城管理项目下的一个模块，自己写的测试用的，还存在一个框架缓存的问题没处理，把hibernate的一级缓存clear就好了
后台管理---商品管理模块
weixin_56105534的博客
02-10 1289
1.实现商品列表的分页查询 2.文件上传 create table CREATE TABLE `item` ( `id` int(11) NOT NULL AUTO_INCREMENT COMMENT '商品id，同时也是商品编号', `title` varchar(100) DEFAULT NULL COMMENT '商品标题', `sell_point` varchar(500) DEFAULT NULL COMMENT '商品卖点', `price` int(
java项目实战----APP信息管理平台下载资料.rar
01-01
总之，这个"java项目实战----APP信息管理平台"涵盖了Java Web开发的多个方面，包括后端开发、数据库设计、前端实现、API接口、安全措施和测试部署。通过实践这个项目，开发者不仅可以提升技术技能，还能理解到软件...
接口测试入门到实战精通-【软件测试】
06-30
- **定义**：接口测试是指对应用程序中不同模块或系统之间的接口进行的测试，以验证数据传输的准确性、完整性和安全性。 - **目的**：确保系统的各个组件能正确交互，避免因接口问题导致的系统故障。 - **范围**...
FPGA实战开发-Verilog代码-uart发送接口.zip
11-19
本项目聚焦于FPGA实战开发，通过使用Verilog HDL（硬件描述语言）来设计UART（通用异步接收/发送器）的发送接口。UART是一种常见的串行通信接口，广泛应用于各种设备之间进行数据传输。 首先，我们要理解Verilog...
Nodejs-MongoDB实战案例-简易用户管理系统.zip
11-02
在本实战案例中，我们探讨的是如何利用Node.js的Express框架与MongoDB数据库构建一个简易的用户管理系统。这个系统涵盖了数据库的基本操作，如增（添加数据）、删（删除数据）、改（更新数据）和查（查询数据），...
基于SpringBoot的商品管理后台ERP系统——商品管理模块
qq1744828575的博客
11-22 2302
随着我国互联网的普及率不断提高，以及物流货运行业的逐渐兴起，人们对电子交易模式进行交易活动和相关服务活动这些业务需求也在不断增长，衍生了大量的第三方交易平台，使得许多电子商务企业得到了突飞猛进式的发展。与此同时，成千上万的商品信息被存储进了这些企业的数据库里面，如何去围绕商品的各种信息来促进订单的合理管理，成为电商企业需要考虑的问题之一。
淘宝商品API接口
天宇淘客
03-14 827
该产品不仅能解决淘宝的数据问题，也可以帮助企业实现业务上的创新，是一款不可多得的好产品。可以在哪里找数据呢？作为第三方平台，淘宝开放平台要做的就是通过接口的形式来收集卖家数据、做好商品管理、辅助运营人员进行店铺管理、对数据进行加工处理、向用户展现商品等工作。通过 API接口，卖家可以根据自己的需求定制不同的服务，但也存在一些问题，例如，如果接口请求数量过多会导致服务器性能不足，甚至导致服务器崩溃。在接口名称方面，可以写成“产品名称”，也可以写成“商品名称”，如果是提供给平台的话，就需要填写一个商品的名字。
电商系统设计之商品接口
CrazyCodes
10-24 2106
前言 我应该是少数在文章中直接展示接口文档的人。本篇我思考了很久到底要不要解析下商品接口开发的注意点。 客户端开发与服务端开发即是天敌也是兄弟。希望本篇文章让你们减少争执，把“爱”给对方。 接口设计 简述 电商系统设计之中，比较复杂的接口就论商品详情的接口了，响应参数特别多，特别杂。在开发获取商品详情接口时要遵循以下几个原则 返回的JSON嵌套数量要少 方便去查询到指定的SKU 其他接口相关规范 查询SKU 关于查询SKU，我让我的小伙伴是这样做的，首先拿出规格和属性 "选择颜色": [ { .
商品详情API接口
03-02 319
商品详情API接口允许开发者获取单个商品的详细信息，包括商品ID、名称、描述、图片链接和价格等。该接口对于开发者来说非常有用，可以用来快速检索和获取商品的详细信息，从而构建完整的电商平台。Lazada提供的商品详情API接口是“GetProductDetail”，用来获取单个商品的详细信息。它的具体请求参数为：API版本、商品ID、销售平台ID、授权令牌等。
商品管理模块微服务demo
qingcyb的博客
10-21 429
商品管理模块微服务demo
淘宝，1688，京东店铺所有商品接口分享
wbryze的博客
05-15 467
今天分享的是获取店铺所有商品接口，很多时候我们想做旺店分析，苦于数据方面来源，以下是行业内了解到的一些情况。更多API调试请移步： 点击获取接口注册 { “items”: { “page”: 1, “total_results”: “32”, “real_total_results”: “32”, “item”: [ { “num_iid”: “669226587081”, “pic_url”: “//img.alicdn.com/bao/uploaded/i1/2209411885160/O1CN019
API接口接入京东平台获取商品详情数据、价格、销量、商品标题、产品属性参数指南
2301_78159247的博客
09-18 1449
京东平台商品详情接口是开放平台提供的一种API接口，通过调用API接口，开发者可以获取京东商品的标题、价格、库存、月销量、总销量、库存、详情描述、图片等详细信息。获取商品详情接口API是一种用于获取电商平台上商品详情数据的接口，通过该接口，用户可以根据商品的ID或其他关键信息，向电商平台发送请求，获取商品的详情数据。用户可以根据这些数据进行统计分析、制作报表或进行数据挖掘，帮助卖家更好地了解市场需求和受众偏好。
S7-300编程调试实战技巧与故障排除
"S7-300编程调试工程实战总结" 在S7-300 PLC编程和调试过程中，有几点关键的知识点值得深入理解： 1. **避免“通讯故障”消息**： 当使用CPU315F配合ET200S及故障安全输入/输出（DI/DO）模块时，通讯故障可能由于...
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值