[스프링 입문] 1. 프로젝트 환경 설정

본 게시글은 하단 강의를 듣고 학습한 내용을 제 생각으로 요약, 정리한 글입니다.

[무료] 스프링 입문 - 코드로 배우는 스프링 부트, 웹 MVC, DB 접근 기술 - 인프런 | 강의

초급자를 위해 준비한 [웹 개발, 백엔드] 강의입니다. 스프링 입문자가 예제를 만들어가면서 스프링 웹 애플리케이션 개발 전반을 빠르게 학습할 수 있습니다. 스프링 학습 첫 길잡이! 개발 공부의 길을 잃지 않도록 도와드립니다. 📣 확인해주세요! 본 강의는 자바 스프링 완전 정복 시리즈의 첫 번째 강의입니다.

https://www.inflearn.com/course/%EC%8A%A4%ED%94%84%EB%A7%81-%EC%9E%85%EB%AC%B8-%EC%8A%A4%ED%94%84%EB%A7%81%EB%B6%80%ED%8A%B8

• 목차
1. 프로젝트 생성2. 라이브러리3. View 환경설정 1) index.html → 정적 컨텐츠 방식 2) 템플릿 엔진 쓰면 동적페이지 사용 가능 → thymeleaf 템플릿엔진 3) /hello & hello.html → 동적 컨텐츠 방식 (MVC, 템플릿 방식) 4) 동작 원리4. 빌드하고 실행하기

1. 프로젝트 생성

1. Java 11 설치
자바(JAVA) 11 설치 및 환경설정 | 자바 11 환경 변수
자바로 코딩 공부를 하려면 개발 할 수 있는 환경을 만들어 주어야 한다. 그 순서를 먼저 작성하자면JAVA SE JDK 설치 -> JAVA 환경 변수 설정 -> IDE 설치 이렇게 볼 수 있겠다. 이 포스팅은 자바로 개발을 할 수 있는 환경을 만들고, 많이 쓰는 자바

https://velog.io/@sqk8657/%EC%9E%90%EB%B0%94JAVA-11-%EC%84%A4%EC%B9%98-%EB%B0%8F-%ED%99%98%EA%B2%BD%EC%84%A4%EC%A0%95-%EC%9E%90%EB%B0%94-11-%ED%99%98%EA%B2%BD-%EB%B3%80%EC%88%98

• 설치 위치: C:\Program Files\Java\jdk-11.0.16.1



• 설치위치는 노트북(11.0.16.1), 데스크톱(11.0.16) 동일

2. IDE: IntelliJ 설치
[IntelliJ] IntelliJ IDEA Community 다운로드 및 설치 후 실행하기
라이센스가 있다면, Ultimate Download 받으면 된다.

https://haenny.tistory.com/317

3. 스프링 부트 스타터 사이트로 이동해서 스프링 프로젝트 생성 https://start.spring.io
세팅 방법
• Maven/Gradle Project : 필요한 라이브러리 가져오고 빌드 관리하는 툴 → Gradle 선택
• Language → Java 선택
• Spring Boot → ex) 2.7.4선택(내 노트북 기준) → snapshot, m1 안붙은 최신 버전 선택
• Project Metadata → Group: hello 입력(회사명), Artifact: hello-spring 입력(프로젝트명), Name, Description, package name 냅두기
참고
• Name → main method 들어가는 파일 이름 결정
• ex) Name: Choo → hello.hellospring.ChooApplication
Spring Initializr Reference Guide
This section provides a brief overview of the Spring Initializr reference documentation: think of it as map for the rest of the document. Some sections are targeted to a specific audience so this reference guide is not meant to be read in a linear fashion.

https://docs.spring.io/initializr/docs/0.4.x/reference/htmlsingle/

