基于Springboot实现微信小程序（前端）

基于Springboot实现微信小程序（前端）

前端

预览

​ 前端：微信小程序；后端：java Springboot；数据库：mysql

​ 本项目实现了简易个人markdown仓库（小程序版），效果如下：

点进条目是对应的markdown文档：

项目结构

pages有5项，其中4项对应tabbar的4项，pages中的markdown用于展示markdown文档。

项目依赖

​ mobx-miniprogram，mobx-miniprogram-building，vant以及towxml

​ 项目使用了vant组件库的tabbar，可以按需引入。towxml用于在小程序预览markdown。mobx-miniprogram用于实现tabbar的跳转（如果使用原生的tabbar可以只引入towxml）

​ 引入mobx-miniprogram，mobx-miniprogram-building如下：

​ 在终端输入命令：

npm install mobx-miniprogram mobx-miniprogram-building --save

​ 然后点击小程序开发者工具的顶部“工具”->“构建npm”。

​ vant与towxml的引入查阅官方文档：

引入完后需要“构建npm”

页面实现

<!-- 每个页面的wxml一样 -->
<view class="container">
  <!-- 使用wx:for指令遍历后端发送的数据 -->
  <view wx:for="{{dataList.data}}" wx:key="id" class="box" bindtap="gotoMarkdown" data-id="{{item.id}}">
    <view class="box-header">{{item.tittle}}</view>
    <view class="box-content">更新时间：{{item.updateTime}}</view>
  </view>
</view>

/* 每个页面的wxss一样 */
.container {
  border-top: 1px solid #000;
  display: flex;
  flex-direction: column;
  align-items: center;
 justify-content: flex-start;
  height: 100%;  
  padding-top: 10rpx;
  padding-bottom: 140rpx;
}
.box {
  height: 78rpx;
  width: 88%;
  margin-bottom: 5rpx;
  margin-top:5rpx;
  padding: 20px;
  padding-top: 15rpx;
  border-radius: 5px;
  box-shadow: 0px 4px 6px rgba(0, 0, 0, 0.1);
}
.box-header {
  font-size: 18px;
  font-weight: bold;
  margin-bottom: 5px;
}
.box-content {
  font-size: 14px;
  color: #666666;
}

​ 以上的wxml与wxss用于实现页面的基本布局与样式，页面的数据来自后端，js文件如下：

const app = getApp();
Page({
  data: {
    dataList:[]
  },
  gotoMarkdown: function(event) {
    const id = event.currentTarget.dataset.id; // 获取点击的box的id属性值
    wx.navigateTo({
      url: '/pages/markdown/markdown?id=' + id, // 将id作为参数传递到markdown页面
    })
},
  onLoad: function () {
      // 页面加载时从后端获取数据
    wx.request({
      url: 'http://你的后端服务器/getPage/1',
      su***ess: (res) => {
        this.setData({
          dataList: res.data // 将从后端获取的数据赋值给dataList属性      
        });
        console.log(this.data.dataList);
      },
      fail: (err) => {
        console.error('请求失败', err); // 输出错误信息
      }
    });
  },
})

​ 微信小程序向后端发起请求，后端返回页面对应的文档的基本信息，在页面上渲染。（具体请求与相应见文档末尾）

​ json文件如下：

{
  "using***ponents": {
    "van-empty": "@vant/weapp/empty/index",
    "van-button": "@vant/weapp/button/index",
    "towxml":"/towxml/towxml"
  }
}

“markdown”页面实现

​ wxml：

<!-- 在对应的WXML文件中 -->
<scroll-view scroll-y style="height: auto;">
    <towxml nodes="{{article}}" />
</scroll-view>

​ 不用额外写wxss文件

​ js文件如下：

