$$config title: 김병훈 Spring Boot 기술서 keywords: - IT - 기술서 - java - Spring Boot $$ ## 스프링부트 기술서 - [소스코드](https://github.com/byeonghooon/SB_AM) - 해당 프로젝트는 JAVA 기반으로 MVC구조의 커뮤니티 사이트 이며, 개인 프로젝트 입니다. - 회원가입을 통해 자유롭게 이용할 수 있도록 구현하였습니다. ### 목차 - 기술 스택 - 동작 과정 - 기능 설명 - 회원 - 회원가입 - 로그인 - 로그아웃 - 아이디 찾기 - 비밀번호 찾기 - 회원정보 수정 - 게시판 - 리스트 - 상세보기 - 작성 - 삭제 - 수정 - 좋아요/싫어요 - API - 카카오 map ### 기술스택 - 형상 관리 : Git Github - 기술 스택 - Tomcat - JDK 1.8 - Servlet / JSP - JDBC - MariaDB - jQuery - Ajax - JAVA - HTML - CSS - JavaScript - Tailwind - 개발 툴 - STS - SQLYog - Maven - Git , Github - Visual Studio Code - Chrome ### 동작 과정 ![](https://i.imgur.com/o5ltVs6.png) 1. Client 에게 받은 요청을 Controller 에게 보내기 전에 Interceptor 에서 로그인 여부를 확인합니다. 2. Interceptor 에서 통과된 데이터는 Controller 에게 전달한 후 Controller 에서 Request 를 통해 액션이 실행되며 비즈니스 로직에 관련된 부분은 Service 에게 위임합니다. 3. Service 에선 Controller 에게 받은 데이터를 분석/처리해주고 데이터 보관, 수정, 삭제를 위해 Dao 에게 위임합니다. 4. 계층 간 데이터 교환에 Dto 가 사용됩니다. (lombok 을 사용하여 클래스에 getter, setter, 생성자 등을 자동으로 생성해줍니다.) 5. mybatis 와 DB 연결을 위해 xml 파일을 읽고 Dao 와 연결합니다. 6. xml 파일에서 쿼리를 읽어 JDBC 에 넘깁니다. 7. Service 는 요청했던 데이터를 Dao 에게 받고 성공과 실패를 구분해 Controller 에게 전달합니다. 8. Controller 는 상황에 맞는 메시지를 Service 에게 받아와 JSP 를 통해 사용자에게 보여줍니다. ## 기능 설명 ### 메인 페이지 ```js public class UsrHomeController { @RequestMapping("/usr/home/main") public String showMain() { return "usr/home/main"; } ``` - /usr/home/main 의 요청이 들어오면 return값에 의해 mian.jsp로 이동. main.jsp ```js <%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%> <%@ include file="../common/head.jspf"%>

Lorem ipsum dolor sit amet, consectetur adipisicing elit. Voluptas molestias provident facilis illum dolor earum modi laborum praesentium architecto veritatis nemo velit optio facere quaerat amet atque temporibus dolorem soluta.

