Google Cloud Translation를 호출하여 번역해보기

• 환경 변수를 사용해 API 키를 안전하게 관리
• API 호출하는 방법 이해 및 구현
• 예제를 통해 특정 문장을 원하는 언어로 번역하기

1. Google Cloud API 키 발급 (사전 과제)

과제로 발급받은 API 키를 준비해주세요!

2. 프로젝트 설정

이 방법은 로컬 개발 환경에서만 사용합니다!

<aside>

1. 프로젝트 생성

• https://start.spring.io/

• Spring AI: Spring Boot 3.x 기준으로 안정화됨 </aside>

<aside>

2. build.gradle에 추가

• 코드 </aside>

<aside>

3. Google Cloud API Key 등록

API KEY는 민감한 키이므로, 절대로!!! 하드코딩 금지!

→ 환경 변수를 사용하자!

<aside> 🗼

환경변수란?

운영 체제가 가지고 있는 ‘특정 이름과 값’을 가진 설정 정보로,

특정 프로그램을 실행할 때 참고하는 고유한 정보!

• 코드 안에 직접 넣는 것이 아니라 OPENAI_API_KEY라는 이름의 값은 이거야! 하고 알려주는 것
• 코드를 공유하더라도 API 키가 코드에 없어서 유출 위험이 적음
• 로컬 개발 환경에서는 주로 .env 파일을 사용해 환경변수를 편하게 관리함 </aside>

1. /main/resources 디렉토리에 google-key.json 파일 생성하고 발급받은 .json 복붙해주기!

.json 파일을 복사해서 붙여 넣어주세요!

1. 프로젝트의 루트 디렉토리에 .env 파일 생성하고, google-key.json 과 함께 .gitignore에 추가해주기!

.env 파일은 build.gradle, .gitignore과 같은 위치에 있으면 됩니다!

• .env 파일은 절대 GitHub에 올라가면 안되므로, **.gitignore**에 **.env**를 추가해줘야 한다.
• google-key.json 파일 역시 절대 GitHub에 올라가면 안되므로, 똑같이 추가해준다.
• git이 .gitignore 파일을 무시하기 때문에 GitHub에 올라가지 않습니다!

1. .env 파일에 google-key.json 위치 등록

GOOGLE_APPLICATION_CREDENTIALS_PATH=classpath:google-key.json

1. **application.yml**에 키 파일 위치 추가

 google:
  cloud:
    credentials:
      location: ${GOOGLE_APPLICATION_CREDENTIALS_PATH}

1. .env 파일을 환경 변수로 설정

Run → Edit Configuration → Environment Variables에 .env 파일 경로를 넣어주면 됩니다.

저 폴더 모양 아이콘을 클릭해주세요

현재 프로젝트의 .env 파일을 선택해주세요

• 스프링 부트가 .env 파일을 자동으로 읽어주지는 않기 때문에, .env를 시스템 환경변수로 직접 넣어주어야 한다.

Q. 혹시 이 방법으로 스프링이 .env 파일을 읽지 못해 실행이 안된다면?

실습 중 이런 에러를 반환한다면, 다시 이 페이지로 돌아와서 아래의 방법으로 에러를 해결해주세요!

//방법 1
implementation 'me.paulschwarz:spring-dotenv:4.0.0'

//방법 2
spring:
  config:
    import: optional:file:.env[.properties]

실제 배포 환경에서는?

</aside>

3. Config 클래스 작성

• 코드
• @Configuration: @Bean이 붙은 메서드들을 스프링이 실행하고, 거기서 반환된 객체들을 스프링 컨테이너에 담아줌
• @Value : 서버 시작 시 yml 파일에서 classpath:google-key.json을 찾아와 변수에 자동 주입
• 🤟 Q. Translate 클래스는 어떻게 구성되어 있나요?

4. 요청/응답 DTO 작성

<aside>

작성 이전에 잠깐…!

• 🤟 Q.요청/응답 DTO를 어떻게 작성해야 할지 모르겠어요… </aside>

• dto/request: TranslateRequest 생성