• Java 11, Packaging Jar 선택 (jar이 spring boot에서 가이드하는 표준임)
[Spring Boot]배포 방법 비교 (JAR vs WAR)
스프링 부트의 장점 중 하나는 실행 가능한 JAR (Executable Jar)로 빌드하여 프로젝트를 바로 실행시킬 수 있다는 점이다. 실제로 스프링부트 관련 문서를 보다 보면 "Executable Jar"라는 단어를 많이 볼 수 있기 때문에, 이에 대한 정리를 제대로 하고 넘어갈 생각이다. 실제로 나는 여러가지 이유로 JAR 가 아닌 WAR로 배포하는 방법을 택했는데, 이 둘의 차이점과 제약사항에 대한 것도 함께 정리해볼 것이다.

https://hye0-log.tistory.com/27

• Dependencies: 스프링부트 기반으로 프로젝트 시작할 때 어떤 라이브러리 가져올 것인가. → Spring Web 검색하여 선택, Thymeleaf 검색하여 선택(html 만들어주는 템플릿 엔진)
• GENERATE 누르기 → 다운로드 됨. 원하는 폴더에 넣고 압축 풀기.

4. intellij에서 open 눌러서 hello-spring(스프링 입문)의 build.gradle선택해서 open하기

5. Open as Project 선택

6. src/main/java/hello/hellospring/HelloSpringApplication.java의 main method 실행하기(run)
src/main/java/hello/hellospring/HelloSpringApplication.java

7. localhost:8080 브라우저에서 들어가기. error 페이지 뜸 (성공임)

8. 왼쪽에 끄는 버튼(빨간 네모)으로 끄고 다시 들어가면 사이트에 연결할 수 없다고 뜸

9. Settings(오른쪽 상단에 톱니바퀴 모양)(혹은 Preferences)에서 gradle 검색하면 build에 Gradle있음.
• Build and run using이랑 Run tests using을 둘다 intelliJ로 바꿔주기! (gradle통해 run하면 느림)



 

2. intellij 깃허브 연동
참고 아티클 + 에러 해결
---
[IntelliJ] IntelliJ + Github 연동하기
안녕하세요. 갓대희 입니다. 이번 포스팅은 [ IntelliJ 로컬 프로젝트 Github 연동하기 ] 입니다. : ) 인텔리 제이를 통해 개발중인 로컬 프로젝트를 Github이랑 연동하는 방법을 알아 보려 한다. 로컬 프로젝트 IntelliJ로 Github 연동하기 인텔리제이에서 내가 만들었던 프로젝트를 깃헙에 연동 하려면 어떻게 해야 하나 알아보자.
https://goddaehee.tistory.com/249

→ Git 실행 설정, GitHub 계정 연동 까지만 참고함
---
[IDE] IntelliJ 터미널 Git Bash로 변경하기
이번 포스팅에서는 IntelliJ 터미널을 Git Bash로 바꾸는 방법에 대해 설명한다. 팀 단위 프로젝트를 Git을 사용해 진행하면 소스코드 형상관리를 위해 Push, Pull 과정이 빈번히 일어난다. 아래와 같이 IntelliJ 내부에서 제공하는 기능을 통해 Commit, Push와 같은 작업을 진행할 수 있지만 필자와 같이 IntelliJ Terminal을 통해 직접 Git 명령으로 진행하는 경우에는 Git Bash 터미널과 달리 아래처럼 가시성이 떨어진다는 단점이 있다.

https://velog.io/@jonghne/IntelliJ-%ED%84%B0%EB%AF%B8%EB%84%90-Git-Bash%EB%A1%9C-%EB%B3%80%EA%B2%BD%ED%95%98%EA%B8%B0

→ 터미널 Git Bash로 변경하는 데에 참고함
---
Git 신규 브랜치 체크아웃 (did not match any file(s) known to git)
error: pathspec 'new-branch' did not match any file(s) known to git 원격 레파지토리에 브랜치를 추가하고 checkout 받으려고하면 발생하는 에러에요. git remote update git fetch 그리고 하던대로 체크아웃..

https://gofnrk.tistory.com/95

