MemFire Cloud是一款提供云数据库,用户可以创建云数据库,并对数据库进行管理,还可以对数据库进行备份操作。它还提供后端即服务,用户可以在1分钟内新建一个应用,使用自动生成的API和SDK,访问云数据库、对象存储、用户认证与授权等功能,可专注于编写前端应用程序代码,加速WEB或APP应用开发。
本篇文章将会教大家手把手使用MemFire Cloud做一个Posts社交网络论坛应用。我们基于Posts社交网络论坛应用做了一个详细的教程(视频详解请戳上方),来讲一讲在通过MemFire Cloud开发Posts社交网络论坛应用的开发步骤及注意事项,希望能真正解决用户使用MemFire Cloud过程中遇到的问题和提供一些应用实现的小技巧。
开发前需要知道的一些事
应用介绍
一个开放的社交网络论坛,任何人都可以在这里分享他们的想法和意见。
应用基础
Posts社交网络论坛是基于supabase官网的一个todo-list应用示例为基础,在这个基础上进行修改,删除,增加一些代码逻辑及功能的应用。
开发条件
您需要对vue3及ts有一定的了解;
您需要对sql语法有一定的了解;
开发依赖
"@supabase/supabase-js": "^1.1.2"
"vue": "^3.0.0"
“node.js”:"14.19.0"
"npm":"6.14.16"
1.准备工作
创建应用
登录https://cloud.memfiredb.com创建应用,打开应用后,查看并获取服务地址以及token信息
创建应用的一步很关键,我们的posts应用就是通过在这里创建的应用来获得数据库、云存储等一系列资源,并将获得该应用专属的API访问链接和访问密钥,用户可以轻松的与以上资源进行交互。想知道关于应用更详细的内容请查看文档(https://docs.memfiredb.com/base/application-introduction.html)
进入应用,我们在这里可以看到,Anon public是客户端API密钥。它允许“匿名访问”您的数据库,直到用户登录。登录后,密钥将切换到用户自己的登录令牌。这将为数据启用行级安全性。
注意:service_role secret可以绕过任何安全策略完全访问您的数据。这些密钥必须保密,并且要在服务器环境中使用,绝不能在客户端或浏览器上使用。
在后续示例代码中,需要提供supabaseUrl和supabaseKey。
supabaseUrl就是上图的网址链接,supabaseKey就是Anon API秘钥
想知道关于应用的连接更详细的内容请查看文档(https://docs.memfiredb.com/base/api.html#api-url%e5%92%8c%e5%af%86%e9%92%a5)
下载代码
「todo-list模板代码」(需要下载,选择项目为supabase /examples/vue3-ts-todo-list):
git clone https://gitee.com/memfiredb/supabase
「Posts最终代码」
git clone https://github.com/LucaRao/memfire-post.git
2.修改项目名称
将项目名vue3-ts-todo-list改为Posts
3.配置访问密钥
每个Supabase项目都有一个独特的API URL。您的 API 在一个 API 网关的保护下,每次请求都需要一个 API 密钥。
将上一步中获取的anon public和网址分别设置到supabaseUrl和supabaseKey中
(1)将根目录下的.env.local.example改为.env.local
(2)supabaseUrl和supabaseKey分别赋值给VUE_APP_SUPABASE_URL和VUE_APP_SUPABASE_KEY
4.表结构初始化
接下来我们需要创建数据表,posts表是用来存储用户论坛评论的数据,likes表用来存储用户点赞的某条评论的数据。
数据表结构
「posts」(论坛评论列表)
名称 | 类型 | 描述 |
---|---|---|
id | in8 | 主键,自增,每条评论的唯一标识ID |
task | text | 评论 |
text | 用户名 | |
created_at | timestamptz | 日期,可为空 |
「likes」(点赞表)
名称 | 类型 | 描述 |
---|---|---|
id | int8 | 主键,自增,每条评论的唯一标识ID |
email_name | text | 用户名 |
post_id | int8 | 每条评论的唯一id |
created_at | timestamptz | 日期,可为空 |
sql初始化语句
drop table if EXISTS public.posts;
drop table if EXISTS public.likes;
create table public.posts (
id bigint generated by default as identity primary key,
email varchar(255),
task text check (char_length(task) > 3),
created_at timestamp with time zone default timezone('utc'::text, now()) not null
);
create table public.likes (
id bigint generated by default as identity primary key,
email varchar(255),
post_id int not null ,
created_at timestamp with time zone default timezone('utc'::text, now()) not null
);
5.注册登录功能
运行项目
npm install
npm run serve
注册、登录、退出登录等功能在vue3-todo-list里已经实现,我们不必再次写一遍,也不需要修改文件里面的代码。
原理
打开Posts/src/compinents/Auth.vue
应用的登录、注册、退出登录的逻辑和页面在这里。登录、注册、退出登录都是通过引入的Posts/src/vuetils/useAuth.ts文件里面的相应功能的api来进行交互的,supabase官网提供的todo-list应用的demo已经在useAuth.ts文件里给我们写好了这些功能的接口。
在Posts/src/vuetils/useAuth.ts文件中看到,在引入supabase依赖之后,我们的登录、注册等功能的api都是由supabase规定的api名称,比如登录叫supabase.auth.signIn,注册叫supabase.auth.signUp。具体查看文档(https://docs.memfiredb.com/base/javascript/auth-signup.html)
「我们来创建一个用户并且尝试登录」
控制台显示注册并登录成功,并且已经将我们的用户信息存入了userSession中
6.实现发布评论功能
(1)修改数据类型(ts语法用到数据类型校验)
打开Posts/src/types/global.ts修改为
declare interface Credentials {
email?: string | undefined
password?: string | undefined
provider?: 'bitbucket' | 'github' | 'gitlab' | 'google' | undefined
}
declare interface Todo {
id?: number
email?: string
task: string
inserted_at?: string
}
(2)编写页面逻辑
-
打开Posts/src/compinents/TodoList.vue
2.修改页面样式,用户名这里我们使用邮箱“@”符号之前的字符串。
修改template页面为
<template>
<div class="w-full">
<h2 class="mb-12 font-bold text-3xl">Write a new post</h2>
<h2 class="mb-12 font-bold text-2xl">welcome {{userSession.user.email.substring(0,userSession.user.email.indexOf('@'))}}!</h2>
<div class="flex gap-2 my-2">
<input
v-model="task"
class="rounded w-full p-2"
type="text"
placeholder="What do you need to?"
/>
<button @click="insertTask" class="btn-black">
Publish
</button>
</div>
<div class="bg-white shadow overflow-hidden rounded-md" style="height: 300px;overflow-y: scroll;">
<ul v-for="(todo, index) in allTodos" :key="index">
<suspense>
<Todo :todo="todo" />
</suspense>
</ul>
</div>
</div>
</template>
3.在该页面搜索insertTask方法,这是发布的按钮,将发布论坛评论方法的参数改为email和task
const todo = await addTodo({ email: userSession.value.user.email, task: task.value, })
下图就是登录后修改的posts首页
页面引入的Posts/src/vuetils/useTodo.ts文件是用来请求posts列表数据和新增一条post相应功能交互的api的方法
打开Posts/src/vuetils/useTodo.ts文件
由于我们修改了表名称,但是逻辑并没有修改,只需要替换查询表名,所以我们将fetchTodos方法里面的查询posts列表语法修改为
const { data: todos, error } = await supabase.from('posts').select('*').order('id')
同上,我们将addTodo里面的新增post语法改为
const { data, error } = await supabase.from('posts').insert(todo).single()
现在我们在页面插入一条数据,观察控制台的network的接口请求情况,显示插入成功
7.渲染评论列表和点赞功能
打开Posts/src/components/Todo.vue页面,我们要先把页面样式做以下修改
Template
<template>
<li
class="
block
cursor-pointer
hover:bg-gray-200
focus:outline-none focus:bg-gray-200
transition
duration-150
ease-in-out
border-style1
"
>
<div class="flex items-center px-4 py-4 sm:px-6">
<div class="min-w-0 flex-1 flex items-center">
<div class="text-sm leading-5 font-medium truncate t-s">{{ todo.task }}</div>
</div>
<button @click="toggleLike" class="w-4 h-4 ml-2 hover:border-black rounded">
<svg
v-if="like"
xmlns="http://www.w3.org/2000/svg"
xmlns:xlink="http://www.w3.org/1999/xlink"
width="24px"
height="24px"
preserveAspectRatio="xMidYMid meet"
viewBox="0 0 256 256"
>
<path
d="M236.023 92c0 30.565-17.713 62.005-52.648 93.446a317.34 317.34 0 0 1-51.442 37.534a8 8 0 0 1-7.819 0c-4.25-2.38-104.09-59.117-104.09-130.98a60.02 60.02 0 0 1 108-36.04a60.02 60.02 0 0 1 108 36.04z"
fill="currentColor"
></path>
</svg>
<svg
v-else
xmlns="http://www.w3.org/2000/svg"
xmlns:xlink="http://www.w3.org/1999/xlink"
width="24px"
height="24px"
preserveAspectRatio="xMidYMid meet"
viewBox="0 0 256 256"
>
<path
d="M128.018 228a11.995 11.995 0 0 1-5.864-1.53C117.82 224.043 16.018 166.18 16.018 92a64.028 64.028 0 0 1 112-42.378a64.028 64.028 0 0 1 112 42.378c0 74.18-101.803 132.043-106.137 134.47a11.995 11.995 0 0 1-5.863 1.53zm-48-176a40.046 40.046 0 0 0-40 40c0 51.222 67.445 97.186 88 110c20.554-12.814 88-58.778 88-110a40.009 40.009 0 0 0-76.928-15.408a12 12 0 0 1-22.145 0A39.923 39.923 0 0 0 80.018 52z"
fill="currentColor"
></path>
</svg>
</button>
</div>
<div class="flex items-center px-4 py-4 sm:px-6 t-m">
{{todo.email.substring(0, todo.email.indexOf('@'))}}
</div>
</li>
</template>
Css
<style lang="css" scoped>
.border-style1 {
border: 1px solid #d5d0d0;
margin: 20px 15px;
border-radius: 10px;
}
.t-s {
font-size: 14px;
font-weight: bold;
}
.t-m {
font-size: 13px;
font-weight: normal;
margin-top: -20px;
}
</style>
在Todo.vue列表组件中,我们需要展示所有用户的评论、用户名、当前用户是否点赞,列表的数据我们已经在TodoList.vue的fetchTodos方法中拿到,并且传递给了Todo.vue子组件。接下来我们编写点赞接口的逻辑。
刷新点赞方法
「原理」:likes表里面包含所有当前用户的点赞数据,是通过当前用户的用户名email与遍历当前一条数据的post的id与likes表里面的email_name和post_id是否匹配进行查询,这是一个组件的循环遍历查询,每查一次,看是否查到数据,查到数据则表示该用户给当前的评论点了赞,即为带有当前用户点赞的数据,有的话将当前一条数据的like改为有数据即为true,爱心点亮
「步骤」:
1.在Todo.vue引入文件
import { defineComponent, ref } from 'vue'
import { supabase } from '@/lib/supabase'
import { userSession } from '@/vuetils/useAuth'
2.将Todo.vue逻辑代码都清空,加上下面的刷新点赞的方法
const fecthLike = async () => {
const { data } = await supabase
.from('likes')
.select('*')
.match({
post_id: props.todo.id,
email_name: userSession?.value?.user?.email || '',
})
if(data?.length){
like.value = data[0]
} else {
like.value = null
}
}
「切换点赞的方法」:
每次切换完都要刷新一下点赞
「原理」:
点赞就在likes表里添加一条用户用户名email_name和post_id的数据,取消点赞就删除此条数据
3.增加以下代码
const toggleLike = async () => {
if (like.value) {
await supabase
.from('likes')
.delete()
.match({
post_id: props.todo.id,
email_name: userSession?.value?.user?.email || '',
})
} else {
await supabase
.from('likes')
.insert({
post_id: props.todo.id,
email_name: userSession?.value?.user?.email,
})
.single()
}
fecthLike()
}
「Todo.vue完整代码」
<template>
<li
class="
block
cursor-pointer
hover:bg-gray-200
focus:outline-none focus:bg-gray-200
transition
duration-150
ease-in-out
border-style1
"
>
<div class="flex items-center px-4 py-4 sm:px-6">
<div class="min-w-0 flex-1 flex items-center">
<div class="text-sm leading-5 font-medium truncate t-s">{{ todo.task }}</div>
</div>
<button @click="toggleLike" class="w-4 h-4 ml-2 hover:border-black rounded">
<svg
v-if="like"
xmlns="http://www.w3.org/2000/svg"
xmlns:xlink="http://www.w3.org/1999/xlink"
width="24px"
height="24px"
preserveAspectRatio="xMidYMid meet"
viewBox="0 0 256 256"
>
<path
d="M236.023 92c0 30.565-17.713 62.005-52.648 93.446a317.34 317.34 0 0 1-51.442 37.534a8 8 0 0 1-7.819 0c-4.25-2.38-104.09-59.117-104.09-130.98a60.02 60.02 0 0 1 108-36.04a60.02 60.02 0 0 1 108 36.04z"
fill="currentColor"
></path>
</svg>
<svg
v-else
xmlns="http://www.w3.org/2000/svg"
xmlns:xlink="http://www.w3.org/1999/xlink"
width="24px"
height="24px"
preserveAspectRatio="xMidYMid meet"
viewBox="0 0 256 256"
>
<path
d="M128.018 228a11.995 11.995 0 0 1-5.864-1.53C117.82 224.043 16.018 166.18 16.018 92a64.028 64.028 0 0 1 112-42.378a64.028 64.028 0 0 1 112 42.378c0 74.18-101.803 132.043-106.137 134.47a11.995 11.995 0 0 1-5.863 1.53zm-48-176a40.046 40.046 0 0 0-40 40c0 51.222 67.445 97.186 88 110c20.554-12.814 88-58.778 88-110a40.009 40.009 0 0 0-76.928-15.408a12 12 0 0 1-22.145 0A39.923 39.923 0 0 0 80.018 52z"
fill="currentColor"
></path>
</svg>
</button>
</div>
<div class="flex items-center px-4 py-4 sm:px-6 t-m">
{{todo.email.substring(0, todo.email.indexOf('@'))}}
</div>
</li>
</template>
<script lang="ts">
import { defineComponent, PropType, ref } from 'vue'
import { supabase } from '@/lib/supabase'
import { userSession } from '@/vuetils/useAuth'
export default defineComponent({
name: 'Todo',
props: {
todo: {
type: Object,
required: true,
},
},
setup(props) {
const like = ref<undefined | null>(undefined)
const fecthLike = async () => {
const { data } = await supabase
.from('likes')
.select('*')
.match({
post_id: props.todo.id,
email_name: userSession?.value?.user?.email || '',
})
if(data?.length){
like.value = data[0]
} else {
like.value = null
}
}
fecthLike()
// Removes todo from supbase and also from app state
const toggleLike = async () => {
if (like.value) {
await supabase
.from('likes')
.delete()
.match({
post_id: props.todo.id,
email_name: userSession?.value?.user?.email || '',
})
} else {
await supabase
.from('likes')
.insert({
post_id: props.todo.id,
email_name: userSession?.value?.user?.email,
})
.single()
}
fecthLike()
}
return { toggleLike, userSession,like,fecthLike }
},
})
</script>
<style lang="css" scoped>
.border-style1 {
border: 1px solid #d5d0d0;
margin: 20px 15px;
border-radius: 10px;
}
.t-s {
font-size: 14px;
font-weight: bold;
}
.t-m {
font-size: 13px;
font-weight: normal;
margin-top: -20px;
}
</style>
小技巧:具体的增删改查的语法可以参考文档(https://docs.memfiredb.com/base/javascript/select.html)
重启一下项目,登录后我们来新增一条数据,新增成功,点赞也成功了!
简单的post应用即完成!
写在结尾的话
以上就是基于一个教程示例对MemFire Cloud的使用和反馈的一些看法,如果在开发中遇到问题,可以参考上面的完整代码项目比对,希望对大家有所帮助。
MemFireDB
产品资料
MemFire Cloud
平台入口:https://memfiredb.com/
文档地址:https://docs.memfiredb.com/
文章评论