Android开发者教程1: 实现一个登录对话框

转　：http://hi.baidu.com/android_fans/blog/item/1e203ad8878d182b10df9b3c.html

 

难度：
适合人员：刚接触Android的开发人员

简述：对网络应用来说“登录框”还是蛮常见的，Code上没有太复杂的东西，基本都是UI设计，很适合练手，代码登录后可下载。

需求分析：
1.实现用户名和密码的输入
2.提取用户名和密码信息
3.登录时有进度条
4.超时处理
5.登录成功跳转
6.（不都列举了， 大家根据实际情况自己添上吧）

Step 1：
目标：设计UI

1.1 编写Layout XML login_view.xml

这种四方规整的布局自然是TableLayout合适了。值得说明的是，每行用一个TableRow标签标识。论坛贴代码太难看了，所以只贴关键的了。完整代码教程写完后会提供下载的。

 

<TableRow>

<TextView android:text="@string/username"

android:layout_width="wrap_content"

android:layout_height="wrap_content" />

<EditText android:layout_width="fill_parent"

android:layout_height="wrap_content"
android:layout_weight="1.0" />

</TableRow>

增加Layout_weight属性是为了要EditText能延伸到最右侧

 

<LinearLayout>

<Button android:text="@string/login"

android:layout_width="wrap_content"

android:layout_height="wrap_content"

android:layout_weight="1.0" />

<Button android:text="@string/cancel"

android:layout_width="wrap_content"

android:layout_height="wrap_content"

android:layout_weight="1.0" />

</LinearLayout>

这里的Layout_weight属性是为了要两个Button的宽度相等，同时又能填充满一行。因为1.0 ：1.0 == 1：1. 所以宽度相等了。

 

在Eclipse中看下效果吧
[attach]501[/attach]

效果貌似还不错。

1.2 写个类测试一下

Dialog 与 Activity都可以加载这个Layout。

TestLoginView.java

package org.androidin.tutorial;

import android.app.Activity;
import android.app.Dialog;
import android.content.Intent;
import android.os.Bundle;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;

public class TestLoginView extends Activity {
    /** Called when the activity is first created. */
    public static Button btnActivity;
    public static Button btnDialog;
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);

        btnActivity = (Button)findViewById(R.id.test_activity);
        btnActivity.setOnClickListener(new BtnActivityOnclikListener());

        btnDialog = (Button)findViewById(R.id.test_dialog);
        btnDialog.setOnClickListener(new BtnDialogOnClickListener());
    }
   
    private class BtnDialogOnClickListener implements OnClickListener {
   
        public void onClick(View v) {
            Dialog dialog = new Dialog(TestLoginView.this);
            dialog.setContentView(R.layout.login_view);
            dialog.setTitle(getString(R.string.address));
            dialog.show();
        }
    }
   
    private class BtnActivityOnclikListener implements OnClickListener {
   
        public void onClick(View v) {
            Intent intent = new Intent();
            intent.setClass(TestLoginView.this, LoginVIewOnActivity.class);
            startActivity(intent);
        }
    }
}

LoginViewOnActivity.java

package org.androidin.tutorial;
import android.app.Activity;
import android.os.Bundle;

public class LoginVIewOnActivity extends Activity {
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setTitle(getString(R.string.address));
        setContentView(R.layout.login_view);
    }
}

   device1.png (7.76 KB)

2008-10-2 19:58   device2.png (10.39 KB)

2008-10-2 19:58   新建 BMP 图像.JPG (16.9 KB)

2008-10-2 19:58
Step 2：
目标 加入Progress UI，登录控件的架构设计（登录逻辑，失败或成功处理）。

首先加入Progress, 默认时Progress是不可见的，所以在android:visibility的属性上设置“gone”，该参数会让控件不显示且不占位，其他信息请参考官方文档。

<LinearLayout android:id="@+id/login_view_progress"
        android:visibility="gone">
        <rogressBar android:layout_width="wrap_content"
                android:layout_height="wrap_content"
        />
        <TextView android:text="@string/is_logining"
                android:textSize = "17.5sp"
                android:layout_width="wrap_content"
                android:layout_height="fill_parent"
                android:gravity = "center"
        />
</LinearLayout> 接下来终于到关键部分了。每个应用的登录逻辑是不一样的，所以写一个接口

