使用Titanium Mobile开发iPhone/Android应用（04）- Twitter客户端之使用OAuth调用API

这回我们将说明使用OAuth调用API。Twitter API基本上都使用的是OAuth作为认证，所以要做Twitter客户端，OAuth是不可缺少的一个技术点。

[b]制作发消息页面[/b]

在实际开始使用OAuth认证之前我们想做一个发消息的页面。在第一回页面的基础上，我们在页面右上角位置做成一个能够发消息的按钮，当按下该按钮后，表示出来发消息页面。

var win1 = Ti.UI.currentWindow;
var messageButton = Ti.UI.createButton(
    {
            systemButton: Titanium.UI.iPhone.SystemButton.ADD
    }
);
messageButton.addEventListener(
    'click',
    function () {
        var messageWindow = Ti.UI.createWindow(
            {
                url: 'message_window.js',
                title: 'message',
                backgroundColor: '#fff'
            }
        );
        messageWindow.open();
    }
);
win1.rightNavButton = messageButton;

在前回做好的table_view.js的最开始插入以下代码，需要注意的一点是，使用做成按钮的createButton方法，在页面左上也就是导航栏右侧放置的代码是win1.rightNavButton。这段代码使用了iPhone预先做好的系统按钮，只是做了iPhone的NavigationBar功能，当然在Android下是不能运行的，需要注意一下。

对于按钮，我们需要把重点放在，使用addEventlistener对click事件设置回调函数上。使用这个addEventlistener方法，在Titanium的开发中会频繁的使用它为应用的按钮等UI追加事件。相比HTML的WEBy应用，很相似的是，Javascript的一些方法。上边例子通过click事件，打开我们将要书写Tweeter的页面。 新打开的窗口我们将在message_window.js中编写代码。

message_window.js
var win = Ti.UI.currentWindow;
var textArea = Ti.UI.createTextArea(
    {
        height:150,
        width:300,
        top:10,
        font:{fontSize:20},
        borderWidth:2,
        borderColor:'#bbb',
        borderRadius:5
    }
);

win.add(textArea);
var postButton = Ti.UI.createButton(
    {
        top: 170,
        right: 10,
        width: 100,
        height: 44,
        title: 'POST'
    }
);
win.add(postButton);

这个就是message_window.js了。

首先只是对齐了一下布局，表示了输入框和发信按钮，但是都还没有什么动作。布局大概是以下这个样子的。

[img]http://dl.iteye.com/upload/attachment/609051/615bde52-29fd-3cde-8017-e2293ad51bb7.png[/img][img]http://dl.iteye.com/upload/attachment/609053/c02247f9-caf6-3e3d-920d-b8758f82ac2e.png[/img]

[b]OAuth认证的准备[/b]

我们已经准备好了页面，下一步就是编写发信announced点击后往Twitter中发送Tweeter的代码了。如前边所说，这样的API需要OAuth认证，所以我们需要提前准备一下。

首先，对已Twitter，想使用API的开发者必须申请。登录网站后，访问http://twitter.com/apps/new，填写一些必要信息后进行申请。

申请成功后，就可以获得OAuth所需要的Consumer Key和Cosumer Secret，把这两个值记载下来以后会用到。

[b]使用OAuth Adapter[/b]

作为从Titanium进行Twitter的OAuth的认证方法，需要使用[url=http://code.google.com/p/oauth-adapter/]OAuth Adapter[/url]库。使用这个库后，一些很麻烦的OAuth认证代码部分，这个库能提大家做了。还有一些相关联的库，所以需要下载以下文件后凡知道Project的Resorces/lib文件夹下。

[url=http://oauth-adapter.googlecode.com/svn-history/r17/trunk/oauth_adapter.js]oauth-adapter[/url]
[url=http://oauth.googlecode.com/svn/code/javascript/oauth.js]oauth.js[/url]
[url=http://oauth.googlecode.com/svn/code/javascript/sha1.js]sha1.js[/url]

放好文件后，在message_window.js中，按照如下修改代码，当按下发信时的处理中，使用oauth_adapter往Twitter中发信。

在代码开始的地方需要把'consumer_key' 和 'consumer_secret'替换成自己的值。

Ti.include('lib/oauth_adapter.js');
var oAuthAdapter = new OAuthAdapter(
    'consumer_secret',
    'consumer_key',
    'HMAC-SHA1'
);
oAuthAdapter.loadAccessToken('twitter');

function tweet(message) {
    oAuthAdapter.send(
        'https://api.twitter.com/1/statuses/update.json',
        [['status', message]],
        'Twitter', //警告标题
        'Published.', //成功后的消息
        'Not published.' //失败后的消息
    );

    if (oAuthAdapter.isAuthorized() == false) {
        var receivePin = function() {
            oAuthAdapter.getAccessToken(
                'https://api.twitter.com/oauth/access_token'
            );
            oAuthAdapter.saveAccessToken('twitter');
        };
        oAuthAdapter.showAuthorizeUI(
            'https://api.twitter.com/oauth/authorize?' +
                oAuthAdapter.getRequestToken(
                    'https://api.twitter.com/oauth/request_token'
                ),
            receivePin
        );
    }
}

postButton.addEventListener(
    'click',
    function () {
        if ( textArea.value ) {
            tweet( textArea.value );
        }
    }
);

win.add(postButton);

这样修改之后，把Tweeter写到TextArea中厚，点击发信按钮就能够看到一下页面。

[img]http://dl.iteye.com/upload/attachment/609055/c82e882e-ec42-3b67-9472-296f9a5e177d.png[/img]

根据这个页面的提示，使用这个Twitter客户端应用的用户就能往Twitter上发信了。在以后的发信处理中，就不在需要用户填写用户信息登录了。

这样原封不动的代码中，不能从发信后的页面返回。所以需要再一次启动应用，使用Web浏览器，用认证的Twitter账户登录后，查看发信是否成功。

在上边的代码中，很重要的一点是，利用Ti.include方法调用库。这个include方法，就相当于在该方法调用的地方书写指定那个文件内容一样的效果。

还有一点，函数tweet中，调用方法oAuthAdapter.send的地方，稍微有些难懂， 把数组[['status', message]]作为第2个参数就是往Twitter发信的Tweeter。


函数tweet中，以外的处理是，OAuth认证的开始，需要获得应用使用者的许可，上边页面那样表示出来的窗口中进行设定。这里需要理解OAuth的处理过程，大家可以参看其他关于OAuth的介绍。

总结

我们说了一下使用oauth_adapter库往Twitter发信的方法。从发信页面还不能返回，所以不能看到发送的Tweeter内容，是这个Twitter应用不足的地方以后的章节中将会进一步进行改善。