📑 Restaurant CRUD

🔷 Many-to-one / One-to-many

Many-to-one / One-to-many 관계는 A가 B의 여러 인스턴스를 포함하지만 B는 A의 인스턴스를 하나만 포함하는 관계이다.

• @OneToMany(): 일대다 관계에서 '다'에 속할 때 사용
  (DB에 해당 컬럼은 저장되지 않음)
• @ManyToOne(): 일대다 관계에서 '일'에 속할 때 사용
  (DB에 user면 userId로 id값만 저장됨)

  // Category Entity
  @Field((type) => [Restaurant])
  @OneToMany((type) => Restaurant, (restaurant) => restaurant.category)
  restaurants: Restaurant[];

  // Restaurant Entity
  @Field((type) => Category)
  @ManyToOne((type) => Category, (category) => category.restaurants)
  category: Category;

🔷 Unique Schema Name

스키마의 이름은 고유 해야한다. 하지만 각 Entity에서 @ObjectType 과 @InputType 가 같은 이름으로 스키마가 된다. 아래의 에러 해결을 위해서는 @InputType 에 따로 이름을 부여해야한다.
Error: Schema must contain uniquely named types but contains multiple types named "Category".

@InputType('CategoryInputType', { isAbstract: true })
@ObjectType()
@Entity()
export class Category extends CoreEntity {
 	//.....
}

🔷 Database Relations Option

2개의 데이터베이스 테이블을 연결했을 때, 한 쪽의 테이블 요소를 삭제했을 경우 연결된 쪽의 테이블의 상태를 결정할 수 있다.

• onDelete: "RESTRICT"|"CASCADE"|"SET NULL"
  Specifies how foreign key should behave when referenced object is deleted

https://orkhan.gitbook.io/typeorm/docs/relations#relation-options

@Field((type) => Category, { nullable: true })
@ManyToOne((type) => Category, (category) => category.restaurants, {
    nullable: true,
    onDelete: 'SET NULL',
})
category: Category;

🔷 Role Authorization / Authentication

🔹MetaData / Role Decorator

Resolver는 각각 다른 권한 체계를 가질 수 있다. 유연하고 재사용 가능한 방식으로 권한 체계를 구현하기 위해서 metadata가 사용된다. Nest는 @SetMetadata() 데코레이터를 통해 Resolver에 커스텀 메타데이터를 붙이는 기능을 제공한다.

• ex) @SetMetadata('role', Role.Owner)
  key - 메타데이터가 저장되는 키를 정의하는 값
  value - 키와 연결될 메타데이터

https://docs.nestjs.com/guards#setting-roles-per-handler

route에서 직접 @SetMetadata()를 사용하는 것은 좋은 습관이 아니다.
대신 아래와 같이 직접 커스텀 데코레이터를 만들 수 있다.

//role decorator
import { SetMetadata } from '@nestjs/common';
import { UserRole } from 'src/users/entities/user.entity';

type AllowedRoles = keyof typeof UserRole | 'Any';
export const Role = (roles: AllowedRoles) => SetMetadata('roles', roles);

🔹 APP_GUARD

다음과 같이 APP_GUARD를 사용할 시 모든 resolver에 대해 Guard가 적용됩니다.

//app.module.ts
import { Module } from '@nestjs/common';
import { APP_GUARD } from '@nestjs/core';
import { AuthGuard } from './auth.guard';

@Module({
  providers: [
    {
      provide: APP_GUARD,
      useValue: AuthGuard,
    },
  ],
})
export class AuthModule {}

https://docs.nestjs.com/guards#binding-guards

❗ AuthGuard와 Role Decorator(MetaData) 연결

• Reflector를 사용해 MetaData를 받는다.

• Metadata가 설정되어있지 않으면 public(누구나 접근 가능)
• Metadata가 설정되어있으면 private(MetaData를 이용해 특정 role만 접근 가능하도록 제한)

@Injectable()
export class AuthGuard implements CanActivate {
  constructor(private readonly reflector: Reflector) {}
  canActivate(context: ExecutionContext) {
    const roles = this.reflector.get<AllowedRoles>(
      'roles',
      context.getHandler(),
    );
    if (!roles) {
      return true;
    }
    const gqlContext = GqlExecutionContext.create(context).getContext();
    const user: User = gqlContext['user'];
    if (!user) {
      return false;
    }
    if (roles.includes('Any')) {
      return true;
    }
    return roles.includes(user.role);
  }
}

🔷 Edit Restaurant CRUD

