跳到主要内容

名词解释

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 的逻辑流程中的预设流程不能满足开发者需求时,我们也提供自定义函数功能。

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