public interface OnLoginListener {       
        public boolean onLogin(View v, String username, String password);
        // View v就是调用该方法的View，其他俩参数不说了
        public void onLoginSuccess(View v);
        public void onLoginFailed(View v);
}

接下来就要对整个LoginView进行封装了，因为要把XML中的View加入到LoginView中，所以继承了FrameLayout

public class LoginView extends FrameLayout {
        protected Button btnLogin;
        protected Button btnCancel;
        protected EditText edtUsername;
        protected EditText edtPassword;
       
        protected View progress;
        private OnLoginListener onLoginListener;
        LoginView(Context context);//对属性进行初始化
       
        public void setOnLoginListener(OnLoginListener l); //设置登录逻辑监听
        public void setCancelOnClickListener(OnClickListener l); //设置Cancel按钮的监听
        public void setLoginOnClickListener(OnClickListener l) ; //设置Login按钮的监听
}

 

接下来我们逐个实现方法。

 

这里只重载了一个构造方法，实际上可能需要重载多个，所以单独写一个初始化View的函数

 

private void initViews() {
        inflate(getContext(), R.layout.login_view, this);
        btnLogin = (Button) findViewById(R.id.login_view_login);
        btnCancel = (Button) findViewById(R.id.login_view_cancel);
        edtUsername = (EditText)findViewById(R.id.login_view_username);
        edtPassword = (EditText)findViewById(R.id.login_view_password);
        btnLogin.setOnClickListener(new LoginButtonListener()); //默认的处理逻辑监听 下文再说。
       
        progress = findViewById(R.id.login_view_progress);
       
}
public LoginView(Context context) {
        super(context);
        initViews();
}
public void setOnLoginListener(OnLoginListener l) {
        onLoginListener = l;
}
public void setCancelOnClickListener(OnClickListener l) {
        btnCancel.setOnClickListener(l);
}
public void setLoginOnClickListener(OnClickListener l) {
        btnLogin.setOnClickListener(l);
}

回过头来，研究上文加入的默认处理逻辑。

 

private class LoginButtonListener implements OnClickListener

 

一般的应用，登录都需要通过Socket远程连接，或者本地数据库连接。读取本地数据还好，可是用Socket通讯的话，估计要等一段时间。遇到网络阻塞，登录过程更是漫长。其次，Socket是一种阻塞的方式，也就是说，如果没有申请到连接，调用Socket的线程也属于等待状态。程序不会往下运行。

 

所以解决办法就是要新建个Thread来处理这个登录过程了。

 

 

private class LoginButtonListener implements OnClickListener {
    public void onClick(View v) {
        if (onLoginListener != null) {
            loginThread = new LoginThread();
            loginThread.start();
        }
    }
}

 

protected class LoginThread extends Thread {
    public void run() {
        handler.sendEmptyMessage(SET_ONLOGIN_TRUE); //设定控件不可用
        boolean flag = onLoginListener.onLogin(
        LoginView.this,
        edtUsername.getText().toString(),
        edtPassword.getText().toString());

 

        if (flag)
            onLoginListener.onLoginSuccess(LoginView.this);
        else
            onLoginListener.onLoginFailed(LoginView.this);
               
        handler.sendEmptyMessage(SET_ONLOGIN_FALSE); //设定控件可用
    }
};

 

这里的handler是用来在非主程序线程改变控件属性。Android规定，在其他非主线程里不可以改变控件属性。但可以用Handler来处理类似情况。具体信息请参考官方文档。

 

基本的框架就是这样，接下来说明此LoginView如何使用。

 

当然，首先要实现一个OnLoginListener

 

package org.androidin.tutorial.view;

 

import org.androidin.tutorial.LoginSuccessActivity;
import org.androidin.tutorial.R;

 

import android.content.Context;
import android.content.Intent;
import android.os.Handler;
import android.view.View;
import android.widget.Toast;

 

public class OnLoginListenerImpl implements OnLoginListener{
       
        protected Object session; //用来保存一些登录状态的返回值，可以是HashMap，大家自己根据实际应用发挥了
       
        protected Handler handler; //所有的这些方法都是在另一线程调用，所以Handler用来改变一些控件的属性。
       
        public OnLoginListenerImpl(Handler handler) {
                this.handler = handler;
        }

 