→ git 브랜치 체크아웃 시 발생한 에러 해결하는 데에 참고함
---
[Git 경고 메세지] LF will be replaced by CRLF in 해결 방안
안녕하세요（・∀・）ゞ Git을 설치하고 GitBash에서 git add 명령어를 입력했는데 git add bora.txt warning: LF will be replaced by CRLF in bora.txt. The file will have its original line endings in your working directory 다음과같은 에러메세지가 떠서 검색한 결과 정리하고자 글을 남기게 되었습니다. warning: LF will be replaced by CRLF in bora.txt.

https://dabo-dev.tistory.com/13

→ git add . 할 때 발생한 경고 해결하는 데에 참고함
git config --global core.autocrlf true
---
[Github] 완전기초 사용방법 : add, commit, push, pull
Git은 분산형 버전관리 시스템(DVCS) 중 하나입니다. 최근 Git과 GitHub를 통해서 많이 사용되는 것 같습니다. Github에 저장하는 것은 매번, 매버전을 모두 저장하고 upload하는 방식이 아닌 각 버전들의 차이 혹은 변경이력 을 저장하는 것입니다. 이를 통해서 훨씬 적은 용량으로 많은 버전 이력들을 저장할 수 있는 것입니다. Git을 사용하기 위해서는 Git의 commit을 남기는 사람에 대한 정보를 설정합니다.

https://chancoding.tistory.com/76

→ 실수 방지
git add .
// commit을 진행하기 전의 임시 저장된 상태로 변경사항들 올리기
git commit -m ‘커밋메시지’
git status
git push origin ChooSeoyeon
git pull origin master
---
[IntelliJ] 콘솔 한글 깨짐 (Console Encoding Issue)
IntelliJ에서 프로그램을 실행시켜 콘솔을 확인했을 때 한글이 깨져 출력되는 경우가 종종 있다. 위의 사진처럼 알 수 없는 문자들이 나타난다. 최근에도 콘솔 한글 깨짐 현상을 겪어 구글링을 통해 문제를 해결했다. 이런 문제는 어떻게 해결해야 하는지 기록해두는 게 좋을 것 같아 포스팅을 한다. 첫번째는 Settings에서 File Encodings를 UTF-8로 변경하는 방법이다.

https://da-nyee.github.io/posts/intellij-console-encoding-issue/
→ 콘솔 한글 깨짐 해결
---
[Android Studio] Invalid VCS root mapping 오류
" Invalid VCS root mapping ERROR Trouble Shooting " [ File ] ▶ [ Settings ] ▶ [ Version Control ] [ 해당 디렉토리 path를 선택 후 우측의 연필모양 아이콘 클릭 ] [ VCS ] ▶ [ Git → 변경 ]

https://tsy0668.tistory.com/4

→ 실수로 루트 두 개 등록해서 발생한 에러 해결
---
 
 
급한 사람은 3부터 따라하기
1. intellij git 실행 설정 (상단 아티클 참고)
2. intellij github 계정 연동 (상단 아티클 참고)
3. 원하는 위치에 GDSC-1st-Backend-Study/ChooSeoyeon 폴더 만들기
4. 만들어둔 프로젝트를 ChooSeoyeon 폴더 내부로 옮기기
5. 터미널(gitbash)(gitbash를 intellij에서 여는 것도 가능. 본인 편한 대로)에서 GDSC-1st-Backend-Study 폴더 들어가서 아래 코드 입력
1. 원격 저장소 init
→ git init
2. 원격 저장소 연결
→ git remote add
3. pull 받기
→ git pull origin master
4. 브랜치 변경 (브랜치명과 폴더명이 중복되어 checkout으론 에러 났음. 따라서 switch 사용함 - 맞는 방법인진 확실x..)
→ git switch origin ChooSeoyeon
5. commit하고 push하기
→ git add .
→ git commit -m ‘커밋메시지’
→ git push origin ChooSeoyeon

2. 라이브러리

