public ActionException(int errorCode, String errorView) {
if (StrKit.isBlank(errorView))
throw new IllegalArgumentException("The parameter errorView can not be blank.");
this.errorCode = errorCode;
this.errorRender = RenderFactory.me().getErrorRender(errorCode, errorView);
}
public static void renderError404(
String view, HttpServletRequest request, HttpServletResponse response, boolean[] isHandled) {
isHandled[0] = true;
response.setStatus(HttpServletResponse.SC_NOT_FOUND);
RenderFactory.me().getRender(view).setContext(request, response).render();
}
/** Redirect to url */
public void redirect(String url, boolean withQueryString) {
if (setFlashFalg) {
String actionPath = this.request.getRequestURI();
String newActionPath = parsePath(actionPath, url);
flashManager.updateFlashKey(this.getSession(false), actionPath, newActionPath);
setFlashFalg = false;
}
render = renderFactory.getRedirectRender(url, withQueryString);
}
/** Render with url and 301 status */
public void redirect301(String url) {
render = renderFactory.getRedirect301Render(url);
}
/** Render with view and status use default type Render configured in JFinalConfig */
public void render(String view, int status) {
render = renderFactory.getRender(view);
response.setStatus(status);
}
/** Render with file */
public void renderFile(File file) {
render = renderFactory.getFileRender(file);
}
/** Render with file */
public void renderFile(String fileName) {
render = renderFactory.getFileRender(fileName);
}
/** Render with view use default type Render configured in JFinalConfig */
public void render(String view) {
render = renderFactory.getRender(view);
}
/** Render with html text. The contentType is: "text/html". */
public void renderHtml(String htmlText) {
render = renderFactory.getHtmlRender(htmlText);
}
/** Render nothing, no response to browser */
public void renderNull() {
render = renderFactory.getNullRender();
}
/**
* Render with json text.
*
* <p>Example: renderJson("{\"message\":\"Please input password!\"}");
*/
public void renderJson(String jsonText) {
render = renderFactory.getJsonRender(jsonText);
}
/**
* Render with attributes set by setAttr(...) before.
*
* <p>Example: renderJson(new String[]{"blogList", "user"});
*/
public void renderJson(String[] attrs) {
render = renderFactory.getJsonRender(attrs);
}
/** Render with json */
public void renderJson() {
render = renderFactory.getJsonRender();
}
/**
* Render with json
*
* <p>Example:<br>
* renderJson("message", "Save successful");<br>
* renderJson("users", users);<br>
*/
public void renderJson(String key, Object value) {
render = renderFactory.getJsonRender(key, value);
}
/** Render with velocity view */
public void renderVelocity(String view) {
render = renderFactory.getVelocityRender(view);
}
/** Render with freemarker view */
public void renderFreeMarker(String view) {
render = renderFactory.getFreeMarkerRender(view);
}
/** Render with jsp view */
public void renderJsp(String view) {
render = renderFactory.getJspRender(view);
}
/** Render with url and 301 status */
public void redirect301(String url, boolean withQueryString) {
render = renderFactory.getRedirect301Render(url, withQueryString);
}
/** Render with view and errorCode status configured in JFinalConfig */
public void renderError(int errorCode) {
throw new ActionException(errorCode, renderFactory.getErrorRender(errorCode));
}
/**
* Render json with object.
*
* <p>Example: renderJson(new User().set("name", "JFinal").set("age", 18));
*/
public void renderJson(Object object) {
render = renderFactory.getJsonRender(object);
}
/** Render with javascript text. The contentType is: "text/javascript". */
public void renderJavascript(String javascriptText) {
render = renderFactory.getJavascriptRender(javascriptText);
}
private void initRender() {
RenderFactory renderFactory = RenderFactory.me();
renderFactory.init(constants, servletContext);
}
/** Render with text. The contentType is: "text/plain". */
public void renderText(String text) {
render = renderFactory.getTextRender(text);
}
/**
* Controller <br>
* 昨夜西风凋碧树。独上高楼，望尽天涯路。<br>
* 衣带渐宽终不悔，为伊消得人憔悴。<br>
* 众里寻她千百度，蓦然回首，那人却在灯火阑珊处。
*/
@SuppressWarnings({"unchecked", "rawtypes"})
public abstract class Controller {
private HttpServletRequest request;
private HttpServletResponse response;
private String urlPara;
private String[] urlParaArray;
private static final String[] NULL_URL_PARA_ARRAY = new String[0];
private static final String URL_PARA_SEPARATOR = Config.getConstants().getUrlParaSeparator();
void init(HttpServletRequest request, HttpServletResponse response, String urlPara) {
this.request = request;
this.response = response;
this.urlPara = urlPara;
}
public void setUrlPara(String urlPara) {
this.urlPara = urlPara;
this.urlParaArray = null;
}
/**
* Stores an attribute in this request
*
* @param name a String specifying the name of the attribute
* @param value the Object to be stored
*/
public Controller setAttr(String name, Object value) {
request.setAttribute(name, value);
return this;
}
/**
* Removes an attribute from this request
*
* @param name a String specifying the name of the attribute to remove
*/
public Controller removeAttr(String name) {
request.removeAttribute(name);
return this;
}
/**
* Stores attributes in this request, key of the map as attribute name and value of the map as
* attribute value
*
* @param attrMap key and value as attribute of the map to be stored
*/
public Controller setAttrs(Map<String, Object> attrMap) {
for (Map.Entry<String, Object> entry : attrMap.entrySet())
request.setAttribute(entry.getKey(), entry.getValue());
return this;
}
/**
* Returns the value of a request parameter as a String, or null if the parameter does not exist.
*
* <p>You should only use this method when you are sure the parameter has only one value. If the
* parameter might have more than one value, use getParaValues(java.lang.String).
*
* <p>If you use this method with a multivalued parameter, the value returned is equal to the
* first value in the array returned by getParameterValues.
*
* @param name a String specifying the name of the parameter
* @return a String representing the single value of the parameter
*/
public String getPara(String name) {
return request.getParameter(name);
}
/**
* Returns the value of a request parameter as a String, or default value if the parameter does
* not exist.
*
* @param name a String specifying the name of the parameter
* @param defaultValue a String value be returned when the value of parameter is null
* @return a String representing the single value of the parameter
*/
public String getPara(String name, String defaultValue) {
String result = request.getParameter(name);
return result != null && !"".equals(result) ? result : defaultValue;
}
/**
* Returns the values of the request parameters as a Map.
*
* @return a Map contains all the parameters name and value
*/
public Map<String, String[]> getParaMap() {
return request.getParameterMap();
}
/**
* Returns an Enumeration of String objects containing the names of the parameters contained in
* this request. If the request has no parameters, the method returns an empty Enumeration.
*
* @return an Enumeration of String objects, each String containing the name of a request
* parameter; or an empty Enumeration if the request has no parameters
*/
public Enumeration<String> getParaNames() {
return request.getParameterNames();
}
/**
* Returns an array of String objects containing all of the values the given request parameter
* has, or null if the parameter does not exist. If the parameter has a single value, the array
* has a length of 1.
*
* @param name a String containing the name of the parameter whose value is requested
* @return an array of String objects containing the parameter's values
*/
public String[] getParaValues(String name) {
return request.getParameterValues(name);
}
/**
* Returns an array of Integer objects containing all of the values the given request parameter
* has, or null if the parameter does not exist. If the parameter has a single value, the array
* has a length of 1.
*
* @param name a String containing the name of the parameter whose value is requested
* @return an array of Integer objects containing the parameter's values
*/
public Integer[] getParaValuesToInt(String name) {
String[] values = request.getParameterValues(name);
if (values == null) return null;
Integer[] result = new Integer[values.length];
for (int i = 0; i < result.length; i++) result[i] = Integer.parseInt(values[i]);
return result;
}
/**
* Returns an Enumeration containing the names of the attributes available to this request. This
* method returns an empty Enumeration if the request has no attributes available to it.
*
* @return an Enumeration of strings containing the names of the request's attributes
*/
public Enumeration<String> getAttrNames() {
return request.getAttributeNames();
}
/**
* Returns the value of the named attribute as an Object, or null if no attribute of the given
* name exists.
*
* @param name a String specifying the name of the attribute
* @return an Object containing the value of the attribute, or null if the attribute does not
* exist
*/
public <T> T getAttr(String name) {
return (T) request.getAttribute(name);
}
/**
* Returns the value of the named attribute as an Object, or null if no attribute of the given
* name exists.
*
* @param name a String specifying the name of the attribute
* @return an String Object containing the value of the attribute, or null if the attribute does
* not exist
*/
public String getAttrForStr(String name) {
return (String) request.getAttribute(name);
}
/**
* Returns the value of the named attribute as an Object, or null if no attribute of the given
* name exists.
*
* @param name a String specifying the name of the attribute
* @return an Integer Object containing the value of the attribute, or null if the attribute does
* not exist
*/
public Integer getAttrForInt(String name) {
return (Integer) request.getAttribute(name);
}
private Integer toInt(String value, Integer defaultValue) {
if (value == null || "".equals(value.trim())) return defaultValue;
if (value.startsWith("N") || value.startsWith("n"))
return -Integer.parseInt(value.substring(1));
return Integer.parseInt(value);
}
/**
* Returns the value of a request parameter and convert to Integer.
*
* @param name a String specifying the name of the parameter
* @return a Integer representing the single value of the parameter
*/
public Integer getParaToInt(String name) {
return toInt(request.getParameter(name), null);
}
/**
* Returns the value of a request parameter and convert to Integer with a default value if it is
* null.
*
* @param name a String specifying the name of the parameter
* @return a Integer representing the single value of the parameter
*/
public Integer getParaToInt(String name, Integer defaultValue) {
return toInt(request.getParameter(name), defaultValue);
}
private Long toLong(String value, Long defaultValue) {
if (value == null || "".equals(value.trim())) return defaultValue;
if (value.startsWith("N") || value.startsWith("n")) return -Long.parseLong(value.substring(1));
return Long.parseLong(value);
}
/**
* Returns the value of a request parameter and convert to Long.
*
* @param name a String specifying the name of the parameter
* @return a Integer representing the single value of the parameter
*/
public Long getParaToLong(String name) {
return toLong(request.getParameter(name), null);
}
/**
* Returns the value of a request parameter and convert to Long with a default value if it is
* null.
*
* @param name a String specifying the name of the parameter
* @return a Integer representing the single value of the parameter
*/
public Long getParaToLong(String name, Long defaultValue) {
return toLong(request.getParameter(name), defaultValue);
}
private Boolean toBoolean(String value, Boolean defaultValue) {
if (value == null || "".equals(value.trim())) return defaultValue;
value = value.trim().toLowerCase();
if ("1".equals(value) || "true".equals(value)) return Boolean.TRUE;
else if ("0".equals(value) || "false".equals(value)) return Boolean.FALSE;
throw new RuntimeException("Can not parse the parameter \"" + value + "\" to boolean value.");
}
/**
* Returns the value of a request parameter and convert to Boolean.
*
* @param name a String specifying the name of the parameter
* @return true if the value of the parameter is "true" or "1", false if it is "false" or "0",
* null if parameter is not exists
*/
public Boolean getParaToBoolean(String name) {
return toBoolean(request.getParameter(name), null);
}
/**
* Returns the value of a request parameter and convert to Boolean with a default value if it is
* null.
*
* @param name a String specifying the name of the parameter
* @return true if the value of the parameter is "true" or "1", false if it is "false" or "0",
* default value if it is null
*/
public Boolean getParaToBoolean(String name, Boolean defaultValue) {
return toBoolean(request.getParameter(name), defaultValue);
}
/** Get all para from url and convert to Boolean */
public Boolean getParaToBoolean() {
return toBoolean(getPara(), null);
}
/** Get para from url and conver to Boolean. The first index is 0 */
public Boolean getParaToBoolean(int index) {
return toBoolean(getPara(index), null);
}
/** Get para from url and conver to Boolean with default value if it is null. */
public Boolean getParaToBoolean(int index, Boolean defaultValue) {
return toBoolean(getPara(index), defaultValue);
}
private Date toDate(String value, Date defaultValue) {
if (value == null || "".equals(value.trim())) return defaultValue;
try {
return new java.text.SimpleDateFormat("yyyy-MM-dd").parse(value);
} catch (ParseException e) {
throw new RuntimeException(e);
}
}
/**
* Returns the value of a request parameter and convert to Date.
*
* @param name a String specifying the name of the parameter
* @return a Date representing the single value of the parameter
*/
public Date getParaToDate(String name) {
return toDate(request.getParameter(name), null);
}
/**
* Returns the value of a request parameter and convert to Date with a default value if it is
* null.
*
* @param name a String specifying the name of the parameter
* @return a Date representing the single value of the parameter
*/
public Date getParaToDate(String name, Date defaultValue) {
return toDate(request.getParameter(name), defaultValue);
}
/** Get all para from url and convert to Date */
public Date getParaToDate() {
return toDate(getPara(), null);
}
/**
* Return HttpServletRequest. Do not use HttpServletRequest Object in constructor of Controller
*/
public HttpServletRequest getRequest() {
return request;
}
/**
* Return HttpServletResponse. Do not use HttpServletResponse Object in constructor of Controller
*/
public HttpServletResponse getResponse() {
return response;
}
/** Return HttpSession. */
public HttpSession getSession() {
return request.getSession();
}
/**
* Return HttpSession.
*
* @param create a boolean specifying create HttpSession if it not exists
*/
public HttpSession getSession(boolean create) {
return request.getSession(create);
}
/**
* Return a Object from session.
*
* @param key a String specifying the key of the Object stored in session
*/
public <T> T getSessionAttr(String key) {
HttpSession session = request.getSession(false);
return session != null ? (T) session.getAttribute(key) : null;
}
/**
* Store Object to session.
*
* @param key a String specifying the key of the Object stored in session
* @param value a Object specifying the value stored in session
*/
public Controller setSessionAttr(String key, Object value) {
request.getSession().setAttribute(key, value);
return this;
}
/**
* Remove Object in session.
*
* @param key a String specifying the key of the Object stored in session
*/
public Controller removeSessionAttr(String key) {
HttpSession session = request.getSession(false);
if (session != null) session.removeAttribute(key);
return this;
}
/** Get cookie value by cookie name. */
public String getCookie(String name, String defaultValue) {
Cookie cookie = getCookieObject(name);
return cookie != null ? cookie.getValue() : defaultValue;
}
/** Get cookie value by cookie name. */
public String getCookie(String name) {
return getCookie(name, null);
}
/** Get cookie value by cookie name and convert to Integer. */
public Integer getCookieToInt(String name) {
String result = getCookie(name);
return result != null ? Integer.parseInt(result) : null;
}
/** Get cookie value by cookie name and convert to Integer. */
public Integer getCookieToInt(String name, Integer defaultValue) {
String result = getCookie(name);
return result != null ? Integer.parseInt(result) : defaultValue;
}
/** Get cookie value by cookie name and convert to Long. */
public Long getCookieToLong(String name) {
String result = getCookie(name);
return result != null ? Long.parseLong(result) : null;
}
/** Get cookie value by cookie name and convert to Long. */
public Long getCookieToLong(String name, Long defaultValue) {
String result = getCookie(name);
return result != null ? Long.parseLong(result) : defaultValue;
}
/** Get cookie object by cookie name. */
public Cookie getCookieObject(String name) {
Cookie[] cookies = request.getCookies();
if (cookies != null)
for (Cookie cookie : cookies) if (cookie.getName().equals(name)) return cookie;
return null;
}
/** Get all cookie objects. */
public Cookie[] getCookieObjects() {
Cookie[] result = request.getCookies();
return result != null ? result : new Cookie[0];
}
/** Set Cookie to response. */
public Controller setCookie(Cookie cookie) {
response.addCookie(cookie);
return this;
}
/**
* Set Cookie to response.
*
* @param name cookie name
* @param value cookie value
* @param maxAgeInSeconds -1: clear cookie when close browser. 0: clear cookie immediately. n>0 :
* max age in n seconds.
* @param path see Cookie.setPath(String)
*/
public Controller setCookie(String name, String value, int maxAgeInSeconds, String path) {
setCookie(name, value, maxAgeInSeconds, path, null);
return this;
}
/**
* Set Cookie to response.
*
* @param name cookie name
* @param value cookie value
* @param maxAgeInSeconds -1: clear cookie when close browser. 0: clear cookie immediately. n>0 :
* max age in n seconds.
* @param path see Cookie.setPath(String)
* @param domain the domain name within which this cookie is visible; form is according to RFC
* 2109
*/
public Controller setCookie(
String name, String value, int maxAgeInSeconds, String path, String domain) {
Cookie cookie = new Cookie(name, value);
if (domain != null) cookie.setDomain(domain);
cookie.setMaxAge(maxAgeInSeconds);
cookie.setPath(path);
response.addCookie(cookie);
return this;
}
/** Set Cookie with path = "/". */
public Controller setCookie(String name, String value, int maxAgeInSeconds) {
setCookie(name, value, maxAgeInSeconds, "/", null);
return this;
}
/** Remove Cookie with path = "/". */
public Controller removeCookie(String name) {
setCookie(name, null, 0, "/", null);
return this;
}
/** Remove Cookie. */
public Controller removeCookie(String name, String path) {
setCookie(name, null, 0, path, null);
return this;
}
/** Remove Cookie. */
public Controller removeCookie(String name, String path, String domain) {
setCookie(name, null, 0, path, domain);
return this;
}
// --------
/** Get all para with separator char from url */
public String getPara() {
if ("".equals(urlPara)) // urlPara maybe is "" see ActionMapping.getAction(String)
urlPara = null;
return urlPara;
}
/** Get para from url. The index of first url para is 0. */
public String getPara(int index) {
if (index < 0) return getPara();
if (urlParaArray == null) {
if (urlPara == null
|| "".equals(urlPara)) // urlPara maybe is "" see ActionMapping.getAction(String)
urlParaArray = NULL_URL_PARA_ARRAY;
else urlParaArray = urlPara.split(URL_PARA_SEPARATOR);
for (int i = 0; i < urlParaArray.length; i++)
if ("".equals(urlParaArray[i])) urlParaArray[i] = null;
}
return urlParaArray.length > index ? urlParaArray[index] : null;
}
/** Get para from url with default value if it is null or "". */
public String getPara(int index, String defaultValue) {
String result = getPara(index);
return result != null && !"".equals(result) ? result : defaultValue;
}
/** Get para from url and conver to Integer. The first index is 0 */
public Integer getParaToInt(int index) {
return toInt(getPara(index), null);
}
/** Get para from url and conver to Integer with default value if it is null. */
public Integer getParaToInt(int index, Integer defaultValue) {
return toInt(getPara(index), defaultValue);
}
/** Get para from url and conver to Long. */
public Long getParaToLong(int index) {
return toLong(getPara(index), null);
}
/** Get para from url and conver to Long with default value if it is null. */
public Long getParaToLong(int index, Long defaultValue) {
return toLong(getPara(index), defaultValue);
}
/** Get all para from url and convert to Integer */
public Integer getParaToInt() {
return toInt(getPara(), null);
}
/** Get all para from url and convert to Long */
public Long getParaToLong() {
return toLong(getPara(), null);
}
/** Get model from http request. */
public <T> T getModel(Class<T> modelClass) {
return (T) ModelInjector.inject(modelClass, request, false);
}
/** Get model from http request. */
public <T> T getModel(Class<T> modelClass, String modelName) {
return (T) ModelInjector.inject(modelClass, modelName, request, false);
}
// TODO public <T> List<T> getModels(Class<T> modelClass, String modelName) {}
// --------
/** Get upload file from multipart request. */
public List<UploadFile> getFiles(String saveDirectory, Integer maxPostSize, String encoding) {
if (request instanceof MultipartRequest == false)
request = new MultipartRequest(request, saveDirectory, maxPostSize, encoding);
return ((MultipartRequest) request).getFiles();
}
public UploadFile getFile(
String parameterName, String saveDirectory, Integer maxPostSize, String encoding) {
getFiles(saveDirectory, maxPostSize, encoding);
return getFile(parameterName);
}
public List<UploadFile> getFiles(String saveDirectory, int maxPostSize) {
if (request instanceof MultipartRequest == false)
request = new MultipartRequest(request, saveDirectory, maxPostSize);
return ((MultipartRequest) request).getFiles();
}
public UploadFile getFile(String parameterName, String saveDirectory, int maxPostSize) {
getFiles(saveDirectory, maxPostSize);
return getFile(parameterName);
}
public List<UploadFile> getFiles(String saveDirectory) {
if (request instanceof MultipartRequest == false)
request = new MultipartRequest(request, saveDirectory);
return ((MultipartRequest) request).getFiles();
}
public UploadFile getFile(String parameterName, String saveDirectory) {
getFiles(saveDirectory);
return getFile(parameterName);
}
public List<UploadFile> getFiles() {
if (request instanceof MultipartRequest == false) request = new MultipartRequest(request);
return ((MultipartRequest) request).getFiles();
}
public UploadFile getFile() {
List<UploadFile> uploadFiles = getFiles();
return uploadFiles.size() > 0 ? uploadFiles.get(0) : null;
}
public UploadFile getFile(String parameterName) {
List<UploadFile> uploadFiles = getFiles();
for (UploadFile uploadFile : uploadFiles) {
if (uploadFile.getParameterName().equals(parameterName)) {
return uploadFile;
}
}
return null;
}
// i18n features --------
/** Write Local to cookie */
public Controller setLocaleToCookie(Locale locale) {
setCookie(I18N_LOCALE, locale.toString(), I18N.getI18nMaxAgeOfCookie());
return this;
}
public Controller setLocaleToCookie(Locale locale, int maxAge) {
setCookie(I18N_LOCALE, locale.toString(), maxAge);
return this;
}
public String getText(String key) {
return I18N.getText(key, getLocaleFromCookie());
}
public String getText(String key, String defaultValue) {
return I18N.getText(key, defaultValue, getLocaleFromCookie());
}
private Locale getLocaleFromCookie() {
Cookie cookie = getCookieObject(I18N_LOCALE);
if (cookie != null) {
return I18N.localeFromString(cookie.getValue());
} else {
Locale defaultLocale = I18N.getDefaultLocale();
setLocaleToCookie(defaultLocale);
return I18N.localeFromString(defaultLocale.toString());
}
}
/** Keep all parameter's value except model value */
public Controller keepPara() {
Map<String, String[]> map = request.getParameterMap();
for (Entry<String, String[]> e : map.entrySet()) {
String[] values = e.getValue();
if (values.length == 1) request.setAttribute(e.getKey(), values[0]);
else request.setAttribute(e.getKey(), values);
}
return this;
}
/** Keep parameter's value names pointed, model value can not be kept */
public Controller keepPara(String... names) {
for (String name : names) {
String[] values = request.getParameterValues(name);
if (values != null) {
if (values.length == 1) request.setAttribute(name, values[0]);
else request.setAttribute(name, values);
}
}
return this;
}
/** Convert para to special type and keep it */
public Controller keepPara(Class type, String name) {
String[] values = request.getParameterValues(name);
if (values != null) {
if (values.length == 1)
try {
request.setAttribute(name, TypeConverter.convert(type, values[0]));
} catch (ParseException e) {
}
else request.setAttribute(name, values);
}
return this;
}
public Controller keepPara(Class type, String... names) {
if (type == String.class) return keepPara(names);
if (names != null) for (String name : names) keepPara(type, name);
return this;
}
public Controller keepModel(Class modelClass, String modelName) {
Object model = ModelInjector.inject(modelClass, modelName, request, true);
request.setAttribute(modelName, model);
return this;
}
public Controller keepModel(Class modelClass) {
String modelName = StrKit.firstCharToLowerCase(modelClass.getSimpleName());
keepModel(modelClass, modelName);
return this;
}
/**
* Create a token.
*
* @param tokenName the token name used in view
* @param secondsOfTimeOut the seconds of time out, secondsOfTimeOut >=
* Const.MIN_SECONDS_OF_TOKEN_TIME_OUT
*/
public void createToken(String tokenName, int secondsOfTimeOut) {
com.jfinal.token.TokenManager.createToken(this, tokenName, secondsOfTimeOut);
}
/** Create a token with default token name and with default seconds of time out. */
public void createToken() {
createToken(Const.DEFAULT_TOKEN_NAME, Const.DEFAULT_SECONDS_OF_TOKEN_TIME_OUT);
}
/**
* Create a token with default seconds of time out.
*
* @param tokenName the token name used in view
*/
public void createToken(String tokenName) {
createToken(tokenName, Const.DEFAULT_SECONDS_OF_TOKEN_TIME_OUT);
}
/**
* Check token to prevent resubmit.
*
* @param tokenName the token name used in view's form
* @return true if token is correct
*/
public boolean validateToken(String tokenName) {
return com.jfinal.token.TokenManager.validateToken(this, tokenName);
}
/**
* Check token to prevent resubmit with default token key ---> "JFINAL_TOKEN_KEY"
*
* @return true if token is correct
*/
public boolean validateToken() {
return validateToken(Const.DEFAULT_TOKEN_NAME);
}
/** Return true if the para value is blank otherwise return false */
public boolean isParaBlank(String paraName) {
String value = request.getParameter(paraName);
return value == null || value.trim().length() == 0;
}
/** Return true if the urlPara value is blank otherwise return false */
public boolean isParaBlank(int index) {
String value = getPara(index);
return value == null || value.trim().length() == 0;
}
/** Return true if the para exists otherwise return false */
public boolean isParaExists(String paraName) {
return request.getParameterMap().containsKey(paraName);
}
/** Return true if the urlPara exists otherwise return false */
public boolean isParaExists(int index) {
return getPara(index) != null;
}
// ----------------
// render below ---
private static final RenderFactory renderFactory = RenderFactory.me();
/** Hold Render object when invoke renderXxx(...) */
private Render render;
public Render getRender() {
return render;
}
/** Render with any Render which extends Render */
public void render(Render render) {
this.render = render;
}
/** Render with view use default type Render configured in JFinalConfig */
public void render(String view) {
render = renderFactory.getRender(view);
}
/** Render with jsp view */
public void renderJsp(String view) {
render = renderFactory.getJspRender(view);
}
/** Render with freemarker view */
public void renderFreeMarker(String view) {
render = renderFactory.getFreeMarkerRender(view);
}
/** Render with velocity view */
public void renderVelocity(String view) {
render = renderFactory.getVelocityRender(view);
}
/**
* Render with json
*
* <p>Example:<br>
* renderJson("message", "Save successful");<br>
* renderJson("users", users);<br>
*/
public void renderJson(String key, Object value) {
render = renderFactory.getJsonRender(key, value);
}
/** Render with json */
public void renderJson() {
render = renderFactory.getJsonRender();
}
/**
* Render with attributes set by setAttr(...) before.
*
* <p>Example: renderJson(new String[]{"blogList", "user"});
*/
public void renderJson(String[] attrs) {
render = renderFactory.getJsonRender(attrs);
}
/**
* Render with json text.
*
* <p>Example: renderJson("{\"message\":\"Please input password!\"}");
*/
public void renderJson(String jsonText) {
render = renderFactory.getJsonRender(jsonText);
}
/**
* Render json with object.
*
* <p>Example: renderJson(new User().set("name", "JFinal").set("age", 18));
*/
public void renderJson(Object object) {
render = renderFactory.getJsonRender(object);
}
/** Render with text. The contentType is: "text/plain". */
public void renderText(String text) {
render = renderFactory.getTextRender(text);
}
/**
* Render with text and content type.
*
* <p>Example: renderText("<user id='5888'>James</user>", "application/xml");
*/
public void renderText(String text, String contentType) {
render = renderFactory.getTextRender(text, contentType);
}
/** Forward to an action */
public void forwardAction(String actionUrl) {
render = new ActionRender(actionUrl);
}
/** Render with file */
public void renderFile(String fileName) {
render = renderFactory.getFileRender(fileName);
}
/** Render with file */
public void renderFile(File file) {
render = renderFactory.getFileRender(file);
}
/** Redirect to url */
public void redirect(String url) {
render = renderFactory.getRedirectRender(url);
}
/** Redirect to url */
public void redirect(String url, boolean withQueryString) {
render = renderFactory.getRedirectRender(url, withQueryString);
}
/** Render with view and status use default type Render configured in JFinalConfig */
public void render(String view, int status) {
render = renderFactory.getRender(view);
response.setStatus(status);
}
/** Render with url and 301 status */
public void redirect301(String url) {
render = renderFactory.getRedirect301Render(url);
}
/** Render with url and 301 status */
public void redirect301(String url, boolean withQueryString) {
render = renderFactory.getRedirect301Render(url, withQueryString);
}
/** Render with view and errorCode status */
public void renderError(int errorCode, String view) {
throw new ActionException(errorCode, renderFactory.getErrorRender(errorCode, view));
}
/** Render with render and errorCode status */
public void renderError(int errorCode, Render render) {
throw new ActionException(errorCode, render);
}
/** Render with view and errorCode status configured in JFinalConfig */
public void renderError(int errorCode) {
throw new ActionException(errorCode, renderFactory.getErrorRender(errorCode));
}
/** Render nothing, no response to browser */
public void renderNull() {
render = renderFactory.getNullRender();
}
/** Render with javascript text. The contentType is: "text/javascript". */
public void renderJavascript(String javascriptText) {
render = renderFactory.getJavascriptRender(javascriptText);
}
/** Render with html text. The contentType is: "text/html". */
public void renderHtml(String htmlText) {
render = renderFactory.getHtmlRender(htmlText);
}
protected void handlerException(Exception e, String methodName) {
if (e instanceof RuntimeException) {
throw (RuntimeException) e;
} else {
throw new RuntimeException(e);
}
}
}
/**
* Render with text and content type.
*
* <p>Example: renderText("<user id='5888'>James</user>", "application/xml");
*/
public void renderText(String text, String contentType) {
render = renderFactory.getTextRender(text, contentType);
}
/** Render with xml view using freemarker. */
public void renderXml(String view) {
render = renderFactory.getXmlRender(view);
}