快速入门｜使用MemFire Cloud构建Angular应用程序

MemFire Cloud是一款供给云数据库，用户能够创立云数据库，并对数据库进行办理，还能够对数据库进行备份操作。它还供给后端即服务，用户能够在1分钟内新建一个运用，运用主动生成的API和SDK，拜访云数据库、对象存储、用户认证与授权等功用，可专心于编写前端运用程序代码，加速WEB或APP运用开发。

学习视频地址： www.bilibili.com/video/BV1wt…

此示例供给了运用 MemFire Cloud 和 angular构建简单用户办理运用程序（从头开始）的步骤。这包含：

• MemFire Cloud云数据库：用于存储用户数据的 MemFireDB数据库。

• MemFire Cloud用户验证：用户能够运用魔法链接登录（只需求电子邮件,不需求暗码）。

• MemFire Cloud存储：用户能够上传相片。

• 行级安全战略：数据受到保护，因而个人只能拜访自己的数据。

• 即时API：创立数据库表时会主动生成 API。

在本攻略结束时，您将具有一个答运用户登录和更新一些基本个人材料详细信息的运用程序：

创立运用

意图：咱们的运用便是经过在这儿创立的运用来取得数据库、云存储等一系列资源，并取得该运用专属的API拜访链接和拜访密钥，用户能够轻松的与以上资源进行交互。

登录cloud.memfiredb.com/auth/login 创立运用

创立数据表

点击运用，视图化创立数据表

1. 创立profiles表；

在数据表页面，点击“新建数据表”，页面装备如下：

其间profiles表字段id和auth.users表中的id字段（uuid类型）外键相关。

2. 开启Profiles的RLS数据安全拜访规矩；

选中创立的Profiles表，点击表权限栏，如下图所示，点击”启用RLS”按钮

3. 答应每个用户能够检查公共的个人信息材料；

点击”新规矩”按钮，在弹出弹框中，挑选”为一切用户启用拜访权限”，输入战略称号，挑选”SELECT(查询)”操作，点击“创立战略”按钮，如下图。

4. 仅答运用户增删改查自己的个人材料信息；

点击”新规矩”按钮，在弹出弹框中，挑选”根据用户ID为用户启用拜访权限”，输入战略称号，挑选”ALL(一切)”操作，点击“创立战略”按钮，如下图。

创立avatars存储桶

创立云存储的存储桶，用来存储用户的头像图片，触及操作包含：

1. 创立一个存储桶avatars

在该运用的云存储导航栏，点击“新建Bucket”按钮，创立存储桶avatars。

2. 答应每个用户能够检查存储桶avatars

选中存储桶avatars，切换到权限设置栏，点击“新规矩”按钮，弹出战略修正弹框，挑选“自定义”，如下图所示：

挑选SELECT操作，输入战略称号，点击“生成战略”按钮，如下图所示。

3. 答运用户上传存储桶avatars；

选中存储桶avatars，切换到权限设置栏，点击“新规矩”按钮，弹出战略修正弹框，挑选“自定义”，如下图所示：

挑选INSERT操作，输入战略称号，点击“生成战略”按钮，如下图所示。

检查结果

一切数据表及RLS的sql（战略称号用英文代替）

-- Create a table for public "profiles"
create table profiles (
  id uuid references auth.users not null,
  updated_at timestamp with time zone,
  username text unique,
  avatar_url text,
  website text,
  primary key (id),
  unique(username),
);
alter table profiles enable row level security;
create policy "Public profiles are viewable by everyone."
  on profiles for select
  using ( true );
create policy "Users can insert their own profile."
  on profiles for insert
  with check ( auth.uid() = id );
create policy "Users can update own profile."
  on profiles for update
  using ( auth.uid() = id );
-- Set up Storage!
insert into storage.buckets (id, name)
values ('avatars', 'avatars');
create policy "Avatar images are publicly accessible."
  on storage.objects for select
  using ( bucket_id = 'avatars' );
create policy "Anyone can upload an avatar."
  on storage.objects for insert
  with check ( bucket_id = 'avatars' );

获取 API秘钥

现在您现已创立了一些数据库表，您能够运用主动生成的 API 刺进数据。咱们只需求从API设置中获取URL和anon的密钥。