<%@ include file="../common/foot.jspf"%> ``` - head와 footor는 어느 페이지나 같이 나오기 때문에 따로 jspf로 만들어서 인클루드 ## 회원 관련 기능 ### 회원가입 UsrMemberController.java ```js @RequestMapping("usr/member/join") public String showJoin() { return "usr/member/join"; } ``` - /usr/member/join 요청이 들어오면 사용자에게 join.jsp로 화면을 보여준다. ![](https://i.imgur.com/py7ufX7.png) join.jsp ```js ``` - 회원가입에 필요한 데이터들이 공백을 제거하고 입력되어 있는지 확인 ![](https://i.imgur.com/06uoG1Z.png) - 회원 아이디 중복 체크(Ajax 기능 사용) ```js @RequestMapping("usr/member/getLoginIdDup") @ResponseBody public ResultData getLoginIdDup(String loginId) { if (Ut.empty(loginId)) { return ResultData.from("F-A1", "아이디를 입력해주세요"); } Member oldMember = memberService.getMemberByLoginId(loginId); if (oldMember != null) { return ResultData.from("F-A2", "해당 아이디는 이미 사용중입니다", "logindId", loginId); } return ResultData.from("S-1", "사용 가능한 아이디입니다", "logindId", loginId); } ``` ![](https://i.imgur.com/osrMFwY.png) - 해당 입력란이 비어있으면 알림창 띄움. - 가입 버튼을 누르면 입력된 데이터를 가지고 UsrMemberController.java의 doJoin함수로 이동 UsrMemberController.java ```js @RequestMapping("usr/member/doJoin") @ResponseBody public String doJoin(String loginId, String loginPw, String name, String nickname, String cellphoneNum, String email, @RequestParam(defaultValue = "/") String afterLoginUri, MultipartRequest multipartRequest) { if (Ut.empty(loginId)) { return rq.jsHistoryBack("F-1", "아이디를 입력해주세요"); } if (Ut.empty(loginPw)) { return rq.jsHistoryBack("F-2", "비밀번호를 입력해주세요"); } if (Ut.empty(name)) { return rq.jsHistoryBack("F-3", "이름을 입력해주세요"); } if (Ut.empty(nickname)) { return rq.jsHistoryBack("F-4", "닉네임을 입력해주세요"); } if (Ut.empty(cellphoneNum)) { return rq.jsHistoryBack("F-5", "전화번호를 입력해주세요"); } if (Ut.empty(email)) { return rq.jsHistoryBack("F-6", "이메일을 입력해주세요"); } ResultData joinRd = memberService.join(loginId, loginPw, name, nickname, cellphoneNum, email); if (joinRd.isFail()) { return rq.jsHistoryBack(joinRd.getResultCode(), joinRd.getMsg()); } int newMemberId = (int) joinRd.getBody().get("id"); String afterJoinUri = "../member/login?afterLoginUri=" + Ut.getUriEncoded(afterLoginUri); Map fileMap = multipartRequest.getFileMap(); for (String fileInputName : fileMap.keySet()) { MultipartFile multipartFile = fileMap.get(fileInputName); if (multipartFile.isEmpty() == false) { genFileService.save(multipartFile, newMemberId); } } return rq.jsReplace("회원가입이 완료되었습니다. 로그인 후 이용해주세요", afterJoinUri); } ``` - 해당 데이터를 가지고 memberService.join으로 넘김. MemberService.java ```js public ResultData join(String loginId, String loginPw, String name, String nickname, String cellphoneNum, String email) { Member existsMember = getMemberByLoginId(loginId); if (existsMember != null) { return ResultData.from("F-7", Ut.f("이미 사용중인 아이디(%s)입니다.", loginId)); } existsMember = getMemberByNameAndEmail(name, email); if (existsMember != null) { return ResultData.from("F-7", Ut.f("이미 사용중인 이름과(%s) 이메일(%s)입니다.", name, email)); } loginPw = Ut.sha256(loginPw); memberRepository.join(loginId, loginPw, name, nickname, cellphoneNum, email); int id = memberRepository.getLastInsertId(); return new ResultData("S-1", "회원가입이 완료되었습니다", "id", id); } ``` MemberRepository.java ```js INSERT INTO `member` SET regDate = NOW(), updateDate = NOW(), loginId = #{loginId}, loginPw = #{loginPw}, `name` = #{name}, nickname = #{nickname}, cellphoneNum = #{cellphoneNum}, email = #{email} ``` - Mybatis Mapper 사용 - 해당하는 데이터를 DB에 추가 ### 로그인 UsrMemberController.java ```js @RequestMapping("usr/member/login") public String showLogin() { return "usr/member/login"; } @RequestMapping("usr/member/doLogin") @ResponseBody public String doLogin(String loginId, String loginPw, @RequestParam(defaultValue = "/") String afterLoginUri) { if (Ut.empty(loginId)) { return Ut.jsHistoryBack("아이디를 입력해주세요"); } if (Ut.empty(loginPw)) { return Ut.jsHistoryBack("비밀번호를 입력해주세요"); } Member member = memberService.getMemberByLoginId(loginId); if (member == null) { return Ut.jsHistoryBack("아이디를 잘못 입력했습니다"); } if (member.getLoginPw().equals(Ut.sha256(loginPw)) == false) { return Ut.jsHistoryBack("비밀번호가 일치하지 않습니다."); } if (member.isDelStatus() == true) { return Ut.jsReplace("사용 정지 된 계정입니다", "/"); } rq.login(member); return Ut.jsReplace(Ut.f("%s님 환영합니다.", member.getNickname()), afterLoginUri); } ``` ![](https://i.imgur.com/sRv61Vd.png) - MemberService로 해당 데이터 전달 MemberService.java ```js public Member getMemberByLoginId(String loginId) { return memberRepository.getMemberByLoginId(loginId); } ``` - MemberRepository로 해당 데이터 전달 MemberRepository.java ```js ``` - 입력 로그인 아이디에 해당하는 데이터 추출 ### 로그아웃 UsrMemberController.java ```js @RequestMapping("usr/member/doLogout") @ResponseBody public String doLogout(@RequestParam(defaultValue = "/") String afterLogoutUri) { rq.logout(); return Ut.jsReplace("로그아웃 되었습니다", afterLogoutUri); } ``` - 세션에 저장되어 있는 member 값을 제거후 메인페이지로 이동 ### 아이디 찾기 ![](https://i.imgur.com/mZVoxJK.png) findLoginId.jsp ```js ``` - 스크립트로 공백 1차 체크 UsrMemberController.java ```js @RequestMapping("usr/member/findLoginId") public String showFindLoginId() { return "usr/member/findLoginId"; } @RequestMapping("usr/member/doFindLoginId") @ResponseBody public String doFindLoginId(String name, String email, @RequestParam(defaultValue = "/") String afterFindLoginIdUri) { Member member = memberService.getMemberByNameAndEmail(name, email); if (member == null) { return Ut.jsHistoryBack("이름과 이메일을 확인해주세요"); } return Ut.jsReplace(Ut.f("회원님의 아이디는 [ %s ] 입니다", member.getLoginId()), afterFindLoginIdUri); } ``` - 2차 공백 체크 - 이름과 이메일을 memberService의 getMemberByNameAndEmail로 넘김 - 해당 데이터가 있는지 없는지 확인 - 만약 DB에 해당 데이터가 있으면 메세지와 함께 로그인 페이지로 이동 MemberService.java ```js public Member getMemberByNameAndEmail(String name, String email) { return memberRepository.getMemberByNameAndEmail(name, email); } ``` - memberRepository의 getMemberByNameAndEmail로 넘김 MemberRepository.java ```js ``` - DB에서 해당 이름과 이메일로 회원을 찾음 ### 비밀번호 찾기 ![](https://i.imgur.com/cb893o7.png) findLoginPw.jsp ```js ``` - 1차 공백 체크 UsrMemberController.java ```js @RequestMapping("usr/member/findLoginPw") public String showFindLoginPw() { return "usr/member/findLoginPw"; } @RequestMapping("usr/member/doFindLoginPw") @ResponseBody public String doFindLoginPw(String loginId, String email, @RequestParam(defaultValue = "/") String afterFindLoginPwUri) { Member member = memberService.getMemberByLoginId(loginId); if (member == null) { return Ut.jsHistoryBack("일치하는 회원이 없습니다"); } if (member.getEmail().equals(email) == false) { return Ut.jsHistoryBack("이메일이 일치하지 않습니다"); } ResultData notifyTempLoginPwByEmailRd = memberService.notifyTempLoginPwByEmailRd(member); return Ut.jsReplace(notifyTempLoginPwByEmailRd.getMsg(), afterFindLoginPwUri); } ``` - 2차 공백 체크. - memberService.getMemberByLoginId() 해당 회원 데이터 가져온뒤 member에 저장. - member값 공백 체크후 공백이면 메세지와 함께 비밀번호 찾기 창으로 이동. - member의 name과 입력한 name이 같은 값인지 확인후 위와 같은 액션 수행. - member의 email과 입력한 email이 같은 값인지 확인후 위와 같은 액션 수행. - memberService의 notifyTempLoginPwByEmail로 임시 패스워드 발송. - 임시 패스워드까지 발송이 되면 로그인 페이지로 이동. MemberService.java ```js public ResultData notifyTempLoginPwByEmail(Member actor) { // 메일 제목 설정 String title = "[" + siteName + "] 임시 패스워드 발송"; // 임시패스워드 6자리로 만듬 String tempPassword = Ut.getTempPassword(6); // 메일 내용 설정 String body = "

