首页 诗词 字典 板报 句子 名言 友答 励志 学校 网站地图
当前位置: 首页 > 教程频道 > 开发语言 > 编程 >

ZkUtils 1.2.1版,一个zk开发中的工具步骤集合

2012-12-20 
ZkUtils1.2.1版,一个zk开发中的工具方法集合?ZkUtils集合了zk中常用的一些工具方法,方便开发中的使用??1.2

ZkUtils 1.2.1版,一个zk开发中的工具方法集合

?

ZkUtils集合了zk中常用的一些工具方法,方便开发中的使用

?

?1.2.1版没添加任何新的工具方法,

?该版本主要改进:结合本人两年多的开发经验

?给一些方法添加细致的注解,使用的同时了解其工作原理

?

?

package org.zkway.common.util.web.zk;import java.io.IOException;import java.util.Date;import java.util.Iterator;import java.util.List;import java.util.Map;import org.zkoss.zk.au.out.AuSendRedirect;import org.zkoss.zk.ui.Component;import org.zkoss.zk.ui.Desktop;import org.zkoss.zk.ui.Execution;import org.zkoss.zk.ui.Executions;import org.zkoss.zk.ui.Page;import org.zkoss.zk.ui.Session;import org.zkoss.zk.ui.Sessions;import org.zkoss.zk.ui.WebApp;import org.zkoss.zk.ui.event.Event;import org.zkoss.zk.ui.event.EventListener;import org.zkoss.zk.ui.event.Events;import org.zkoss.zk.ui.event.ForwardEvent;import org.zkoss.zk.ui.event.GenericEventListener;import org.zkoss.zk.ui.sys.ExecutionCtrl;import org.zkoss.zk.ui.sys.SessionCtrl;import org.zkoss.zk.ui.util.Clients;import org.zkoss.zul.Messagebox;import org.zkoss.zul.impl.api.InputElement;/** * ZkUtils集合了zk中常用的一些功能,方便开发中的使用 *  *  * @author sunflower *  *  *         Email:zhangxuehuaemail # gmail 点 com * @since zk5.0+ */public class ZkUtils {/** *  * 获得当前Execution,Execution类似HttpServletRequest * <p> * 客户端请求的执行器(例如ServletRequest),当客户端发送一个请求后, * 服务端负责构造这个Execution对象,获取当前执行的信息,然后服务这个请求 * <p> * 一个客户端请求, 例如, HttpServletRequest, 或许关联多个请求 request ( * {@link org.zkoss.zk.au.AuRequest}). 但是, 这些 ZK 请求来自的页面 ({@link Page} * )必须具有相同的desktop * <p> * 因为一个请求也许来自http或其他协议,Execution通常一个隔离层 *  *  * @return 当前execution * @see Execution */public static final Execution getCurrentExecution() {return Executions.getCurrent();}/** * 返回当前Exection桌面对象 * <p> * 在zk中,具有同一个dom document元素组成了desktop,注意这里的同一个document, * 例如iframe会创建另外一个document, 点击链接打开一个新浏览器窗口,这个窗口里的document与原窗口的document是不同的 *  * @return * @see Execution#getDesktop() */public static final Desktop getCurrentDesktop() {return getCurrentExecution().getDesktop();}/** * 获得当前Execution所属的会话 * <p> * <b>注</b>该Session不同于HttpSession,该session为zk定义的session作用域 *  * @return * @see Session */public static final Session getCurrentSession() {return Sessions.getCurrent();}/** * 返回本地session对象,如果不可用返回null,返回的对象依赖客户端类型,如果是就http的 * ,那么返回javax.servlet.http.HttpSession的一个实例 * ,如果是portlet,那么返回javax.portlet.PortletSession的实例 */public static final Object getNativeSession() {return getCurrentSession().getNativeSession();}/** * 返回本地请求对象,如果不可用返回null *  * @return 返回的对象依赖web容器,如果web容器是一个servlet容器,那么返回的对象为ServletRequest */public static final Object getNativeRequest() {return getCurrentExecution().getNativeRequest();}/** * 返回本地响应对象,如果不可用返回null *  * @return 返回的对象依赖web容器,如果web容器是一个servlet容器,那么返回的对象为ServletResponse */public static final Object getNativeResponse() {return getCurrentExecution().getNativeResponse();}/** * 获得WebApp对象,类似HttpServletContext *  * @return * @see Desktop#getWebApp() * @see WebApp */public static final WebApp getWebApp() {return getCurrentDesktop().getWebApp();}/** * 返回给定虚拟路径的实际路径 *  */public static final String getRealPath(String virtualPath) {return getWebApp().getRealPath(virtualPath);}/** * 获得当前请求来自的页面 *  * @return */public static final Page getCurrentPage() {return ((ExecutionCtrl) getCurrentExecution()).getCurrentPage();}/** * 返回execution作用域内参数 *  * @return * @see Execution#getArg() */@SuppressWarnings("rawtypes")public static final Map getExecutionArgs() {return getCurrentExecution().getArg();}/** * 获得当前Execution作用域内的属性,类似HttpServletRequest相应方法 *  * @see Execution#getAttributes() */@SuppressWarnings("rawtypes")public static final Map getExectionAttributes() {return getCurrentExecution().getAttributes();}/** * 设置Execution请求属性值,类似HttpServletRequest相应方法 *  * @param name *            请求属性 * @param value *            属性值 */public static final void setExecutionAttribute(String name, Object value) {getCurrentExecution().setAttribute(name, value);}/** * 设置Execution作用域属性值或其父作用域的值,类似HttpServletRequest相应方法 *  * @param name *            请求属性 * @param value *            属性值 * @param recurse *            检查父作用域是否存在该属性,如果存在将替换父作用域的值 *  */public static final void setExecutionAttribute(String name, Object value,boolean recurse) {getCurrentExecution().setAttribute(name, value, recurse);}/** * 获得Execution请求参数,类似HttpServletRequest相应方法 *  * @return 参数map */@SuppressWarnings("rawtypes")public static final Map getExecutionParameterMap() {return getCurrentExecution().getParameterMap();}/** * 获得Execution请求参数值,类似HttpServletRequest相应方法 *  * @param name *            请求参数的名字 * @return 指定名字的参数值 */public static final String getExecutionParameter(String name) {return getCurrentExecution().getParameter(name);}/** * 获得Execution请求参数值,类似HttpServletRequest相应方法 *  * @param name *            参数的名字 * @return 字符数组 */public static final String[] getExecutionParameterValues(String name) {return getCurrentExecution().getParameterValues(name);}/** * 获得当前请求消息头,类似HttpServletRequest相应方法 *  * @param name *            消息头名字 * @return 消息头值 */public static final String getRequestHeader(String name) {return getCurrentExecution().getHeader(name);}/** * 返回指定请求头名字的所有值,类似HttpServletRequest相应方法 *  * @param name *            请求头的名字 * @return */@SuppressWarnings("rawtypes")public static final Iterator getRequestHeaders(String name) {return getCurrentExecution().getHeaders(name);}/** * 返回所有请求头名字,类似HttpServletRequest相应方法 *  * @return */@SuppressWarnings("rawtypes")public static final Iterator getRequestHeaderNames() {return getCurrentExecution().getHeaderNames();}/** * 添加一个指定名称和值的相应头,允许相应头具有多值,类似HttpServletResponse相应方法 *  * @param name * @param value */public static final void addResponseHeader(String name, String value) {getCurrentExecution().addResponseHeader(name, value);}/** * 添加一个指定名称和日期值的响应头,类似HttpServletResponse相应方法 *  * @param name * @param value */public static final void addResponseHeader(String name, Date value) {getCurrentExecution().addResponseHeader(name, value);}/** * 返回接收请求的本地ip地址,类似HttpServletRequest相应方法 *  * @return */public static final String getLocalAddr() {return getCurrentExecution().getLocalAddr();}/** * 获得接收请求的本地host name,类似HttpServletRequest相应方法 *  * @return */public static final String getLocalName() {return getCurrentExecution().getLocalName();}/** * 获得接收请求的本地端口,类似HttpServletRequest相应方法 *  * @return */public static final int getLocalPort() {return getCurrentExecution().getLocalPort();}/** * 获得发送请求的客户端ip,类似HttpServletRequest相应方法 *  * @return */public static final String getRemoteAddr() {return getCurrentExecution().getRemoteAddr();}/** * 获得发送请求的客户端的host name,类似HttpServletRequest相应方法 *  * @return */public static final String getRemoteHost() {return getCurrentExecution().getRemoteHost();}/** * 设置session 属性,类似HttpSession相应方法 *  * @param name *            属性名 * @param value *            属性值 */public static final void setSessionAttribute(String name, Object value) {getCurrentSession().setAttribute(name, value);}/** * 设置session或父作用域 属性,类似HttpSession相应方法 *  * @param name *            属性名 * @param value *            属性值 * @param recurse *            是否查询父作用域包含name名字的属性,如果包含将替换该值 */public static final void setSessionAttribute(String name, Object value,boolean recurse) {getCurrentSession().setAttribute(name, value, recurse);}/** * 返回session作用域对象,类似HttpSession相应方法 *  * @param name *            属性名 * @param recurse *            是否检索父作用域,如果为true, 并且当前作用域没声明这个属性,那么将搜索父作用域 * @return */public static final Object getSessionAttribute(String name, boolean recurse) {return getCurrentSession().getAttribute(name, recurse);}/** * 返回session作用域对象,类似HttpSession相应方法 *  * @param name *            属性名 * @return */public static final Object getSessionAttribute(String name) {return getCurrentSession().getAttribute(name);}/** * 获得所有session作用域对象,类似HttpSession相应方法 *  * @return map 类型的作用域所有对象 */@SuppressWarnings("rawtypes")public static final Map getSessionAttributes() {return getCurrentSession().getAttributes();}/** * 获得会话超时时间,单位秒,类似HttpSession相应方法 *  * @return */public static final int getSessionMaxInactiveInterval() {return getCurrentSession().getMaxInactiveInterval();}/** * 指定失效事件,单位秒,负值表示永不过期,类似HttpSession相应方法 *  * @param interval */public static final void setSessionMaxInactiveInterval(int interval) {getCurrentSession().setMaxInactiveInterval(interval);}/** * 销毁当前session * <p> *  * 表示解除绑定在session上的所有对象 这里我们要注意: 通常你使用 {@link Executions#sendRedirect} * 让客户端重定向另一个页面(或重加载同一页面) session并不立即销毁 ,而是在当前请求之后销毁,即重定向页面显示完毕之后 * 如果想立即销毁((SessionCtrl)Sessions.getCurrent()).invalidateNow(); * 在zk中这一点和通常所说的HttpSession.invalidate()有所不同 * <p> * 由 天明ゞ破晓 (qq 513062844) 提出的疑问。great thanks */public static final void invalidateSession() {getCurrentSession().invalidate();}/** * 立即销毁当前session * <p> * 非立即销毁session情况见 {@link #invalidateSession()} *  */public static final void invlidateSessionNow() {((SessionCtrl) getCurrentSession()).invalidateNow();}/** * 设置页面作用域属性 *  * @param name *            属性名 * @param value *            属性值 */public static final void setPageAttribute(String name, Object value) {getCurrentPage().setAttribute(name, value);}/** *  * 设置page或父作用域属性 *  * @param name * @param value * @param recurse *            是否检索父作用域,如果为true, 并且当前作用域没声明这个属性,那么将搜索父作用域 ,并替换 */public static final void setPageAttribute(String name, Object value,boolean recurse) {getCurrentPage().setAttribute(name, value, recurse);}/** * 获得当前请求来自的页面 *  * @return */public static final String getRequestPagePath() {return getCurrentPage().getRequestPath();}/** * 获得桌面作用域属性 *  * @param name * @return */public static final Object getDesktopAttribute(String name) {return getCurrentDesktop().getAttribute(name);}/** * 获得指定id的page * <p> * 需要注意到是:例如在page1中包含iframe,iframe包含的页面为page2,那么zk将为page2新建一个桌面对象desktop2, * 因此page1与page2属于不同的桌面, 当你在page2的一个按钮或所属的其他组件触发的事件中 * 使用该方法获得page1的子页面的时候,当前动作请求所属桌面为desktop2,而不是page1所属的desktop1, * 因此你无法从desktop2中查找属于desktop1的页面 *  * @param pageId *            页面的id * @return 页面对戏那个 * @see Desktop#getPage(String) */public static final Page getPage(String pageId) {return getCurrentDesktop().getPage(pageId);}/** * 请求转发 * <p> * 调用这个方法的时机:非事件处理内调用,在事件处理时必须调用{@link #sendRedirect(String)} *  * @param pageUri * @throws IOException */public static final void forward(String pageUri) throws IOException {Executions.forward(pageUri);}/** * 重定向指定页面 * <p> * 该方法的行为:如果用户尚未看到响应结果,该方法发送重定向状态码! 如果用户已经看到响应,在用户事件中调用该方法时,zk向客户端发送一个 * {@link AuSendRedirect}指令,客户端引擎调用redirect js函数(zAu.cmd0.redirect(String * uri,String target)),修改浏览器地址栏里的url,而不是传统我们说的重定向 *  * @param pageUri */public static final void sendRedirect(String pageUri) {Executions.sendRedirect(pageUri);}/** * 向当前execution提交一个事件 * <p> * 将事件提交到事件队列末尾,然后立即返回。 队列中排在前面的事件处理完毕后执行该动作提交的事件。 *  * @param event */public static final void postEvent(Event event) {Events.postEvent(event);}/** * 向当前execution提交一个事件,可以设置事件的优先级 * <p> * 将事件提交到事件队列末尾,然后立即返回。 队列中排在前面的事件处理完毕后执行该动作提交的事件。 *  * @priority * @param event */public static final void postEvent(int priority, Event event) {Events.postEvent(priority, event);}/** * 向目标组件发送指定名称的事件 * <p> * 将事件提交到事件队列末尾,然后立即返回。 队列中排在前面的事件处理完毕后执行该动作提交的事件。 */public static final void postEvent(String name, Component target,Object data) {Events.postEvent(name, target, data);}/** * 向当前execution发送一个事件 * <p> * 事件处理线程和调用该方法的线程为同一线程,即二者为相同线程,所以必须等待事件处理完毕,该方法才会返回。 * <p> * 如果目标事件的的处理器,是一个长操作,那么当前线程将长事件阻塞,而在客户端表现为:左上角一直出现"正在处理,请稍候..."等字样的提示, * 所以在使用前注意 *  * @param event */public static final void sendEvent(Event event) {Events.sendEvent(event);}/** * 向指定组件发送事件 * <p> * 事件处理线程和调用该方法的线程为同一线程,即二者为相同线程,所以必须等待事件处理完毕,该方法才会返回 * <p> * 如果目标事件的的处理器,是一个长操作,那么当前线程将长事件阻塞,而在客户端表现为:左上角一直出现"正在处理,请稍候..."等字样的提示, * 所以在使用前注意 *  * @param comp *            目标组件 * @param event */public static final void sendEvent(Component comp, Event event) {Events.sendEvent(comp, event);}/** * 向目标组件发送指定名称的事件 *  * <p> * 事件处理线程和调用该方法的线程为同一线程,即二者为相同线程,所以必须等待事件处理完毕,该方法才会返回 * <p> * 如果目标事件的的处理器,是一个长操作,那么当前线程将长事件阻塞,而在客户端表现为:左上角一直出现"正在处理,请稍候..."等字样的提示, * 所以在使用前注意 *  * @param name *            事件名称 * @param target *            目标组件 * @param data *            事件携带的数据,可以调用在事件监听器中使用<code>Event.getData()</code>获得该数据 */public static final void sendEvent(String name, Component target,Object data) {Events.sendEvent(name, target, data);}/** * 获取ForwardEvent事件的原始事件 *  * @param event * @return */public static final Event getRealOrigin(ForwardEvent event) {return Events.getRealOrigin(event);}/** * 给指定的组件添加controller对象中定义的onXxx事件处理器,该controller是一个 * 包含onXxx方法的POJO对象,该工具方法将onXxx方法注册给指定组件,因此你不用通过{@link EventListener} * 一个一个的向组件注册了 * <p> * 所有在controller对象中以"on"开头的公共方法被作为事件处理器,并且相关事件同时也被监听,例如, * 如果controller对象有一个名字为onOk的方法,那么 onOk事件将被监听,然后当接收到onOk事件的时候, onOk方法被调用 *  * @param comp *            the component to be registered the events * @param controller *            a POJO file with onXxx methods(event handlers) * @since 3.0.6 * @see GenericEventListener */public static final void addEventListeners(Component comp, Object controller) {Events.addEventListeners(comp, controller);}/** * 检测名称是否是一个合法的zk事件名 *  * @param name * @return */public static final boolean isValidEventName(String name) {return Events.isValid(name);}/** * 判断一个指定事件的组件是否有事件处理器或监听器 *  * @param comp * @param evtnm * @param asap *            是否仅检测非延迟事件监听器,例如实现org.zkoss.zk.ui.event.Deferrable或 *            org.zkoss.zk.ui.event.Deferrable.isDeferrable 返回 false的监听器 * @return */public static final boolean isListened(Component comp, String evtnm,boolean asap) {return Events.isListened(comp, evtnm, asap);}/** * 从uri指定的文件创建组件 * <p> * 如果uri的页面内包含&lt;?page id=&quot;pageId&quot; * title=&quot;这个是标题&quot;?&gt;页面指令 * ,在createComponents中该语句指令失效,createComponents方法不会因此创建Page对象, 当然 * <code>desktop.getPage("pageId")</code的时候返回的是null *  * @param uri * @param parent *            创建的组件所属的父组件F * @param args *            创建组件传递的参数 * @return 创建的组件,该组件对象为uri页面的第一个组件(zk节点除外) */public static final Component createComponents(String uri,Component parent, @SuppressWarnings("rawtypes") Map args) {return Executions.createComponents(uri, parent, args);}/** * 从zul格式字符串创建组件,创建的组件将作为第二个参数的子组件,如果第二个参数为null, * 那么创建的组件将作为当前Execution关联的page的子组件; * <p> * 如果content内包含&lt;?page id=&quot;pageId&quot; * title=&quot;这个是标题&quot;?&gt;页面指令 * ,在createComponents中该语句指令失效,createComponents方法不会因此创建Page对象, 当然 * <code>desktop.getPage("pageId")</code的时候返回的是null *  * @param content *            zul格式内容的字符串 * @param parent *            父组件,如果为null,那么组件所属的页面为当前页面,当前页面由execution上下文决定。 *            另外新的组件将作为当前页面的根组件 * @param args *            一个map类型的参数, 传递的参数可以使用{@link Executions#getArgs()}获得 * @return 根据content创建的组件第一个组件 */public static final Component createComponentsDirectly(String content,Component parent, @SuppressWarnings("rawtypes") Map args) {return Executions.createComponentsDirectly(content, "zul", parent, args);}/** * 重绘组件 * <p> * 仅允许在<b>请求处理阶段</b>和<b>事件处理阶段</b>调用, 不允许在<b>呈现阶段</b>调用 *  * @param comp */public static final void redraw(Component comp) {comp.invalidate();}/** * 重绘页面 * <p> * 仅允许在<b>请求处理阶段</b>和<b>事件处理阶段</b>调用, 不允许在<b>呈现阶段</b>调用 *  * @param page */public static final void redrawPage(Page page) {page.invalidate();}/** * 弹出消息提示框 *  * @param message *            提示消息 * @param title *            提示框标题 */public static final void showInformation(String message, String title) {try {Messagebox.show(message, title, Messagebox.OK,Messagebox.INFORMATION);} catch (InterruptedException e) {// ignore}}/** * 弹出警告提示框 *  * @param message *            提示消息 * @param title *            提示框标题 */public static final void showExclamation(String message, String title) {try {Messagebox.show(message, title, Messagebox.OK,Messagebox.EXCLAMATION);} catch (InterruptedException e) {// ignore}}/** * 弹出消息提示框 *  * @param message *            提示消息 * @param title *            提示框标题 */public static final void showError(String message, String title) {try {Messagebox.show(message, title, Messagebox.OK, Messagebox.ERROR);} catch (InterruptedException e) {// ignore}}/** * 询问提示框 * <p> * 如果禁用事件处理线程,该方法会立即返回,返回值永远为true。 如果作为if判断语句的条件, * 那么else部分永远不会执行,启用和开启事件处理请查看zk.xml配置: <br /> * &lt;system-config&gt;<br /> * &lt;disable-event-thread&gt;false&lt;/disable-event-thread&gt;<br /> * &lt;/system-config&gt; *  * @param message *            提示消息 提示框标题 * @return 禁用事件处理线程该方法永远返回true,启用事件处理相称时,如果用户点击ok按钮,返回true,反之false */public static final boolean showQuestion(String message, String title) {try {return Messagebox.OK == Messagebox.show(message, title,Messagebox.OK | Messagebox.CANCEL, Messagebox.QUESTION);} catch (InterruptedException e) {// ignorereturn false;}}/** * 询问提示框 * <p> * 该方法是一个类似 {@link #showQuestion(String, String)} * 的方法,但与其不同的是,当禁用事件处理线程时,该方法非常有用。 * <p> *  * <p> * 示例:<br /> * <hr> *  * <pre> * ZkUtils.showQuestion(&quot;您确定删除该记录吗?&quot;, &quot;询问&quot;, new EventListener() { * &#064;Override * public void onEvent(Event event) throws Exception { * int clickedButton = (Integer) event.getData(); * if (clickedButton == Messagebox.OK) { * // 用户点击的是确定按钮 * } else { * // 用户点击的是取消按钮 * } * } *  * }); * </pre> *  * <hr> * <p> *  * <table border="1"> * <tr> * <td>按钮名称</td> * <td>事件名称</td> * </tr> * <tr> * <td>确定</td> * <td>onOK</td> * </tr> * <tr> * <td>取消</td> * <td>onCancel</td> * </tr> * </table> *  * @param message * @param title * @param eventListener */public static final void showQuestion(String message, String title,EventListener eventListener) {try {Messagebox.show(message, title, Messagebox.OK | Messagebox.CANCEL,Messagebox.QUESTION, eventListener);} catch (InterruptedException e) {// ignore}}/** * 给指定组件添加错误提示 * <p> * 清除错误,需要使用{@link #clearWrongValue(Component)} *  * @param comp * @param message *            错误提示消息 * @see #clearWrongValue(Component) */public static final void addWrongValue(Component comp, String message) {Clients.wrongValue(comp, message);}/** * 清除指定组件的错误提示 * <p> * 例如在输入组件中指定constraint属性验证用户输入,输入错误时,弹出提示, 该 方法可以清除这个提示框 *  * @param comp */public static final void clearWrongValue(Component comp) {Clients.clearWrongValue(comp);}/** * 清除列表中组件的错误提示 *  * @see #clearWrongValue(Component) */public static final void clearWrongValue(@SuppressWarnings("rawtypes") List comps) {Clients.clearWrongValue(comps);}/** * 设置或删除widget的事件监听器,如果已经有同样的事件监听,那么上一个将被替换 * *  * <pre> * ZkUtils.addWidgetEventListener(txtAge, &quot;onKeyPress&quot;, &quot;&quot; * + &quot;    if(event.keyCode&lt;48||event.keyCode&gt;57){         &quot; * + &quot;       return false;                                 &quot; + &quot;     }   &quot; * + &quot;   &quot;); * </pre> *  * * * <p> * 与comp.addEventListener()和<component * onClick=""/>中的事件处理(EventHandler)不同,该事件处理运行于客户端 *  * @param comp * @param evtName *            事件名称,例如onClick * @param script *            javascript脚本代码,书写格式可按照html事件中js代码格式,如果为空,那么事件处理程序被删除 */public static final void setWidgetEventListener(Component comp,String evtName, String script) {comp.setWidgetListener(evtName, script);}/** *  * 向指定组件事件追加事件监听器 *  * <pre> *  * ZkUtils.addWidgetEventListener(txtAge, &quot;onKeyPress&quot;, &quot;&quot; * + &quot;    if(event.keyCode&lt;48||event.keyCode&gt;57){         &quot; * + &quot;       return false;                                 &quot; + &quot;     }   &quot; * + &quot;   &quot;); * </pre> * <p> * 与comp.addEventListener()和<component * onClick=""/>中的事件处理(EventHandler)不同,该事件处理运行于客户端 *  * @param comp * @param evtnm *            事件名称,例如onClick * @param script *            javascript脚本代码,书写格式可按照html事件中js代码格式 */public static final void addWidgetEventListener(Component comp,String evtnm, String script) {if (script == null || "".equals(script.trim())) {return;}String oldScript = comp.getWidgetListener(evtnm);if (oldScript == null) {oldScript = "";}comp.setWidgetListener(evtnm, oldScript + script);}/** * 验证表单 * <p> * 需要input元素的constraint属性的支持 * <p> *  * 例如 年龄&lt;textbox constraint=&quot;/^[0-9]*$/:仅允许输入数字&quot;/&gt; *  * @param formContainer *            Input元素公共组件,即需要验证的输入元素所在的公共容器组件,这个form在zk里是虚拟的, *            任何容器组件都可以是一个form容器 * @return 如果验证成功返回true,否则返回false */public static boolean validateForm(Component formContainer) {return validateForm(formContainer, true);}/** * 验证表单 * <p> * 需要input元素的constraint属性的支持 *  * 例如 年龄 &lt;textbox constraint=&quot;/^[0-9]*$/:仅允许输入数字&quot;/&gt; *  * @param formContainer *            Input元素公共组件,即需要验证的输入元素所在的公共容器组件,这个form在zk里是虚拟的, *            任何容器组件都可以是一个form容器 * @param showError *            是否显示错误提示 * @return 如果验证成功返回true,否则返回false */public static boolean validateForm(Component formContainer,boolean showError) {try {validateForm0(formContainer, showError);return true;} catch (Exception e) {return false;}}private static void validateForm0(Component formContainer, boolean showError) {@SuppressWarnings("unchecked")List<Component> cList = formContainer.getChildren();if (cList == null || cList.size() < 1) {return;} else {for (Component c : cList) {if (c instanceof InputElement && !((InputElement) c).isValid()) {if (showError) {((InputElement) c).getText();}throw new RuntimeException("表单输入不正确!");} else {validateForm0(c, showError);}}}}/** * 结束长操作处理 * <p> * 一个业务操作可能要一段时间可以处理完成,在处理期间,又不想让用户操作界面,影响业务处理等, * 那么可以在前台事件中调用zk.startProcessing(),此时左上角出现提示框,"正在处理,请稍候...", 那么待业务处理过后再try * catch finally{}块里调用该方法,通知客户端操作完毕 */public static final void endProcessing() {Clients.evalJavaScript("zk.endProcessing();");}}

热点排行