在运用->归纳页面，获取服务地址以及token信息。

Anon（揭露）密钥是客户端API密钥。它答应“匿名拜访”您的数据库，直到用户登录。登录后，密钥将切换到用户自己的登录令牌。这将为数据启用行级安全性。

注意：service_role（秘密）密钥能够绕过任何安全战略彻底拜访您的数据。这个密钥有必要保密，而且要在服务器环境中运用，绝不能在客户端或浏览器上运用。 在后续示例代码中，需求供给supabaseUrl和supabaseKey。

认证设置

当用户点击邮件内魔法链接进行登录时，是需求跳转到咱们运用的登录界面的。这儿需求在认证设置中进行相关URL重定向的装备。

由于咱们终究的运用会在本地的4200端口发动（亦或许其他端口），所以这儿咱们暂时将url设置为http://localhost:4200

除此之外，在此界面也能够自定义运用咱们自己的smtp服务器。

构建运用程序

让咱们从头开始构建 Angular运用程序。

初始化项目

咱们能够运用Angular CLI来初始化一个名为memfiredb-angular：

Angular 需求 Node.js (>=14.15 <=16.10) 。

npm install -g @angular/cli
npx ng new memfiredb-angular --routing false --style css
cd memfiredb-angular

然后让咱们装置仅有的附加依靠项：supabase-js

npm install @supabase/supabase-js

最后，咱们要将环境变量保存在environment.ts， 咱们需求的是 API URL 和您上面anon仿制的密钥。

src/environments/environment.ts文件

export const environment = {
  production: false,
  supabaseUrl: "YOUR_SUPABASE_URL",
  supabaseKey: "YOUR_SUPABASE_KEY"
};

现在咱们现已有了 API 凭据，经过ng g s supabase创立一个SupabaseService来初始化 Supabase 客户端并完成与 Supabase API 通信的函数。

src/app/supabase.service.ts

import { Injectable } from '@angular/core';
import {AuthChangeEvent, createClient, Session, SupabaseClient} from '@supabase/supabase-js';
import {environment} from "../environments/environment";
export interface Profile {
  username: string;
  website: string;
  avatar_url: string;
}
@Injectable({
  providedIn: 'root'
})
export class SupabaseService {
  private supabase: SupabaseClient;
  constructor() {
    this.supabase = createClient(environment.supabaseUrl, environment.supabaseKey);
  }
  get user() {
    return this.supabase.auth.user();
  }
  get session() {
    return this.supabase.auth.session();
  }
  get profile() {
    return this.supabase
      .from('profiles')
      .select(`username, website, avatar_url`)
      .eq('id', this.user?.id)
      .single();
  }
  authChanges(callback: (event: AuthChangeEvent, session: Session | null) => void) {
    return this.supabase.auth.onAuthStateChange(callback);
  }
  signIn(email: string) {
    return this.supabase.auth.signIn({email});
  }
  signOut() {
    return this.supabase.auth.signOut();
  }
  updateProfile(profile: Profile) {
    const update = {
      ...profile,
      id: this.user?.id,
      updated_at: new Date()
    }
    return this.supabase.from('profiles').upsert(update, {
      returning: 'minimal', // Don't return the value after inserting
    });
  }
  downLoadImage(path: string) {
    return this.supabase.storage.from('avatars').download(path);
  }
  uploadAvatar(filePath: string, file: File) {
    return this.supabase.storage
      .from('avatars')
      .upload(filePath, file);
  }
}

更新款式

能够看到界面实在是不怎么高雅，更新下款式，让它美观一些。 修正src/styles.css文件。

