feat : 샘플 코드작성 & 상세 주석

src/main/java/go/kr/project/biz/minwon/init/controller/SampleController.java

@@ -35,6 +35,7 @@ public class SampleController {
     // 이걸 [엔드포인트]라고 한다.
 
     //자바파일은 클래스와 매서드(함수)들로 이루어지는데 아래 링크를 한번 읽고오면 이해가 빠르다.
+    //https://velog.io/@luna001631/%EC%9E%90%EB%B0%94JAVA-%EB%A9%94%EC%86%8C%EB%93%9Cmethod%EB%9E%80
     //첨부한 링크들에서 이해가 안가는 부분있으면 정민 호출하면 최대한 쉽게 풀어 설명해주려고 노력한다.
     //추가로 변수나 매서드명을 만들때 축약어는 지양한다. 길어도 상관없다.
     //누가 읽어도 무슨동작을 하는지 예측되도록 정의하는것이 좋다.
@@ -42,7 +43,6 @@ public class SampleController {
     // ex) 좋은예 : findCpMainByMmcode / 나쁜예 : srchCm
     //줄인다고 성능이 빨라지는것도 아니며 길이 제한이 있는것도 아니다.
     //남이 읽기 좋은 코드를 만든다고 생각하고 만들어야 한다.
-    //https://velog.io/@luna001631/%EC%9E%90%EB%B0%94JAVA-%EB%A9%94%EC%86%8C%EB%93%9Cmethod%EB%9E%80
     @GetMapping("/minwon/init/sample.do")
     public String samplePageReturn() {
         // .do로 리턴하는건 jsp페이지를 찾아서 리턴하라는 표시이다
@@ -67,6 +67,11 @@ public class SampleController {
 
         List<SampleDto.Response.cpMain> result = sampleService.searchSampleMybatis(testDto);
 
+        //해당 리턴은 http 리스폰스 응답객체로 리턴을 해주는것이다.
+        //http는 헤더 바디 메시지 등등으로 이루어져있다.
+        //해당 형식을 ResponseEntity에서 구현하고 있음으로 백엔드 응답을 바디에 담아서 보내주기만 하면된다.
+        //아래는 Http 에 대한 설명이다.
+        //https://hahahoho5915.tistory.com/62
         return ResponseEntity.ok(result);
     }
 

src/main/java/go/kr/project/biz/minwon/init/mapper/SampleMapper.java

@@ -10,6 +10,7 @@ import java.util.List;
 @Mapper
 public interface SampleMapper {
 
-
+    //Sql문이 있는 xml파일과 이어주는 고리이다.
+    //이 매서드가 호출되면서 sql문이 나간다.
     List<SampleDto.Response.cpMain> selectAllSample(SampleDto.Request.Search searchDto);
 }

src/main/resources/mybatis/mapper/biz/minwon/SampleMapper_maria.xml

@@ -7,7 +7,7 @@
 
     <!--
     매퍼인터페이스의 매소드명과 id가 일치해야 한다.
-     parameterType은 가져올 파라미터,
+     parameterType은 사용할 파라미터,
      resultType은 쿼리 결과를 반납하는 객체를 넣어준다.
      아래 보면 이너클래스는 $형태로 들어간다.
      -->

src/main/webapp/WEB-INF/views/biz/minwon/init/sample.jsp

@@ -1,4 +1,10 @@
 <%@ page contentType="text/html;charset=UTF-8" language="java" %>
+
+<%--
+<script type="text/javascript"> 이전까지가 html 영역이다.
+해당 영역은 화면 스케치 영역이라고 생각하면 된다.
+--%>
+
 <div class="main_body">
 
     <input type="text" id="input1" value="샘플 인풋1"></br>
@@ -71,8 +77,12 @@
             // });
         },
 
-        eventListener: () => {
 
+        eventListener: () => {
+            //이벤트 리스너이다
+            //이벤트 리스너란 html 태그에 동작을 넣어주는것이다.
+            //html에서 만든 Botton 태그는 그냥 버튼 모양일뿐 아무것도 아니다.
+            //아래 리스너를 넣어줌으로써 동작이 완성되는것이다.
             $("#mybatis-call").on("click", () => {
                 //아작스는 비동기 서버호출 함수이다. 아래 블로그 설명글 참고
                 //https://jbground.tistory.com/4
@@ -82,6 +92,8 @@
                     contentType: 'application/json',
                     data: JSON.stringify({ mmState : "01" }),
                     success: function(response) {
+                        //요청에 대한 응답 정상적으로 넘어오면 response 안에 담긴다.
+                        //해당 response로 화면에서 컨트롤 해주면된다.
                         $("#result").text("");
                         $("#result").text(JSON.stringify(response, null, 2));
                     },
@@ -101,7 +113,6 @@
                     data: JSON.stringify({ mmState : "01" }),
                     success: function(response) {
                         $("#result").text("");
-                        // $("#result").text(response);
                         $("#result").text(JSON.stringify(response, null, 2));
 
                     },
@@ -124,7 +135,7 @@
 
 
 
-    // $(function) 은 제이쿼리 초기화 함수로 $(document).ready(function(){} 과 똑같은 코드이다
+    // $(function) 은 제이쿼리 초기화 함수로 $(document).ready(function(){}) 과 똑같은 코드이다
     // 초기화라 함은 도큐멘트 (페이지) 가 열릴때 실행되는 코드이다.
     // 아래는 페이지가 열리면서, fnBiz.init() 을 실행시키라는 뜻이다.
     // 예를들어 페이지 진입하면서 바로 조회를 하게 만들고 싶다면, 에제와 같이 init함수 안에 조회하는 함수호출해버리면 된다.