自制发送短信程序
SmsManager与PendingIntent对象


范例说明


前面的范例,示范了如何通过程序来拨打电话,在GSM移动通信系统的服务中,除了拨打电话外,另一个常用的功能,就是发送短信。也因为如此,许多电信业者推出许多专属于短信族的专用费率,由此可知短信功能对手机的重要性。

在这个范例中,通过自定义两个EditText控件,分别取得收件人电话与短信的正文,并判断收件人电话格式是否正确,以及正文输入的文字字数(GSM的规范为70个Unicode16文字为1则)是否超过一则短信的限制,若超过一则短信的字数,或电话号码格式不符,则利用Toast来告诉用户,若无任何错误,则取得EdiText控件里的输入值,并将输入的内容当作短信发送,完成自制发送短信程序。

发送短信的关键程序是通过SmsManager对象的sendTextMessage()方法来完成,其中sendTextMessage()方法需传入5个值,依次是收件人地址(String)、发送地址(String)、正文(String)、发送服务(PendingIntent)与送达服务(PendingIntent),其中收件人与正文是不可为Null的两个参数。

<!--[endif]-->

▲ 图5-3 在EditText中输入电话与短信内容,送出后,Toast会发送成功或相关格式错误的信息


范例程序


src/irdc.ex05_03/EX05_03.java

主程序除了在onCreat()中创建两个EditText控件与一个Button控件外,分别设置onClickLinstener()让用户单击EditText控件时,同时清除内容,在单击Button时送出短信,并通过isPhoneNumberValid()与iswithin70()这两个自定义的方法来检查收件人电话号码的正则表达式,以及短信正文的字数是否超过70个字符。

在两项检查同时通过的前提下,通过PendingIntent.getBroadcast()的方法自定义PendingIntent并进行Broadcasting,而后使用SmsManager.getDefault()(当处理SMS 短信相关的活动,例如发送数据、文字与pdu SMS信息,都需要调用这种静态的方法)所预先构建的SmsManager使用sendTextMessage()方法,将相关数据以参数带入,即可完成发送短信的任务。


