퀵스타터즈
Spring Boot를 위한 백엔드를 구축하는 방법은?

32min
소개
이 튜토리얼에서는 Back4App을 사용하여 Spring Boot의 백엔드를 구축하는 방법을 배웁니다.
Spring Framework를 활용한 Java 기반 웹 애플리케이션인 Spring Boot 애플리케이션을 데이터베이스 관리, Cloud Code, REST 및 GraphQL API, 사용자 인증, 파일 저장소, 실시간 쿼리와 같은 필수 Back4App 기능에 연결하는 방법을 안내합니다.
이 단계를 따르면 Spring Boot의 기능을 Back4App에서 제공하는 강력한 Parse Platform과 원활하게 통합할 수 있습니다.
Back4App을 백엔드로 활용하면 데이터베이스 연결, 보안 구성 및 배포 프로세스가 크게 간소화됩니다.
서버 설정 및 수동 데이터베이스 관리의 복잡성을 피할 수 있으므로 Spring Boot 애플리케이션의 비즈니스 로직 작성에 집중할 수 있습니다.
이 튜토리얼이 끝나면 웹 앱이나 Spring 웹에서 실행되는 Java 애플리케이션의 기반이 될 수 있는 견고하고 확장 가능한 백엔드를 갖추게 되며, 쉽게 프로덕션 준비가 완료된 배포로 확장할 수 있습니다.
전제 조건
이 가이드를 완료하려면 다음 사항이 준비되어 있는지 확인하세요:
Back4App 계정과 새로운 Back4App 프로젝트
Back4app 시작하기.
계정이 없으면 무료로 가입하세요.
Java 개발 환경
다음과 같은 Java SE 8 이상과 Maven 또는 Gradle. 이는 개발 환경을 설정하는 데 필수적입니다.
Spring Boot 기초
 spring boot 애플리케이션을 만드는 데 익숙해야 합니다. 필요하다면 Spring Boot 공식 문서를 참조하여 spring security, 컨트롤러, 서비스 등을 배우세요.
Parse/Back4App에 대한 기본 지식
Parse 플랫폼이 어떻게 작동하는지 아는 것이 유익합니다. 처음이라면 Back4App 문서를 검토하세요.
이러한 전제 조건을 준비하면 원활한 튜토리얼 경험을 보장합니다. Back4App을 사용하여 백엔드를 구축하는 것을 시작해 봅시다!
1단계 – Back4App에서 새 프로젝트 만들기 및 연결하기
이 단계가 필요한 이유
새로운 Back4App 프로젝트를 만드는 것은 백엔드의 기초입니다. 이 프로젝트는 데이터베이스, 구성 설정, 보안 규칙을 보유하고 spring boot 애플리케이션 데이터를 Parse 플랫폼을 통해 관리할 수 있게 해줍니다.
Back4App 프로젝트 생성하기
Back4App 계정에 로그인하세요.
“새 앱” 클릭하기 Back4App 대시보드에서.
프로젝트 이름 제공하기 (예: “SpringBoot-Backend-Tutorial”) 및 설정 완료하기.
﻿
완료되면, Back4App 대시보드에서 새 프로젝트가 나열된 것을 볼 수 있습니다.
Parse Java SDK 설치 및 구성 (선택 사항)
Back4App은 Parse 플랫폼을 사용하며, Java SDK를 제공하여 Spring Boot 앱과 통합할 수 있습니다. 원하신다면, java 개발자 코드에서 REST/GraphQL 호출을 직접 할 수도 있습니다. 그러나 SDK를 사용하면 데이터 저장, 쿼리 및 사용자 인증과 같은 작업을 간소화할 수 있습니다.
Maven 의존성 (예):
XML
<dependency>
  <groupId>com.parse</groupId>
  <artifactId>parse</artifactId>
  <version>1.26.0</version>
</dependency>
<dependency>
  <groupId>com.parse</groupId>
  <artifactId>parse</artifactId>
  <version>1.26.0</version>