html,
body {
  --custom-font-family: -apple-system, BlinkMacSystemFont, Segoe UI, Roboto, Oxygen, Ubuntu,
    Cantarell, Fira Sans, Droid Sans, Helvetica Neue, sans-serif;
  --custom-bg-color: #101010;
  --custom-panel-color: #222;
  --custom-box-shadow: 0 2px 8px 0 rgba(0, 0, 0, 0.8);
  --custom-color: #fff;
  --custom-color-brand: #24b47e;
  --custom-color-secondary: #666;
  --custom-border: 1px solid #333;
  --custom-border-radius: 5px;
  --custom-spacing: 5px;
  padding: 0;
  margin: 0;
  font-family: var(--custom-font-family);
  background-color: var(--custom-bg-color);
}
* {
  color: var(--custom-color);
  font-family: var(--custom-font-family);
  box-sizing: border-box;
}
html,
body,
#__next {
  height: 100vh;
  width: 100vw;
  overflow-x: hidden;
}
/* Grid */
.container {
  width: 90%;
  margin-left: auto;
  margin-right: auto;
}
.row {
  position: relative;
  width: 100%;
}
.row [class^='col'] {
  float: left;
  margin: 0.5rem 2%;
  min-height: 0.125rem;
}
.col-1,
.col-2,
.col-3,
.col-4,
.col-5,
.col-6,
.col-7,
.col-8,
.col-9,
.col-10,
.col-11,
.col-12 {
  width: 96%;
}
.col-1-sm {
  width: 4.33%;
}
.col-2-sm {
  width: 12.66%;
}
.col-3-sm {
  width: 21%;
}
.col-4-sm {
  width: 29.33%;
}
.col-5-sm {
  width: 37.66%;
}
.col-6-sm {
  width: 46%;
}
.col-7-sm {
  width: 54.33%;
}
.col-8-sm {
  width: 62.66%;
}
.col-9-sm {
  width: 71%;
}
.col-10-sm {
  width: 79.33%;
}
.col-11-sm {
  width: 87.66%;
}
.col-12-sm {
  width: 96%;
}
.row::after {
  content: '';
  display: table;
  clear: both;
}
.hidden-sm {
  display: none;
}
@media only screen and (min-width: 33.75em) {
  /* 540px */
  .container {
    width: 80%;
  }
}
@media only screen and (min-width: 45em) {
  /* 720px */
  .col-1 {
    width: 4.33%;
  }
  .col-2 {
    width: 12.66%;
  }
  .col-3 {
    width: 21%;
  }
  .col-4 {
    width: 29.33%;
  }
  .col-5 {
    width: 37.66%;
  }
  .col-6 {
    width: 46%;
  }
  .col-7 {
    width: 54.33%;
  }
  .col-8 {
    width: 62.66%;
  }
  .col-9 {
    width: 71%;
  }
  .col-10 {
    width: 79.33%;
  }
  .col-11 {
    width: 87.66%;
  }
  .col-12 {
    width: 96%;
  }
  .hidden-sm {
    display: block;
  }
}
@media only screen and (min-width: 60em) {
  /* 960px */
  .container {
    width: 75%;
    max-width: 60rem;
  }
}
/* Forms */
label {
  display: block;
  margin: 5px 0;
  color: var(--custom-color-secondary);
  font-size: 0.8rem;
  text-transform: uppercase;
}
input {
  width: 100%;
  border-radius: 5px;
  border: var(--custom-border);
  padding: 8px;
  font-size: 0.9rem;
  background-color: var(--custom-bg-color);
  color: var(--custom-color);
}
input[disabled] {
  color: var(--custom-color-secondary);
}
/* Utils */
.block {
  display: block;
  width: 100%;
}
.inline-block {
  display: inline-block;
  width: 100%;
}
.flex {
  display: flex;
}
.flex.column {
  flex-direction: column;
}
.flex.row {
  flex-direction: row;
}
.flex.flex-1 {
  flex: 1 1 0;
}
.flex-end {
  justify-content: flex-end;
}
.flex-center {
  justify-content: center;
}
.items-center {
  align-items: center;
}
.text-sm {
  font-size: 0.8rem;
  font-weight: 300;
}
.text-right {
  text-align: right;
}
.font-light {
  font-weight: 300;
}
.opacity-half {
  opacity: 50%;
}
/* Button */
button,
.button {
  color: var(--custom-color);
  border: var(--custom-border);
  background-color: var(--custom-bg-color);
  display: inline-block;
  text-align: center;
  border-radius: var(--custom-border-radius);
  padding: 0.5rem 1rem;
  cursor: pointer;
  text-align: center;
  font-size: 0.9rem;
  text-transform: uppercase;
}
button.primary,
.button.primary {
  background-color: var(--custom-color-brand);
  border: 1px solid var(--custom-color-brand);
}
/* Widgets */
.card {
  width: 100%;
  display: block;
  border: var(--custom-border);
  border-radius: var(--custom-border-radius);
  padding: var(--custom-spacing);
}
.avatar {
  border-radius: var(--custom-border-radius);
  overflow: hidden;
  max-width: 100%;
}
.avatar.image {
  object-fit: cover;
}
.avatar.no-image {
  background-color: #333;
  border: 1px solid rgb(200, 200, 200);
  border-radius: 5px;
}
.footer {
  position: absolute;
  max-width: 100%;
  bottom: 0;
  left: 0;
  right: 0;
  display: flex;
  flex-flow: row;
  border-top: var(--custom-border);
  background-color: var(--custom-bg-color);
}
.footer div {
  padding: var(--custom-spacing);
  display: flex;
  align-items: center;
  width: 100%;
}
.footer div > img {
  height: 20px;
  margin-left: 10px;
}
.footer > div:first-child {
  display: none;
}
.footer > div:nth-child(2) {
  justify-content: left;
}
@media only screen and (min-width: 60em) {
  /* 960px */
  .footer > div:first-child {
    display: flex;
  }
  .footer > div:nth-child(2) {
    justify-content: center;
  }
}
@keyframes spin {
  from {
    transform: rotate(0deg);
  }
  to {
    transform: rotate(360deg);
  }
}
.mainHeader {
  width: 100%;
  font-size: 1.3rem;
  margin-bottom: 20px;
}
.avatarPlaceholder {
  border: var(--custom-border);
  border-radius: var(--custom-border-radius);
  width: 35px;
  height: 35px;
  background-color: rgba(255, 255, 255, 0.2);
  display: flex;
  align-items: center;
  justify-content: center;
}
/* Auth */
.auth-widget {
  display: flex;
  flex-direction: column;
  gap: 20px;
}
.auth-widget > .button {
  display: flex;
  align-items: center;
  justify-content: center;
  border: none;
  background-color: #444444;
  text-transform: none !important;
  transition: all 0.2s ease;
}
.auth-widget .button:hover {
  background-color: #2a2a2a;
}
.auth-widget .button > .loader {
  width: 17px;
  animation: spin 1s linear infinite;
  filter: invert(1);
}
/* Account */
.account {
  display: flex;
  flex-direction: column;
  gap: 20px;
}
.account > * > .avatarField {
  display: flex;
  align-items: center;
  margin-bottom: 30px;
}
.account > * > .avatarField > .avatarContainer {
  margin-right: 20px;
}
/* Profile Card */
.profileCard {
  border-radius: 5px;
  display: flex;
  border: var(--custom-border);
  background-color: var(--custom-panel-color);
  padding: 20px 20px;
  margin-bottom: 20px;
}
.profileCard:last-child {
  margin-bottom: 0px;
}
.profileCard > .userInfo {
  margin-left: 20px;
  font-weight: 300;
  display: flex;
  flex-direction: column;
  justify-content: center;
}
.profileCard > .userInfo > p {
  margin: 0;
}
.profileCard > .userInfo > .username {
  font-size: 1.3rem;
  font-weight: 500;
  margin-bottom: 5px;
}
.profileCard > .userInfo > .website {
  font-size: 0.9rem;
  color: var(--custom-color-brand);
  margin-bottom: 10px;
  text-decoration: none;
}