        public boolean onLogin(View v, String username, String password) {
                for (int i=0; i<10000000; i++) //此方法来模拟阻塞的Socket
                ;
                if(username.equals("androidin")) return true; //登录成功
                return false; //登录失败
        }

 

        public void onLoginFailed(final View v) {
                handler.post(new Runnable() { //失败显示一个Toast
                        public void run() {
                                Toast.makeText(
                                v.getContext(),
                                v.getContext().getText(R.string.login_failed),
                                Toast.LENGTH_LONG).show();
                        }
                });
        }

 

        public void onLoginSuccess(View v) {
                Context context = v.getContext();
                context.startActivity(new Intent(context,
                LoginSuccessActivity.class)); //跳转到成功页面
        }
}

 

现在来组装起来吧，以在Activity中显示此控件为例。

package org.androidin.tutorial;

 

import org.androidin.tutorial.view.LoginView;
import org.androidin.tutorial.view.OnLoginListenerImpl;

 

import android.app.Activity;
import android.os.Bundle;
import android.os.Handler;
import android.view.View;
import android.view.View.OnClickListener;

 

public class LoginViewOnActivity extends Activity {
   
    private LoginView logV;

 

    public void onCreate(Bundle savedInstanceState) {
            super.onCreate(savedInstanceState);
            setTitle(getString(R.string.address));
            logV = new LoginView(this);
            logV.setOnLoginListener(new OnLoginListenerImpl(new Handler()));
            logV.setCancelOnClickListener(new OnClickListener() {
                public void onClick(View v) {
                    finish();
                }
            });
            setContentView(logV);
    }
}
So，easy！！

 

device3.png (9.82 KB)

2008-10-2 19:58

 

 

此时还有个小BUG，不知道大家发现没有，这个BUG修复留在Step 3里讲了。
Step 3：

目标：修复BUG，加入超时处理

在step2中遗留下来一个小BUG，当点击Login按钮后，在登录状态返回前，如果强行终止（比如按Back键）。登录逻辑是无法终止的，因为登录逻辑在一个新的线程里。所以必须能够终止登录逻辑线程。终止线程可以调用Thread.stop() Thread.interrupt(),stop方法并不是安全的，可能会产生死锁。而interrupt只是改变线程状态，而不是真正的去即时将线程终止。

所以我们设置一个isLoginCanceled，在登录状态返回后验证状态，如果是取消就不继续实行下面的程序。

protected class LoginThread extends Thread {
        public void run() {
                handler.sendEmptyMessage(SET_ONLOGIN_TRUE);
                boolean flag = onLoginListener.onLogin(LoginView.this, edtUsername
                .getText().toString(), edtPassword.getText().toString());
                if (isLoginCanceled) {
                        return;
                }
                if (flag)
                handler.sendEmptyMessage(LOGIN_SUCCESS);
                else
                handler.sendEmptyMessage(LOGIN_FAILED);
                handler.sendEmptyMessage(SET_ONLOGIN_FALSE);
        }
};

对于超时处理我们采用类似的方法，超时后将isLoginCanceled赋值true。下面的逻辑就不会执行了。
private class LoginButtonListener implements OnClickListener {
    public void onClick(View v) {
        if (onLoginListener != null) {
            isLoginCanceled = false;
            if (timeout != 0)
                handler.sendEmptyMessageDelayed(LOGIN_TIMEOUT, timeout);
            loginThread = new LoginThread();
            loginThread.start();
        }
    }
}

private Handler handler = new Handler() {
        @Override
        public void handleMessage(Message msg) {
            switch (msg.what) {
            case SET_ONLOGIN_TRUE:
                setOnLoging(true);
                break;
            case SET_ONLOGIN_FALSE:
                setOnLoging(false);
                break;
            case LOGIN_TIMEOUT:
                onLoginListener.onLoginTimeout(LoginView.this);
                loginCancel();
                sendEmptyMessage(SET_ONLOGIN_FALSE);
                break;
            case LOGIN_SUCCESS:
                onLoginListener.onLoginSuccess(LoginView.this);
                break;
            case LOGIN_FAILED:
                onLoginListener.onLoginFailed(LoginView.this);
                break;
            }
            super.handleMessage(msg);
        }
    };