SPRING-102-Spring Web MVC : Exception Handler - XML

오류 발생시 브라우저에 오류 메세지 발생하면
브라우저 상에서 오류 페이지가 뜨는데,
별로임... ^^
나만으 어? 딱 그런 오류 페이지도 하나 만들어서 보여주면
사용자도, 나도 좋지 않겠어?

그럼 오류를 처리하고, jsp페이지를 하나 만들어서 오류 발생하면 그 페이지로 이동되는
예외처리 핸들러를 만들어보자


XML ver

 

 

 

 

 

 

 

 

 

 

프로젝트 생성

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>
    
    
	<!-- validation-api를 사용하기 위한 설정 -->
	<dependency>
	    <groupId>javax.validation</groupId>
	    <artifactId>validation-api</artifactId>
	    <version>2.0.1.Final</version>
	</dependency>
	
	
	<!-- hibernate-validator를 사용하기 위한 설정 -->
	<dependency>
  	  	<groupId>org.hibernate.validator</groupId>
  	 	<artifactId>hibernate-validator</artifactId>
 	 	<version>6.2.1.Final</version>
	</dependency>
	
	
	
  </dependencies>
</project>

Validation api를 사용하기 위해 dependency를 추가했고,
Hibernate-validator가 같이 있어야 하나베.. 뭐 설명도 안해주고 그냥 막 깔으라네... 차음내

https://mvnrepository.com/artifact/javax.validation/validation-api/2.0.1.Final

https://mvnrepository.com/artifact/org.hibernate.validator/hibernate-validator/6.2.1.Final

자 여그서 받으이소~

 

 

 

 

Spring MVC XML 기본설정

일단 Spring MVC를 어떻게 구현할지 구조부터 대충 살펴보면,
전에 JSP MVC 패턴때 bean.xml 만들어서 bean을 정의해주었지
그 역할을 이젠 web.xml 이용해서 XML버전으로 만들어보자