</dependency>
﻿
당신의 Spring Boot 메인 애플리케이션 클래스 또는 구성 클래스에서 Parse를 초기화하세요:
Java
@SpringBootApplication
public class SpringBootBackendTutorialApplication {
    public static void main(String[] args) {
        // Initialize Parse before running the application
        Parse.initialize(new Parse.Configuration.Builder("YOUR_APP_ID")
            .server("https://parseapi.back4app.com/")
            .clientKey("YOUR_CLIENT_KEY")
            .build()
        );
        
        SpringApplication.run(SpringBootBackendTutorialApplication.class, args);
    }
}
@SpringBootApplication
public class SpringBootBackendTutorialApplication {
    public static void main(String[] args) {
        // Initialize Parse before running the application
        Parse.initialize(new Parse.Configuration.Builder("YOUR_APP_ID")
            .server("https://parseapi.back4app.com/")
            .clientKey("YOUR_CLIENT_KEY")
            .build()
        );
        
        SpringApplication.run(SpringBootBackendTutorialApplication.class, args);
    }
}
﻿
“YOUR_APP_ID” 및 “YOUR_CLIENT_KEY”를 Back4App 대시보드에서 찾은 자격 증명으로 교체하는 것을 잊지 마세요. 앱 설정 또는 보안 및 키에서 확인할 수 있습니다.
2단계 – 데이터베이스 설정하기
1. 데이터 모델 생성하기
당신의 데이터베이스 연결은 Back4App에 의해 처리됩니다. 대시보드에서 데이터 모델(클래스)을 생성하거나 Parse SDK를 통해 객체를 저장하여 즉석에서 생성할 수 있습니다. 더 나은 제어를 위해 Back4App 대시보드로 가서:
“데이터베이스” 클릭
새 클래스 생성 (예: “Todo”)
열 추가 (필드) 예를 들어 title (문자열) 및 isCompleted (부울)
새 클래스 생성
﻿
2. AI 에이전트를 사용하여 데이터 모델 생성하기
Back4App은 AI 에이전트를 제공하여 스키마를 생성할 수 있습니다:
대시보드 또는 메뉴에서 AI 에이전트 열기
데이터 모델 설명하기 간단한 언어로.
AI 에이전트가 관련 클래스와 필드 생성을 처리하도록 하세요.
﻿
3. SDK를 사용한 데이터 읽기 및 쓰기
Parse Java SDK를 spring framework 프로젝트에 추가했다면, 다음과 같이 클래스와 상호작용할 수 있습니다:
Java
@Service
public class TodoService {

    public ParseObject createTodoItem(String title, boolean isCompleted) throws ParseException {
        ParseObject todo = new ParseObject("Todo");
        todo.put("title", title);
        todo.put("isCompleted", isCompleted);
        return todo.save(); // Throws ParseException if something goes wrong
    }

    public List<ParseObject> fetchTodos() throws ParseException {
        ParseQuery<ParseObject> query = ParseQuery.getQuery("Todo");
        return query.find(); 
    }
}
@Service
public class TodoService {

    public ParseObject createTodoItem(String title, boolean isCompleted) throws ParseException {
        ParseObject todo = new ParseObject("Todo");
        todo.put("title", title);
        todo.put("isCompleted", isCompleted);
        return todo.save(); // Throws ParseException if something goes wrong
    }

    public List<ParseObject> fetchTodos() throws ParseException {
        ParseQuery<ParseObject> query = ParseQuery.getQuery("Todo");
        return query.find(); 
    }
}
﻿
4. REST API를 사용한 데이터 읽기 및 쓰기
대안으로, REST 엔드포인트를 통해 Back4App 데이터베이스와 상호작용할 수 있습니다:
Bash
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APPLICATION_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Buy groceries", "isCompleted": false}' \
  https://parseapi.back4app.com/classes/Todo
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APPLICATION_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Buy groceries", "isCompleted": false}' \
  https://parseapi.back4app.com/classes/Todo
