这回我们说说使用数据库来操作数据。具体来说,就是我们在Twitter客户端的Home页面,取得Timeline数据后将其保存,这样一来我们就能在启动的时候显示前一次取得的Timeline数据,也能够检索Timeline中的内容。
取得Timeline
在最开始的页面上我们不仅仅显示自己的信息,也将Follow中的人的Timeline取出来显示。在以前我们做成的table_view.js中,关于Timeline取得部分的代码做如下修改:
Ti.include("lib/twitter_api.js"); Ti.include("twitter_settings.js"); Ti.include("tweet_db.js"); //initialization Ti.App.twitterApi = new TwitterApi({ consumerKey: TwitterSettings.consumerKey, consumerSecret: TwitterSettings.consumerSecret }); var twitterApi = Ti.App.twitterApi; twitterApi.init(); twitterApi.statuses_home_timeline( { onSuccess: function(response){ updateTimeline(db.savedTweets()); }, onError: function(error){ Ti.API.error(error); } } );
截止目前的message_window.js中的TwitterApi的初期化移到table_view.js中去,还有,通过TwitterApi对象实现TimeLine的取得。
Titanium.Database
在TItanium中,提供了通过Titanium.Database这个对象来访问RDBMS的功能,不管是在iPhone还是在Android中都能够使用提供的SQLite库。SQLite是Public Domain的RDBMS,由于其轻量并且高速的运行,被各个领域使用。如果习惯了MySQL等RDBMS的话,应该使用起来不会是困难。
这里,我们先做成一个连接数据库的对象,新做成一个tweet_db.js文件放置到Resources文件夹下,然后编写一下代码,在使用这个对象的时候,可以使用函数TweetDB。
var TweetDB = function() { this.dbName = 'tweetdb'; //(1) this.open = function () { //(2) this.db = Titanium.Database.open(this.dbName); }; this.close = function () { //(3) this.db.close(); }; this.addTweets = function (tweets) { //(4) this.open(); for (var i=0;i0 ) continue; var res = this.db.execute( 'INSERT INTO tweets (screen_name, profile_image_url, tweet_text, status_id, created_at) VALUES(?,?,?,?,?)', tweet.user.screen_name, tweet.user.profile_image_url, tweet.text, tweet.id_str, tweet.created_at ); Ti.API.debug('Add to DB'); } this.close(); return true; }; this.open(); this.db.execute('CREATE TABLE IF NOT EXISTS tweets (screen_name TEXT, profile_image_url TEXT, tweet_text TEXT, status_id TEXT, created_at TEXT)'); this.close(); };
我们从头解释一下这段代码。
最开始(1)的位置,把连接的数据库名设置到对象的属性中。
在下来的(2),(3)的位置,分别定义了open和close方法。这两个方法中,只是简单的实现了在数据库处理的开始时调用Titanium.Database.open,终了时调用close处理的功能。在open方法中,使用了Titanium.Database.open方法来开启数据库的连接。通过这个方法返回的Titatnium.Database对象来实现以后的各个数据库操作。
后边(4)的位置,我们定义了addTweet方法,将获取到TimeLine信息的数据tweets中需要保存的数据保存到数据库中。首先需要通过this.open()来连接到数据库。之后,对于TimeLine中的各个Tweet判断是否已经保存(A),没有保存的话,保存到数据库当中(B)。
var rows = this.db.execute( 'SELECT * FROM tweets WHERE status_id = ?', tweet.id_str ); Ti.API.debug('Found: ' + rows.getRowCount() ); if ( rows.getRowCount() > 0 ) continue;
其中所说的(A)处理就是,(5)位置的处理,对于保存到this.db当中的Titatnium.Database对象执行SQL的SELECT查询。其中第一个参数中的SQL语句里带有的‘?’是第二个参数以后为了变化SQL语句的占位符。
SQL执行后的结果中,如果有返回数据的时候,从execute方法的返回对象Titanium.Database.ResultSet的getRowCount()方法能判断出来。在这个例子中,返回数据的时候,判断getRowCount()比0大的时候,因为该Tweet已经被保存到了数据库中,所以不需要做任何处理,继续处理下一条Tweet。
还有在接下来的代码中,(B)的往数据库中保存数据部分,通过执行INSERT语句,将各个Tweet信息保存到DB中。
TimeLine中所有的Tweet处理完成之后,调用this.close()方法。关闭数据库连接,结束处理。
还有一个重要的地方是在定义了saveTweet方法之后,有以下代码:
this.db.execute('CREATE TABLE IF NOT EXISTS tweets (screen_name TEXT, profile_image_url TEXT, tweet_text TEXT, status_id TEXT, created_at TEXT)');
这段代码在这个TweetDB对象在被new的时候,只执行一次,tweets表不存在的时候,在数据库中做成tweets表的CREATE TABLE语句。
这样一来我们就准备好了往数据库中保存Tweet。TimeLine取得部分中将会保存Tweet。
var db = new TweetDB(); twitterApi.statuses_home_timeline( { onSuccess: function(response){ db.addTweets(response); updateTimeline(response); }, onError: function(error){ Ti.API.error(error); } } );
首先是做成TweetDB对象,在获取自己的TimeLine的时候,把内容传给addTweets方法,然后就能将Tweet内容保存到数据库中。
取出Tweet
因为我们已经把Tweet保存到了数据库中,表示的时候就需要从数据库中把Tweet取出来显示。这样一来,最新的Tweet和过去的Tweet就能连续的表示到页面上了。
下边在tweet_db.js中编写获取Tweet的getSavedTweets方法。
this.getSavedTweets = function() { this.open(); var rows = this.db.execute( 'SELECT * FROM tweets ORDER BY created_at DESC' ); //(1) var res = []; if ( rows.getRowCount() > 0 ) { while ( rows.isValidRow() ) { //(2) var tweetObj = {}; tweetObj.user = {}; tweetObj.user.screen_name = rows.fieldByName('screen_name'); tweetObj.user.profile_image_url = rows.fieldByName('profile_image_url'); tweetObj.text = rows.fieldByName('tweet_text'); var date = new Date(rows.fieldByName('created_at')); tweetObj.created_at = date.toLocaleString(); res.push(tweetObj); rows.next(); } } rows.close(); this.close(); return res; };
在(1)的位置,执行SELECT语句,将保存的所有Tweet取出。然后在(2)的位置将取出来的Tweet循环处理,挨个将其变化成和Twitter API返回的数据相同的结构。这里重点是循环处理的最后位置的rows.next()方法,一旦执行了这个方法,rows中指定的数据内容就变成了下一条数据,如果下一条数据不存在的话,isValidRow()将会返回false循环处理结束。
而且,Titanium.Database.ResultSet对象中的rows被close之后,以后将不能再被使用。所以还需要修改table_view.js中表示时候的Tweet取得方法。
twitterApi.statuses_home_timeline( { onSuccess: function(response){ db.addTweets(response); updateTimeline(db.getSavedTweets()); }, onError: function(error){ Ti.API.error(error); } } );
TimeLine取得之后,将其保存,然后再从数据库总取得数据。
检索Tweet
在这篇的最后,我们来实现一下简单的检索功能:按下页面左上角的Search按钮后,弹出检索窗口,然后能通过用户名来检索Tweet。
在tweet_db.js中追加,返回包含特定字符的用户的Tweet的方法。
this.searchByScreenName = function (screen_name) { this.open(); var rows = this.db.execute( 'SELECT * FROM tweets WHERE screen_name like ?', '%' + screen_name + '%' ); var res = []; if ( rows.getRowCount() > 0 ) { while ( rows.isValidRow() ) { var tweetObj = {}; tweetObj.user = {}; tweetObj.user.screen_name = rows.fieldByName('screen_name'); tweetObj.user.profile_image_url = rows.fieldByName('profile_image_url'); tweetObj.text = rows.fieldByName('tweet_text'); var date = new Date(rows.fieldByName('created_at')); tweetObj.created_at = date.toLocaleString(); res.push(tweetObj); rows.next(); } } rows.close(); this.close(); return res.length ? res : null; ;
和getSavedTweets方法基本上是一样的。参数中要执行的查询SQL语句的WHERE部分稍有不一样。SQL的WHERE部分通过like检索screen_name,返回用户名中包含了特定字符的用户的Tweet。
下来继续修改table_view.js的显示部分。
var search = Titanium.UI.createSearchBar({ //(1) height:43, top:0 }); win1.add(search); search.addEventListener('return', function(e) //(2) { var query = e.value; var res = db.searchByScreenName(query); if (res) { updateTimeline(res); } search.blur(); search.hide(); }); search.addEventListener('change', function(e) //(3) { if (e.value.length == 0 ) { updateTimeline(db.savedTweets()); search.blur(); search.hide(); } }); search.hide(); //(4) var searchButton = Ti.UI.createButton( //(5) { title: 'search' } ); searchButton.addEventListener( //(6) 'click', function () { search.show(); } ); win1.leftNavButton = searchButton;
在这部份代码中,(1)的位置是做成SearchBar对象。
(2)的位置是SearchBar中换行处理的监听。在(2)这里调用了刚才做好的searchByScreenName()方法,只显示用户名中包含输入的字符的用户的Tweet。
(3)的位置是SearchBar中字符发生变化时处理的监听。当SearchBar中没有字符的时候,将会把所有的Tweet表示出来。
SearchBar如果一直表示的话也不好,所以在(4)的位置将其先隐藏,然后在(5)的位置做成一个将SearchBar表示出来的按钮。
(6)的位置当按钮按下后,通过SearchBar对象的show()方法将其表示出来。
总结一下,我们说明了使用SQL来操作Tweet的数据,不仅能表示过去的Tweet信息,又能够实现Tweet的检索。从Tweet的例子当中我们也可以看出,在检索不重复保存的相同数据的时候,SQL也是很方便的。如果在使用Titanium开发应用的时候,需要使用大量的数据,最好考虑使用SQL。