【小程序+雲開發】實戰：一天搭建小型論壇

筆者最近涉獵了小程序相關的知識，因而利用週末時間開發了一款相似於同事的小程序，深度體驗了小程序雲開發模式提供的雲函數、數據庫、存儲三大能力。關於雲開發，可參考文檔：小程序·雲開發。
我的感受雲開發帶來的最大好處是鑑權流程的簡化和對後端的弱化，因此像筆者這種從未接觸太小程序開發的人也可以在週末兩天時間內開發出一個功能完備、體驗閉環的勉強能用的產品。
最後，本文並非搬運官方文檔，也不會詳細介紹開發工具和雲開發後臺的使用，因此建議結合上面給出文檔連接一塊兒消化本文。
<!--more-->

功能分析

該小程序功能目前較爲簡單（發佈帖子、瀏覽帖子、發佈評論），可用下圖表示，無需贅述：

由架構圖可知，雲開發的數據庫（存帖子、存評論）、存儲（圖片）、雲函數（讀、寫、更新數據庫等）都將涉及，很好地達到了練手的目的。

發佈帖子

若是帖子不帶圖片，直接寫數據庫便可，若是帶圖片則須要先存入圖片到雲開發提供的存儲中，拿到返回的fileId（可理解爲圖片的url）再一併寫入數據庫，核心代碼：

for (let i = 0; i < img_url.length; i++) {
      var str = img_url[i];
      var obj = str.lastIndexOf("/");
      var fileName = str.substr(obj + 1)
      console.log(fileName)
      wx.cloud.uploadFile({
        cloudPath: 'post_images/' + fileName,//必須指定文件名，不然返回的文件id不對
        filePath: img_url[i], // 小程序臨時文件路徑
        success: res => {
          // get resource ID: 
          console.log(res)
          //把上傳成功的圖片的地址放入數組中
          img_url_ok.push(res.fileID)
          //若是所有傳完，則能夠將圖片路徑保存到數據庫
          if (img_url_ok.length == img_url.length) {
            console.log(img_url_ok)
            that.publish(img_url_ok)
          }
        },
        fail: err => {
          // handle error
          console.log('fail: ' + err.errMsg)
        }
      })
    }

經過img_url_ok.length == img_url.length咱們肯定全部圖片已經上傳完成並返回了對應的id，而後執行寫入數據庫的操做：

/**
   * 執行發佈時圖片已經上傳完成，寫入數據庫的是圖片的fileId
   */
  publish: function(img_url_ok) {
    wx.cloud.init()
    wx.cloud.callFunction({
      name: 'publish_post',
      data: {
        openid: app.globalData.openId,// 這個雲端其實能直接拿到
        author_name: app.globalData.userInfo.nickName,
        content: this.data.content,
        image_url: img_url_ok,
        publish_time: "",
        update_time: ""//目前讓服務器本身生成這兩個時間
      },
      success: function (res) {
        // 強制刷新，這個傳參很粗暴
        var pages = getCurrentPages();             //  獲取頁面棧
        var prevPage = pages[pages.length - 2];    // 上一個頁面
        prevPage.setData({
          update: true
        })
        wx.hideLoading()
        wx.navigateBack({
          delta: 1
        })
      },
      fail: console.error
    })
  },

經過wx.cloud.callFunction咱們調用了一個雲函數（經過name指定函數名），並將帖子內容content和圖片image_url以及其餘信息（發佈者暱稱、id等）一併傳到雲端。而後再看看這個雲函數：

exports.main = async (event, context) => {
  try {
    return await db.collection('post_collection').add({
      // data 字段表示需新增的 JSON 數據
      data: {
        // 發佈時小程序傳入
        //author_id: event.openid,不要本身傳，用sdk自帶的
        author_id: event.userInfo.openId,
        author_name: event.author_name,
        content: event.content,
        image_url: event.image_url,
        // 服務器時間和本地時間會形成什麼影響，須要評估
        publish_time: new Date(),
        // update_time: event.update_time,// 最近一次更新時間，發佈或者評論觸發更新,目前用服務器端時間
        update_time: new Date(),
        // 默認值，一些目前還沒開發，因此沒設置
        // comment_count: 0,//評論數，直接讀數據庫，避免兩個數據表示同一含義
        watch_count: 3,//瀏覽數
        // star_count: 0,//TODO：收藏人數
      }
    })
  } catch (e) {
    console.error(e)
  }
}