﻿
5. GraphQL API를 사용한 데이터 읽기 및 쓰기
Back4App에는 GraphQL 엔드포인트도 있습니다:
GraphQL
mutation {
  createTodo(input: {
    fields: {
      title: "Clean the house"
      isCompleted: false
    }
  }) {
    todo {
      objectId
      title
      isCompleted
    }
  }
}
mutation {
  createTodo(input: {
    fields: {
      title: "Clean the house"
      isCompleted: false
    }
  }) {
    todo {
      objectId
      title
      isCompleted
    }
  }
}
﻿
6. 실시간 쿼리 작업하기 (선택 사항)
귀하의 웹 앱이 실시간 업데이트가 필요하다면, Back4App 대시보드에서 실시간 쿼리를 활성화하고 스프링 웹 애플리케이션에 연결할 수 있습니다. 일반적으로 Java 클라이언트에서 이벤트를 구독하거나 실시간 쿼리를 지원하는 프론트엔드 도구를 사용합니다.
3단계 – ACL 및 CLP로 보안 적용하기
간략한 개요
Back4App의 ACLs (액세스 제어 목록) 및 CLPs (클래스 수준 권한)은 귀하의 데이터를 보호합니다. 이는 스프링 보안을 보완하거나 보완하여 귀하의 자바 애플리케이션을 추가로 보호할 수 있습니다.
단계별
클래스 수준 권한 (CLPs): “클래스 수준 권한”의 “데이터베이스” 탭에서 구성합니다.
ACLs: 코드 또는 대시보드에서 객체 수준 권한을 설정합니다.
﻿
자세한 내용은 앱 보안 가이드라인을 참조하십시오.
4단계 – 클라우드 코드 함수 작성하기
클라우드 코드의 장점
클라우드 코드는 민감한 비즈니스 로직을 서버로 이동하거나 보호할 수 있게 해줍니다. 이는 클라이언트 측에 노출되어서는 안 되는 로직이 필요하거나 외부 API를 통합하고자 할 때 특히 유용합니다.
예제 함수
JS
Parse.Cloud.define('calculateTextLength', async (request) => {
  const { text } = request.params;
  if (!text) throw new Error('No text provided');
  return { length: text.length };
});
Parse.Cloud.define('calculateTextLength', async (request) => {
  const { text } = request.params;
  if (!text) throw new Error('No text provided');
  return { length: text.length };
});
﻿
배포
코드를 배포하려면 Back4App CLI 또는 Back4App 대시보드를 사용하세요. 그런 다음 Java SDK, REST 또는 GraphQL을 통해 Spring Boot에서 함수를 직접 호출할 수 있습니다.
5단계 – 인증 구성
사용자 인증
Parse 사용자 클래스는 사용자 가입, 로그인 및 세션 토큰을 처리합니다. 이를 스프링 부트 애플리케이션에 통합하려면 Java SDK를 호출하거나 REST 호출을 사용할 수 있습니다.
가입하기 (Java SDK 예제):
Java
public ParseUser signUpUser(String username, String password, String email) throws ParseException {
    ParseUser user = new ParseUser();
    user.setUsername(username);
    user.setPassword(password);
    user.setEmail(email);
    return user.signUp(); // returns the newly created user
}
public ParseUser signUpUser(String username, String password, String email) throws ParseException {
    ParseUser user = new ParseUser();
    user.setUsername(username);
    user.setPassword(password);
    user.setEmail(email);
    return user.signUp(); // returns the newly created user
}
﻿
소셜 로그인
Google이나 Facebook과 같은 제공자의 경우, parse는 OAuth 기반 로그인을 지원합니다. 추가 설정 세부정보는 소셜 로그인 문서를 확인하세요.
6단계 – 파일 저장 처리
파일 저장 설정
다음 클래스를 사용하여 파일을 업로드합니다: ParseFile 또는 REST를 사용하실 수 있습니다:
Java
// Example using Java SDK
ParseFile file = new ParseFile("myImage.png", fileBytes);
file.save(); // uploads to Back4App

ParseObject photo = new ParseObject("Photo");
photo.put("imageFile", file);
photo.save();
// Example using Java SDK
ParseFile file = new ParseFile("myImage.png", fileBytes);
file.save(); // uploads to Back4App

ParseObject photo = new ParseObject("Photo");
photo.put("imageFile", file);
photo.save();
﻿
예시
Bash
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: text/plain" \
  --data-binary '@myImage.png' \
  https://parseapi.back4app.com/files/myImage.png
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: text/plain" \
  --data-binary '@myImage.png' \
  https://parseapi.back4app.com/files/myImage.png
