小程序的全棧開發新時代

時間 2019-11-09

標籤程序開發新時代简体版

原文原文鏈接

歡迎你們前往騰訊雲+社區，獲取更多騰訊海量技術實踐乾貨哦~html

本文由heyli發表於雲+社區專欄前端

什麼是小程序·雲開發

小程序·雲開發是微信團隊和騰訊雲團隊共同研發的一套小程序基礎能力，簡言之就是：雲能力將會成爲小程序的基礎能力。整套功能是基於騰訊雲全新推出的雲開發(Tencent Cloud Base)所研發出來的一套完備的小程序後臺開發方案。node

小程序·雲開發爲開發者提供完整的雲端流程，簡化後端開發和運維概念，無需搭建服務器，使用平臺提供的 API 進行核心業務開發，便可實現快速上線和迭代。git

該解決方案目前提供三大基礎能力支持：github

存儲：在小程序前端直接上傳/下載雲端文件，在小程序雲控制檯可視化管理
數據庫：一個既可在小程序前端操做，也能在雲函數中讀寫的文檔型數據庫
雲函數：在雲端運行的代碼，微信私有協議自然鑑權，開發者只需編寫業務邏輯代碼

將來，咱們還會集成更多的服務能力，爲小程序提供更強有力的雲端支持。數據庫

如何使用小程序·雲開發

上面就是小程序·雲開發簡單的使用圖譜：在小程序端，直接用官方提供的接口，在雲函數端，直接用官方提供的 Node SDK，就能夠操做你雲的資源。之前開發小程序所擔心的數據庫搭建、文件系統部署，統統沒有。npm

你只須要有在小程序開發 IDE 裏面的 雲開發，開通一下，填寫環境 ID，即可以擁有小程序的雲能力！json

固然，其實用雲開發，並不排斥原有的後臺架構，經過下面的架構，你也能夠無縫與原有的後臺服務兼容，也簡化了一些小程序鑑權的邏輯：小程序

接下來，我會分別從小程序端、服務端講述如何使用這些雲資源。後端

使用雲能力

小程序端

客戶端，這裏是指在小程序端中。若是要使用雲開發能力，請作如下配置：

在 app.json / game.json 中，中增長字段 "cloud": true
project.config.json 中增長了字段 cloudfunctionRoot 用於指定存放雲函數的目錄
初始化雲開發能力：

//app.js
App({
  onLaunch: function () {
    wx.cloud.init({
        traceUser: true // 用戶信息會顯示在雲開發控制檯的用戶面板中
    });
  }
});

小程序端初始化能力文檔

在用戶管理中會顯示使用雲能力的小程序的訪問用戶列表，默認以訪問時間倒敘排列，訪問時間的觸發點是在小程序端調用 wx.cloud.init 方法，且其中的 traceUser 參數傳值爲 true。

服務端

若是你想在雲函數中，操做文件、數據庫和雲函數資源，你可使用咱們提供的服務端 SDK 進行操做。首先，進入到你的某個雲函數中，安裝如下依賴包：

npm i --save tcb-admin-node

在雲函數中初始化

// 初始化示例
const app = require('tcb-admin-node');

// 初始化資源
// 雲函數下不須要secretId和secretKey。
// env若是不指定將使用默認環境
app.init({
  secretId: 'xxxxx',
  secretKey: 'xxxx', 
  env: 'xxx'
});

//雲函數下使用默認環境
app.init()

//雲函數下指定環境
app.init({
  env: 'xxx'
});

服務端初始化文檔

存儲

雲開發提供存儲空間、上傳文件、下載文件、CDN加速文件訪問等能力,開發者能夠在小程序端與服務端經過 API 使用這些能力。

小程序端

// 選擇圖片
wx.chooseImage({
    success: dRes => {
        // 上傳圖片
        const uploadTask = wx.cloud.uploadFile({
            cloudPath: `${Date.now()}-${Math.floor(Math.random(0, 1) * 10000000)}.png`, // 隨機圖片名
            filePath: dRes.tempFilePaths[0], // 本地的圖片路徑
            success: console.log,
            fail: console.error
        });
    },
    fail: console.error,
});

小程序端存儲文檔

服務端

const app = require('tcb-admin-node');
app.init();

app.uploadFile({
    cloudPath: "cover.png",
    fileContent: fs.createReadStream(`${__dirname}/cover.png`)
}).then((res) => {
    console.log(res);
}).catch((err) => {
    console.error(err);
});;

控制檯

上傳好的文件，就會出如今控制檯中，以下圖。你能夠在控制檯裏刪除、下載或者查看圖片的詳情。

你還能夠控文件總體的權限，這裏還有一些具體的介紹。

服務端存儲文檔

數據庫

小程序雲提供文檔型數據庫 ( document-oriented database )，數據庫包含多個集合（至關於關係型數據中的表），集合近似於一個 JSON 數組，數組中的每一個對象就是一條記錄，記錄的格式是 JSON 文檔。

每條記錄都有一個 _id 字段用以惟一標誌這條記錄、一個 _openid 字段用以標誌記錄的建立者，即小程序的用戶。開發者能夠自定義 _id，但不可在小程序端自定義（在服務端能夠） _openid 。_openid 是在文檔建立時由系統根據小程序用戶默認建立的，開發者可以使用其來標識和定位文檔。

