目录导航
?
本节开始,进行代码的实战练习。我的这个App是管理保险客户信息的,数据采用Sqlite存储在本地手机上,第一次使用需要先登记自己的个人信息,这个功能非常简单,也无关紧要,我是拿这个练手,方便做后面复杂的功能。
?
- 效果图
废话不多说,先看看个人信息的效果。
?
主页右上角一个[设置]按钮,点击按钮会弹出对话框,目前只有一个[我的信息]用于查看个人信息。
点击弹出框上的[我的信息],这时会进行个人信息详细列表,点击[返回]按钮会回到主页,而点击[修改]按钮会跳转到个人信息修改页面。
?
下图是从[我的信息]页面点击[编辑]按钮,跳转到的个人信息修改页面。
如果是第一次使用该程序,会被默认跳转到这个页面,并且没有返回按钮。
?
?
点击保存按钮会进行输入有效性验证,如果表单数据有错会在页面提示错误信息。
?
?
- 数据库相关
如果不了解SQLite用法,建议先看看[学习系列(5)-SQLite数据库]。
?
个人信息建表代码如下:
StringBuilder user_info = new StringBuilder(); user_info.append("CREATE TABLE IF NOT EXISTS \"user_info\" ("); user_info.append("\"id\" INTEGER NOT NULL,"); user_info.append("\"name\" varchar(99),"); user_info.append("\"sex\" INTEGER,"); user_info.append("\"birthday\" varchar(32),"); user_info.append("\"mobile_phone\" varchar(32),"); user_info.append("\"email\" varchar(99),"); user_info.append("\"delete_flag\" INTEGER,"); user_info.append("\"user_type\" INTEGER,"); user_info.append("\"update_time\" varchart(99),"); user_info.append("\"id_number\" varchart(99),"); user_info.append("\"qq_number\" varchart(99),"); user_info.append("\"address\" varchart(999),"); user_info.append("PRIMARY KEY (\"id\")"); user_info.append(");"); db.execSQL(user_info.toString());
?
对应的JavaBean如下,为了方便,我的属性名全部与数据库字段一致,某些带下划线的也就没使用驼峰命名模式。
public class UserInfo extends BasePO{ private static final long serialVersionUID = -8834697836148097731L; private Long id; private String name; private int sex; private String birthday; private String mobile_phone; private String id_number; private String qq_number; private String email; private String address; private int delete_flag; private int user_type; private String update_time; ......}
?
而Manager类似于DAO层,嫌麻烦,没有分开,增删改查全部在BaseManagerImpl封装好的,有特殊SQL才在UserManager中实现。
public class UserManager extends BaseManagerImpl<UserInfo>{ public UserManager(Context context) { super(context); super.TABLE = "user_info"; super.clazz = UserInfo.class; } public UserInfoBO getCurrentUser(){ String sql = "SELECT * FROM "+TABLE+" ORDER BY update_time DESC"; List<UserInfo> userList = super.findBySql(sql, null, 1, 1); if(!ObjectUtils.isEmpty(userList)){ return new UserInfoBO(userList.get(0)); } return null; }}
?
public class BaseManagerImpl<T> implements BaseManager<T> { protected String LOG_TAG = "BaseManagerImpl"; protected String TABLE = null; protected DBHelper dbHelper = null; protected Class clazz = null; protected Context context = null; public BaseManagerImpl(Context context) { super(); dbHelper = BeanFactory.getDBHelper(context); } @Override public long save(T t) { SQLiteDatabase db = dbHelper.getWritableDatabase(); return db.insert(TABLE, null, ClassUtils.getContentValues(t)); } @Override public int delete(Serializable id) { SQLiteDatabase db = dbHelper.getWritableDatabase(); return db.delete(TABLE, "id=?", new String[]{id.toString()}); } @Override public int update(T t) { SQLiteDatabase db = dbHelper.getWritableDatabase(); try { return db.update(TABLE, ClassUtils.getContentValues(t), "id=?", new String[]{ClassUtils.getFieldValue(t, "id").toString()}); } catch (Exception e) { Log.e(LOG_TAG, "反射无法找到对象的ID值", e); return 0; } } @Override public T get(Serializable id) { String getSQL = "SELECT * FROM "+TABLE+" WHERE id=?"; List<T> list = this.findBySql(getSQL, new String[]{id.toString()}, 0, 0); if(!ObjectUtils.isEmpty(list)){ return list.get(0); } return null; } @Override public List<T> findBySql(String sql, String[] params,int pageSize,int pageNo) { if(StringUtils.isBlank(sql)){ throw new RuntimeException("findBySql的sql不能为空!"); } if(pageSize != 0 && pageNo != 0){//分页操作 int begin = (pageSize - 1)*pageNo; sql = sql + " limit "+begin + ","+pageNo; } SQLiteDatabase db = dbHelper.getReadableDatabase(); Cursor cursor = db.rawQuery(sql, params); List<T> tList = null; try { tList = ClassUtils.getObject(cursor, clazz); } catch (Exception e) { Log.e(LOG_TAG, "反射创建对象失败,clazz:"+clazz.getName(), e); }finally{ cursor.close(); } return tList; } @Override public List<Map<String,String>> find(String sql,String[] params,int pageSize,int pageNo){ if(StringUtils.isBlank(sql)){ throw new RuntimeException("findBySql的sql不能为空!"); } if(pageSize != 0 && pageNo != 0){//分页操作 int begin = (pageSize - 1)*pageNo; sql = sql + " limit "+begin + ","+pageNo; } SQLiteDatabase db = dbHelper.getReadableDatabase(); Cursor cursor = db.rawQuery(sql, params); List<Map<String,String>> list = new ArrayList<Map<String,String>>(); try { String[] columnNames = cursor.getColumnNames(); Map<String,String> map = null; while (cursor.moveToNext()) { map = new HashMap<String, String>(); for (String column : columnNames) { map.put(column, cursor.getString(cursor.getColumnIndex(column))); list.add(map); } } } catch (Exception e) { Log.e(LOG_TAG, "反射创建对象失败,clazz:"+clazz.getName(), e); }finally{ cursor.close(); } return list; } @Override public void updateBySql(String sql, Object[] params) { SQLiteDatabase db = dbHelper.getWritableDatabase(); db.execSQL(sql, params); } @Override public List<T> findAll() { String findAllSql = "SELECT * FROM "+TABLE; return this.findBySql(findAllSql, null, 0, 0); }}
?
- 开发过程
数据库存储准备好之后,就是开发实体功能。因为采用的是Web开发,所以肯定会涉及HTML和javascript文件,我将这些文件全部放在assets目录下,如下图所示。
?
?
------>入口界面
应用程序的入口界面是home.html,前面提到过JqueryMobile的转场方式采用的是AJAX的形式转场,也就是说所有的跳转都是在home.html中操作,所以home.html一定要包含所有的css和js文件,而其它html则完全不需要再单独引用js等(引用了也无效)。
<head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/> <meta name="viewport" content="width=device-width, initial-scale=1"> <link rel="stylesheet" href="../scripts/jquery.mobile-1.3.2/jquery.mobile-1.3.2.min.css" type="text/css"> <script src="../scripts/jquery.mobile-1.3.2/jquery.js" type="text/javascript" > </script> <script src="../scripts/jquery.mobile-1.3.2/jquery.mobile-1.3.2.min.js" type="text/javascript" > </script> <script src="../scripts/bless.ui.core.js" type="text/javascript" > </script> <script src="../scripts/home/bless.home.js" type="text/javascript" > </script> <script src="../scripts/insurer/bless.insurer.js" type="text/javascript" > </script> <script src="../scripts/insure_remind/bless.insurer_remind.js" type="text/javascript" > </script> <script src="../scripts/self/bless.self.js" type="text/javascript" > </script> <script src="../scripts/insurance_company/bless.company.js" type="text/javascript" > </script> <title> </title> </head><body><div data-role="page" id="home_index_page">......</div></body>
?
每次用户进入home.html页面都会先检查用户是否注册个人信息,如果没有则会直接跳转到个人信息新增页面(self_edit.html)。
$(document).on("pageinit", "#home_index_page", function() { initData_home(); }); //全部变量 用于存储当前用户 var CURRENT_USER; function initData_home() { var currentUserJson = javascriptUser.getCurrentUser(); if (!$.isNull(currentUserJson)) { CURRENT_USER = $.parseJSON(currentUserJson); $("#home_index_page").find("#header_h1").html(CURRENT_USER.name); } else { $.changePageInitData("self/self_edit.html","self_edit_page",function(page, data, params){ javascriptUser.toUserNew(); initData_self_edit(page); }); } }
注意一点:javascriptUser不是我在javascript中定义的,而是Android的WebView控件自己提供的后台与前台数据交互的接口,这个是一个Java类,你可以在里面编写各种后台代码,然后在前台通过[java类.方法]的形式调用后台数据,非常方便。但是注意这个Java类的参数和返回值最好都用最简单的数据类型(我基本都是用String)。
?
public class JavascriptUser { protected Activity activity; protected AppContext app; protected UserManager userManager; protected InsurerInfoManager insurerInfoManager; protected InsurancesManager insurancesManager; protected ImageInfoManager imageInfoManager; protected InsuranceCompanyManager insuranceCompanyManager; public JavascriptUser(Activity activity) { super(); this.activity = activity; app = (AppContext) activity.getApplication(); userManager = (UserManager) BeanFactory.getDBManager(UserManager.class, activity); insurerInfoManager = (InsurerInfoManager) BeanFactory.getDBManager(InsurerInfoManager.class, activity); insurancesManager = (InsurancesManager) BeanFactory.getDBManager(InsurancesManager.class, activity); imageInfoManager = (ImageInfoManager) BeanFactory.getDBManager(ImageInfoManager.class, activity); insuranceCompanyManager = (InsuranceCompanyManager) BeanFactory.getDBManager(InsuranceCompanyManager.class, activity); } ......}
?
?在MainActivity中注册与前端关联。
/** javascript与Java对象映射,页面可使用javascript:ajax.xx()来调用AjaxManager的方法 */webView.addJavascriptInterface(new JavascriptUser(MainActivity.this), "javascriptUser");
?
有了JavascriptUser后台接口就非常方便了,你就可以用在里面写代码逻辑来查询数据库数据,判断用户是否存在。
?
------>新增/修改页面
新增和修改因为文本元素一样,所以共用一个页面。根据我的开发习惯,代码逻辑先不写,而是先把界面UI做好,下面是self_edit.html页面代码。
<!DOCTYPE html><html> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/> <meta name="viewport" content="width=device-width, initial-scale=1"> <title> </title> </head> <body> <div data-role="page" data-control-title="修改我的信息" id="self_edit_page"> <div data-theme="b" data-role="header" data-position="fixed"> <a id="a_back" data-role="button" data-rel="back" href="#" class="ui-btn-left" data-icon="back">返回</a> <h3> 修改我的信息 </h3> <a id="a_save" data-role="button" data-theme="b" href="#" data-icon="check" data-iconpos="left" class="ui-btn-right"> 保存 </a> </div> <div data-role="content"> <h5 style="color:red" id="error_msg"></h5> <form method="post" action="#"> <input type="hidden" name="id" id="id" > <input type="hidden" name="delete_flag" id="delete_flag" > <input type="hidden" name="user_type" id="user_type" > <div role="main" class="ui-content"> <div class="ui-field-contain" data-controltype="textinput"> <label for="name"> 姓名 </label> <input name="name" id="name" placeholder="您的姓名..." value="" type="text"> </div> <div id="sex" class="ui-field-contain" data-controltype="radiobuttons"> <fieldset data-role="controlgroup" data-type="horizontal"> <legend> 性别 </legend> <input id="radio1" name="sex" value="1" type="radio" checked="checked"> <label for="radio1"> 男 </label> <input id="radio2" name="sex" value="2" type="radio"> <label for="radio2"> 女 </label> </fieldset> </div> <div class="ui-field-contain" data-controltype="dateinput"> <label for="birthday"> 生日 </label> <input name="birthday" id="birthday" placeholder="您的出生日期..." value="" type="date"> </div> <div class="ui-field-contain" data-controltype="textinput"> <label for="id_number"> 身份证号 </label> <input name="id_number" id="id_number" placeholder="您的身份证号码..." value="" type="text"> </div> <div class="ui-field-contain" data-controltype="textinput"> <label for="mobile_phone"> 移动电话 </label> <input name="mobile_phone" id="mobile_phone" placeholder="您的手机号码..." value="" type="tel"> </div> <div class="ui-field-contain" data-controltype="textinput"> <label for="email"> 电子邮箱 </label> <input name="email" id="email" placeholder="您的E-Mail地址..." value="" type="email"> </div> <div class="ui-field-contain" data-controltype="textinput"> <label for="qq_number"> QQ </label> <input name="qq_number" id="qq_number" placeholder="您的QQ号码..." value="" type="text"> </div> <div class="ui-field-contain" data-controltype="textarea"> <label for="address"> 联系地址 </label> <textarea name="address" id="address" placeholder="你的直接联系地址..."></textarea> </div> </div> </form> </div> </div> </body></html>
?整个页面都是采用JqueryMobile样式,对于新手不知道怎么做页面布局的,我建议到JqueryMobile中文站了解,该站点首页有一个“jquery mobile UI builder”页面元素在线设计器,你可以通过拖动控件的形式设计页面元素,然后选择“inspect code”查看代码。
?
新增修改页面唯一的交互操作就是[保存]按钮,当用户点击[保存]按钮时,首先用js获取页面元素的值,然后以参数的形式调用与后台交互的JavascriptUser接口中的saveUserInfo方法执行输入有效性和保存操作。
$(document).on("pageinit", "#self_edit_page", function() { $("#self_edit_page").find("#a_save").unbind("click").bind("click",function(){ //保存 var pageDom = $("#self_edit_page"); var id = pageDom.find("#id").val(); var name = pageDom.find("#name").val(); //radio button获取值得方式 var sex = pageDom.find('input[name="sex"]:checked').val(); var birthday = pageDom.find("#birthday").val(); var mobilePhone = pageDom.find("#mobile_phone").val(); var email = pageDom.find("#email").val(); var delete_flag = pageDom.find("#delete_flag").val(); var user_type = pageDom.find("#user_type").val(); var id_number = pageDom.find("#id_number").val(); var qq_number = pageDom.find("#qq_number").val(); var address = pageDom.find("#address").html(); //调用JavascriptUser的saveUserInfo保存信息 var result = javascriptUser.saveUserInfo(id, name, sex, birthday, mobilePhone, email, delete_flag, user_type, id_number, qq_number, address); if ($.startWith(result,"true,")) {//返回true则保存成功 if($.isNull(id)){//第一次注册后返回到主页 $.mobile.changePage ('../home.html'); }else{//编辑操作返回 个人详细信息页面 $.changePageInitData("self_detail.html","self_detail_page",function(page, data, params){ initData_self_Detail(page, result.substring("true,".length) ); }); } } else {//返回其它信息则将错误信息显示在页面 $("#self_edit_page").find("#error_msg").html(result); } }); });
?
public String saveUserInfo(String id_,String name,String sex,String birthday,String mobile_phone,String email,String deleteFlag_,String userType_, String id_number,String qq_number,String address){ try { /**先做输入有效性验证*/ List<Validator> list = new ArrayList<Validator>(); list.add( new Validator(ValidateUtils.ValidateEnum.EMPTY, "姓名", new Object[]{name}) ); list.add( new Validator(ValidateUtils.ValidateEnum.CHARACTERS, "姓名", new Object[]{name.trim(),"<>'\""}) ); if(StringUtils.isNotBlank(birthday)){ list.add( new Validator(ValidateUtils.ValidateEnum.DATE, "生日", new Object[]{birthday,"yyyy-MM-dd"}) ); } if(StringUtils.isNotBlank(mobile_phone)){ list.add( new Validator(ValidateUtils.ValidateEnum.NUMBER, "移动电话", new Object[]{mobile_phone}) ); } if(StringUtils.isNotBlank(email)){ list.add( new Validator(ValidateUtils.ValidateEnum.EMAIL, "E-Mail", new Object[]{email}) ); } if(StringUtils.isNotBlank(qq_number)){ list.add( new Validator(ValidateUtils.ValidateEnum.NUMBER, "QQ", new Object[]{qq_number}) ); } String check = ValidateUtils.validateList(list); if(StringUtils.isNotBlank(check)){ return check; } /**再做入库操作*/ boolean edit = StringUtils.isNotBlank(id_); Long id = StringUtils.isNotBlank(id_) ? Long.valueOf(id_) : UserInfo.uuid(); Integer delete_flag = Enums.DeleteEnum.AVAILABLE.getKey(); Integer user_type = StringUtils.isNotBlank(userType_) ? Integer.valueOf(userType_) : Enums.UserTypeEnum.USER.getKey(); String update_time = DateUtil.date2string(new Date(), DateUtil.yyyy_MM_dd_HH_mm_ss); UserInfo user = new UserInfo(id, name, Integer.valueOf(sex), birthday, mobile_phone, id_number, qq_number, email, address, delete_flag, user_type, update_time); if(edit){ userManager.update(user); Log.i(Enums.LogTagEnum.COMMON.getKey(), "修改个人信息:"+user.toString()); }else{ userManager.save(user); Log.i(Enums.LogTagEnum.COMMON.getKey(), "新增个人信息:"+user.toString()); } // 初始化当前用户 app.setUser(new UserInfoBO(user)); return "true,"+user.getId(); } catch (Exception e) { Log.e(Enums.LogTagEnum.COMMON.getKey(), "输入异常:"+e.getMessage(), e); return "输入异常:"+e.getMessage(); } }
?我写了一个非常非常简单的Validator验证组件,因为为了方便写了很多小组件,具体逻辑在后面章节[组件化]统一说明。
?
?
------>个人信息详细页面
在首页选择"我的信息"可以跳转到个人信息页面,首先先看self_detail.html页面代码。
<!DOCTYPE html><html> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/> <meta name="viewport" content="width=device-width, initial-scale=1"> <title> </title> </head> <body> <!-- data-dom-cache="true" --> <div data-role="page" data-control-title="我的信息" id="self_detail_page" > <div data-theme="b" data-role="header" data-position="fixed"> <a data-role="button" data-rel="back" data-transition="slide" href="#" class="ui-btn-left" data-icon="back">返回</a> <h3> 我的信息 </h3> <a id="a_edit" data-role="button" data-theme="b" href="#" data-icon="edit" data-iconpos="left" class="ui-btn-right"> 修改 </a> </div> <div data-role="content"> <ul data-role='listview' id="ul_self_detail"> </ul> </div> </div></body></html>
?
下面这段是转场到self_detail.html的逻辑代码,在转场到self_detail.html时会调用JavascriptUser接口获取个人信息数据。
$(document).on("pageinit", "#home_setting_page", function() { $("#home_setting_page").find("#a_editSelf").unbind("click").bind("click", function() { $.changePageInitData("self/self_detail.html","self_detail_page",function(page, data, params){ initData_self_Detail(page,CURRENT_USER.id); }); }); });function initData_self_Detail(pageDOM,id) { if (id != undefined) { //修改操作 var userJson = javascriptUser.getUser(id); var currentUser = $.parseJSON(userJson); var DOM = pageDOM.find("#ul_self_detail"); var html = ""; html = html + "<li><p>姓名:"+currentUser.name+"</p></li>"; html = html + "<li><p>性别:"+ (currentUser.sex==1 ? "男" : "女") +"</p></li>"; html = html + "<li><p>生日:"+currentUser.birthday+"</p></li>"; html = html + "<li><p>移动电话:"+currentUser.mobile_phone+"</p></li>"; html = html + "<li><p>电子邮箱:"+currentUser.email+"</p></li>"; html = html + "<li><p>身份证号:"+currentUser.id_number+"</p></li>"; html = html + "<li><p>QQ号:"+currentUser.qq_number+"</p></li>"; html = html + "<li><p>联系地址:"+currentUser.address+"</p></li>"; DOM.html(html); //只有执行刷新操作才能出ListView样式 DOM.listview("refresh"); }else{ pageDOM.find("#a_back").hide(); }}
?
?
------>详情页面到修改页面
最后一个功能是self_detail.html页面点击[修改]按钮进入self_edit.html页面并且将数据回填到页面元素中。
$(document).on("pageinit", "#self_detail_page", function() { $("#self_detail_page").find("#a_edit").unbind("click").bind("click",function(){ $.changePageInitData("self_edit.html","self_edit_page",function(page, data, params){ initData_self_edit(page,CURRENT_USER.id); }); }); }); function initData_self_edit(pageDOM,id) { if (id != undefined) { //修改操作 var userJson = javascriptUser.getUser(id); var currentUser = $.parseJSON(userJson); pageDOM.find("#id").val(currentUser.id); pageDOM.find("#delete_flag").val(currentUser.delete_flag); pageDOM.find("#user_type").val(currentUser.user_type); pageDOM.find("#name").val(currentUser.name); $.radioChecked(pageDOM.find("input[name='sex']"),currentUser.sex); pageDOM.find("#birthday").val(currentUser.birthday); pageDOM.find("#mobile_phone").val(currentUser.mobilePhone); pageDOM.find("#email").val(currentUser.email); pageDOM.find("#id_number").val(currentUser.id_number); pageDOM.find("#qq_number").val(currentUser.qq_number); pageDOM.find("#address").html(currentUser.address); }else{ pageDOM.find("#a_back").hide(); }}
?
?
- 特别功能点
1、关于WebView与javascript交互:不是只有javascript调用Java,也可以java调用javascript方法。具体可参考博客[Android中webview跟JAVASCRIPT中的交互]
?
2、关于JqueryMobile页面转场及传参与常规的Java Web有很大不同,可以参考我的博客[学习系列(4)-页面转场及参数传递]或者这个博客[Jquery Mobile中文章跳转传值如何实现]
?
3、javascript调用Java代码传递的参数和返回值最好都是基本数据类型,我基本用的String,以前试过用JavaBean或者Map之类的不行。
?
4、如果javascript想从后台获得一个对象或者对象集合,建议在后台转换成JSON字符串,然后在前端通过$.parseJSON转换成对象。一定要注意的是JavaBean中的属性值一定不能包含"\n"(换行符)之类的特殊字符,如果有的话,传给$.parseJSON就会报错,而且LogCat不会直接说这行错了,而是会显示一些莫名其妙的错误提示,很难跟踪。
关于"\n"换行符的解决办法非常简单,就是将字符串"\n"替换成"\\n":
String value ......value.replaceAll("\r\n", "\\\\r\\\\n").replaceAll("\n", "\\\\n")
?
5、动态添加listview元素之后一定要刷新listview,否则JqueryMobile不会渲染成自己的效果。
$("#listview").append(......);$("#listview").listview("refresh");
?
6、radio button动态设置值的话也要刷新checkboxradio,否则页面看起来没效果:
$.radioChecked(pageDOM.find("input[name='sex']"),currentUser.sex);$.radioChecked = function(fn, value) { for (var i = 0; i < fn.length; i++) { if ($(fn[i]).val() == value) { $(fn[i]).attr("checked",true).checkboxradio("refresh"); } else { $(fn[i]).attr("checked",false).checkboxradio("refresh"); } }};
?
?