Android彩信发送过程介绍

这篇写彩信发送过程。
我想追踪的内容是：用户按下发送之后，彩信的图片阿数据阿文件阿，是怎么包装起来，最后发送出去。
按我看源码的先后顺序来写了。 写完可能最后整理下。
1. com.Android.mms.data.WorkingMessage.Java 类
send()函数。 注释如下：
    /**
     * Send this message over the network. Will call back with onMessageSent()
     * once it has been dispatched to the telephony stack. This WorkingMessage
     * object is no longer useful after this method has been called.
     */
这个是2.1的源码
Java代码
复制到剪贴板  Java代码
public void send() {    
    if (Log.isLoggable(LogTag.TRANSACTION, Log.VERBOSE)) {    
        LogTag.debug("send");    
    }    
    
    // Get ready to write to disk.    
    prepareForSave(true /* notify */);    
    
    // We need the recipient list for both SMS and MMS.    
    final Conversation conv = mConversation;    
    String msgTxt = mText.toString();    
    
    if (requiresMms() || addressContainsEmailToMms(conv, msgTxt)) {    
        // Make local copies of the bits we need for sending a message,    
        // because we will be doing it off of the main thread, which will    
        // immediately continue on to resetting some of this state.    
        final Uri mmsUri = mMessageUri;    
        final PduPersister persister = PduPersister    
                .getPduPersister(mContext);    
    
        final SlideshowModel slideshow = mSlideshow;    
        final SendReq sendReq = makeSendReq(conv, mSubject);    
    
        // Make sure the text in slide 0 is no longer holding onto a    
        // reference to the text    
        // in the message text box.    
        slideshow.prepareForSend();    
    
        // Do the dirty work of sending the message off of the main UI    
        // thread.    
        new Thread(new Runnable() {    
            public void run() {    
                sendMmsWorker(conv, mmsUri, persister, slideshow, sendReq);    
            }    
        }).start();    
    } else {    
        // Same rules apply as above.    
        final String msgText = mText.toString();    
        new Thread(new Runnable() {    
            public void run() {    
                sendSmsWorker(conv, msgText);    
            }    
        }).start();    
    }    
    
    // update the Recipient cache with the new to address, if it's different    
    RecipientIdCache    
            .updateNumbers(conv.getThreadId(), conv.getRecipients());    
    
    // Mark the message as discarded because it is "off the market" after    
    // being sent.    
    mDiscarded = true;    
}    
粗浅的解说一下，
(1) prapareForSave. 先确保有slidshow,也就是实质内容。 确保文字已拷贝。确保标题。
(2a) 根据消息分类，如果是短信直接起一个线程，跑sendSmsWorker函数，发送短信
(2b) 如果是彩信，先跑这么个函数，确保文本信息
            // Make sure the text in slide 0 is no longer holding onto a  // reference to the text      // in the message text box.
            slideshow.prepareForSend();
