跳到主要内容

名词解释

BaaS

Backend as a Service 后端作为服务,类似于 SaaS Software as a Service 软件即服务。不同于 SaaS 是将整个软件卖给你,BaaS 是提供给你 API,软件界面可以由你自己开发,功能可以随心定制。

应用

本文档中 应用 有两种意思,大多是第一种意思,根据上下文不同也有第二种意思。

第一种指在清林云系统中开发的 BaaS 应用,有应用市场的第三方应用和自己开发的自定义应用。

第二种指你或你公司自行开发的应用程序,可能是网页、手机 App、企业软件等。

前端/后端

一般在应用程序的开发中,分为前端和后端两个部分。

前端指用户能看到的界面软件,包括操作交互、动画等等。

后端指除前端之外的程序,包含了数据的储存、查询,一些功能的逻辑等等。

在线应用一般有前端展示界面和简单交互给用户,通过网络请求连接后端存取数据或判断用户权限等。

如果权限信息等敏感数据不保存在后端,则应用程序的前端容易被破解后直接修改相关信息,非常不安全。

服务

在本文档中服务有三种意思:

  1. Server 的意思,指应用程序后端的系统进程,面向前端程序服务;
  2. 提供的功能,比如说,后端即服务的意思就是将后端作为一种功能提供给所有人使用;
  3. 正常服务的意思,如咨询服务、客户服务,就是我们提供的人力劳动、智力劳动等。

API

API:Application Programming Interface,应用程序接口。

指软件系统不同组成部分衔接的约定。在本文档中多指后端应用的接口。

前端程序可以通过不同的 API 调用来实现不同的功能。

云服务

传统的应用软件开发,你需要购买服务器、硬盘、带宽、电等基础设施来运行程序和储存数据。

云服务即由云厂商来购买这些东西,并通过远程连接的方式提供给开发者使用。

使用云服务可以有效地降低初始成本,统一的管理保障安全。避免服务器中断、停电等等意外。

数字化

数字化指将现实实体或虚拟实体的信息通过网络、数据的形式交互,利用信息传输的特点构建光速的信息世界。

清林云系统中的名词

组织

当你在登录清林云时会要求你创建组织,类似于公司、团队的概念,你可以邀请其他人加入到你创建的组织,共同管理资源和使用应用。同时也可以是一人组织。

组织可以拥有最多五千个成员和五个环境。

组织分组

每个组织可以创建至多 5000 个分组,类似于公司的不同部门,每个分组都可以设置相关的分组权限。

分组成员

用户可以归属于某个或多个组织分组,便于组织管理区分和获得相关权限。

环境

环境是前端请求 API 的基本条件。就好比家中的卧室和客厅,他们有着不同的作用和适用场景。环境也是类似,不同的环境有不同的作用。它们的数据互相隔离。

你可以创建一个测试环境,一个生产环境。当你在本地开发应用前端时,使用测试环境,可以创造一些假数据、假用户等等来实验功能。当你部署或发布应用时切换为生产环境,即全都是真实的用户数据。

同样的,如果你想开发互相独立的两个应用,也可以用两个环境来互相隔离数据。

环境拥有环境密匙。

环境密匙

环境密匙分为两部分,keyId 和 secret。keyId 是当前端请求 BaaS 时需要携带的信息,用来判定到底用哪一个密匙去解密 token 或加密 token。

注:A 密匙加密的 token 无法用 B 密匙解密,如果不是泄露了密匙需要更换,请尽量不要创建多个密匙,容易混乱。

secret 只在创建时能看到一次,请在创建密匙时妥善保存。你可以使用 secret 和 keyId 创建管理员 token 来访问 API 之外的原始数据。

token

用户信息的加密密文,通常在请求中携带。

通过 token 可以验证该请求是否为恶意请求,可以判断是哪一个用户。

token 由注册登录系统生成,返回给用户时请调用客户端代码保存至用户本地的浏览器、手机或电脑。

大部分 API 需要携带用户 token 来判断用户身份。少部分 API 不要求用户登录即可访问,有一定恶意请求的风险,前端可以采用验证码或防爬虫等方式保护。

环境资源

环境资源分为已使用 RU 和总储备。

每次某环境的前端请求 API 时会消耗储备的 RU,当消耗完时 API 将拒绝该环境请求。你可以为该环境充值 RU 继续使用。

总储备 RU = 已使用 RU + 剩余储备 RU

RU

Request Unit 请求资源单位

每个应用 API 都有各自的定价 RU,根据流程、设计难度等不同而随之变化。

比如说,某个简单的请求,应用开发者会定价为 1RU,即当你每次请求这个 API 时会产品 1RU 的计费。

某个长流程复杂的请求,应用开发者定价为 10RU,则当你每次请求时会产生 10RU 的计费。

应用市场

公开上架的可以被所有人安装使用的 BaaS 应用的市场。

可以搜索、查看应用。

应用

清林云 BaaS 的应用是官方或用户创建的一个功能集合,可以提供给前端使用。

应用分为上架应用和私有应用。

用户可以控制应用的上架与否。上架即可在应用市场被所有人使用,赚取 RU 资源。不上架则只能被该应用所在的组织使用。

应用有:

  • 多个 API,提供实际的应用逻辑。
  • 一个文档,解释说明应用的作用。
  • 一个应用控制台,可以提供给组织成员管理应用功能数据的前端页面。
  • 一系列应用配置,应用使用者在使用该应用前所必须填写的固定配置。用于 API 流程中读取判断。比如某功能需要微信的 appid 等信息,需要提前由使用者配置好。
  • 一个数据库结构设计。包含多个数据库表结构。每个环境使用应用时都会分配一个独立的数据库环境。所以应用开发者不能查看其他用户环境的数据。

云数据库

每个环境都有独立的云数据库,每个应用都有独立的数据库结构。

应用可以设置多个数据库表,每张表都是一系列信息的集合。如用户表记录所有用户,商品表记录所有商品等等。

每个表都有特定的引擎,每个引擎都有不同的功能。

表内有 ID 和字段,单个或多个 ID 组合代表该条数据的唯一性。字段为该条数据的一系列信息。

API

API 是用户直接请求的目标,拥有独立的权限、定价、文档、分组、RU 收入、参数配置、逻辑流程等。

具体设置可参考自定义应用 API 文档

自定义函数

当 API 的逻辑流程中的预设流程不能满足开发者需求时,我们也提供自定义函数功能。

可以将任意语言的代码和库打包上传至自定义函数,在流程中调用即可,具体设置可参考自定义应用函数文档