🔹 @ RelationId

Field에 특정 relation의 id를 로드한다. 예를 들어 Restuarant 엔터티에 Many-to-one이 있는 경우 새 속성을 @RelationId로 표시하여 새 Relation ID를 가질 수 있다. 이 기능은 many-to-many를 포함한 모든 종류의 관계에서 작동한다. Relation ID는 추가/제거/변경되지 않는다.

  //Restaurant Entity

  @Field((type) => User)
  @ManyToOne((type) => User, (user) => user.restaurants, {
    onDelete: 'CASCADE',
  })
  owner: User;

  @RelationId((restaurant: Restaurant) => restaurant.owner)
  ownerId: number;

🔹 Custom repositories

데이터베이스 작업을 위한 메소드를 포함해야 하는 사용자 정의 레포지토리를 생성할 수 있다.
일반적으로 사용자 지정 리포지토리는 단일 엔티티에 대해 생성되고 특정 쿼리를 포함합니다.

예를 들어, 아래와 같이 getOrCreate(name: string)이라는 메서드가 있다고 가정하면 this.categories.getOrCreate(...)와 같이 호출할 수 있다.

// @EntityRepository(Category)
@CustomRepository(Category)
export class CategoryRepository extends Repository<Category> {
  async getOrCreate(name: string): Promise<Category> {
    const categoryName = name.trim().toLowerCase();
    const categorySlug = categoryName.replace(/ /g, '-');
    let category = await this.findOne({ where: { slug: categorySlug } });
    if (!category) {
      category = await this.save(
        this.create({ slug: categorySlug, name: categoryName }),
      );
    }
    return category;
  }
}

TypeOrm 0.2.45까지는 @EntityRepository를 사용했지만 deprecated 되면서 직접 decorator를 생성해야한다.
https://stackoverflow.com/questions/71557301/how-to-workraound-this-typeorm-error-entityrepository-is-deprecated-use-repo
다운그레이드해도 에러 stackoverflow대로 해도 에러 8시간 잡아먹음...
세상이 날 억까하네ㅋㅋㅋ일단 진도 나가고 다음에 고치자..

🔷 Categories Part

🔹@ ResolveField()

매 request마다 계산된 field값을 가져온다.
(DB에는 존재하지 않고 GraphQL 스키마에만 존재)

@Resolver((of) => Category)
export class CategoryResolver {
  constructor(private readonly restaurantService: RestaurantService) {}

  @ResolveField((type) => Int)
  restaurantCount(): number {
    return 80;
  }

  @Query((returns) => AllCategoriesOutput)
  allCategories(): Promise<AllCategoriesOutput> {
    return this.restaurantService.allCategories();
  }
}

🔷 Repository method Option

🔹 Like

const [restaurants, totalResults] = await this.restaurants.findAndCount({
        where: {
          name: Like(`%${query}%`),
        },
      });

위의 코드는 아래 쿼리를 실행한다.

SELECT * FROM "post" WHERE "title" LIKE '%{query}%'

https://orkhan.gitbook.io/typeorm/docs/find-options#advanced-options
https://github.com/typeorm/typeorm/blob/master/docs/find-options.md#advanced-options

🔹 ILike

Like는 대소문자를 구분하지만 ILike는 대소문자를 구분하지 않는다.

🔹 Raw

const [restaurants, totalResults] = await this.restaurants.findAndCount({
        where: {
          name: Raw(name => `${name} ILIKE '%${query}%'`),
        },

🔹SQL - LIKE Clause

SQL LIKE 절은 wildcard 연산자를 사용하여 값을 유사한 값과 비교하는 데 사용된다. 퍼센트 기호(%)는 0, 하나 또는 여러 문자를 나타낸다. 밑줄(_)은 단일 숫자 또는 문자를 나타낸다. 이러한 기호는 조합하여 사용할 수 있다.

EX )

WHERE SALARY LIKE '200%' : 200으로 시작하는 모든 값을 찾습니다.
WHERE SALARY LIKE '%200%': 어느 위치든 200이 있는 값을 찾습니다.
WHERE SALARY LIKE '_00%': 두 번째 및 세 번째 위치에 00이 있는 값을 찾습니다.
WHERE SALARY LIKE '%2': 2로 끝나는 값을 찾습니다.
https://www.tutorialspoint.com/sql/sql-like-clause.htm

❓ Questions

• express로 백엔드 구축했을 때는 Many-to-one / One-to-many 와 같은 관계를 어떻게 구현했었는지?