const app = getApp();
Page({
  data: {
    isLoading: false,
    article: {},
  },
  onLoad: function (options) {
    const id = options.id; // 获取从上一个页面传递过来的id参数
    console.log('接收到的id参数为', id);
    // 页面加载时从后端获取数据
    wx.request({
      url: 'http://后端ip/getDoc/' + id,
      su***ess: (res) => {
        let markdownString = res.data.data[0].docMain; // 获取从后端返回的data对象
        // 替换图片链接
        markdownString = markdownString.replace(/!\[.*?\]\((.*?)\)|<img src="(.*?)"(.*?)>/g, (match, p1, p2, p3) => {
          console.log("匹配成功")
          if (p1) {            
            return `<img src='https://gitee.***/gitee用户名/仓库/raw/main/${p1}'>`;
          } else {
            return `<img src='https://gitee.***/gitee用户名/仓库/raw/main/${p2}' ${p3}>`;
          }
        });
        console.log("打印markdownString")
        console.log(markdownString);
        let result = app.towxml(markdownString, 'markdown', {
          base: 'https://xxx.***',
          theme: 'light',
          events: {
            tap: (e) => {
              console.log('tap', e);
            }
          }
        });
        this.setData({
          article: result,
          isLoading: false
        });
      }
    }, );
  },
});

​ md文件以字符串的形式保存在mysql数据库，后端将mysql数据库的md文件也是以字符串的形式发送给前端，前端接收字符串在解析为md即可。

​ 但是，保存在数据库中的md文件的图片的url是链接本地的，因此小程序中图片无法显示，代码中 markdownString = markdownString.replace()就是就是为了解决这一问题，后面再仔细讲。

解决图片无法显示的问题

​ 保存的md文档中的图片是以![image-20240226143642237](WXMiniProgarmAboveSpringboot.assets/image-20240226143642237.png)或<img src="WXMiniProgarmAboveSpringboot.assets/image-20240226143642237.png" alt="image-20240226143642237" style="zoom:80%;" />（如果图片有缩放）这样的形式保存的。

​ 在微信小程序中，无法打开本地的WXMiniProgarmAboveSpringboot.assets，所以需要修改图片保存的路径。以保存到gitee为例（不保存到GitHub是因为众所周知的原因加载图片会比较慢），在gitee中新建一个仓库，用于保存小程序要展示的md文档的所有assets文件夹，用正则表达式遍历匹配保存Markdown文档的String字符串中的图片语法，然后替换为指定的图片链接：

markdownString.replace(/!\[.*?\]\((.*?)\)|<img src="(.*?)"(.*?)>/g, (match, p1, p2, p3) => {
  console.log("匹配成功")
  if (p1) {            
    return `<img src='https://gitee.***/用户名/仓库名/raw/main/${p1}'>`;
  } else {
    return `<img src='https://gitee.***/用户名/仓库名/raw/main/${p2}' ${p3}>`;
  }
});

• markdownString 是一个包含 Markdown 文本的字符串。
• replace 方法接受一个正则表达式和一个回调函数。正则表达式 /!\[.*?\]\((.*?)\)|<img src="(.*?)"(.*?)>/g 匹配 Markdown 中的图片语法。
• 回调函数接受匹配到的结果和捕获组（即正则表达式中的括号内的内容）作为参数，然后根据匹配到的情况进行处理。
• 如果匹配到 ![...](...) 形式的图片语法，使用 p1 中的内容构建新的图片链接。
• 如果匹配到 <img src="..." ...> 形式的图片语法，使用 p2 中的内容构建新的图片链接，并保留 p3 中的其他属性。
• 最终替换原始字符串中的图片语法为新的图片链接。

后端

​ 见另一篇文档。

请求与响应

1. 进入页面时发起网络请求

1.1 基本信息

请求路径：/getPage

请求方式：GET

接口描述：该接口用于进入小程序页面时的文档预览

1.2 请求参数

参数格式：路径参数

参数说明：

请求参数样例：

/getPage/1

1.3响应数据

参数格式：application/json

参数说明：

2. 跳转markdown页面时发起网络请求

2.1 基本信息

请求路径：/getDoc

请求方式：GET

接口描述：该接口用于获取markdown文件

2.2 请求参数

参数格式：路径参数

参数说明：

请求参数样例：

/getDoc/1

2.3响应数据

参数格式：application/json

参数说明：