﻿
7단계 – 이메일 인증 및 비밀번호 재설정
개요
귀하의 java 개발자 워크플로우에서 안전한 사용자 계정을 보장하기 위해, Back4App 대시보드에서 이메일 인증 및 비밀번호 재설정을 활성화하십시오.
구성
이메일 인증 활성화 귀하의 앱의 이메일 설정에서.
더 나은 사용자 경험을 위해 이메일 템플릿을 설정하십시오.
8단계 – 클라우드 작업으로 작업 예약하기
클라우드 작업의 기능
클라우드 작업을 통해 주기적인 데이터 정리, 일일 알림 전송 또는 시스템 전체 유지 관리와 같은 작업을 자동화할 수 있습니다. 다음은 예시 작업입니다:
JS
Parse.Cloud.job('cleanupOldTodos', async () => {
  const query = new Parse.Query('Todo');
  // Example: remove todos older than 30 days
  // ...
  // implement the job logic here
});
Parse.Cloud.job('cleanupOldTodos', async () => {
  const query = new Parse.Query('Todo');
  // Example: remove todos older than 30 days
  // ...
  // implement the job logic here
});
﻿
백4앱 대시보드에서 서버 설정 > 백그라운드 작업에서 예약하세요.
클라우드 작업 예약
﻿
9단계 – 웹훅 통합
정의 및 구성
웹훅은 자바 애플리케이션이 이벤트 기반 HTTP 요청을 전송하거나 수신할 수 있게 해줍니다. 예를 들어, 백4앱 데이터베이스에 객체가 생성될 때마다 외부 서비스에 알릴 수 있습니다.
백4앱 대시보드로 이동 > 더보기 > 웹훅
웹훅 추가 및 대상 엔드포인트 설정
트리거 설정 (생성, 업데이트, 삭제)
웹훅 추가
﻿
10단계 – 백4앱 관리 패널 탐색
찾는 방법
 백4앱 관리 앱은 비기술 팀원이 데이터를 보고 수정할 수 있는 모델 중심의 사용자 친화적인 인터페이스입니다. 앱 대시보드 > 더보기 > 관리 앱로 이동하여 활성화하세요.
관리 앱 활성화
﻿
서브도메인을 선택하고 첫 번째 관리자 사용자를 생성하세요. 그런 다음 코드를 건드리지 않고 데이터를 관리하기 위해 로그인하세요.
﻿
결론
Back4App과의 Spring Boot 통합을 완료한 것을 축하합니다! 데이터, 인증, 파일, 실시간 구독 및 예약 작업을 관리하는 Spring Boot 백엔드를 구축하는 방법을 보았습니다. 모든 것이 최소한의 오버헤드로 이루어졌습니다.
이 강력하고 확장 가능한 접근 방식은 저수준 서버나 데이터베이스 세부 사항에 대해 걱정하기보다는 비즈니스 로직 작성에 집중할 수 있게 해줍니다.
당신은:
Back4App 프로젝트를 생성하고 이를 스프링 프레임워크에 연결했습니다.
클래스와 데이터 모델을 사용하여 데이터베이스 연결을 관리하는 방법을 배웠습니다.
ACL, CLP, 클라우드 코드 함수 및 클라우드 작업을 통한 스케줄링을 구현했습니다.
파일 저장소, 사용자 인증 및 웹훅과 같은 고급 기능을 구성했습니다.
이러한 기본 사항을 바탕으로, 귀하의 스프링 부트 애플리케이션은 완전한 스프링 보안 또는 더 복잡한 데이터 관계를 갖춘 프로덕션 준비 시스템으로 성장할 준비가 되어 있습니다.
Back4App의 다른 기능과 현대 웹 앱 개발을 가속화하는 스프링 부트의 기능을 탐색해 보시기 바랍니다.
다음 단계
프로덕션을 위한 확장: 성능 최적화, 캐싱 추가 및 CLP에서 고급 역할 구성.
더 많은 통합 추가: 클라우드 코드 또는 웹훅을 통해 외부 서비스(결제 게이트웨이, 분석 등)에 연결.
공식 문서 참조: Back4App의 문서 및 고급 파스 기술에 대한 이해를 심화하세요.
튜토리얼 탐색: 실시간 채팅, 푸시 알림 또는 위치 기반 서비스에 대한 전문 튜토리얼을 찾아보세요. 이를 스프링 부트 설정과 결합하여 최첨단 웹 애플리케이션을 구축하세요.
스프링 부트와 Back4App 간의 시너지를 활용하여, 코드베이스를 깔끔하게 유지하고 배포 프로세스를 간단하게 하면서 자바 애플리케이션을 신속하게 개발, 유지 관리 및 확장할 수 있습니다.
업데이트됨 24 Jan 2025
이 페이지가 도움이 되었습니까?
Play 프레임워크를 위한 백엔드를 구축하는 방법?
Java로 백엔드를 구축하는 방법?