TheCranberriers（卡百利）的歌真好听。
然后起一个线程，单独跑sendMmsWorker函数,后文有介绍。
彩信比sms麻烦很多。从sendMmsWorker函数的参数就可以看出来：(conv, mmsUri, persister, slideshow, sendReq) 上下文，uri，PduPersister（彩信是用pdu的），slideshow包含了所有的彩信信息，sendreq包含了mime封装mms时的headers（在我的剥壳彩信2里面有提到）。包括了 ContentType("application/vnd.wap.multipart.related" ，from,to等信息 。
(3)。 不管是短信还是彩信，起了那俩个worker函数之一就算发送信息成功了。
最后修改Recipient cache， 重置标志位，过程就结束了。

2。函数 sendMmsWorker 
Java代码
复制到剪贴板  Java代码
private void sendMmsWorker(Conversation conv, Uri mmsUri,    
        PduPersister persister, SlideshowModel slideshow, SendReq sendReq) {    
    // First make sure we don't have too many outstanding unsent message.    
    Cursor cursor = null;    
    try {    
        Log.d("GN@@@","mContext:  "+mContext.toString());    
        Log.d("GN@@@","mContentResolver:  "+mContentResolver.toString());    
        Log.d("GN@@@","Mms.Outbox.CONTENT_URI:  "+Mms.Outbox.CONTENT_URI.toString());    
            
        cursor = SqliteWrapper.query(mContext, mContentResolver,    
                Mms.Outbox.CONTENT_URI, MMS_OUTBOX_PROJECTION, null, null,    
                null);    
        if (cursor != null) {    
            long maxMessageSize = MmsConfig    
                    .getMaxSizeScaleForPendingMmsAllowed()    
                    * MmsConfig.getMaxMessageSize();    
            long totalPendingSize = 0;    
            while (cursor.moveToNext()) {    
                totalPendingSize += cursor.getLong(MMS_MESSAGE_SIZE_INDEX);    
            }    
            if (totalPendingSize >= maxMessageSize) {    
                unDiscard(); // it wasn't successfully sent. Allow it to be    
                             // saved as a draft.    
                mStatusListener.onMaxPendingMessagesReached();    
                return;    
            }    
        }    
    } finally {    
        if (cursor != null) {    
            cursor.close();    
        }    
    }    
    mStatusListener.onPreMessageSent();    
    
    // Make sure we are still using the correct thread ID for our    
    // recipient set.    
    long threadId = conv.ensureThreadId();    
    
    if (Log.isLoggable(LogTag.APP, Log.VERBOSE)) {    
        LogTag.debug("sendMmsWorker: update draft MMS message " + mmsUri);    
    }    
    
    if (mmsUri == null) {    
        // Create a new MMS message if one hasn't been made yet.    
        mmsUri = createDraftMmsMessage(persister, sendReq, slideshow);    
    } else {    
        // Otherwise, sync the MMS message in progress to disk.    
        updateDraftMmsMessage(mmsUri, persister, slideshow, sendReq);    
    }    
    
    // Be paranoid and clean any draft SMS up.    
    deleteDraftSmsMessage(threadId);    
    
    MessageSender sender = new MmsMessageSender(mContext, mmsUri, slideshow    
            .getCurrentMessageSize());    
    try {    
        if (!sender.sendMessage(threadId)) {    
            // The message was sent through SMS protocol, we should    
            // delete the copy which was previously saved in MMS drafts.    
            SqliteWrapper.delete(mContext, mContentResolver, mmsUri, null,    
                    null);    
        }    
    
        // Make sure this thread isn't over the limits in message count    
        Recycler.getMmsRecycler().deleteOldMessagesByThreadId(mContext,    
                threadId);    
    } catch (Exception e) {    
        Log.e(TAG, "Failed to send message: " + mmsUri + ", threadId="    
                + threadId, e);    
    }    
    
    mStatusListener.onMessageSent();    
}    
依旧是粗浅的解说：
a )前面挺长一段代码，检查这个对话（conversation)之前还有没有未发送的信息，uri是Mms.Outbox.CONTENT_URI。
这里需要提到一下MessageStatusListener，这个Interface接口实现在WorkingMessage.java里，而短信类的主题ComposeMessageActivity.java实现了这个接口，所以前者在一些状态改变的时候可以很方便的调用后者的一些函数，作相应的改动。主要是：onProtocolChanged彩信短信互切换，onAttachmentChanged福建改变，onPreMessageSent发消息前，onMessageSent发消息后。
b)
当然，这里调用了onPreMessageSent这个监听函数，
然后ComposeMessageActivity 就会调用resetMessage函数 ，这个函数会调整显示，focus，软键盘等等。
c）
然后检查mmsUri。如果这个uri是空的话，直接造一个新的uri继续发送。这个真是让我叫亚灭爹。因为一开始不知道
这个createDraftMmsMessage(persister, sendReq, slideshow);函数可以包含所有发送需要的信息，以为这么发出去太可怕了。
如果uri不为空。 调用的是updateDraftMmsMessage(mmsUri, persister, slideshow, sendReq);
总之功能是，把这个将发送的mms，存disk了，也就是存draft了。为什么要发送还要存draft呢，后面另会说,因为这个是我写这个文章前想要找的东西。。。这个过程还有一些信息写道mmsUri了。所以之后mmsUri就可以代表将发送的mms的全部信息。
d）deleteDraftSmsMessage 删除草稿
e）创建一个MmsMessageSender，用这个sender来调用sendMessage函数
可以猜到的，Sms那边是SmsMessageSender，同样调用sendMessage函数
通过这里之后，短信已经真的发掉了。 这个类后面有介绍。
f）这里这个if相当搞笑，按正常流程下来，按理这里本来这里是一个彩信的发送，然后有一些数据在draft数据库，会在上面的流程中被移到send数据库。
但是搞笑的地方来了：因为忽然发现函数返回值表示刚刚发送出去的其实是一个短信sms，而已。于是要把数据库里存着的draft删掉。
我也不知道这个if里面的情况会不会发生，反正源码是这么写的，我只管不负责任直译。。。
g)调用onMessageSent这个监听函数。调用ComposeMessageActivity的onMessageSent，这个函数功能是重新显示conversation list。