/* import程序略 */ /*引用telephony.SmsManager类才能使用sendTextMessage()*/ import android.telephony.SmsManager; public class EX05_03 extends Activity { /*声明变量一个Button与两个EditText*/ private Button mButton1; private EditText mEditText1; private EditText mEditText2; /** Called when the activity is first created. */ @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main); /* * 通过findViewById构造器来建构 * EditText1,EditText2与Button对象 */ mEditText1 = (EditText) findViewById(R.id.myEditText1); mEditText2 = (EditText) findViewById(R.id.myEditText2); mButton1 = (Button) findViewById(R.id.myButton1); /*将默认文字加载到EditText中*/ mEditText1.setText("请输入电话号码"); mEditText2.setText("请输入短信内容!!"); /*设置onClickListener 让用户单击EditText时做出反应*/ mEditText1.setOnClickListener(new EditText.OnClickListener() { public void onClick(View v) { /*单击EditText时清空正文*/ mEditText1.setText(""); } } ); /*设置onClickListener 让用户单击EditText时做出反应*/ mEditText2.setOnClickListener(new EditText.OnClickListener() { public void onClick(View v) { /*单击EditText时清空正文*/ mEditText2.setText(""); } } ); /*设置onClickListener 让用户单击Button时做出反应*/ mButton1.setOnClickListener(new Button.OnClickListener() { @Override public void onClick(View v) { /*由EditText1取得短信收件人电话*/ String strDestAddress = mEditText1.getText().toString(); /*由EditText2取得短信文字内容*/ String strMessage = mEditText2.getText().toString(); /*建构一取得default instance的 SmsManager对象 */ SmsManager smsManager = SmsManager.getDefault(); // TODO Auto-generated method stub /*检查收件人电话格式与短信字数是否超过70字符*/ if(isPhoneNumberValid(strDestAddress)==true && iswithin70(strMessage)==true) { try { /* * 两个条件都检查通过的情况下,发送短信 * 先构建一个PendingIntent对象并使用getBroadcast()广播 * 将PendingIntent,电话,短信文字等参数 * 传入sendTextMessage()方法发送短信 */ PendingIntent mPI = PendingIntent.getBroadcast (EX05_03.this, 0, new Intent(), 0); smsManager.sendTextMessage (strDestAddress, null, strMessage, mPI, null); } catch(Exception e) { e.printStackTrace(); } Toast.makeText ( EX05_03.this,"送出成功!!" , Toast.LENGTH_SHORT ).show(); mEditText1.setText(""); mEditText2.setText(""); } else { /* 电话格式与短信文字不符合条件时,以Toast提醒 */ if (isPhoneNumberValid(strDestAddress)==false) { /*且字数超过70字符*/ if(iswithin70(strMessage)==false) { Toast.makeText ( EX05_03.this, "电话号码格式错误+短信内容超过70个字,请检查!!", Toast.LENGTH_SHORT ).show(); } else { Toast.makeText ( EX05_03.this, "电话号码格式错误,请检查!!" , Toast.LENGTH_SHORT ).show(); } } /*字数超过70个字符*/ else if (iswithin70(strMessage)==false) { Toast.makeText ( EX05_03.this, "短信内容超过70个字,请删除部分内容!!", Toast.LENGTH_SHORT ).show(); } } } }); } /*检查字符串是否为电话号码的方法,并返回true or false的判断值*/ public static boolean isPhoneNumberValid(String phoneNumber) { boolean isValid = false; /* 可接受的电话格式有: * ^//(? : 可以使用 "(" 作为开头 * (//d{3}): 紧接着三个数字 * //)? : 可以使用")"继续 * [- ]? : 在上述格式后可以使用具有选择性的 "-". * (//d{3}) : 再紧接着三个数字 * [- ]? : 可以使用具有选择性的 "-" 继续. * (//d{5})$: 以五个数字结束. * 可以比较下列数字格式: * (123)456-7890, 123-456-7890, 1234567890, (123)-456-7890 */ String expression = "^//(?(//d{3})//)?[- ]?(//d{3})[- ]?(//d{5})$"; /* 可接受的电话格式有: * ^//(? : 可以使用 "(" 作为开头 * (//d{3}): 紧接着三个数字 * //)? : 可以使用")"继续 * [- ]? : 在上述格式后可以使用具有选择性的 "-". * (//d{4}) : 再紧接着四个数字 * [- ]? : 可以使用具有选择性的 "-" 继续. * (//d{4})$: 以四个数字结束. * 可以比较下列数字格式: * (02)3456-7890, 02-3456-7890, 0234567890, (02)-3456-7890 */ String expression2= "^//(?(//d{3})//)?[- ]?(//d{4})[- ]?(//d{4})$"; CharSequence inputStr = phoneNumber; /*创建Pattern*/ Pattern pattern = Pattern.compile(expression); /*将Pattern 以参数传入Matcher作Regular expression*/ Matcher matcher = pattern.matcher(inputStr); /*创建Pattern2*/ Pattern pattern2 =Pattern.compile(expression2); /*将Pattern2 以参数传入Matcher2作Regular expression*/ Matcher matcher2= pattern2.matcher(inputStr); if(matcher.matches()||matcher2.matches()) { isValid = true; } return isValid; } public static boolean iswithin70(String text) { if (text.length()<= 70) { return true; } else { return false; } } }


AndroidManifest.xml


请注意,需要添加发送短信的权限android.permission.SEND_SMS。



<uses-permission android:name="android.permission.SEND_SMS">




扩展学习


本范例使用到的PendingIntent对象,具有下列的特性:当接收到PendingIntent对象时,会进行broadcast的动作,就如同使用Context.sendBroadcast()方法一样,这也就是为什么在SmsManager.sendTextMessage()方法中需要传入PendingIntent作为传送服务的参数之一。

在主程序中使用发送短信的方式,只展示了SmsManager类中,可使用的3种传送短信的方法之一,而完整的3种可用方法,整理如表5-1所示。

表5-1 SmsManager类中可使用的3种方法

方 法 名 称

传 入 参 数

使 用 时 机

sendDataMessage

String destinationAddress, String scAddress, short destin-
ationPort, byte[] data, PendingIntent sentIntent, Pending
Intent deliveryIntent

发送Data格式的SMS传送到特定程序的Port

sendMultipartTextMessage

String destinationAddress, String scAddress, ArrayList
<String> parts, ArrayList<PendingIntent> sentIntents,
ArrayList<PendingIntent> deliveryIntents

发送多条文字短信

sendTextMessage

String destinationAddress, String scAddress, String text,
PendingIntent sentIntent, PendingIntent deliveryIntent

发送文字短信


另外,本范例并没有实现接收sms的部分,仅发出短信,由于单纯通过运行程序的模拟器,将无法了解短信是否真的有送出,而收件人是否真的有收到。因此,在程序开发的过程中,读者可以通过下面的小技巧来打开两个模拟器,一个进行传送,另一个进行收件的模拟测试。

步骤一:先进入Eclipse,compile运行程序,并顺利开始第一个模拟器实例(Instance)。

步骤二:打开DOS窗口(cmd),并输入命令,进入文件夹:



D:/>cd D:/SDK/android/tools/



步骤三:输入shell command,其中foo为AVD的名称。



D:/SDK/android/tools>emulator -data foo



此时,窗口会跳出另一个模拟器,通过输入左上方的InstanceID(例:5546)作为收件人的电话号码,即可测试短信送达的状态。

最后提到了拆分短信,此范例中虽然自制了简单的判断字符串字符数,却只能接受单则的短信,事实上,在SmsManager里尚有一个公有方法:



public ArrayList<String> divideMessage (String text)