设置登录组件

让咱们设置一个 Angular 组件来办理登录和注册。咱们将运用 Magic Links，因而用户无需运用暗码即可运用电子邮件登录。运用Angular CLI 指令创立一个AuthComponent 。 ng g c auth

src/app/auth/auth.component.ts

import { Component } from '@angular/core';
import {SupabaseService} from "../supabase.service";
@Component({
  selector: 'app-auth',
  template: `
    <div class="row flex flex-center">
      <form class="col-6 form-widget">
        <h1 class="header">Memfiredb + Angular</h1>
        <p class="description">运用下面的电子邮件经过戏法链接登录</p>
        <div>
          <input
            #input
            class="inputField"
            type="email"
            placeholder="Your email"
          />
        </div>
        <div>
          <button
            type="submit"
            (click)="handleLogin(input.value)"
          class="button block"
          [disabled]="loading"
          >
          {{loading ? 'Loading' : 'Send magic link'}}
          </button>
        </div>
      </form>
    </div>
  `,
})
export class AuthComponent {
  loading = false;
  constructor(private readonly supabase: SupabaseService) { }
  async handleLogin(input: string) {
    try {
      this.loading = true;
      await this.supabase.signIn(input);
      alert('请检查您的电子邮件以获取登录链接!');
    } catch (error:any) {
      alert(error.error_description || error.message)
    } finally {
      this.loading = false;
    }
  }
}