3 MmsMessageSender.java类。在mms/transaction下面。实现了MessageSender接口。这个接口只有一个事儿，就是sendMessage并返回boolean的值。弱发送的是mms，返回true。若发送的是sms，返回false。出错返回啥？exception。
我最先想要追踪的发送流程也在这里了。贴一些代码
Java代码
复制到剪贴板  Java代码
public MmsMessageSender(Context context, Uri location, long messageSize) {    
    mContext = context;    
    mMessageUri = location;    
    mMessageSize = messageSize;    
        
    if (mMessageUri == null) {    
        throw new IllegalArgumentException("Null message URI.");    
    }    
}    
 
 
Java代码   
public boolean sendMessage(long token) throws MmsException {    
    // Load the MMS from the message uri    
    PduPersister p = PduPersister.getPduPersister(mContext);    
    GenericPdu pdu = p.load(mMessageUri);    
    
    if (pdu.getMessageType() != PduHeaders.MESSAGE_TYPE_SEND_REQ) {    
        throw new MmsException("Invalid message: " + pdu.getMessageType());    
    }    
    
    SendReq sendReq = (SendReq) pdu;    
    
    // Update headers.    
    updatePreferencesHeaders(sendReq);    
    
    // MessageClass.    
    sendReq.setMessageClass(DEFAULT_MESSAGE_CLASS.getBytes());    
    
    // Update the 'date' field of the message before sending it.    
    sendReq.setDate(System.currentTimeMillis() / 1000L);    
    
    sendReq.setMessageSize(mMessageSize);    
    
    p.updateHeaders(mMessageUri, sendReq);    
    
    // Move the message into MMS Outbox    
    p.move(mMessageUri, Mms.Outbox.CONTENT_URI);    
    
    // Start MMS transaction service    
    SendingProgressTokenManager    
            .put(ContentUris.parseId(mMessageUri), token);    
    mContext.startService(new Intent(mContext, TransactionService.class));    
    
    return true;    
}    
 
解说：
现从PduPersister那里拿数据，包括需要拼装的发送报头和需要发送的数据信息。
然后把要发送的信息相关数据从数据库的draft那里转移到send，表示已经发送。
最后起一个TransactionService服务，这个服务也是从PduPersister里找，找到需要发送的数据，并通过不同的用户网络送出去。
这块我猜一般人都没有改的需求。。
4.  
createDraftMmsMessage(persister, sendReq, slideshow); 和
updateDraftMmsMessage(mmsUri, persister, slideshow, sendReq); 这两个函数
刨掉 try catch , createDraftMmsMessage 函数大概有这么几句：
复制到剪贴板  Java代码
Java代码   
PduBody pb = slideshow.toPduBody();    
sendReq.setBody(pb);    
Uri res = persister.persist(sendReq, Mms.Draft.CONTENT_URI);    
slideshow.sync(pb);    
 
