SPRING-97-Spring Web MVC : JSR-380 - JAVA
JSR-303처럼 유효성의 편의를 위해 사용할 수 있는 어노테이션이다!
원리도 역시 JSR-303과 동일하다
@NotEmpty
@NotBlank
@Positive
@PositiveOrZero
@Negative
@NegativeOrZero
Java ver
Properties software Download
Name : properties
Location : http://propedit.sourceforge.jp/eclipse/updates
프로젝트 생성
Project Explorer에서 빈공간에 우클릭하면 Dynamic Web Project 만들 수 있다!
여기까진 할 수 있잖아
방금 만든 그 프로젝트를 Maven Project로 만들어주자!
혹시 다시 Maven 제거하고 싶다면, 위의 그림처럼 Disabled Maven Nature 해주믄 되니꽈
아! 메이븐 설정하고 프로젝트에 오류뜨면 그냥 alt+F5로 마무리해주십시다
Maven 기본설정 해보자!
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
<!-- pom모델버전 -->
<modelVersion>4.0.0</modelVersion>
<!-- 프로젝트 생성하는 조직의 고유 아이디 like 도메인 이름 -->
<groupId>Ex01JavaSetting</groupId>
<!-- Maven 프로젝트 식별하는 아이디 like 프로젝트명 -->
<artifactId>Ex01JavaSetting</artifactId>
<!-- 프로젝트 현재 버전 -->
<version>0.0.1-SNAPSHOT</version>
<!-- 어떤 형태로 프로젝트를 패키징할 지 결정 -->
<packaging>war</packaging>
<!-- 소스의 디렉토리 구조, 빌드 산출물 디렉토리 구조, 빌드시 사용할 플러긴 정보 관리 -->
<build>
<!-- sourceDirectory : 자바 소스 코드를 관리하는 디렉토리 -->
<sourceDirectory>src/main/java</sourceDirectory>
<!-- Maven제공 기능은 플러긴 기반으로 작동 따라서 설정 필요 -->
<plugins>
<!-- 컴파일 플러그인 설정 -->
<plugin>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.8.1</version>
<configuration>
<!-- 16>14변경 -->
<release>14</release>
</configuration>
</plugin>
<!-- 배포 패키징 플러긴 설정 -->
<plugin>
<artifactId>maven-war-plugin</artifactId>
<version>3.2.3</version>
<!-- configuration 추가 -->
<configuration>
<!-- 배포할 위치 directory -->
<warSourceDirectory>src</warSourceDirectory>
</configuration>
</plugin>
</plugins>
</build>
<!-- 라이브러리 버전관리 : properties -->
<properties>
<javax.servlet-version>4.0.1</javax.servlet-version>
<javax.servlet.jsp-version>2.3.3</javax.servlet.jsp-version>
<javax.servlet.jsp.jstl-version>1.2</javax.servlet.jsp.jstl-version>
<org.springframework>5.2.2.RELEASE</org.springframework>
</properties>
<!-- 라이브러리 셋팅 : dependencies 프로그램과 의존관계인 라이브러리 관리 -->
<dependencies>
<!-- servlet-api 라이브러리 적용 위한 설정 -->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<!-- 버전관리는 properties에서 하기 때문에 변수처럼 사용하기 -->
<version>${javax.servlet-version}</version>
<scope>provided</scope>
</dependency>
<!-- javax.servlet.jsp-api 라이브러리 적용 위한 설정 -->
<dependency>
<groupId>javax.servlet.jsp</groupId>
<artifactId>javax.servlet.jsp-api</artifactId>
<!-- 버전관리는 properties에서 하기 때문에 변수처럼 사용하기 -->
<version>${javax.servlet.jsp-version}</version>
<scope>provided</scope>
</dependency>
<!-- javax.servlet/jstl 라이브러리 적용 위한 설정 -->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>jstl</artifactId>
<!-- 버전관리는 properties에서 하기 때문에 변수처럼 사용하기 -->
<version>${javax.servlet.jsp.jstl-version}</version>
</dependency>
<!-- spring-webmvc 라이브러리 적용 위한 설정 -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<!-- 버전관리는 properties에서 하기 때문에 변수처럼 사용하기 -->
<version>${org.springframework}</version>
</dependency>
<!-- resource 어노테이션 안먹혀서 추가함.. 요상하군... -->
<dependency>
<groupId>javax.annotation</groupId>
<artifactId>javax.annotation-api</artifactId>
<version>1.3.2</version>
</dependency>
</dependencies>
</project>@Resource가 안먹혀서 dependency 추가함..
Spring MVC Java 기본설정
일단 Spring MVC를 어떻게 구현할지 구조부터 대충 살펴보면,
전에 JSP MVC 패턴때 BeansConfigClass 만들어서 bean을 정의해주었지
그 역할을 이젠 SpringConfigClass라는 이름으로 변경해 Java버전으로 해볼게!
import javax.servlet.Filter;
import org.springframework.web.filter.CharacterEncodingFilter;
import org.springframework.web.servlet.support.AbstractAnnotationConfigDispatcherServletInitializer;
public class SpringConfigClass extends AbstractAnnotationConfigDispatcherServletInitializer {
//AbstractAnnotationConfigDispatcherServletInitializer의 메소드 전부 override
//프로젝트에서 사용할 bean정의 클래스 지정
@Override
protected Class<?>[] getRootConfigClasses() {
// TODO Auto-generated method stub
//return 추가
return new Class[] {RootAppContext.class};
}
//Spring MVC 프로젝트 설정 위한 configuration 클래스 지정
@Override
protected Class<?>[] getServletConfigClasses() {
// TODO Auto-generated method stub
return new Class[] {ServletAppContext.class};
}
//DispatcherServlet에 매핑할 요청 주소 세팅
//DispatcherServlet : 클라이언트 요청을 맨 처음 받는 위치로 공통작업 후 세부 작업은 담당 컨트롤러로 전달하는 역할
@Override
protected String[] getServletMappings() {
// TODO Auto-generated method stub
return new String[] {"/"};
}
//얘는 안따라와서 따로 추가해줌
//request.setCharacterEncoding("UTF-8") 한 번만 설정하기
@Override
protected Filter[] getServletFilters() {
// TODO Auto-generated method stub
CharacterEncodingFilter encodingFilter = new CharacterEncodingFilter();
encodingFilter.setEncoding("UTF-8");
return new Filter[] {encodingFilter};
}
}AbstractAnnotationConfigDispatcherServletInitializer를 상속받아서 그 내부 메서드를 override 받았어.
맨 마지막 filter 메서드는 안따라오더라고?
걍 내가 불렀어 filter적고 ctrl+space하믄 뜰겨
보면 먼저 bean 뭐 쓸지 getRoot~()메서드에서 정의해주고,
getServletConfigClasses()메서드에서 Configuration을 지정해준다
getServletMapping()메서드는 말그대로 매핑 역할을 하는데, 위에서 적었다시피 클라이언트 요청 받으면
그 요청에 해당하는 컨트롤러 쪽으로 보내주는 것이 바로 매핑!
맨 마지막 filter 메서드는 우리 맨~날 스크립틀릿으로 또는 컨트롤러에서 request.set~("UTF-8") 적어줬잖아?
그걸 저기다가 딱 한 번, 두 번도 아니고 한 번만 적어주면 페이지마다 적은 효과를 주는거지
이제 getRootConfigClass 메서드에서 정의될 bean 클래스 RootAppContext를 한 번 만들어보자
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.context.annotation.SessionScope;
import kr.co.goodee39.vo.DataVO1;
import kr.co.goodee39.vo.DataVO2;
//Spring MVC 프로젝트에서 사용할 bean 정의하는 클래스
@Configuration
public class RootAppContext {
}간단하지? @Configuration 이라고 어노테이션 달아준 클래스가 전부야
물론 필요하게 되면 클래스 내부에 필드니, 생성자니, 메서드니 들어가겠지만 지금은 틀만 잡고 있는거니까 요대로 둘게
이번엔 getServletConfigClass 메서드에서 Spring MVC 설정을 해줄 Configuration 클래스를 정의해보자
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.support.ReloadableResourceBundleMessageSource;
import org.springframework.web.servlet.config.annotation.EnableWebMvc;
import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry;
import org.springframework.web.servlet.config.annotation.ViewResolverRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
//Spring MVC 프로젝트 설정 클래스
@Configuration
//@Controller 셋팅된 크래스를 Controller로 등록
@EnableWebMvc
//스캔할 패키지 저장
@ComponentScan("kr.co.goodee39.controller")
public class ServletAppContext implements WebMvcConfigurer {
//Controller의 메서드가 반환하는 jsp의 이름 앞뒤에 경로(/WEB-INF/views), 확장자(.jsp) 추가하는 설정
//configureViewResolvers
@Override
public void configureViewResolvers(ViewResolverRegistry registry) {
// TODO Auto-generated method stub
WebMvcConfigurer.super.configureViewResolvers(registry);
registry.jsp("/WEB-INF/views/", ".jsp");
}
//정적 파일(img, video, audio, etc) 경로 매핑
//addResourceHandlers
@Override
public void addResourceHandlers(ResourceHandlerRegistry registry) {
// TODO Auto-generated method stub
WebMvcConfigurer.super.addResourceHandlers(registry);
registry.addResourceHandler("/**").addResourceLocations("/resources/");
}
//Properties파일 등록 : 등록하면 이 데이터를 Jsp에서도 사용 가능함 & 다국어 처리 가능
@Bean
// reloadableResourceBundleMessageSource는 일정시간에 한 번씩 갱신되는 객체
public ReloadableResourceBundleMessageSource messageSource() {
ReloadableResourceBundleMessageSource res = new ReloadableResourceBundleMessageSource();
// data1.properties에서 .properties 제거 가능
//단수ver
res.setBasename("/WEB-INF/properties/error_message");
//복수ver
//res.setBasenames("/WEB-INF/properties/data1", "/WEB-INF/properties/data2");
return res;
}
}좀 낯설긴한데, servlet이라는 단어는 주구장창 봐왔잖아?
한 페이지 이동 할 때마다 servlet 추가추가추가 하던 그런 날이 끝났다 이거임..
여기서 한 큐에 설정이 가능해
일단 이 클래스가 Configuration할 클래스임을 어노테이션으로 명명하고,
@EnableWebMvc를 통해 이따가 @Controller 역할을 할 클래스를 진짜 controller로서 역할 할 수 있게 만들어줘
@ComponentScan으로 경로 설정해주면 그 내부 클래스 중 @Component설정된 클래스를 찾게될건데,
사실 이번에는 @Component로 등록된 클래스는 없어ㅎㅎㅎ
그리고나서 WebMvcConfigurer 상속받아준 후에 RootConfigClass와 마찬가지로 내부 메서드를 모두 상속 받아줘
configViewResolvers(ViewResolverResistry registry)라는 메서드는 이따가 @Controller에서 어떤 페이지로 갈 수 있게끔
jsp의 이름을 반환할텐데, 그 앞전 경로를 설정해주고, jsp파일임을 명시하는 확장자 설정이 가능해
addResourceHandelers(ResourceHandlerRegistry registry) 메서드는 정적인 파일, 예를들면 이미지, 영상, 음성 등등
어딘가에 딱 넣어두고, 불러와지기만 하는 변함없는 파일이잖아?
그 경로를 설정할 수 있는데, 여기서 보면 느끼겠지만 경로가 하나뿐이잖아..
하나의 경로밖에 못써..
뭐 하나의 경로 안에 폴더를 또 만들면 쓸 수 있겠지?
아 여기서 사실 addResourceHandler("/**")는 아직 어떤 역할인건지 잘 모르겠어.. 찾아보자 더 ㅎㅎㅎㅎ
마지막에 보면 @Bean객체 하나를 정의해둔 것이 있는데,
ReloadableResourceBundleMessageSource라는 객체 이올시다~
이 설정이 있어야만 Properties를 Message이용해서 JSP상에 띄우고, 바꾸고 하는 것이 가능해진다
만약 사용할 properties가 단수개라면 getBasename("properties파일 path")
복수개라면 getBasenames("properties파일1 path", "properties파일2 path", ...)
이런 식으로 삽입한다!
자 여기까지가 기초다 기초...
사실 아직 100% 이해된건 아니야.
이렇다니까 일단 받아들인거고, 계속 따라쳐보고, 구글링 해보면서 내것으로 만들고 또 발전도 시켜봐야지!
Controller 클래스 만들기
아까 위에서 Spring MVC를 설정하게 해주는 클래스 하나가 있었잖아?
그 클래스 내부에 @EnableWebMvc라는 어노테이션이 있었는데
이건 @Controller로 지정된 클래스가 정말 controller로서의 역할을 할 수 있게끔 해주는 어노테이션이였어.
그럼 이제 @Controller를 달고있을 클래스를 만들어보자
따지고보면 JSP에서 Servlet역할의 일부를 담당하는 것이라고도 생각할 수 있지 않나? 싶네
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
@Controller
public class HomeController {
//ServletAppContext에서 설정한 configureViewResolvers()메소드 통해서
///WEB-INF/views/index.jsp로 변환됨
@RequestMapping(value="/", method=RequestMethod.GET)
public String home() {
return "index";
}
}별건 없어
그냥 무슨 역할하는지 보자고!
위에서 계속 언급했듯 이 클래스는 controller의 역할을 할 클래스이므로 어노테이션으로 이름표 달아주고,
메소드를 하나 만드는데, 이 메소드는 무어냐
첫 페이지 역할, 그러니까 home 역할을 할 페이지를 설정하는 메서드야
그래서 이름도 home이야 후후
value는 우리 JSP MVC 패턴에서 servlet만들면 맨 상단에
@WebServlet("/블라블라")하는 공간이 있어 (ㄴㅇㄹ는 무시혀~ 걍 쓴거임)
저 블라블라는 보통 servlet이름이 들어가는데, 파일을 실행시켜서 이동한다거나 하면
url에 저기 작성된 이름이 뒤에 뜨더라고?
근데 이걸 /만 남기고 지워주면?!
그냥 RequestDispatcher rdp = request.getRequestDispatcher("");에서 설정한 jsp파일이 home으로 떠부러
servlet이라는 위치가 jsp파일 앞전에 안붙기 때문이지!
그거랑 같은 이치야 value = "/"는
아무턴, return "문자열";은 이따가 만들 home이 될 jsp파일 이름을 넣어준거야
이 controller가 실행되면 index라는 홈이름이 전달되겠지 어디로?
아까 위에서 @EnableWebMvc로 지금 이 클래스에 Controller의 자격을 준 servletAppContext 클래스로!
그리고는 configureViewResolvers(ViewResolverRegistry registry) 메소드를 만나
/WEB-INF/views/index.jsp로 변신!
그리고 index.jsp에 이미지가 있다면 addResourceHandlers(ResourceHandlerRegistry registry) 메서드 통해서
src 앞에 /resources/가 콱 붙어주겠지~
필드명 파서 그 안에 메세지 추가하기 위해 객체 생성
import javax.validation.constraints.Email;
import javax.validation.constraints.Negative;
import javax.validation.constraints.NegativeOrZero;
import javax.validation.constraints.NotBlank;
import javax.validation.constraints.NotEmpty;
import javax.validation.constraints.Positive;
import javax.validation.constraints.PositiveOrZero;
public class DataVO1 {
//NotEmpty : 주입된 값이 공백 포함 1글자 이상이 아니면 오류
@NotEmpty
private String data1;
//NotBlank : 주입된 값이 공백 불포함 1글자 이상이 아니면 오류
@NotBlank
private String data2;
//Positive : 주입된 값이 양수가 아니면 오류
@Positive
private int data3;
//PositiveOrZero : 주입된 값이 0 또는 양수가 아니면 오류
@PositiveOrZero
private int data4;
//Negative : 주입된 값이 음수가 아니면 오류
@Negative
private int data5;
//NegativeOrZero : 주입된 값이 0 또는 음수가 아니면 오류
@NegativeOrZero
private int data6;
//Email : 주입된 값이 이메일 형식이 아니면 오류 (@과 . 유뮤 여부로 판단)
@Email
private String data7;
public DataVO1() {
// TODO Auto-generated constructor stub
}
public String getData1() {
return data1;
}
public void setData1(String data1) {
this.data1 = data1;
}
public String getData2() {
return data2;
}
public void setData2(String data2) {
this.data2 = data2;
}
public int getData3() {
return data3;
}
public void setData3(int data3) {
this.data3 = data3;
}
public int getData4() {
return data4;
}
public void setData4(int data4) {
this.data4 = data4;
}
public int getData5() {
return data5;
}
public void setData5(int data5) {
this.data5 = data5;
}
public int getData6() {
return data6;
}
public void setData6(int data6) {
this.data6 = data6;
}
public String getData7() {
return data7;
}
public void setData7(String data7) {
this.data7 = data7;
}
}@NotEmpty : 주입된 값이 공백 포함 1글자 이상이 아니면 오류
@NotBlank : 주입된 값이 공백 불포함 1글자 이상이 아니면 오류
@Positive : 주입된 값이 양수가 아니면 오류
@PositiveOrZero : 주입된 값이 0 또는 양수가 아니면 오류
@Negative : 주입된 값이 음수가 아니면 오류
@NegativeOrZero : 주입된 값이 0 또는 음수가 아니면 오류
@Email : 주입된 값이 이메일 형식이 아니면 오류 (@과 . 유뮤 여부로 판단)
properties 폴더 생성 및 properties 파일 만들기
WEB-INF내부에 properties 폴더 하나 파주고
error_message.properties라는 properties 확장자 타입의 파일 생성
NotEmpty.dataVO1.data1 = data1이 공백포함 1글자 이상이어야 합니다.
NotBlank.dataVO1.data2 = data2이 공백불포함 1글자 이상이어야 합니다.
Positive.dataVO1.data3 = data3은 양수여야 합니다.
PositiveOrZero.dataVO1.data3 = data3은 0 또는 양수여야 합니다.
Negative.dataVO1.data4 = data4는 음수여야 합니다.
NegativeOrZero.dataVO1.data4 = data4는 0 또는 음수여야 합니다.
Email.dataVO1.data5 = data5는 이메일 형식이 아닙니다. (@필요)
# 어노테이션이름.커맨드체(첫글자 소문자).변수로 설정해야함!
만약 이 파일이 없거나, 내용이 없다면
그냥 기본 문구인 이상이어야 합니다10 이런 식으로 출력되는데
뒤에 10은 임의의 숫자를 준 것으로 실제로는 입력한 값이 출력된다
HomeController에서 설정한 첫 페이지가 되어줄 index.jsp를 만들자
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>Insert title here</title>
</head>
<body>
<!-- 유효성 검사하기 -->
<a href="input_data">Input_data</a>
</body>
</html>누르면 유효성 검사할 값 넣고, 검사해서 오류 메시지 보여줄 페이지로 이동!
Controller 만들기
import javax.validation.Valid;
import org.springframework.stereotype.Controller;
import org.springframework.validation.BindingResult;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;
import kr.co.goodee39.vo.DataVO1;
@Controller
public class TestController {
@GetMapping("/input_data")
public String inputData(DataVO1 dataVO1) {
return "input_data";
}
@PostMapping("/input_pro")
public String inputPro(@Valid DataVO1 dataVO1, BindingResult result) {
if(result.hasErrors()) {
return "input_data";
}
return "input_success";
}
}
@Controller 설정 해주고,
a태그니까 GetMapping으로 페이지 이동 설정해주는데,
커맨드 객체를 받아와서 에러메세지 판단할 수 있도록 해주기
검사할 페이지에서는 spring form 태그를 사용하기 때문에 @PostMapping을 이용한다
form태그 action을 input_pro로 설정할꾸
검사할 커맨드 객체에 @Valid 달아주고, BindingResult객체 사용해 결과에 에러가 있는지 검사해준다
에러 메시지가 뜨면 그 페이지 고대로 머물러서 에러만 띄우고,
에러 없으면 success페이지로 이동한다
값을 입력하고, 유효성 검사 결과를 표시할 input_data 페이지
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<%@ taglib prefix="form" uri="http://www.springframework.org/tags/form"%>
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>Insert title here</title>
</head>
<body>
<h1>Input_data 완</h1>
<form:form action="input_pro" modelAttribute="dataVO1" method="post">
<!-- NotEmpty 유효성 검사 -->
data1 : <form:input path="data1" type="text"/><br />
<form:errors path="data1"></form:errors><br />
<!-- NotBlank 유효성 검사 -->
data2 : <form:input path="data2" type="text"/><br />
<form:errors path="data2"></form:errors><br />
<!-- Positive 유효성 검사 -->
data3 : <form:input path="data3" type="text"/><br />
<form:errors path="data3"></form:errors><br />
<!-- PositiveOrZero 유효성 검사 -->
data4 : <form:input path="data4" type="text"/><br />
<form:errors path="data4"></form:errors><br />
<!-- Negative 유효성 검사 -->
data5 : <form:input path="data5" type="text"/><br />
<form:errors path="data5"></form:errors><br />
<!-- NegativeOrZero 유효성 검사 -->
data6 : <form:input path="data6" type="text"/><br />
<form:errors path="data6"></form:errors><br />
<!-- Email 유효성 검사 -->
data7 : <form:input path="data7" type="text"/><br />
<form:errors path="data7"></form:errors><br />
<form:button type="submit">확인</form:button>
</form:form>
</body>
</html>form:form태그 사용해 form 영역 생성하고
modelAttribute로 @Valid 설정해둔 객체 넣어준다
form:input에 삽입한 내용을 토대로 어노테이션으로 설정한 유효성 조건에 따라 form:errors로 메세지 띄우기~
에러 메시지도 스타일 설정 가능한데,
f12눌러서 개발자모드로 확인하면 span태그로 메세지가 들어감
거기서 id보고 설정할 수 있음!
로직을 보면, 일단 커맨드 객체에 달아둔 @Valid에 의해
@NotEmpty유효성 검사를 수행함
만약 form에서 에러 발생해? 그럼 path를 찾아 ! path는 setter 메서드의 이름! data1
그리고 form에서 model이 어딘지 찾아 dataVO1
properties에서 설정한 어노테이션, 객체, 변수명 찾아서 글 데꼬와 뿌려주기!
나머지도 마찬가즤~
정해진 범위나 조건 벗어나면 상동 로직에 의해 메세지 나타남
만약 유효성 검사 통과하면 아래 페이지로 이동
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>Insert title here</title>
</head>
<body>
<h1>Input_success</h1>
</body>
</html>
home으로 만들었던 index페이지에서 진짜 이동 되는지 한 번 해보자!
Run on Server를 클릭해주쟈
결과