用户信息页面

用户登录后，咱们能够答应他们修正他们的个人材料详细信息并办理他们的帐户。运用Angular CLI 指令创立一个AccountComponent 。 ng g c account

src/app/account/account.component.ts

import {Component, Input, OnInit} from '@angular/core';
import {Profile, SupabaseService} from "../supabase.service";
import {Session} from "@supabase/supabase-js";
@Component({
  selector: 'app-account',
  template: `
    <div class="form-widget">
      <div>
        <label for="email">邮箱</label>
        <input id="email" type="text" [value]="session?.user?.email" disabled/>
      </div>
      <div>
        <label for="username">称号</label>
        <input
          #username
          id="username"
          type="text"
          [value]="profile?.username ?? ''"
        />
      </div>
      <div>
        <label for="website">网址</label>
        <input
          #website
          id="website"
          type="url"
          [value]="profile?.website ?? ''"
        />
      </div>
      <div>
        <button
          class="button block primary"
          (click)="updateProfile(username.value, website.value)"
          [disabled]="loading"
        >
          {{loading ? 'Loading ...' : 'Update'}}
        </button>
      </div>
      <div>
        <button class="button block" (click)="signOut()">
          退出登录
        </button>
      </div>
    </div>
  `
})
export class AccountComponent implements OnInit {
  loading = false;
  profile: Profile | undefined;
  @Input() session: Session | undefined;
  constructor(private readonly supabase: SupabaseService) { }
  ngOnInit() {
    this.getProfile();
  }
  async getProfile() {
    try {
      this.loading = true;
      let {data: profile, error, status} = await this.supabase.profile;
      if (error && status !== 406) {
        throw error;
      }
      if (profile) {
        this.profile = profile;
      }
    } catch (error:any) {
      alert(error.message)
    } finally {
      this.loading = false;
    }
  }
  async updateProfile(username: string, website: string, avatar_url: string = '') {
    try {
      this.loading = true;
      await this.supabase.updateProfile({username, website, avatar_url});
    } catch (error:any) {
      alert(error.message);
    } finally {
      this.loading = false;
    }
  }
  async signOut() {
    await this.supabase.signOut();
  }
}

修正项目进口文件

现在咱们现已准备好了一切组件，让咱们更新AppComponent：

src/app/app.component.ts

import {Component, OnInit} from '@angular/core';
import {SupabaseService} from "./supabase.service";
@Component({
  selector: 'app-root',
  template: `
  <div class="container">
    <app-account *ngIf="session; else auth" [session]="session"></app-account>
    <ng-template #auth>
      <app-auth></app-auth>
    </ng-template>
  </div>
  `
})
export class AppComponent implements OnInit {
  session = this.supabase.session;
  constructor(private readonly supabase: SupabaseService) { }
  ngOnInit() {
    this.supabase.authChanges((_, session) => this.session = session);
  }
}

完成后，在终端窗口中运转它：

npm run start

然后翻开浏览器到http://localhost:4200，你应该会看到完好的运用程序。

完成：上传头像及更新用户信息

每个 MemFire Cloud项目都装备了存储，用于办理相片和视频等大文件。

创立上传小组件

让咱们为用户创立一个头像，以便他们能够上传个人材料相片。运用Angular CLI 指令创立AvatarComponent 。 ng g c avatar

src/app/avatar/avatar.component.ts