임시 패스워드 : " + tempPassword + "

"; body += "로그인 하러가기"; // 메일 발송 ResultData sendResultData = mailService.send(actor.getEmail(), title, body); if (sendResultData.isFail()) { return sendResultData; } tempPassword = Ut.sha256(tempPassword); setTempPassword(actor, tempPassword); return ResultData.from("S-1", "계정의 이메일주소로 임시 패스워드가 발송되었습니다."); } private void setTempPassword(Member actor, String tempPassword) { memberRepository.modify(actor.getId(), tempPassword, null, null, null, null); } ``` - 메일 제목 및 내용을 설정. - 임시패스워드를 6자리로 만듬. (getTempPassword) - 메일 발송 (send) - 메일 발송 성공 실패 확인 - 임시비밀번호를 암호화 한뒤 DB에 저장 (setTempPassword) mailService.getTempPassword ```js public static String getTempPassword(int length) { int index = 0; char[] charArr = new char[] { '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z' }; StringBuffer sb = new StringBuffer(); for (int i = 0; i < length; i++) { index = (int) (charArr.length * Math.random()); sb.append(charArr[index]); } return sb.toString(); } ``` mailService.send ```js public ResultData send(String email, String title, String body) { MailHandler mail; try { mail = new MailHandler(sender); mail.setFrom(emailFrom.replaceAll(" ", ""), emailFromName); mail.setTo(email); mail.setSubject(title); mail.setText(body); mail.send(); } catch (Exception e) { e.printStackTrace(); return ResultData.from("F-1", "메일 발송을 실패하였습니다."); } return ResultData.from("S-1", "메일이 발송되었습니다."); } ``` ![](https://i.imgur.com/87aLMt8.png) ![](https://i.imgur.com/2CR3epH.png) - DB에 임시 비밀번호 저장 ### 회원 정보 수정 - 로그인을 하게 되면 상단의 mypage 메뉴가 나오게 된다. - mypage를 클릭하면 아래와 같은 창이 나오게 된다. ![](https://i.imgur.com/IKMM3FB.png) - 회원정보수정을 누르면 사용자가 맞는지 비밀번호로 한번더 확인하기위해 UsrMemberController의 checkPassword로 이동 ![](https://i.imgur.com/dvRgY9P.png) - 비밀번호 암호화 및 입력 체크 UsrMemberController.java ```js @RequestMapping("usr/member/doCheckPassword") @ResponseBody public String doCheckPassword(String loginPw, String replaceUri) { if (Ut.empty(loginPw)) { return Ut.jsHistoryBack("비밀번호를 입력해주세요"); } if (rq.getLoginedMember().getLoginPw().equals(Ut.sha256(loginPw)) == false) { return rq.jsHistoryBack("비밀번호가 일치하지 않습니다"); } if (replaceUri.equals("../member/modify")) { String memberModifyAuthKey = memberService.genMemberModifyAuthKey(rq.getLoginedMemberId()); replaceUri += "?memberModifyAuthKey=" + memberModifyAuthKey; } return rq.jsReplace("", replaceUri); } ``` - 보안을 위한 인증키 생성 (genMemberModifyAuthKey) - 인증키 생성후 modify로 이동 MemberService.java ```js public String genMemberModifyAuthKey(int actorId) { String memberModifyAuthKey = Ut.getTempPassword(10); attrService.setValue("member", actorId, "extra", "memberModifyAuthKey", memberModifyAuthKey, Ut.getDateStrLater(60 * 5)); return memberModifyAuthKey; } ``` - 현재시간 기준으로 5분뒤 시간을 가져옴. (Ut.getDateStrLater) - memberModifyAuthKey에 인증키 10자리 저장. - attr이라는 부가정보 테이블을 추가 및 데이터 저장. (attrService.setValue) ![](https://i.imgur.com/EKTdy4C.png) UsrMemberController.java ```js @RequestMapping("/usr/member/modify") public String showModify(String memberModifyAuthKey) { if (Ut.empty(memberModifyAuthKey)) { return rq.jsHistoryBackOnView("회원 수정 인증코드가 필요합니다"); } ResultData checkMemberModifyAuthKeyRd = memberService.checkMemberModifyAuthKey(rq.getLoginedMemberId(), memberModifyAuthKey); if (checkMemberModifyAuthKeyRd.isFail()) { return rq.jsHistoryBackOnView(checkMemberModifyAuthKeyRd.getMsg()); } return "usr/member/modify"; } ``` - 인증키가 비어있는지 확인. - 입력된 인증키가 실제 인증키와 같은지 확인. (checkMemberModifyAuthKey) - 확인이 끝나면 modify.jsp로 이동 MemberService.java ```js public ResultData checkMemberModifyAuthKey(int actorId, String memberModifyAuthKey) { String saved = attrService.getValue("member", actorId, "extra", "memberModifyAuthKey"); if (!saved.equals(memberModifyAuthKey)) { return ResultData.from("F-1", "일치하지 않거나 만료되었습니다"); } return ResultData.from("S-1", "정상 코드입니다"); } ``` - 인증키와 5분이 넘어는지 확인후 성공 실패 여부 리턴 modify.jsp ```js ``` - 공백 체크 - 입력된 데이터를 가지고 UsrMemberController.java의 doModify함수로 이동 UsrMemberController.java ```js @RequestMapping("/usr/member/doModify") @ResponseBody public String doModify(String memberModifyAuthKey, String loginPw, String name, String nickname, String cellphoneNum, String email) { if (Ut.empty(memberModifyAuthKey)) { return rq.jsHistoryBack("회원 수정 인증코드가 필요합니다"); } ResultData checkMemberModifyAuthKeyRd = memberService.checkMemberModifyAuthKey(rq.getLoginedMemberId(), memberModifyAuthKey); if (checkMemberModifyAuthKeyRd.isFail()) { return rq.jsHistoryBack(checkMemberModifyAuthKeyRd.getMsg()); } if (Ut.empty(loginPw)) { loginPw = null; return rq.jsHistoryBack("비밀번호를 입력해주세요"); } if (Ut.empty(name)) { return rq.jsHistoryBack("이름을 입력해주세요"); } if (Ut.empty(nickname)) { return rq.jsHistoryBack("닉네임을 입력해주세요"); } if (Ut.empty(cellphoneNum)) { return rq.jsHistoryBack("전화번호를 입력해주세요"); } if (Ut.empty(email)) { return rq.jsHistoryBack("이메일을 입력해주세요"); } ResultData modifyRd = memberService.modify(rq.getLoginedMemberId(), loginPw, name, nickname, cellphoneNum, email); return rq.jsReplace(modifyRd.getMsg(), "/"); } ``` - 백엔드에서 공백 2차 체크 진행. - 인증키 체크 진행. - 데이터들을 memberService로 넘김 - 수정이 끝나면 메인 페이지로 이동 MemberService.java ```js public ResultData modify(int id, String loginPw, String name, String nickname, String cellphoneNum, String email) { loginPw = Ut.sha256(loginPw); memberRepository.modify(id, loginPw, name, nickname, cellphoneNum, email); return ResultData.from("S-1", "회원정보가 수정되었습니다"); } ``` - 데이터를 다시 리포지터리로 넘김 - DB추가가 되면 ResultData로 메세지를 리턴함. MemberRepository.java ```js @Select("""

