AOM2.0M1在2月2号就发布了:
引用
Apusic OperaMasks 2.0 M1 发布
1. 升级到Ext2.0
2. IoVC编程模型支持
3. 无状态支持
4. 增强调试辅助
5. 完善的布局组件
6. 组件快速开发支持
还有就是现在地球人都知道的:约定优先配置(Convention Over Configuration),AOM在2.0M1中已经得到了很大的支持。
我们以用户登陆例子开始AOM2.0的探索之旅。
新建apusic标准项目
点击 完成
新建一个web模块
点击下一步,将默认后缀名xhtml 选上
点击完成。
在web/webContent下新建登陆页面 login.xhtml
<f:view xmlns="http://www.w3.org/1999/xhtml" xmlns:f="http://java.sun.com/jsf/core"
xmlns:w="http://www.apusic.com/jsf/widget" xmlns:layout="http://www.apusic.com/jsf/layout"
xmlns:ajax="http://www.apusic.com/jsf/ajax"
renderKitId="AJAX" xmlns:h="http://java.sun.com/jsf/html">
<w:page>
<w:form clientValidate="true">
<layout:panelGrid columns="3">
<h:outputLabel for="username"/>
<w:textField id="username"/>
<h:message for="username"/>
<h:outputLabel for="password"/>
<h:inputSecret id="password" />
<h:message for="password"/>
<h:outputText id="message"/>
</layout:panelGrid>
<layout:panelGrid>
<w:button id="login"/>
</layout:panelGrid>
</w:form>
</w:page>
</f:view>
页面很简单,就是一个表单,包括用户名、密码还有个按钮。可是为什么label的value都没有值呢?不急,我们先继续做下去。
在web/src下,新建LoginBean.java
点击完成。
那么页面上的控件如何和代码绑定呢?
在Bean中
1:属性是通过元数据@Bind 来绑定页面对应控件的ID的。
2:方法是通过元数据@Action 来绑定页面对应控件的ID
LoginBean 修改成如下代码
package org.operamasks.demo.login;
import org.operamasks.faces.annotation.Action;
import org.operamasks.faces.annotation.Bind;
import org.operamasks.faces.annotation.ManagedBean;
import org.operamasks.faces.annotation.ManagedBeanScope;
@ManagedBean(scope = ManagedBeanScope.SESSION)
public class LoginBean {
/**
* 用户账号
*
* @Bind 表示绑定页面对应的控件
*/
@Bind
private String username;
/**
* 用户密码
*
* @Bind 表示绑定页面对应的控件
*/
@Bind
private String password;
/**
* 绑定页面id为message控件,用于显示消息
*/
@Bind
private String message;
/**
* 用户登陆
*
* @Action 表示页面对应id控件的action
*/
@Action
public void login() {
this.message = "欢迎你:"+this.username;
}
}
绑定的属性是可以直接在页面上通过el之类的表达式访问的,因此也无需要getter/setter了。
如何将页面和Bean对应起来,在jsf中,大家都知道通过faces-config.xml 来配置url,model-bean.在AOM中,可以简化掉这繁琐的工作。
在webContent/web-inf/目录下,新建operamasks.xml
<?xml version="1.0"?>
<operamasks-config xmlns="http://www.operamasks.org/IoVC"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.operamasks.org/IoVC http://www.operamasks.org/schema/operamasks.xsd ">
<view-mapping>
<url-pattern>*</url-pattern>
<model-bean>#{~View}Bean</model-bean>
</view-mapping>
</operamasks-config>
login.xhtml 会自动寻找bean:LoginBean,如果你的bean的name为小写,即loginBean,那么将
<model-bean>#{~View}Bean</model-bean>
中的大写V改成小写的v即可
<model-bean>#{~view}Bean</model-bean>
在那里配置bean的name?
哦,忘记了。在LoginBean代码中
@ManagedBean(name="loginBean",scope = ManagedBeanScope.SESSION)
public class LoginBean {
}
如果没有写,默认的是LoginBean。
好了,这就是全部可以运行的代码,我们测试下
Apusic Studio默认已经内置支持apusic,选择login.xhtml,点击右键浏览即可
有人要问,是不是不能在其他的服务器上运行呢?
当然可以,AOM并没有绑定死在Apusic上,如果你愿意(想),当然没有任何问题的。你可以参考operamasks.org上的文档
http://infocenter.apusic.com/help/index.jsp?topic=/org.operamasks.infocenter/output/eclipse/install_requirement.html
输入用户名测试下:
用户名和密码都是必须的,我该如何验证呢?
OK,该@Required登场了。修改LoginBean.java,在需要验证的地方,加上@Required元数据
/**
* 用户账号
*
* @Bind 表示绑定页面对应的控件
* @Required 验证 表示该属性是必须的
*/
@Bind
@Required
private String username;
/**
* 用户密码
*
* @Bind 表示绑定页面对应的控件
* @Required 验证 表示该属性是必须的
*/
@Bind
@Required
private String password;
保存代码,刷新下页面,看看效果
Great!
可是这个我可以放在客户端先验证的,没必要直接提交给服务器验证,该怎么办?
这个提议不错,AOM当然也提供支持,修改login.xhtml
<w:form>
为
<w:form clientValidate="true">
打开FireBug, 盯着 Console,再刷新,哦,确实是在客户端验证了。
那么错误信息可以自定义吗?
@Bind有个message属性,你可以直接输入 @Bind(messages="Ooops....")
还有更多验证吗?
当然有,不过不是本文的范围,会在接下来的文章中专门介绍。
输入框旁边的字符这么出来的呢?
这个是根据你的id自动产生的,首字母大写。
可是我想改呢?
控件都有个value的属性,直接修改即可
<h:outputLabel for="username" value="用户名"/>
看着上面直接在代码中输入 message ,value="用户名" 感觉代码的坏味道又出来了,我要全球化怎么办?
AOM很好,也很强大:) 已经有很到的支持了,每个bean会自动去加载同目录级别下的LocalStrings_xxx.properties
在LoginBean.java同目录新建
LocalStrings_en_US.properties
LoginBean.username.label=Username
LoginBean.password.label=Password
LoginBean.login.label=Login
LocalStrings_zh_CN.properties
LoginBean.username.label=用户名
LoginBean.password.label=密码
LoginBean.login.label=登陆
再次浏览页面
错误信息的改变:
还等什么呢?还不快来试试:)