• Gradle은 의존관계가 있는 라이브러리를 다 함께 다운로드함
→ spring관련 라이브러리 쓰면 알아서 core까지 다 가져와 줌.(편리)
 

3. View 환경설정

1) index.html → 정적 컨텐츠 방식

• Welcome Page 만들기

1. html 파일 만들기
src/main/resources/static/index.html
 

2. 서버 껐다 키기(좌측 하단에 빨간네모→초록세모 차례로 클릭)

3. localhost:8080 들어가서 확인(정적페이지)

2) 템플릿 엔진 쓰면 동적페이지 사용 가능 → thymeleaf 템플릿엔진

3) /hello & hello.html → 동적 컨텐츠 방식 (MVC, 템플릿 방식)

• Controller(웹어플리케이션의 첫번째 진입점) 사용해서 Page 만들기

1. src/main/java에서 package 만들기 → hello.hellospring.controller

2. 만든 package에서 Java Class 만들기 → HelloController

3. Controller 코드 입력
src/main/java/hello/hellospring/controller/HelloController.java

4. html 파일 만들기
src/main/resources/templates/hello.html
타임리프 쓸 때 값이 안들어온다면?
예를 들어 Controller에서 data 값을 안주면 null로 화면에 뜸. 에러는 안남.

5. 서버 껐다 키기
에러
해결
→ 아래 코드 추가하기
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;
→ GetMapping이랑 Model에 대해 import를 안해서 발생한 에러였음

6. localhost:8080/hello 들어가서 확인
페이지 소스

4) 동작 원리

1. 웹 브라우저에서 /hello 던지면, 스프링부트가 내장한 톰캣이란 웹서버가 이를 받아서 스프링한테 이에 대해 물어봄.

2. 스프링이 helloController에 보면 GetMapping(”hello”)가 있는데, 여기서 Get은 Get, Post… method 할 때 Get임. Get 방식이기에 컨트롤러의 hello url에 매칭이 됨.

3. 컨트롤러에 있는 아래 method가 실행됨.

4. model은 스프링이 만들어서 넘겨준거임. model에다가 addAttribute해서 key는 data고 값은 hello!!라고 씀으로써 model에 data는 hello!!라고 넣어놈.

5. “hello”를 return 함. 이때 hello는 src/main/resources/template에 있는 html 파일 이름과 같은 거임. 즉, hello.html에 렌더링시키라는 뜻임. 모델이란걸 화면에 넘기면서 hello.html의 화면을 실행시키라는 거임.
• return 값 == html 파일명
에러
해결

return값은 "hoho"인데 templates의 html파일 이름은 hi.html이라 둘이 달라 발생한 에러. 두 개를 같게 만들어주면 됨



정리
• 컨트롤러에서 리턴 값으로 문자를 반환하면 뷰 리졸버( viewResolver )가 화면을 찾아서 처리한다.
• 스프링 부트 템플릿엔진 기본 viewName 매핑
• resources:templates/ +{ViewName}+ .html
참고
• spring-boot-devtools 라이브러리를 추가하면, html 파일을 컴파일만 해주면 서버 재시작 없이 View 파일 변경이 가능하다.
• 인텔리J 컴파일 방법: 메뉴 build Recompile

4. 빌드하고 실행하기

1. intellij에서 구동 중인 서버 끄기

2. 터미널(git bash)에서 hello-spring(스프링 입문) 폴더 들어가기
cd c/리포지토리/GDSC-1st-Backend-Study/ChooSeoyeon/스프링 입문

3. ./gradlew build

4. cd build/libs

5. ls -arlth → 18메가 짜리 jar 파일 있는 거 확인 가능

6. java -jar hello-spring-0.0.1-SNAPSHOT.jar

• 배포 시, hello-spring-0.0.1-SNAPSHOT.jar 파일만 복사해서 서버에 넣고서

• 잘 안되면 ./gradlew clean build 하면 됨. 그러면 완전히 지우고 다시 build함.