updateDraftMmsMessage 函数大概有这么几句：   
Java代码   
persister.updateHeaders(uri, sendReq);    
final PduBody pb = slideshow.toPduBody();    
persister.updateParts(uri, pb);    
slideshow.sync(pb);    
 
两个函数从本质上讲是一样的：把附件的东西以pdubody的形式存下来，另外就是更新uri。
什么叫PduBody呢？ 厉害了。就是n个PduPart。什么叫PduPart呢？厉害了，就是数据库里的那个Part！ 那个part是什么？
那个最厉害了。数据库里的PART_1234455这种数据，文件名代表创建时间（在mediaModel产生时就进系统了），导出来就是源文件，比如图片文件，改个jpg就可以看了。
sync函数不怎么动，无责任解说：把每个slide里面每个媒体跟真实文件位置对应上。
slideshow.toPduBody();里面，用SMILDocument mDocumentCache;
调用到SlideshowModel.java的
Java代码
复制到剪贴板  Java代码
／／其中context＝null。 isMakingCopy＝false。 document＝mDocumentCache    
    private PduBody makePduBody(Context context, SMILDocument document,    
            boolean isMakingCopy) {    
        PduBody pb = new PduBody();    
    
        boolean hasForwardLock = false;    
        for (SlideModel slide : mSlides) {    
            for (MediaModel media : slide) {    
                if (isMakingCopy) {    
                    if (media.isDrmProtected() && !media.isAllowedToForward()) {    
                        hasForwardLock = true;    
                        continue;    
                    }    
                }    
    
                PduPart part = new PduPart();    
    
                if (media.isText()) {    
                    TextModel text = (TextModel) media;    
                    // Don't create empty text part.    
                    if (TextUtils.isEmpty(text.getText())) {    
                        continue;    
                    }    
                    // Set Charset if it's a text media.    
                    part.setCharset(text.getCharset());    
                }    
    
                // Set Content-Type.    
                part.setContentType(media.getContentType().getBytes());    
    
                String src = media.getSrc();    
                String location;    
                boolean startWithContentId = src.startsWith("cid:");    
                if (startWithContentId) {    
                    location = src.substring("cid:".length());    
                } else {    
                    location = src;    
                }    
    
                // Set Content-Location.    
                part.setContentLocation(location.getBytes());    
    
                // Set Content-Id.    
                if (startWithContentId) {    
                    // Keep the original Content-Id.    
                    part.setContentId(location.getBytes());    
                } else {    
                    int index = location.lastIndexOf(".");    
                    String contentId = (index == -1) ? location : location    
                            .substring(0, index);    
                    part.setContentId(contentId.getBytes());    
                }    
    
                if (media.isDrmProtected()) {    
                    DrmWrapper wrapper = media.getDrmObject();    
                    part.setDataUri(wrapper.getOriginalUri());    
                    part.setData(wrapper.getOriginalData());    
                } else if (media.isText()) {    
                    part.setData(((TextModel) media).getText().getBytes());    
                } else if (media.isImage() || media.isVideo()    
                        || media.isAudio()) {    
                    part.setDataUri(media.getUri());    
                } else {    
                    Log.w(TAG, "Unsupport media: " + media);    
                }    
    
                pb.addPart(part);    
            }    
        }    
    
        if (hasForwardLock && isMakingCopy && context != null) {    
            Toast.makeText(context,    
                    context.getString(R.string.cannot_forward_drm_obj),    
                    Toast.LENGTH_LONG).show();    
            document = SmilHelper.getDocument(pb);    
        }    
    
        // Create and insert SMIL part(as the first part) into the PduBody.    
        ByteArrayOutputStream out = new ByteArrayOutputStream();    
        SmilXmlSerializer.serialize(document, out);    
        PduPart smilPart = new PduPart();    
        smilPart.setContentId("smil".getBytes());    
        smilPart.setContentLocation("smil.xml".getBytes());    
        smilPart.setContentType(ContentType.APP_SMIL.getBytes());    
        smilPart.setData(out.toByteArray());    
        pb.addPart(0, smilPart);    
    
        return pb;    
    }    
好了，搞定