數據庫 API 分爲小程序端和服務端兩部分，小程序端 API 擁有嚴格的調用權限控制，開發者可在小程序內直接調用 API 進行非敏感數據的操做。對於有更高安全要求的數據，可在雲函數內經過服務端 API 進行操做。雲函數的環境是與客戶端徹底隔離的，在雲函數上能夠私密且安全的操做數據庫。

數據庫 API 包含增刪改查的能力，使用 API 操做數據庫只需三步：獲取數據庫引用、構造查詢/更新條件、發出請求。切記，在操做數據庫前，請先在控制檯中建立 collection。

小程序端

const db = wx.cloud.database();

// 插入數據
db.collection('photo').add({
    data: {
        photo: 'cloud://tcb-xxx/05ca1d38f86f90d66d4751a730379dfa6584dde05ab4-Ma9vMN_fw658.jpg',
        title: '風景'
    }
});

// 提取數據
db.collection('photo').get().then((res) => {
    let data = res.data;
    console.log(data);
});

// 輸出
// 在小程序端， _openid 會自動插入到數據庫中
{
    photo: 'cloud://tcb-xxx/05ca1d38f86f90d66d4751a730379dfa6584dde05ab4-Ma9vMN_fw658.jpg',
    title: '風景',
    _openid: 'oLlMr5FICCQJV-QgVLVzKu1212341'
}

小程序端數據庫文檔

服務端

const app = require('tcb-admin-node');
app.init();
const db = app.database();

db.collection('photo').limit(10).get().then((res) => {
    console.log(res);
}).catch((err) => {
    console.error(err);
});

// 輸出
// 由於是在服務端，其它用戶的也能夠提取出來
{
    photo: 'cloud://tcb-xxx/05ca1d38f86f90d66d4751a730379dfa6584dde05ab4-Ma9vMN_fw658.jpg',
    title: '風景',
    _openid: 'oLlMr5FICCQJV-QgVLVzKu1342121'
}
{
    photo: 'cloud://tcb-xxx/0dc3e66fd6b53641e328e091ccb3b9c4e53874232e6bf-ZxSfee_fw658.jpg',
    title: '美女',
    _openid: 'DFDFEX343xxdf-QgVLVzKu12452121'
}
{
    photo: 'cloud://tcb-xxx/104b27e339bdc93c0da15a47aa546b6e9c0e3359c315-L8Px2Y_fw658.jpg',
    title: '動物',
    _openid: 'DFDFEX343xxdf-QgVLVzKu1342121'
}

服務端數據庫文檔

控制檯

能夠在控制檯裏，看到用戶操做的數據，你也能夠本身在控制檯上添加、更新或刪除數據。

若是數據量龐大，能夠設置索引提供查詢的效率。

數據庫也能夠經過設置權限，管控每一個 collection。

雲函數

雲函數是一段運行在雲端的代碼，無需管理服務器，在開發工具內一鍵上傳部署便可運行後端代碼。

開發者能夠在雲函數內獲取到每次調用的上下文（appid、openid 等），無需維護複雜的鑑權機制，便可獲取自然可信任的用戶登陸態（openid）。

小程序端

wx.cloud.callFunction({
    name: 'addblog', // 雲函數名稱
    data: { // 傳到雲函數處理的參數
        title: '雲開發 TCB',
        content: '存儲、數據庫存、雲函數'
    }
}).then(res => {
    console.log(res)
}).catch((err) => {
    console.error(err);
});

小程序端雲函數文檔

服務端

const app = require("tcb-admin-node");
app.init();

app.callFunction({
    name: 'addblog', // 雲函數名稱
    data: { // 傳到雲函數處理的參數
        title: '雲開發 TCB',
        content: '存儲、數據庫存、雲函數'
    }
}).then((res) => {
    console.log(res);
}).catch((err) => {
    console.error(err);
});

服務端雲函數文檔

控制檯

上傳好以後的雲函數，都會在這裏羅列出來。

每次調用雲函數，均可以在這裏看到日誌，還能夠構造測試的參數，用於調試。

語法糖

大部份的接口，目前都支持兩種寫法，分別是Promise 和 Async/Await，本節以 callFunction做爲例子，在雲函數中介紹這兩種寫法。 Async/Await 本質上是基於 Promise 的一種語法糖，它只是把 Promise 轉換成同步的寫法而已。

Promise

const app = require("tcb-admin-node");
app.init();

exports.main = (event, context, callback) => {
    app.callFunction({
        name: 'addblog', // 雲函數名稱
        data: { // 傳到雲函數處理的參數
            title: '雲開發 TCB',
            content: '存儲、數據庫存、雲函數'
        }
    }).then((res) => {
        console.log(res);
        callback(null, res.data);
    }).catch((err) => {
        callback(err);
    });
};

Async/Await

const app = require("tcb-admin-node");
app.init();

exports.main = async (event, context) => {
    let result = null;

    try {
        result = await app.callFunction({
            name: 'addblog', // 雲函數名稱
            data: { // 傳到雲函數處理的參數
                title: '雲開發 TCB',
                content: '存儲、數據庫存、雲函數'
            }
        });
    }
    catch (e) {
        return e;
    }

    return result;
};

在雲函數裏使用，因爲是 Node 8.9 或以上的環境，所以自然支持 Async/Await 詰法，但在小程端要使用的話，須要額外引入 Polyfill，好比這個開源的項目：regenerator