View Javadoc

1   //
2   //  ========================================================================
3   //  Copyright (c) 1995-2016 Mort Bay Consulting Pty. Ltd.
4   //  ------------------------------------------------------------------------
5   //  All rights reserved. This program and the accompanying materials
6   //  are made available under the terms of the Eclipse Public License v1.0
7   //  and Apache License v2.0 which accompanies this distribution.
8   //
9   //      The Eclipse Public License is available at
10  //      http://www.eclipse.org/legal/epl-v10.html
11  //
12  //      The Apache License v2.0 is available at
13  //      http://www.opensource.org/licenses/apache2.0.php
14  //
15  //  You may elect to redistribute this code under either of these licenses.
16  //  ========================================================================
17  //
18  
19  package org.eclipse.jetty.server.handler;
20  
21  import java.io.IOException;
22  import java.io.PrintWriter;
23  import java.io.StringWriter;
24  import java.io.Writer;
25  import java.nio.ByteBuffer;
26  import java.nio.charset.Charset;
27  import java.nio.charset.StandardCharsets;
28  import java.util.List;
29  
30  import javax.servlet.RequestDispatcher;
31  import javax.servlet.ServletException;
32  import javax.servlet.http.HttpServletRequest;
33  import javax.servlet.http.HttpServletResponse;
34  
35  import org.eclipse.jetty.http.HttpFields;
36  import org.eclipse.jetty.http.HttpHeader;
37  import org.eclipse.jetty.http.HttpMethod;
38  import org.eclipse.jetty.http.HttpStatus;
39  import org.eclipse.jetty.http.MimeTypes;
40  import org.eclipse.jetty.server.Dispatcher;
41  import org.eclipse.jetty.server.Request;
42  import org.eclipse.jetty.server.Server;
43  import org.eclipse.jetty.util.BufferUtil;
44  import org.eclipse.jetty.util.StringUtil;
45  import org.eclipse.jetty.util.log.Log;
46  import org.eclipse.jetty.util.log.Logger;
47  
48  /* ------------------------------------------------------------ */
49  /** Handler for Error pages
50   * An ErrorHandler is registered with {@link ContextHandler#setErrorHandler(ErrorHandler)} or
51   * {@link org.eclipse.jetty.server.Server#addBean(Object)}.
52   * It is called by the HttpResponse.sendError method to write a error page via {@link #handle(String, Request, HttpServletRequest, HttpServletResponse)}
53   * or via {@link #badMessageError(int, String, HttpFields)} for bad requests for which a dispatch cannot be done.
54   *
55   */
56  public class ErrorHandler extends AbstractHandler
57  {    
58      private static final Logger LOG = Log.getLogger(ErrorHandler.class);
59      public final static String ERROR_PAGE="org.eclipse.jetty.server.error_page";
60      
61      boolean _showStacks=true;
62      boolean _showMessageInTitle=true;
63      String _cacheControl="must-revalidate,no-cache,no-store";
64  
65      /* ------------------------------------------------------------ */
66      /*
67       * @see org.eclipse.jetty.server.server.Handler#handle(javax.servlet.http.HttpServletRequest, javax.servlet.http.HttpServletResponse, int)
68       */
69      @Override
70      public void handle(String target, Request baseRequest, HttpServletRequest request, HttpServletResponse response) throws IOException
71      {
72          String method = request.getMethod();
73          if (!HttpMethod.GET.is(method) && !HttpMethod.POST.is(method) && !HttpMethod.HEAD.is(method))
74          {
75              baseRequest.setHandled(true);
76              return;
77          }
78          
79          if (this instanceof ErrorPageMapper)
80          {
81              String error_page=((ErrorPageMapper)this).getErrorPage(request);
82              if (error_page!=null && request.getServletContext()!=null)
83              {
84                  String old_error_page=(String)request.getAttribute(ERROR_PAGE);
85                  if (old_error_page==null || !old_error_page.equals(error_page))
86                  {
87                      request.setAttribute(ERROR_PAGE, error_page);
88  
89                      Dispatcher dispatcher = (Dispatcher) request.getServletContext().getRequestDispatcher(error_page);
90                      try
91                      {
92                          if(dispatcher!=null)
93                          {
94                              dispatcher.error(request, response);
95                              return;
96                          }
97                          LOG.warn("No error page "+error_page);
98                      }
99                      catch (ServletException e)
100                     {
101                         LOG.warn(Log.EXCEPTION, e);
102                         return;
103                     }
104                 }
105             } 
106             else 
107             {
108                 if (LOG.isDebugEnabled())
109                 {
110                     LOG.debug("No Error Page mapping for request({} {}) (using default)",request.getMethod(),request.getRequestURI());
111                 }
112             }
113         }
114 
115         if (_cacheControl != null)
116             response.setHeader(HttpHeader.CACHE_CONTROL.asString(), _cacheControl);
117         generateAcceptableResponse(baseRequest,request,response,response.getStatus(),baseRequest.getResponse().getReason());
118     }
119 
120     /** 
121      * Generate an acceptable error response.
122      * <p>This method is called to generate an Error page of a mime type that is 
123      * acceptable to the user-agent.  The Accept header is evaluated in 
124      * quality order and the method 
125      * {@link #generateAcceptableResponse(Request, HttpServletRequest, HttpServletResponse, int, String, String)}
126      * is called for each mimetype until {@link Request#isHandled()} is true.</p>
127      * @param baseRequest The base request
128      * @param request The servlet request (may be wrapped)
129      * @param response The response (may be wrapped)
130      * @throws IOException if the response cannot be generated
131      */
132     protected void generateAcceptableResponse(Request baseRequest, HttpServletRequest request, HttpServletResponse response, int code, String message)
133         throws IOException
134     {
135         List<String> acceptable=baseRequest.getHttpFields().getQualityCSV(HttpHeader.ACCEPT);
136         
137         if (acceptable.isEmpty() && !baseRequest.getHttpFields().contains(HttpHeader.ACCEPT))
138             generateAcceptableResponse(baseRequest,request,response,code,message,MimeTypes.Type.TEXT_HTML.asString());
139         else
140         {
141             for (String mimeType:acceptable)
142             {
143                 generateAcceptableResponse(baseRequest,request,response,code,message,mimeType);
144                 if (baseRequest.isHandled())
145                     return;
146             }
147         }
148         baseRequest.setHandled(true);
149     }
150 
151     /** 
152      * Returns an acceptable writer for an error page.
153      * <p>Uses the user-agent's <code>Accept-Charset</code> to get response
154      * {@link Writer}.  The acceptable charsets are tested in quality order 
155      * if they are known to the JVM and the first known is set on
156      * {@link HttpServletResponse#setCharacterEncoding(String)} and the 
157      * {@link HttpServletResponse#getWriter()} method used to return a writer.
158      * If there is no <code>Accept-Charset</code> header then 
159      * <code>ISO-8859-1</code> is used.  If '*' is the highest quality known
160      * charset, then <code>utf-8</code> is used.
161      * </p>     
162      * @param baseRequest The base request
163      * @param request The servlet request (may be wrapped)
164      * @param response The response (may be wrapped)
165      * @return A {@link Writer} if there is a known acceptable charset or null
166      * @throws IOException if a Writer cannot be returned
167      */
168     protected Writer getAcceptableWriter(Request baseRequest, HttpServletRequest request, HttpServletResponse response)
169         throws IOException
170     {
171         List<String> acceptable=baseRequest.getHttpFields().getQualityCSV(HttpHeader.ACCEPT_CHARSET);
172         if (acceptable.isEmpty())
173         {
174             response.setCharacterEncoding(StandardCharsets.ISO_8859_1.name());
175             return response.getWriter();
176         }
177         
178         for (String charset:acceptable)
179         {
180             try
181             {
182                 if ("*".equals(charset))
183                     response.setCharacterEncoding(StandardCharsets.UTF_8.name());
184                 else
185                     response.setCharacterEncoding(Charset.forName(charset).name());
186                 return response.getWriter();
187             }
188             catch(Exception e)
189             {
190                 LOG.ignore(e);
191             }
192         }
193         return null;
194     }
195         
196     /* ------------------------------------------------------------ */
197     /** Generate an acceptable error response for a mime type.
198      * <p>This method is called for each mime type in the users agent's
199      * <code>Accept</code> header, until {@link Request#isHandled()} is true and a 
200      * response of the appropriate type is generated.
201      * 
202      * @param baseRequest The base request
203      * @param request The servlet request (may be wrapped)
204      * @param response The response (may be wrapped)
205      * @param mimeType The mimetype to generate (may be *&#47;*or other wildcard)
206      * @throws IOException if a response cannot be generated
207      */
208     protected void generateAcceptableResponse(Request baseRequest, HttpServletRequest request, HttpServletResponse response, int code, String message, String mimeType)
209         throws IOException
210     {
211         switch(mimeType)
212         {
213             case "text/html":
214             case "text/*":
215             case "*/*":
216             {
217                 baseRequest.setHandled(true);
218                 Writer writer = getAcceptableWriter(baseRequest,request,response);
219                 if (writer!=null)
220                 {
221                     response.setContentType(MimeTypes.Type.TEXT_HTML.asString());
222                     handleErrorPage(request, writer, code, message);
223                 }
224             }
225         }        
226     }
227     
228     /* ------------------------------------------------------------ */
229     protected void handleErrorPage(HttpServletRequest request, Writer writer, int code, String message)
230         throws IOException
231     {
232         writeErrorPage(request, writer, code, message, _showStacks);
233     }
234 
235     /* ------------------------------------------------------------ */
236     protected void writeErrorPage(HttpServletRequest request, Writer writer, int code, String message, boolean showStacks)
237         throws IOException
238     {
239         if (message == null)
240             message=HttpStatus.getMessage(code);
241 
242         writer.write("<html>\n<head>\n");
243         writeErrorPageHead(request,writer,code,message);
244         writer.write("</head>\n<body>");
245         writeErrorPageBody(request,writer,code,message,showStacks);
246         writer.write("\n</body>\n</html>\n");
247     }
248 
249     /* ------------------------------------------------------------ */
250     protected void writeErrorPageHead(HttpServletRequest request, Writer writer, int code, String message)
251         throws IOException
252         {
253         writer.write("<meta http-equiv=\"Content-Type\" content=\"text/html;charset=utf-8\"/>\n");
254         writer.write("<title>Error ");
255         writer.write(Integer.toString(code));
256 
257         if (_showMessageInTitle)
258         {
259             writer.write(' ');
260             write(writer,message);
261         }
262         writer.write("</title>\n");
263     }
264 
265     /* ------------------------------------------------------------ */
266     protected void writeErrorPageBody(HttpServletRequest request, Writer writer, int code, String message, boolean showStacks)
267         throws IOException
268     {
269         String uri= request.getRequestURI();
270 
271         writeErrorPageMessage(request,writer,code,message,uri);
272         if (showStacks)
273             writeErrorPageStacks(request,writer);
274 
275         Request.getBaseRequest(request).getHttpChannel().getHttpConfiguration()
276             .writePoweredBy(writer,"<hr>","<hr/>\n");
277     }
278 
279     /* ------------------------------------------------------------ */
280     protected void writeErrorPageMessage(HttpServletRequest request, Writer writer, int code, String message,String uri)
281     throws IOException
282     {
283         writer.write("<h2>HTTP ERROR ");
284         writer.write(Integer.toString(code));
285         writer.write("</h2>\n<p>Problem accessing ");
286         write(writer,uri);
287         writer.write(". Reason:\n<pre>    ");
288         write(writer,message);
289         writer.write("</pre></p>");
290     }
291 
292     /* ------------------------------------------------------------ */
293     protected void writeErrorPageStacks(HttpServletRequest request, Writer writer)
294         throws IOException
295     {
296         Throwable th = (Throwable)request.getAttribute(RequestDispatcher.ERROR_EXCEPTION);
297         while(th!=null)
298         {
299             writer.write("<h3>Caused by:</h3><pre>");
300             StringWriter sw = new StringWriter();
301             PrintWriter pw = new PrintWriter(sw);
302             th.printStackTrace(pw);
303             pw.flush();
304             write(writer,sw.getBuffer().toString());
305             writer.write("</pre>\n");
306 
307             th =th.getCause();
308         }
309     }
310 
311     /* ------------------------------------------------------------ */
312     /** Bad Message Error body
313      * <p>Generate a error response body to be sent for a bad message.
314      * In this case there is something wrong with the request, so either
315      * a request cannot be built, or it is not safe to build a request.
316      * This method allows for a simple error page body to be returned 
317      * and some response headers to be set.
318      * @param status The error code that will be sent
319      * @param reason The reason for the error code (may be null)
320      * @param fields The header fields that will be sent with the response.
321      * @return The content as a ByteBuffer, or null for no body.
322      */
323     public ByteBuffer badMessageError(int status, String reason, HttpFields fields)
324     {
325         if (reason==null)
326             reason=HttpStatus.getMessage(status);
327         fields.put(HttpHeader.CONTENT_TYPE,MimeTypes.Type.TEXT_HTML_8859_1.asString());
328         return BufferUtil.toBuffer("<h1>Bad Message " + status + "</h1><pre>reason: " + reason + "</pre>");
329     }    
330     
331     /* ------------------------------------------------------------ */
332     /** Get the cacheControl.
333      * @return the cacheControl header to set on error responses.
334      */
335     public String getCacheControl()
336     {
337         return _cacheControl;
338     }
339 
340     /* ------------------------------------------------------------ */
341     /** Set the cacheControl.
342      * @param cacheControl the cacheControl header to set on error responses.
343      */
344     public void setCacheControl(String cacheControl)
345     {
346         _cacheControl = cacheControl;
347     }
348 
349     /* ------------------------------------------------------------ */
350     /**
351      * @return True if stack traces are shown in the error pages
352      */
353     public boolean isShowStacks()
354     {
355         return _showStacks;
356     }
357 
358     /* ------------------------------------------------------------ */
359     /**
360      * @param showStacks True if stack traces are shown in the error pages
361      */
362     public void setShowStacks(boolean showStacks)
363     {
364         _showStacks = showStacks;
365     }
366 
367     /* ------------------------------------------------------------ */
368     /**
369      * @param showMessageInTitle if true, the error message appears in page title
370      */
371     public void setShowMessageInTitle(boolean showMessageInTitle)
372     {
373         _showMessageInTitle = showMessageInTitle;
374     }
375 
376 
377     /* ------------------------------------------------------------ */
378     public boolean getShowMessageInTitle()
379     {
380         return _showMessageInTitle;
381     }
382 
383     /* ------------------------------------------------------------ */
384     protected void write(Writer writer,String string)
385         throws IOException
386     {
387         if (string==null)
388             return;
389 
390         writer.write(StringUtil.sanitizeXmlString(string));
391     }
392 
393     /* ------------------------------------------------------------ */
394     public interface ErrorPageMapper
395     {
396         String getErrorPage(HttpServletRequest request);
397     }
398 
399     /* ------------------------------------------------------------ */
400     public static ErrorHandler getErrorHandler(Server server, ContextHandler context)
401     {
402         ErrorHandler error_handler=null;
403         if (context!=null)
404             error_handler=context.getErrorHandler();
405         if (error_handler==null && server!=null)
406             error_handler = server.getBean(ErrorHandler.class);
407         return error_handler;
408     }
409 }