能夠看到，雲函數寫入了一條數據庫記錄，咱們的參數經過event這個變量帶了進來。

獲取帖子列表

所謂獲取帖子列表其實就是讀上一節寫入的數據庫，可是咱們並不須要所有信息（例如圖片url），而且要求按照時間排序，若是熟悉數據庫的話，會發現這又是一條查詢語句罷了：

exports.main = async (event, context) => {
  return {
    postlist: await db.collection('post_collection').field({// 指定須要返回的字段
      _id: true,
      author_name: true,
      content: true,
      title: true,
      watch_count: true
    }).orderBy('update_time', 'desc').get(),//指定排序依據

  }
}

瀏覽帖子內容

瀏覽帖子內容及給定一個帖子的id，由帖子列表點擊時帶入：

onItemClick: function (e) {
    console.log(e.currentTarget.dataset.postid)
    wx.navigateTo({
      url: '../postdetail/postdetail?postid=' + e.currentTarget.dataset.postid,
    })
  },

而後在雲函數中根據這個id拿到所有數據：

exports.main = async (event, context) => {
  
  return {
    postdetail: await db.collection('post_collection').where({
      _id: event.postid
    }).get(),
  }
}

拿到所有數據後，再根據圖片id去加載貼子的圖片：

// 獲取內容
    wx.cloud.callFunction({
      // 雲函數名稱 
      name: 'get_post_detail',
      data: {
        postid: options.postid
      },
      success: function (res) {
        var postdetail = res.result.postdetail.data[0];
        that.setData({
          detail: postdetail,
          contentLoaded: true
        })
        that.downloadImages(postdetail.image_url)
      },
      fail: console.error
    })

這裏that.downloadImages(postdetail.image_url)即加載圖片：

/**
   * 從數據庫獲取圖片的fileId，而後去雲存儲下載，最後加載出來
   */
  downloadImages: function(image_urls){
    var that = this
    if(image_urls.length == 0){
      return
    } else {
      var urls = []
      for(let i = 0; i < image_urls.length; i++) {
        wx.cloud.downloadFile({
          fileID: image_urls[i],
          success: res => {
            // get temp file path
            console.log(res.tempFilePath)
            urls.push(res.tempFilePath)
            if (urls.length == image_urls.length) {
              console.log(urls)
              that.setData({
                imageUrls: urls,
                imagesLoaded: true
              })
            }
          },
          fail: err => {
            // handle error
          }
        })
      }
    }
  },

發表評論

發表評論和發佈帖子邏輯相似，只是寫入的數據不一樣，不作贅述。

總結

前面說過，雲開發弱化了後端（簡化鑑權本質也是弱化後端），這樣帶來的好處就是提升了開發效率，由於先後端聯調向來都是一件耗時間的事情，並且小程序自己主打的就是小型應用，實在沒有必要引入過多的開發人員。但云開發也不是萬能的，例如我一開始想作RSS閱讀器，那麼後端就須要聚合信息，目前雲開發還作不了。我的感受只要是信息類的小程序，如新聞類、視頻類，雲開發目前都很乏力，由於數據庫的支持還過於簡陋（也多是我太菜，沒發現很好的解決辦法，歡迎拍磚）。但若是是本文說起的這種用戶本身也會產生信息的小程序，那麼雲開發則會有開發效率上的優點。最後就是雲開發目前提供的2G數據庫和5G存儲，對於一些用戶量較多的小程序是否足夠也是個問題，目前也沒見有付費版。
總的類說，初次接觸小程序開發，仍是發現有很多值得借鑑學習之處。
源碼：vimerzhao/RssHub