Entity, Repository 개념 & 프론트엔드에 적용하기

Entity와 Repository는 개발에서 많이 사용되는 개념이다. Entity는 도메인 모델의 구성 요소로, 하나 이상의 속성을 가지며 유일하게 구분될 수 있는 식별자를 가지고 있다. Repository는 DB나 File system과 같은 저장소에 접근하는 객체이다. Repository는 Entity를 생성, 읽기, 수정, 삭제(CRUD)하는 데 사용된다.

 

예를 들어, 블로그 게시물을 저장하는 웹 애플리케이션을 만든다고 가정해보자. 이 애플리케이션에서는 게시물을 생성, 읽기, 수정, 삭제해야 한다. 게시물을 저장하는 DB가 있다면, Entity는 게시물을 나타내고 Repository는 DB에 접근하는 객체를 나타낸다. 여기서 Entity는 게시물의 속성을 가지고 있다. 예를 들어, 게시물의 제목, 내용, 작성자, 작성일 등이 게시물의 속성이 될 수 있다. 게시물의 식별자는 유일한 값을 가지며, 이를 통해 다른 게시물과 구분할 수 있다.

 

Repository는 DB와 같은 저장소에 접근하는 '객체'이다. 예를 들어, MySQL DB에 게시물을 조회하는 경우 Repository는 MySQL DB에 접근하여 데이터를 조회하고 변경하는 역할을 한다. Repository는 다음과 같은 인터페이스를 제공한다.

 

interface PostRepository {
    create(post: Post): Promise<Post>;
    findById(id: number): Promise<Post | null>;
    findAll(): Promise<Post[]>;
    update(post: Post): Promise<Post>;
    delete(id: number): Promise<boolean>;
}

위 인터페이스는 게시물을 생성, 조회, 수정, 삭제하는 메서드를 정의한다. create 메서드는 게시물을 생성하고, findById 메서드는 주어진 ID에 해당하는 게시물을 조회한다. findAll 메서드는 모든 게시물을 조회한다. update 메서드는 주어진 게시물을 수정하고, delete 메서드는 주어진 ID에 해당하는 게시물을 삭제한다.

이러한 Entity와 Repository 패턴은 도메인 모델과 데이터 액세스 로직을 분리하고, 단일 책임 원칙(Single Responsibility Principle)을 따르기 위해 사용된다. 이를 통해 코드의 가독성, 유지보수성, 확장성을 향상할 수 있다.

 

보통 프론트엔드에서는 Entity와 Repository 패턴을 직접적으로 적용하기보다는, Redux와 같은 상태관리 라이브러리를 사용해 상태를 관리한다. 하지만, 비즈니스 로직을 분리하고, 코드를 유지보수 가능한 상태로 유지하기 위해 Entity와 Repository를 적용할 수 있다. 예를 들어, 게시물을 생성하고 조회하는 간단한 React 애플리케이션을 만든다고 해보자. 이 애플리케이션에는 게시물을 생성, 목록 조회하는 기능을 제공한다.

 

먼저, Entity를 정의해 보자. 이 애플리케이션에서는 게시물이라는 모델이 필요하므로, 다음과 같은 'Post' 모델을 만들 수 있다.

interface Post {
  id: number;
  title: string;
  content: string;
  author: string;
  createdAt: Date;
}

 

다음으로 Repository를 정의해보자. 이 애플리케이션에서는 게시물 목록을 관리하기 위해 ‘PostRepository’를 만들어보자.

interface PostRepository {
  create(post: Post): Promise<Post>;
  findAll(): Promise<Post[]>;
}

여기서 ‘create’ 메서드는 새로운 게시물을 생성하고, ‘findAll’ 메서드는 모든 게시물을 조회하는 역할을 한다. 이 Repository를 구현하기 위해서는, 서버 API와 통신을 처리하는 클라이언트 코드를 작성해야 한다.

 

class ApiPostRepository implements PostRepository {
  async create(post: Post): Promise<Post> {
    const response = await fetch('/api/posts', {
      method: 'POST',
      body: JSON.stringify(post),
      headers: {
        'Content-Type': 'application/json',
      },
    });
    return response.json();
  }

  async findAll(): Promise<Post[]> {
    const response = await fetch('/api/posts');
    return response.json();
  }
}

 

위 ApiPostRepository 클래스는 HTTP API를 통해 게시물을 생성하고, 조회하는 역할을 수행한다. 이 클래스를 사용하여 게시물을 생성하고, 조회하는 React 컴포넌트를 작성할 수 있다. 간단한 예시 코드이다.

 

function PostList() {
  const [posts, setPosts] = useState<Post[]>([]);

  useEffect(() => {
    const repository = new ApiPostRepository();
    repository.findAll().then(setPosts);
  }, []);

  return (
    <div>
      {posts.map(post => (
        <div key={post.id}>
          <h2>{post.title}</h2>
          <p>{post.content}</p>
          <p>By {post.author} on {post.createdAt.toISOString()}</p>
        </div>
      ))}
    </div>
  );
}

function PostForm() {
  const [post, setPost] = useState
	//..