아까 Java버전으로 치자면 ServletConfigClass의 역할을 얘가 하는거여

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://xmlns.jcp.org/xml/ns/javaee" xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd" id="WebApp_ID" version="4.0">
 	<!-- 현재 웹 애플리케이션에러 받아들이는 모든 요청에 대해 appServlet이란 이름으로 정의된 서블릿 사용 -->
	<servlet-mapping>
		<servlet-name>appServlet</servlet-name>
		<url-pattern>/</url-pattern>
	</servlet-mapping>

	<!-- 설정 정보를 분석해 controller 선택하는 서블릿 지정 -->
	<servlet>
		<servlet-name>appServlet</servlet-name>
		<!-- Spring MVC에서 저공하는 기본 서블릿 지정 -->
		<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
		<!-- Spring MVC 설정을 위한 XML파일 지정 -->
		<init-param>
			<param-name>contextConfigLocation</param-name>
			<param-value>/WEB-INF/config/servlet-context.xml</param-value>
		</init-param>
		<!-- 로드는 딱 한 번만 시키기 : 서버 꺼질 때까지 한 번만 실행 -->
		<load-on-startup>1</load-on-startup>
	</servlet>

	<!-- Bean정의할 XML 파일 지정 -->
	<context-param>
		<param-name>contextConfigLocation</param-name>
		<param-value>/WEB-INF/config/root-context.xml</param-value>
	</context-param>

	<!-- 리스너 설정 -->
	<listener>
		<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
	</listener>

	<!-- 파라미터 인코딩 필터 설정 -->
	<filter>
		<filter-name>encodingFilter</filter-name>
		<filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
		<init-param>
			<param-name>encoding</param-name>
			<param-value>UTF-8</param-value>
		</init-param>
		<init-param>
			<param-name>forceEncoding</param-name>
			<param-value>true</param-value>
		</init-param>
	</filter>

	<filter-mapping>
		<filter-name>encodingFilter</filter-name>
		<url-pattern>/*</url-pattern>
	</filter-mapping>
</web-app>

 

 

이제 web.xml에서 context-param을 보면 bean을 정의할 xml파일을 지정해두었잖아?
root-context.xml 그걸 한 번 만들어보자

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xsi:schemaLocation="http://www.springframework.org/schema/beans
                  http://www.springframework.org/schema/beans/spring-beans.xsd">

</beans>

간단하지? bean을 설정할 수 있는 xmlns, xmls:xsi, xsi:schemaLocation을 삽입해준게 전부야

 

 

 

 

이번엔 web.xml에서 servlet을 보면 설정 정보 분석해서 controller를 선택해주는 서블릿 경로를 만들어뒀어
servlet-context.xml이건데, 그걸 한 번 해보자고

<?xml version="1.0" encoding="UTF-8"?>
<!-- mvc는 beans:beans로 태그 변경해야 인식함 -->
<beans:beans
	xmlns="http://www.springframework.org/schema/mvc"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xmlns:beans="http://www.springframework.org/schema/beans"
	xmlns:context="http://www.springframework.org/schema/context"
	xsi:schemaLocation="http://www.springframework.org/schema/mvc
						http://www.springframework.org/schema/mvc/spring-mvc.xsd
						http://www.springframework.org/schema/beans
						http://www.springframework.org/schema/beans/spring-beans.xsd
						http://www.springframework.org/schema/context
						http://www.springframework.org/schema/context/spring-context.xsd">


	<!-- 스캔한 패키지 내부 클래스 중 @Controller 있는 클래스 controller로써 로딩하도록 설정 -->
	<annotation-driven />

	<!-- 스캔할 bean들이 모여있는 패키지 지정 -->
	<context:component-scan
		base-package="kr.co.goodee39.controller" />
	<context:component-scan
		base-package="kr.co.goodee39.exception" />

	<!-- Controller의 메서드에서 반환하는 문자열 앞, 뒤에 붙일 경로 정보 셋팅 -->
	<beans:bean
		class="org.springframework.web.servlet.view.InternalResourceViewResolver">
		<beans:property name="prefix" value="/WEB-INF/views/" />
		<beans:property name="suffix" value=".jsp" />
	</beans:bean>


	<!-- 정적파일(img, video, audio) 로드 설정 -->
	<resources mapping="/**" location="/resources/" />
</beans:beans>

Java때랑 내용이 같은데, 표현법이 다른거야
annotaion-driven은 클래스에 @Controller달린걸 찾을 수 있게 도와주는 아이야
context:component-scan으로 controller 찾아낼 경로 설정해주고, 

beans:bean에서는 아까 Java에서 경로 자동으로 /WEB-INF/views/파일명.jsp 완성되도록 설정했어
prefix, suffix가 위치에 따른 설정인거쥐

마찬가지로 정적파일 즉 오디오, 사진, 비디오를 위한 파일을 불러오기 위한 폴더를 설정해주는데
resources로 할 수 있다.
mapping="/**"라는건 어떤 위치이든 뭐 그런 뜻일까...?ㅎㅎㅎㅎ
(이제 알았음.. 모든 경로에 위치한 파일이라는 뜻임!!!)

 

exception패키지에 exception 클래스 넣어두고 @ControllerAdvice로 달아준 것을 읽어오기 위해
@ComponentScan으로 해당 경로를 추가해준다~

 

 

 

 

Controller 클래스 만들기

아까 위에서 web.xml보면 servlet에서 appServlet이란 이름으로 설정한 controller 선택 서블릿이 있는데,
servlet-context.xml라고 파일 하나 만들었좌나,
그리고 @Controller로 지정한 파일 알 수 있도록 annotaion-driven 태그 달아줬고,
context:component-scan으로 controller 찾아낼 경로 설정까지 했으니 이제 @Controller단 클래스를 하나 만들기야

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라는 홈이름이 아까 위에서 servlet-context.xml로 설정한 beans를 통해
prefix="/WEB-INF/views/"와 suffix=".jsp"를 만나 /WEB-INF/views/문자열.jsp가 되는거지

그리고 index.jsp에 이미지가 있다면 resources태그 통해서
src 앞에 /resources/가 콱 붙어주겠지~ 

 

이 아래부터는 Java버전이랑 동일합니다!

 

 

 

 

 

 

 

 

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>
<!-- 예외처리 -->
	<h1>SPRING MVC 예외처리</h1>
	<br />
	<a href="test1">Test1</a><br />
	<a href="test2">Test2</a><br />
</body>
</html>

이동시에 일부러 에러 발생할 메소드를 정의해두었음!
따로 예외처리하지 않은 상황에서는 404에러 화면같이 하얗고, 하늘색이고~ 뭐 블라블라 적힌 내용이 나오겠지?

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

error페이지 만들기

<%@ 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>SPRING MVC 예외처리</h1>
	<br />
	<h1>ArrayIndexOutOfBoundsExceptiond 발생! 주어진 배열의 갯수를 초과합니다!</h1>

</body>
</html>

<%@ 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>SPRING MVC 예외처리</h1>
	<br />
	<h1>NullPointerException 발생! </h1>

</body>
</html>

<%@ 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>SPRING MVC 예외처리</h1>
	<br />
	<h1>rException 발생! </h1>

</body>
</html>

에러는 총 3가지 해볼꾸
하나는 ArrayIndexOutOfBoundsExceptiond, 또 하나는 NullPointerException, 마지막으로 Exception

 

 

 

 

 

 

 

 

 

 

 

에러 발생하지 않는다면 정상적으로 이동될 페이지도 구색 맞추기 위해 만들기

<%@ 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>SPRING MVC 예외처리</h1>
	<br />
	<h1>Test1</h1>
	<h3>arr1 : ${arr1}</h3>
</body>
</html>

<%@ 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>SPRING MVC 예외처리</h1>
	<br />
	<h1>Test2</h1>
	<h3>list : ${list}</h3>
</body>
</html>

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Controller 만들기

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.GetMapping;

@Controller
public class TestController {

	@GetMapping("/test1")
	public String test1(Model model) {
		
		int[] arr1 = {10, 20, 30};
		//정상수행됨
		//model.addAttribute("arr1", arr1[0]);
		
		//일부러 오류 발생시키기
		model.addAttribute("arr1", arr1[10]);
		//ArrayIndexOutOfBoundsException 예외 등장~
		
		return "test1";
	}
	
	//ArrayIndexOutOfBoundsException에러 발생시 이동할 페이지 설정
	@ExceptionHandler(ArrayIndexOutOfBoundsException.class)
	public String exceptionArr() {
		return "error1";
	}
}

이 컨트롤러는 test1에 대한 컨트롤러이고, 지역에러처리로 한 번 만들어 보았다!
일단 arr1는 0, 1, 2만 있는데, 10이라는 인덱스를 추가해서 ArrayIndexOutOfBoundException을 유도했으
에러 발생하면 상단에서 만든 error1페이지로 이동시킬꺼여

 

 

 

 

import java.util.ArrayList;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;

@Controller
public class SecondController {

	@GetMapping("/test2")
	public String test2() {
			ArrayList<String> list = null;
			list.add("문자열");
		
		
		return "test2";
	}
	
	//현재 controller내에서는 ExceptionHandler를 만들지 않았다.
	//GlobalExceptionHandler에서 정의해 사용함
}

이 컨트롤러는 test2에 대한 메소드만 있어
즉, 에러처리가 없는거지
얘는 GlobalExceptionHandler를 생성해서 처리해볼라구!

 

 

 

 

 

 

GlobalExceptionHandler만들기

import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;

//전역으로 예외처리 핸들러를 만들어서 설정하면 controller에 직접 선언하지 않아도 사용가능하다
//RuntimeException을 상속받아서 @ExceptionHandler 설정하면 가능함
//클래스명의 밑줄은 ID를 default값으로 주어야 하는데 주지 않아서 라고함
//주지 않아도 구동은 잘 됨
@ControllerAdvice
public class GlobalExceptionHandler extends RuntimeException {

	//오직 NullPointerException에 대한 예외처리
	@ExceptionHandler(NullPointerException.class)
	public String handleException() {
		
		return "error2";
	}
	
	//모~든 에러에 대해 error3으로 보내는 예외처리
	@ExceptionHandler(Exception.class)
	public String handlerGlobalException() {
		return "error3";
	}
	
	//국소 예외처리과 전역 예외처리 둘 다 설정하면 뭐가 나올까?
	//Expception보다 특정Exception으로 정의한 것이 우선하기 때문에
	//특정Exception 예외처리 정의되었다면 그 예외처리를 따름
	//없다면 그 때 Exception 예외처리를 따름
}

전역으로 에러를 처리하기 위해 클래스 하나 파고, RuntimeException을 상속받아줘
그리고 이 클래스에 @ControllerAdvice 어노테이션을 달아주면 환상의 전역 Exception Handler 뚝딱

이제 그 아래 @ExceptionHandler 어노테이션과 (에러타입.class)로 정의해주면 해당 에러에 대한 처리를 담당하는 핸들러가 전역으로 적용되는거여
하나는 handlerException은 NullPointerException만을 담당하고,
handlerGlobalException은 전~~체 Exception을 담당할거야

근데 잠깐, 특정 예외 담당 핸들러와 전~체 에러 다 처리해주는 핸들러가 둘 다 존재하면
특정 예외 발생했을 때 어떤 핸들러가 작동할까?

미리 그냥 답을 얘기헌다
주석에도 있잖아

특정 예외처리 핸들러가 작동함!
특정되는 예외처리가 없을 때만 전~체 예외처리 담당 핸들러가 작동함!

 

 

 

 

 

 

 

 

 

home으로 만들었던 index페이지에서 진짜 이동 되는지 한 번 해보자!

Run on Server를 클릭해주쟈

 

결과