package com.cucu.tapestry.util;


import javax.servlet.ServletRequest;

/**
 * 這個類提供了前臺jsp里用的一些方法
 * <ul>
 * <li>非空判斷
 * </ul>
 *
 * @author 絕情酷哥
 * @version $Id: PageUtil.java,v 1.1.1.1 2005/11/23 03:54:53 ns Exp $
 */
public class WebUtil {


    /**
     * 判斷字符串是否為null，如果不是就直接返回，否則返回""
     * 這個函數主要用于對一些前臺對象值的判斷，以防止在界面上顯示null
     *
     * @param s 要檢查的字符串
     * @return 如果為null,返回""空字符串
     */
    public static String checkNull(String s) {
        if (s == null) {
            return "";
        } else {
            return s;
        }
    }

    /**
     * 判斷字符串是否為null，如果不是就直接返回字符串，否則defaultValue的值
     * 這個函數主要用于對一些前臺對象值的判斷，以防止在界面上顯示null
     *
     * @param s            要檢查的字符串
     * @param defaultValue 要檢查的字符串
     * @return 如果為null,返回defaultValue，否則返回s
     */
    public static String checkNullWithDefault(String s, String defaultValue) {
        return s == null ? defaultValue : s;
    }

    /**
     * 從請求里取得參數(String)
     *
     * @param request HTTP 請求
     * @param name    參數名
     * @param defval  缺省值
     * @return 如果請求里有參數就返回參數值，或者返回缺省值
     */
    public static final String getParam(ServletRequest request, String name,
                                        String defval) {
        String param = request.getParameter(name);
        return (param != null ? param : defval);
    }

    /**
     * 從請求里取得參數(int)
     *
     * @param request HTTP 請求
     * @param name    參數名
     * @param defval  缺省值
     * @return 如果請求里有參數就返回參數值，或者返回缺省值
     *         如果請求的參數不是int，返回缺省值
     */
    public static final int getParam(ServletRequest request, String name,
                                     int defval) {
        String param = request.getParameter(name);
        int value = defval;
        if (param != null) {
            try {
                value = Integer.parseInt(param);
            } catch (NumberFormatException ignore) {
            }
        }
        return value;
    }

    /**
     * 返回數組參數值
     *
     * @param request http請求
     * @param name    參數名稱
     * @return String[] 數組值，如果請求里沒有，返回null
     */
    public static final String[] getArrayParam(ServletRequest request,
                                               String name) {
        String[] param = request.getParameterValues(name);
        return (param != null ? param : null);
    }
}