import {Component, EventEmitter, Input, Output} from '@angular/core';
import {SupabaseService} from "../supabase.service";
import {DomSanitizer, SafeResourceUrl} from "@angular/platform-browser";
@Component({
  selector: 'app-avatar',
  template: `
    <div>
      <img
        *ngIf="_avatarUrl"
        [src]="_avatarUrl"
        alt="Avatar"
        class="avatar image"
        style="height: 150px; width: 150px"
      ></div>
    <div *ngIf="!_avatarUrl" class="avatar no-image" style="height: 150px; width: 150px"></div>
    <div style="width: 150px">
      <label class="button primary block" for="single">
        {{uploading ? 'Uploading ...' : 'Upload'}}
      </label>
      <input
        style="visibility: hidden;position: absolute"
        type="file"
        id="single"
        accept="image/*"
        (change)="uploadAvatar($event)"
        [disabled]="uploading"
      />
    </div>
  `,
})
export class AvatarComponent {
  _avatarUrl: SafeResourceUrl | undefined;
  uploading = false;
  @Input()
  set avatarUrl(url: string | undefined) {
    if (url) {
      this.downloadImage(url);
    }
  };
  @Output() upload = new EventEmitter<string>();
  constructor(
    private readonly supabase: SupabaseService,
    private readonly dom: DomSanitizer
  ) { }
  async downloadImage(path: string) {
    try {
      const {data} = await this.supabase.downLoadImage(path);
       if (data instanceof Blob) {
        this._avatarUrl = this.dom.bypassSecurityTrustResourceUrl(
          URL.createObjectURL(data)
        );
      }
    } catch (error:any) {
      console.error('下载图片出错: ', error.message);
    }
  }
  async uploadAvatar(event: any) {
    try {
      this.uploading = true;
      if (!event.target.files || event.target.files.length === 0) {
        throw new Error('有必要挑选要上载的图像。');
      }
      const file = event.target.files[0];
      const fileExt = file.name.split('.').pop();
      const fileName = `${Math.random()}.${fileExt}`;
      const filePath = `${fileName}`;
      await this.supabase.uploadAvatar(filePath, file);
      this.upload.emit(filePath);
      this.downloadImage(filePath)
    } catch (error:any) {
      alert(error.message);
    } finally {
      this.uploading = false;
    }
  }
}

然后咱们能够在AccountComponent html 模板的顶部添加小部件：

src/app/account/account.component.ts

import {Component, Input, OnInit} from '@angular/core';
import {Profile, SupabaseService} from "../supabase.service";
import {Session} from "@supabase/supabase-js";
@Component({
  selector: 'app-account',
  template: `
      <app-avatar
        [avatarUrl]="this.profile?.avatar_url"
        (upload)="updateProfile(username.value, website.value, $event)">
    </app-avatar>
    <div class="form-widget">
      <div>
        <label for="email">邮箱</label>
        <input id="email" type="text" [value]="session?.user?.email" disabled/>
      </div>
      <div>
        <label for="username">称号</label>
        <input
          #username
          id="username"
          type="text"
          [value]="profile?.username ?? ''"
        />
      </div>
      <div>
        <label for="website">网址</label>
        <input
          #website
          id="website"
          type="url"
          [value]="profile?.website ?? ''"
        />
      </div>
      <div>
        <button
          class="button block primary"
          (click)="updateProfile(username.value, website.value)"
          [disabled]="loading"
        >
          {{loading ? 'Loading ...' : 'Update'}}
        </button>
      </div>
      <div>
        <button class="button block" (click)="signOut()">
          退出登录
        </button>
      </div>
    </div>
  `
})
export class AccountComponent implements OnInit {
  loading = false;
  profile: Profile | undefined;
  @Input() session: Session | undefined;
  constructor(private readonly supabase: SupabaseService) { }
  ngOnInit() {
    this.getProfile();
  }
  async getProfile() {
    try {
      this.loading = true;
      let {data: profile, error, status} = await this.supabase.profile;
      if (error && status !== 406) {
        throw error;
      }
      if (profile) {
        this.profile = profile;
      }
    } catch (error:any) {
      alert(error.message)
    } finally {
      this.loading = false;
    }
  }
  async updateProfile(username: string, website: string, avatar_url: string = '') {
    try {
      this.loading = true;
      await this.supabase.updateProfile({username, website, avatar_url});
      alert("修正成功")
    } catch (error:any) {
      alert(error.message);
    } finally {
      this.loading = false;
    }
  }
  async signOut() {
    await this.supabase.signOut();
  }
}

祝贺！在这个阶段，您具有一个功用完全的运用程序！