01: /*
02: * Copyright (c) 1998-2008 Caucho Technology -- all rights reserved
03: *
04: * This file is part of Resin(R) Open Source
05: *
06: * Each copy or derived work must preserve the copyright notice and this
07: * notice unmodified.
08: *
09: * Resin Open Source is free software; you can redistribute it and/or modify
10: * it under the terms of the GNU General Public License version 2
11: * as published by the Free Software Foundation.
12: *
13: * Resin Open Source is distributed in the hope that it will be useful,
14: * but WITHOUT ANY WARRANTY; without even the implied warranty of
15: * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE, or any warranty
16: * of NON-INFRINGEMENT. See the GNU General Public License for more
17: * details.
18: *
19: * You should have received a copy of the GNU General Public License
20: * along with Resin Open Source; if not, write to the
21: *
22: * Free Software Foundation, Inc.
23: * 59 Temple Place, Suite 330
24: * Boston, MA 02111-1307 USA
25: *
26: * @author Scott Ferguson
27: */
28:
29: package javax.faces.application;
30:
31: import java.io.*;
32: import java.util.*;
33:
34: import javax.faces.*;
35: import javax.faces.component.*;
36: import javax.faces.context.*;
37:
38: public abstract class ViewHandler {
39: public static final String CHARACTER_ENCODING_KEY = "javax.faces.request.charset";
40: public static final String DEFAULT_SUFFIX = ".jsp";
41: public static final String DEFAULT_SUFFIX_PARAM_NAME = "javax.faces.DEFAULT_SUFFIX";
42:
43: public abstract Locale calculateLocale(FacesContext context);
44:
45: public String calculateCharacterEncoding(FacesContext context) {
46: return "UTF-8";
47: }
48:
49: public abstract String calculateRenderKitId(FacesContext context);
50:
51: public abstract UIViewRoot createView(FacesContext context,
52: String viewId);
53:
54: public abstract String getActionURL(FacesContext context,
55: String viewId);
56:
57: public abstract String getResourceURL(FacesContext context,
58: String path);
59:
60: public void initView(FacesContext context) throws FacesException {
61: try {
62: String encoding = calculateCharacterEncoding(context);
63:
64: if (encoding != null)
65: context.getExternalContext()
66: .setRequestCharacterEncoding(encoding);
67: } catch (RuntimeException e) {
68: throw e;
69: } catch (Exception e) {
70: throw new FacesException(e);
71: }
72: }
73:
74: public abstract void renderView(FacesContext context,
75: UIViewRoot viewToRender) throws IOException, FacesException;
76:
77: public abstract UIViewRoot restoreView(FacesContext context,
78: String viewId) throws FacesException;
79:
80: public abstract void writeState(FacesContext context)
81: throws IOException;
82: }
|