Java Web 错误/异常处理页面(更新)

简介: 更新!!之前的代码严重过度设计!!现修正只是一张 jsp 即可。 错误页面 code:${requestScope['javax.servlet.error.status_code']} body { max-width: 600px; min-width:...

更新!!之前的代码严重过度设计!!现修正只是一张 jsp 即可。

<%@page pageEncoding="UTF-8" isErrorPage="true" import="java.io.*"%>
<%!/**
	 * 收集错误信息 输出到网页
	 * 
	 * @param request
	 *            请求对象
	 */
	public static OutputStream getError(HttpServletRequest request, Throwable ex) {
		try(
			OutputStream os = new ByteArrayOutputStream();// 创建一个空的字节流,保存错误信息
			PrintStream ps = new PrintStream(os);
		){
			// 收集错误信息
			ps.println("错误代码: " +     request.getAttribute("javax.servlet.error.status_code")); 
			ps.println("异常 Servlet: " + request.getAttribute("javax.servlet.error.servlet_name"));
			ps.println("出错页面地址: " + request.getAttribute("javax.servlet.error.request_uri"));
			ps.println("访问的路径: " + 	 request.getAttribute("javax.servlet.forward.request_uri"));
			ps.println();
	
			for (String key : request.getParameterMap().keySet()) {
				ps.println("请求中的 Parameter 包括:");
				ps.println(key + "=" + request.getParameter(key));
				ps.println();
			}
			
			for (Cookie cookie : request.getCookies()) {
				ps.println("请求中的 Cookie 包括:");
				ps.println(cookie.getName() + "=" + cookie.getValue());
				ps.println();
			}
	
			// javax.servlet.jspException 等于 JSP 里面的 exception 对象
			if (ex != null) { 
				ps.println("堆栈信息");
				ex.printStackTrace(ps);
				ps.println();
			}

			return os; 
		} catch (IOException e) {
			e.printStackTrace();
			return null;
		}
	}
%>
<!DOCTYPE html>
<html>
<head>
	<meta charset="utf-8" />
	<title>错误页面 code:${requestScope['javax.servlet.error.status_code']}</title>
	<style>
		body {
			max-width: 600px;
			min-width: 320px;
			margin: 0 auto;
			padding-top: 2%;
		}
		textarea {
			width: 100%;
			min-height: 300px;
			outline:none;
			border:1px solid gray;
			padding:1%;
		}
		h1 {
			text-align: right;
			color: lightgray;
		}
		div {
			margin-top: 1%;
		}
	</style>
</head>
<body>
	<h1>抱 歉……</h1>
	<div style="padding:2% 0;text-indent:2em;">尊敬的用户:我们致力于提供更好的服务,但人算不如天算,有些错误发生了,希望是在控制的范围内。如果问题重复出现,请向系统管理员反馈。</div>
	<textarea><%
	 out.print(getError(request, exception));
%></textarea>
	<div align="center">
			<a href="${pageContext.request.contextPath}">回首页</a> | <a href="javascript:history.go(-1);">上一页</a>
	</div>
</body>
</html>

------------------------------------------------------------------------------------------------------------------------------------

发生服务器 500 异常,如果默认方式处理,则是将异常捕获之后跳到 Tomcat 缺省的异常页面,如下图所示。


不论哪个网站都是一样的,所以为了满足自定义的需要,Tomcat 也允许自定义样式的。也就是在 web.xml 文件中配置:

<error-page>
	<error-code>500</error-code>
	<location>/error.jsp</location>
</error-page>

首先说说自带的逻辑。如果某个 JSP 页面在执行的过程中出现了错误, 那么 JSP 引擎会自动产生一个异常对象,如果这个 JSP 页面指定了另一个 JSP 页面为错误处理程序,那么 JSP 引擎会将这个异常对象放入到 request 对象中,传到错误处理程序中。如果大家有写 Servlet 的印象,这是和那个转向模版 JSP 的 javax.servlet.forward.request_uri 一个思路,保留了原请求的路径而不是 JSP 页面的那个路径。在错误处理程序里,因为 page 编译指令的 isErrorPage 属性的值被设为 true,那么 JSP 引擎会自动声明一个 exception 对象,这个 exception 对象从 request 对象所包含的 HTTP 参数中获得。

request 对象中包含的异常信息非常丰富,如下所示:

javax.servlet.error.status_code             类型为Integer        错误状态代码
javax.servlet.error.exception_type          类型为Class          异常的类型
javax.servlet.error.message                 类型为String         异常的信息
javax.servlet.error.exception               类型为Throwable      异常类
javax.servlet.error.request_uri             类型为String         异常出现的页面
javax.servlet.error.servlet_name            类型为String         异常出现的servlet名
你可以用 Java 语句 request.getAttribute("javax.servlet.error.status_code") 获取,也可以在 JSP 页面中通过 EL 表达式来获取,如 ${requestScope["javax.servlet.error.status_code"]}。

这个自定义错误页面虽然简单,JSP 本身也有很好的封装结果,我也看过别人不少的资源,但细究之下也有不少“学问”,于是我想重新再”磨磨这个轮子“——首先 location 是一个 jsp 页面,也可以是 servlet,不过万一 servlet 也有可能启动不起来的话那就使用简单的 JSP 页面就好了。我们通过 JSP 页面定义内部类的方法,达到页面与逻辑的分离(无须编写 servlet)。其余的思路如下:

  • 在 JSP 里面完成 ErrorHandler 类,另有页面调用这个 ErrorHandler 类
  • 不但可以接受 JSP 页面的错误,也可接受 servlet 的控制器传递的错误,并且提取尽量多信息
  • 全部内容先写到内存,然后分别从两个输出流再输出到页面和文件
  • 把错误信息输出到网页的同时,简单加几句话,可以把网页上的信息也写一份到数据库或者文本
  • 可以返回 HTML/JSON/XML

实现代码如下:

	
/**
 * 异常处理类
*/
class ErrorHandler {
	// 全部内容先写到内存,然后分别从两个输出流再输出到页面和文件
	private ByteArrayOutputStream byteArrayOutputStream = new ByteArrayOutputStream();
	private PrintStream printStream = new PrintStream(byteArrayOutputStream);

	/**
	 * 收集错误信息
	 * @param request
	 * @param exception
	 * @param out
	 */
	public ErrorHandler(HttpServletRequest request, Throwable exception, JspWriter out) {
		setRequest(request);
		setException(exception);

		if(out != null) {
			try {
				out.print(byteArrayOutputStream); // 输出到网页
			} catch (IOException e) {
				e.printStackTrace();
			}
		}
		
		 log(request);
		
		if(byteArrayOutputStream != null)
			try {
				byteArrayOutputStream.close();
			} catch (IOException e) {
				e.printStackTrace();
			}
		if(printStream != null) printStream.close();
	}

	/**
	 * 
	 * @param request
	 */
	private void setRequest(HttpServletRequest request) {
		printStream.println();
		printStream.println("用户账号:" + request.getSession().getAttribute("userName"));
		printStream.println("访问的路径: "   + getInfo(request, "javax.servlet.forward.request_uri", String.class));
		printStream.println("出错页面地址: " + getInfo(request, "javax.servlet.error.request_uri", String.class));
		printStream.println("错误代码: "     + getInfo(request, "javax.servlet.error.status_code", int.class));
		printStream.println("异常的类型: "   + getInfo(request, "javax.servlet.error.exception_type", Class.class));
		printStream.println("异常的信息: "   + getInfo(request, "javax.servlet.error.message", String.class));
		printStream.println("异常servlet: "  + getInfo(request, "javax.servlet.error.servlet_name", String.class));
		printStream.println();
		
		// 另外两个对象
		getInfo(request, "javax.servlet.jspException", Throwable.class);
		getInfo(request, "javax.servlet.forward.jspException", Throwable.class);

		Map<String, String[]> map = request.getParameterMap();

		for (String key : map.keySet()) {
			printStream.println("请求中的 Parameter 包括:");
			printStream.println(key + "=" + request.getParameter(key));
			printStream.println();
		}
		
		for (Cookie cookie : request.getCookies()){  // cookie.getValue()
			printStream.println("请求中的 Cookie 包括:");
			printStream.println(cookie.getName() + "=" + cookie.getValue());
			printStream.println();
		}

	}

	/**
	 * 
	 * @param exception
	 */
	private void setException(Throwable exception) {
		if (exception != null) {
			printStream.println("异常信息");
			printStream.println(exception.getClass() + " : " + exception.getMessage());
			printStream.println();

			printStream.println("堆栈信息");
			exception.printStackTrace(printStream);
			printStream.println();
		}
	}

		/**
		 * 
		 * @param request
		 */
		private void log(HttpServletRequest request) {
 			File dir = new File(request.getSession().getServletContext().getRealPath("/errorLog"));
 			if (!dir.exists()) {
 				dir.mkdir();
 			}
			
 			String timeStamp = new java.text.SimpleDateFormat("yyyyMMddhhmmssS").format(new Date());
 			File file = new File(dir.getAbsolutePath() + File.separatorChar + "error-" + timeStamp + ".txt");
			
//  			try(FileOutputStream fileOutputStream = new FileOutputStream(file);
//  				PrintStream ps = new PrintStream(fileOutputStream)){// 写到文件
//  				ps.print(byteArrayOutputStream);
//  			} catch (FileNotFoundException e) {
//  				e.printStackTrace();
//  			} catch (IOException e) {
//  				e.printStackTrace();
//  			} catch (Exception e){
//  				e.printStackTrace();
//  			}
		}

		/**
		 * 
		 * @param request
		 * @param key
		 * @param type
		 * @return
		 */
		@SuppressWarnings("unchecked")
		private <T> T getInfo(HttpServletRequest request, String key, Class<T> type){
			Object obj = request.getAttribute(key);
			return obj == null ? null : (T) obj;
		} 
}

这样就可以完成异常的控制了。下面定义 web.xml,让 tomcat 出错引向我们刚才指定的页面 error.jsp

<!-- 404 页面不存在错误 -->
<error-page>
	<error-code>404</error-code>
	<location>/WEB-INF/jsp/common/default/error.jsp</location>
</error-page>
<!-- // -->

<!-- 500 服务器内部错误 -->
<error-page>
	<error-code>500</error-code>
	<location>/WEB-INF/jsp/common/default/error.jsp</location>
</error-page>
<!-- // -->

我们安排一个默认的页面如下

源码如下:

<%@page pageEncoding="UTF-8" isErrorPage="true"%>
<%@ include file="/WEB-INF/jsp/common/ClassicJSP/util.jsp"%>
<!DOCTYPE html>
<html>
<head>
	<title>错误页面</title>
	<style>
		body {
			max-width: 600px;
			min-width: 320px;
			margin: 0 auto;
			padding-top: 2%;
		}
		
		textarea {
			width: 100%;
			min-height: 300px;
		}
		
		h1 {
			text-align: right;
			color: lightgray;
		}
		
		div {
			margin-top: 1%;
		}
	</style>
</head>
<body>
	<h1>抱 歉!</h1>
	<div style="padding:2% 0;text-indent:2em;">尊敬的用户:我们致力于提供更好的服务,但人算不如天算,有些错误发生了,希望是在控制的范围内……如果问题重复出现,请向系统管理员反馈。</div>
	<textarea><%
           	new ErrorHandler(request, exception, out);
           %></textarea>
	<div>
		<center>
			<a href="${pageContext.request.contextPath}">回首页</a> | <a href="javascript:history.go(-1);">上一页</a>
		</center>
	</div>
</body>
</html>

目录
相关文章
|
20天前
|
Java 编译器
探索Java中的异常处理机制
【10月更文挑战第35天】在Java的世界中,异常是程序运行过程中不可避免的一部分。本文将通过通俗易懂的语言和生动的比喻,带你了解Java中的异常处理机制,包括异常的类型、如何捕获和处理异常,以及如何在代码中有效地利用异常处理来提升程序的健壮性。让我们一起走进Java的异常世界,学习如何优雅地面对和解决问题吧!
|
8天前
|
安全 Java 程序员
Java中的异常处理:从新手到专家
在Java编程的世界里,异常处理是每个开发者必须面对的挑战。本文将带你从基础的异常概念出发,逐步深入到高级处理技巧,让你在遇到代码中的“意外”时,能够从容应对,甚至化险为夷。
|
13天前
|
Java 数据库连接 开发者
Java中的异常处理:从基础到高级
【10月更文挑战第42天】在Java的世界中,异常处理是维护程序稳定性和健壮性的关键。本文将带你深入了解Java的异常处理机制,从基本的try-catch语句出发,逐步探索更复杂的异常处理策略。我们将通过实际代码示例来演示如何捕获和处理异常,以及如何自定义异常类型来满足特定需求。无论你是Java新手还是有经验的开发者,这篇文章都将帮助你更好地理解和应用Java的异常处理。
|
20天前
|
Java 开发者
Java中的异常处理:从基础到高级
【10月更文挑战第35天】在Java的世界里,异常处理是维护程序健壮性的关键。本文将深入浅出地探讨Java的异常处理机制,从基本的try-catch语句到自定义异常类的实现,带领读者理解并掌握如何在Java中优雅地处理错误和异常。我们将通过实际代码示例,展示如何捕获、处理以及预防潜在的运行时错误,确保程序即使在面临意外情况时也能保持稳定运行。
33 7
|
21天前
|
Java Maven Spring
Java Web 应用中,资源文件的位置和加载方式
在Java Web应用中,资源文件如配置文件、静态文件等通常放置在特定目录下,如WEB-INF或classes。通过类加载器或Servlet上下文路径可实现资源的加载与访问。正确管理资源位置与加载方式对应用的稳定性和可维护性至关重要。
|
19天前
|
Java 数据库连接 开发者
Java中的异常处理机制及其最佳实践####
在本文中,我们将探讨Java编程语言中的异常处理机制。通过深入分析try-catch语句、throws关键字以及自定义异常的创建与使用,我们旨在揭示如何有效地管理和响应程序运行中的错误和异常情况。此外,本文还将讨论一些最佳实践,以帮助开发者编写更加健壮和易于维护的代码。 ####
|
23天前
|
Java
Java 异常处理下篇:11 个异常处理最佳实践
本文深入探讨了 Java 异常处理的最佳实践,包括早抛出晚捕获、只捕获可处理的异常、不要忽略捕获的异常、抛出具体检查性异常、正确包装自定义异常、记录或抛出异常但不同时执行、避免在 `finally` 块中抛出异常、避免使用异常进行流程控制、使用模板方法处理重复的 `try-catch`、尽量只抛出与方法相关的异常以及异常处理后清理资源。通过遵循这些实践,可以提高代码的健壮性和可维护性。
|
24天前
|
存储 安全 搜索推荐
理解Session和Cookie:Java Web开发中的用户状态管理
理解Session和Cookie:Java Web开发中的用户状态管理
47 4
|
24天前
|
Java 编译器 开发者
Java异常处理的最佳实践,涵盖理解异常类体系、选择合适的异常类型、提供详细异常信息、合理使用try-catch和finally语句、使用try-with-resources、记录异常信息等方面
本文探讨了Java异常处理的最佳实践,涵盖理解异常类体系、选择合适的异常类型、提供详细异常信息、合理使用try-catch和finally语句、使用try-with-resources、记录异常信息等方面,帮助开发者提高代码质量和程序的健壮性。
45 2
|
25天前
|
Java 程序员 数据库连接
深入浅出Java异常处理
【10月更文挑战第30天】在Java的世界里,异常处理就像是生活中的急救箱,遇到意外时能及时救治。本文不仅教你如何使用try-catch语句包扎“伤口”,还会深入讲解如何通过自定义异常来应对那些常见的“头疼脑热”。准备好,我们将一起探索Java异常处理的奥秘,让你的程序更加健壮。