작성자	${rq.loginedMember.nickname }
게시판
제목
내용

수정 삭제

``` - 프론트에서 제목과 내용 공백 체크. - 작성버튼을 누르면 Controller의 doWrite로 이동 UsrArticleController.java ```js @RequestMapping("/usr/article/doWrite") @ResponseBody public String doWrite(int boardId, String title, String body, String replaceUri) { // 백엔드에서 공백 2차 체크 if (Ut.empty(title)) { return rq.jsHistoryBack("title(을)를 입력해주세요."); } if (Ut.empty(body)) { return rq.jsHistoryBack("body(을)를 입력해주세요."); } // articleService로 게시글 작성에 필요한 데이터를 넘김. ResultData writeArticleRd = articleService.writeArticle(rq.getLoginedMemberId(), boardId, title, body); int id = writeArticleRd.getData1(); // 방금 작성한 게시글의 상세페이지로 url설정 if (Ut.empty(replaceUri)) { replaceUri = Ut.f("../article/detail?id=%d", id); } return rq.jsReplace(Ut.f("%d번 글이 생성되었습니다.", id), replaceUri); } ``` - 2차 공백 체크 - articleService로 게시글 작성에 필요한 데이터를 넘김. ArticleService.java ```js public ResultData writeArticle(int memberId, int boardId, String title, String body) { articleRepository.writeArticle(memberId, boardId, title, body); // 방금 생성한 게시글의 번호를 가져옴 int id = articleRepository.getLastInsertId(); return ResultData.from("S-1", Ut.f("%d번 게시물이 생성되었습니다.", id), "id", id); } ``` - 리포지터리로 데이터 한번더 전달. - 방금 생성한 게시글의 번호를 가져옴 (getLastInsertId). ArticleRepository.java ```js public void writeArticle(@Param("memberId") int memberId, @Param("boardId") int boardId, @Param("title") String title, @Param("body") String body); ``` ArticleRepository.xml로 이동 ```js INSERT INTO article SET regDate = NOW(), updateDate = NOW(), boardId = #{boardId}, memberId = #{memberId}, title = #{title}, `body` = #{body} ``` - 해당 게시판에 게시글을 추가한다. ## 삭제 - 상세보기 페이지에서 게시물 삭제를 누르게되면 사용자에게 한번더 물어보기위해 알림을 띄어준다 ![](https://i.imgur.com/Z6IapBi.png) - 확인을 누르면 /article/doDelete로 이동. UsrArticleController.java ```js @RequestMapping("/usr/article/doDelete") @ResponseBody public String doDelete(int id) { // 해당 게시글의 정보를 가져옴. Article article = articleService.getForPrintArticle(rq.getLoginedMemberId(), id); // 게시글 존재 유무 확인 if (article == null) { rq.jsHistoryBack(Ut.f("%d번 게시물이 존재하지 않습니다.", id)); } // 권한체크 if (article.getMemberId() != rq.getLoginedMemberId()) { return rq.jsHistoryBack("권한이 없습니다."); } // 삭제 실행 articleService.deleteArticle(id); return rq.jsReplace(Ut.f("%d번 게시물을 삭제하였습니다.", id), "../article/list"); } ``` - 해당 게시글의 정보를 가져옴. (getForPrintArticle) - 가져온 정보로 게시글의 존재 유무를 확인. - 현재 로그인한 멤버의 아이디와 해당 게시글의 작성자 아이디가 같은지 확인. ArticleService.java ```js public void deleteArticle(int id) { articleRepository.deleteArticle(id); } ``` - 삭제하려는 게시글의 id를 articleRepository로 넘김. ArticleRepository.java ```js DELETE FROM article WHERE id = #{id} ``` - 해당 게시글 삭제 처리. ## 수정 - 상세보기페이지에서 게시물 수정을 누르면 - /article/modify로 이동 ```js @RequestMapping("/usr/article/modify") public String showModify(Model model, int id) { // 수정하려는 게시글의 정보를 가져옴 Article article = articleService.getForPrintArticle(rq.getLoginedMemberId(), id); // 게시글 존재 유무 확인 if (article == null) { return rq.historyBackJsOnView(Ut.f("%d번 게시물이 존재하지 않습니다.", id)); } // 수정 권한 확인 ResultData actorCanModifyRd = articleService.actorCanModify(rq.getLoginedMemberId(), article); // 수정 권한이 없으면 메세지와 함께 히스토리백 if (actorCanModifyRd.isFail()) { return rq.historyBackJsOnView(actorCanModifyRd.getMsg()); } // model에 해당 게시글 값 추가 model.addAttribute("article", article); // jsp로 이동 return "usr/article/modify"; } ``` - 수정하려는 게시글의 정보를 가져온뒤 게시글의 존재 유무를 확인한다. (getForPrintArticle) - 수정 권한이 있는지 확인한다. (actorCanModify) - 수정 권한이 없으면 메세지와 함께 되돌아간다. - model에 해당 게시글의 값을 추가해준다. modify.jsp ![](https://i.imgur.com/gyMHl3s.png) ```js ``` - 카카오 map API 를 사용함