AMessage.h revision 1734c7d01c1567568ced29398b23abd601fd44cb
172961230a5890071bcca436eb5630172ce84ec41Andreas Huber/* 272961230a5890071bcca436eb5630172ce84ec41Andreas Huber * Copyright (C) 2010 The Android Open Source Project 372961230a5890071bcca436eb5630172ce84ec41Andreas Huber * 472961230a5890071bcca436eb5630172ce84ec41Andreas Huber * Licensed under the Apache License, Version 2.0 (the "License"); 572961230a5890071bcca436eb5630172ce84ec41Andreas Huber * you may not use this file except in compliance with the License. 672961230a5890071bcca436eb5630172ce84ec41Andreas Huber * You may obtain a copy of the License at 772961230a5890071bcca436eb5630172ce84ec41Andreas Huber * 872961230a5890071bcca436eb5630172ce84ec41Andreas Huber * http://www.apache.org/licenses/LICENSE-2.0 972961230a5890071bcca436eb5630172ce84ec41Andreas Huber * 1072961230a5890071bcca436eb5630172ce84ec41Andreas Huber * Unless required by applicable law or agreed to in writing, software 1172961230a5890071bcca436eb5630172ce84ec41Andreas Huber * distributed under the License is distributed on an "AS IS" BASIS, 1272961230a5890071bcca436eb5630172ce84ec41Andreas Huber * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 1372961230a5890071bcca436eb5630172ce84ec41Andreas Huber * See the License for the specific language governing permissions and 1472961230a5890071bcca436eb5630172ce84ec41Andreas Huber * limitations under the License. 1572961230a5890071bcca436eb5630172ce84ec41Andreas Huber */ 1672961230a5890071bcca436eb5630172ce84ec41Andreas Huber 1772961230a5890071bcca436eb5630172ce84ec41Andreas Huber#ifndef A_MESSAGE_H_ 1872961230a5890071bcca436eb5630172ce84ec41Andreas Huber 1972961230a5890071bcca436eb5630172ce84ec41Andreas Huber#define A_MESSAGE_H_ 2072961230a5890071bcca436eb5630172ce84ec41Andreas Huber 2172961230a5890071bcca436eb5630172ce84ec41Andreas Huber#include <media/stagefright/foundation/ABase.h> 2272961230a5890071bcca436eb5630172ce84ec41Andreas Huber#include <media/stagefright/foundation/ALooper.h> 2372961230a5890071bcca436eb5630172ce84ec41Andreas Huber#include <utils/KeyedVector.h> 2472961230a5890071bcca436eb5630172ce84ec41Andreas Huber#include <utils/RefBase.h> 2572961230a5890071bcca436eb5630172ce84ec41Andreas Huber 2672961230a5890071bcca436eb5630172ce84ec41Andreas Hubernamespace android { 2772961230a5890071bcca436eb5630172ce84ec41Andreas Huber 282d8bedd05437b6fccdbc6bf70f673ffd86744d59Andreas Huberstruct ABuffer; 295804a76ac5f9f3c311f1bbbcc5ebdc8f8568ae14Lajos Molnarstruct AHandler; 3072961230a5890071bcca436eb5630172ce84ec41Andreas Huberstruct AString; 316d339f1f764bbd32e3381dae7bfa7c6c575bb493Lajos Molnarclass Parcel; 3272961230a5890071bcca436eb5630172ce84ec41Andreas Huber 333f27436a9346f043f52265da1e6a74cde2bffd4dLajos Molnarstruct AReplyToken : public RefBase { 343f27436a9346f043f52265da1e6a74cde2bffd4dLajos Molnar AReplyToken(const sp<ALooper> &looper) 353f27436a9346f043f52265da1e6a74cde2bffd4dLajos Molnar : mLooper(looper), 363f27436a9346f043f52265da1e6a74cde2bffd4dLajos Molnar mReplied(false) { 373f27436a9346f043f52265da1e6a74cde2bffd4dLajos Molnar } 383f27436a9346f043f52265da1e6a74cde2bffd4dLajos Molnar 393f27436a9346f043f52265da1e6a74cde2bffd4dLajos Molnarprivate: 403f27436a9346f043f52265da1e6a74cde2bffd4dLajos Molnar friend struct AMessage; 413f27436a9346f043f52265da1e6a74cde2bffd4dLajos Molnar friend struct ALooper; 423f27436a9346f043f52265da1e6a74cde2bffd4dLajos Molnar wp<ALooper> mLooper; 433f27436a9346f043f52265da1e6a74cde2bffd4dLajos Molnar sp<AMessage> mReply; 443f27436a9346f043f52265da1e6a74cde2bffd4dLajos Molnar bool mReplied; 453f27436a9346f043f52265da1e6a74cde2bffd4dLajos Molnar 463f27436a9346f043f52265da1e6a74cde2bffd4dLajos Molnar sp<ALooper> getLooper() const { 473f27436a9346f043f52265da1e6a74cde2bffd4dLajos Molnar return mLooper.promote(); 483f27436a9346f043f52265da1e6a74cde2bffd4dLajos Molnar } 493f27436a9346f043f52265da1e6a74cde2bffd4dLajos Molnar // if reply is not set, returns false; otherwise, it retrieves the reply and returns true 503f27436a9346f043f52265da1e6a74cde2bffd4dLajos Molnar bool retrieveReply(sp<AMessage> *reply) { 513f27436a9346f043f52265da1e6a74cde2bffd4dLajos Molnar if (mReplied) { 523f27436a9346f043f52265da1e6a74cde2bffd4dLajos Molnar *reply = mReply; 533f27436a9346f043f52265da1e6a74cde2bffd4dLajos Molnar mReply.clear(); 543f27436a9346f043f52265da1e6a74cde2bffd4dLajos Molnar } 553f27436a9346f043f52265da1e6a74cde2bffd4dLajos Molnar return mReplied; 563f27436a9346f043f52265da1e6a74cde2bffd4dLajos Molnar } 573f27436a9346f043f52265da1e6a74cde2bffd4dLajos Molnar // sets the reply for this token. returns OK or error 583f27436a9346f043f52265da1e6a74cde2bffd4dLajos Molnar status_t setReply(const sp<AMessage> &reply); 593f27436a9346f043f52265da1e6a74cde2bffd4dLajos Molnar}; 603f27436a9346f043f52265da1e6a74cde2bffd4dLajos Molnar 6172961230a5890071bcca436eb5630172ce84ec41Andreas Huberstruct AMessage : public RefBase { 625804a76ac5f9f3c311f1bbbcc5ebdc8f8568ae14Lajos Molnar AMessage(); 635804a76ac5f9f3c311f1bbbcc5ebdc8f8568ae14Lajos Molnar AMessage(uint32_t what, const sp<const AHandler> &handler); 6472961230a5890071bcca436eb5630172ce84ec41Andreas Huber 6514acc736e336cbd6026df781d4f411e908831815Andreas Huber static sp<AMessage> FromParcel(const Parcel &parcel); 6614acc736e336cbd6026df781d4f411e908831815Andreas Huber void writeToParcel(Parcel *parcel) const; 6714acc736e336cbd6026df781d4f411e908831815Andreas Huber 6872961230a5890071bcca436eb5630172ce84ec41Andreas Huber void setWhat(uint32_t what); 6972961230a5890071bcca436eb5630172ce84ec41Andreas Huber uint32_t what() const; 7072961230a5890071bcca436eb5630172ce84ec41Andreas Huber 715804a76ac5f9f3c311f1bbbcc5ebdc8f8568ae14Lajos Molnar void setTarget(const sp<const AHandler> &handler); 7272961230a5890071bcca436eb5630172ce84ec41Andreas Huber 73f933441648ef6a71dee783d733aac17b9508b452Andreas Huber void clear(); 74f933441648ef6a71dee783d733aac17b9508b452Andreas Huber 7572961230a5890071bcca436eb5630172ce84ec41Andreas Huber void setInt32(const char *name, int32_t value); 7672961230a5890071bcca436eb5630172ce84ec41Andreas Huber void setInt64(const char *name, int64_t value); 7772961230a5890071bcca436eb5630172ce84ec41Andreas Huber void setSize(const char *name, size_t value); 7872961230a5890071bcca436eb5630172ce84ec41Andreas Huber void setFloat(const char *name, float value); 7972961230a5890071bcca436eb5630172ce84ec41Andreas Huber void setDouble(const char *name, double value); 8072961230a5890071bcca436eb5630172ce84ec41Andreas Huber void setPointer(const char *name, void *value); 8172961230a5890071bcca436eb5630172ce84ec41Andreas Huber void setString(const char *name, const char *s, ssize_t len = -1); 82513d967dae82cd03e67bff17b927cf869d9bc43eLajos Molnar void setString(const char *name, const AString &s); 8372961230a5890071bcca436eb5630172ce84ec41Andreas Huber void setObject(const char *name, const sp<RefBase> &obj); 842d8bedd05437b6fccdbc6bf70f673ffd86744d59Andreas Huber void setBuffer(const char *name, const sp<ABuffer> &buffer); 8572961230a5890071bcca436eb5630172ce84ec41Andreas Huber void setMessage(const char *name, const sp<AMessage> &obj); 8672961230a5890071bcca436eb5630172ce84ec41Andreas Huber 8731e2508c75018145a8238925ff1a08cbde4e799aAndreas Huber void setRect( 8831e2508c75018145a8238925ff1a08cbde4e799aAndreas Huber const char *name, 8931e2508c75018145a8238925ff1a08cbde4e799aAndreas Huber int32_t left, int32_t top, int32_t right, int32_t bottom); 9031e2508c75018145a8238925ff1a08cbde4e799aAndreas Huber 91513d967dae82cd03e67bff17b927cf869d9bc43eLajos Molnar bool contains(const char *name) const; 92513d967dae82cd03e67bff17b927cf869d9bc43eLajos Molnar 9372961230a5890071bcca436eb5630172ce84ec41Andreas Huber bool findInt32(const char *name, int32_t *value) const; 9472961230a5890071bcca436eb5630172ce84ec41Andreas Huber bool findInt64(const char *name, int64_t *value) const; 9572961230a5890071bcca436eb5630172ce84ec41Andreas Huber bool findSize(const char *name, size_t *value) const; 9672961230a5890071bcca436eb5630172ce84ec41Andreas Huber bool findFloat(const char *name, float *value) const; 9772961230a5890071bcca436eb5630172ce84ec41Andreas Huber bool findDouble(const char *name, double *value) const; 9872961230a5890071bcca436eb5630172ce84ec41Andreas Huber bool findPointer(const char *name, void **value) const; 9972961230a5890071bcca436eb5630172ce84ec41Andreas Huber bool findString(const char *name, AString *value) const; 10072961230a5890071bcca436eb5630172ce84ec41Andreas Huber bool findObject(const char *name, sp<RefBase> *obj) const; 1012d8bedd05437b6fccdbc6bf70f673ffd86744d59Andreas Huber bool findBuffer(const char *name, sp<ABuffer> *buffer) const; 10272961230a5890071bcca436eb5630172ce84ec41Andreas Huber bool findMessage(const char *name, sp<AMessage> *obj) const; 10372961230a5890071bcca436eb5630172ce84ec41Andreas Huber 10431e2508c75018145a8238925ff1a08cbde4e799aAndreas Huber bool findRect( 10531e2508c75018145a8238925ff1a08cbde4e799aAndreas Huber const char *name, 10631e2508c75018145a8238925ff1a08cbde4e799aAndreas Huber int32_t *left, int32_t *top, int32_t *right, int32_t *bottom) const; 10731e2508c75018145a8238925ff1a08cbde4e799aAndreas Huber 1085804a76ac5f9f3c311f1bbbcc5ebdc8f8568ae14Lajos Molnar status_t post(int64_t delayUs = 0); 10972961230a5890071bcca436eb5630172ce84ec41Andreas Huber 1105df775d2f509c76e76a46615fca83dba95299f6eAndreas Huber // Posts the message to its target and waits for a response (or error) 1115df775d2f509c76e76a46615fca83dba95299f6eAndreas Huber // before returning. 1125df775d2f509c76e76a46615fca83dba95299f6eAndreas Huber status_t postAndAwaitResponse(sp<AMessage> *response); 1135df775d2f509c76e76a46615fca83dba95299f6eAndreas Huber 1145df775d2f509c76e76a46615fca83dba95299f6eAndreas Huber // If this returns true, the sender of this message is synchronously 1153f27436a9346f043f52265da1e6a74cde2bffd4dLajos Molnar // awaiting a response and the reply token is consumed from the message 1163f27436a9346f043f52265da1e6a74cde2bffd4dLajos Molnar // and stored into replyID. The reply token must be used to send the response 1173f27436a9346f043f52265da1e6a74cde2bffd4dLajos Molnar // using "postReply" below. 1183f27436a9346f043f52265da1e6a74cde2bffd4dLajos Molnar bool senderAwaitsResponse(sp<AReplyToken> *replyID); 1193f27436a9346f043f52265da1e6a74cde2bffd4dLajos Molnar 1203f27436a9346f043f52265da1e6a74cde2bffd4dLajos Molnar // Posts the message as a response to a reply token. A reply token can 1213f27436a9346f043f52265da1e6a74cde2bffd4dLajos Molnar // only be used once. Returns OK if the response could be posted; otherwise, 1223f27436a9346f043f52265da1e6a74cde2bffd4dLajos Molnar // an error. 1233f27436a9346f043f52265da1e6a74cde2bffd4dLajos Molnar status_t postReply(const sp<AReplyToken> &replyID); 1245df775d2f509c76e76a46615fca83dba95299f6eAndreas Huber 1252c2814b900a61fa07ddfff860b143fbbe9c740e9Andreas Huber // Performs a deep-copy of "this", contained messages are in turn "dup'ed". 1262c2814b900a61fa07ddfff860b143fbbe9c740e9Andreas Huber // Warning: RefBase items, i.e. "objects" are _not_ copied but only have 1272c2814b900a61fa07ddfff860b143fbbe9c740e9Andreas Huber // their refcount incremented. 12872961230a5890071bcca436eb5630172ce84ec41Andreas Huber sp<AMessage> dup() const; 12972961230a5890071bcca436eb5630172ce84ec41Andreas Huber 1301734c7d01c1567568ced29398b23abd601fd44cbLajos Molnar // Performs a shallow or deep comparison of |this| and |other| and returns 1311734c7d01c1567568ced29398b23abd601fd44cbLajos Molnar // an AMessage with the differences. 1321734c7d01c1567568ced29398b23abd601fd44cbLajos Molnar // Warning: RefBase items, i.e. "objects" are _not_ copied but only have 1331734c7d01c1567568ced29398b23abd601fd44cbLajos Molnar // their refcount incremented. 1341734c7d01c1567568ced29398b23abd601fd44cbLajos Molnar // This is true for AMessages that have no corresponding AMessage equivalent in |other|. 1351734c7d01c1567568ced29398b23abd601fd44cbLajos Molnar // (E.g. there is no such key or the type is different.) On the other hand, changes in 1361734c7d01c1567568ced29398b23abd601fd44cbLajos Molnar // the AMessage (or AMessages if deep is |false|) are returned in new objects. 1371734c7d01c1567568ced29398b23abd601fd44cbLajos Molnar sp<AMessage> changesFrom(const sp<const AMessage> &other, bool deep = false) const; 1381734c7d01c1567568ced29398b23abd601fd44cbLajos Molnar 139bbc2b8289458cfde931b133bad0c9d1026674ee7Andreas Huber AString debugString(int32_t indent = 0) const; 140bbc2b8289458cfde931b133bad0c9d1026674ee7Andreas Huber 14172961230a5890071bcca436eb5630172ce84ec41Andreas Huber enum Type { 14272961230a5890071bcca436eb5630172ce84ec41Andreas Huber kTypeInt32, 14372961230a5890071bcca436eb5630172ce84ec41Andreas Huber kTypeInt64, 14472961230a5890071bcca436eb5630172ce84ec41Andreas Huber kTypeSize, 14572961230a5890071bcca436eb5630172ce84ec41Andreas Huber kTypeFloat, 14672961230a5890071bcca436eb5630172ce84ec41Andreas Huber kTypeDouble, 14772961230a5890071bcca436eb5630172ce84ec41Andreas Huber kTypePointer, 14872961230a5890071bcca436eb5630172ce84ec41Andreas Huber kTypeString, 14972961230a5890071bcca436eb5630172ce84ec41Andreas Huber kTypeObject, 15072961230a5890071bcca436eb5630172ce84ec41Andreas Huber kTypeMessage, 15131e2508c75018145a8238925ff1a08cbde4e799aAndreas Huber kTypeRect, 1522d8bedd05437b6fccdbc6bf70f673ffd86744d59Andreas Huber kTypeBuffer, 15372961230a5890071bcca436eb5630172ce84ec41Andreas Huber }; 15472961230a5890071bcca436eb5630172ce84ec41Andreas Huber 1555778822d86b0337407514b9372562b86edfa91cdAndreas Huber size_t countEntries() const; 1565778822d86b0337407514b9372562b86edfa91cdAndreas Huber const char *getEntryNameAt(size_t index, Type *type) const; 1575778822d86b0337407514b9372562b86edfa91cdAndreas Huber 1585778822d86b0337407514b9372562b86edfa91cdAndreas Huberprotected: 1595778822d86b0337407514b9372562b86edfa91cdAndreas Huber virtual ~AMessage(); 1605778822d86b0337407514b9372562b86edfa91cdAndreas Huber 1615778822d86b0337407514b9372562b86edfa91cdAndreas Huberprivate: 1625804a76ac5f9f3c311f1bbbcc5ebdc8f8568ae14Lajos Molnar friend struct ALooper; // deliver() 1635804a76ac5f9f3c311f1bbbcc5ebdc8f8568ae14Lajos Molnar 16472961230a5890071bcca436eb5630172ce84ec41Andreas Huber uint32_t mWhat; 1655804a76ac5f9f3c311f1bbbcc5ebdc8f8568ae14Lajos Molnar 1665804a76ac5f9f3c311f1bbbcc5ebdc8f8568ae14Lajos Molnar // used only for debugging 16772961230a5890071bcca436eb5630172ce84ec41Andreas Huber ALooper::handler_id mTarget; 16872961230a5890071bcca436eb5630172ce84ec41Andreas Huber 1695804a76ac5f9f3c311f1bbbcc5ebdc8f8568ae14Lajos Molnar wp<AHandler> mHandler; 1705804a76ac5f9f3c311f1bbbcc5ebdc8f8568ae14Lajos Molnar wp<ALooper> mLooper; 1715804a76ac5f9f3c311f1bbbcc5ebdc8f8568ae14Lajos Molnar 17231e2508c75018145a8238925ff1a08cbde4e799aAndreas Huber struct Rect { 17331e2508c75018145a8238925ff1a08cbde4e799aAndreas Huber int32_t mLeft, mTop, mRight, mBottom; 17431e2508c75018145a8238925ff1a08cbde4e799aAndreas Huber }; 17531e2508c75018145a8238925ff1a08cbde4e799aAndreas Huber 17672961230a5890071bcca436eb5630172ce84ec41Andreas Huber struct Item { 17772961230a5890071bcca436eb5630172ce84ec41Andreas Huber union { 17872961230a5890071bcca436eb5630172ce84ec41Andreas Huber int32_t int32Value; 17972961230a5890071bcca436eb5630172ce84ec41Andreas Huber int64_t int64Value; 18072961230a5890071bcca436eb5630172ce84ec41Andreas Huber size_t sizeValue; 18172961230a5890071bcca436eb5630172ce84ec41Andreas Huber float floatValue; 18272961230a5890071bcca436eb5630172ce84ec41Andreas Huber double doubleValue; 18372961230a5890071bcca436eb5630172ce84ec41Andreas Huber void *ptrValue; 18472961230a5890071bcca436eb5630172ce84ec41Andreas Huber RefBase *refValue; 18572961230a5890071bcca436eb5630172ce84ec41Andreas Huber AString *stringValue; 18631e2508c75018145a8238925ff1a08cbde4e799aAndreas Huber Rect rectValue; 18772961230a5890071bcca436eb5630172ce84ec41Andreas Huber } u; 18872961230a5890071bcca436eb5630172ce84ec41Andreas Huber const char *mName; 1897ea429295a2eb31f2d9256c36c1ef53a195456acLajos Molnar size_t mNameLength; 19072961230a5890071bcca436eb5630172ce84ec41Andreas Huber Type mType; 1917ea429295a2eb31f2d9256c36c1ef53a195456acLajos Molnar void setName(const char *name, size_t len); 19272961230a5890071bcca436eb5630172ce84ec41Andreas Huber }; 19372961230a5890071bcca436eb5630172ce84ec41Andreas Huber 19472961230a5890071bcca436eb5630172ce84ec41Andreas Huber enum { 195e370bb62b89d2f2980f519392010ea08a24c558eAndreas Huber kMaxNumItems = 64 19672961230a5890071bcca436eb5630172ce84ec41Andreas Huber }; 19772961230a5890071bcca436eb5630172ce84ec41Andreas Huber Item mItems[kMaxNumItems]; 19872961230a5890071bcca436eb5630172ce84ec41Andreas Huber size_t mNumItems; 19972961230a5890071bcca436eb5630172ce84ec41Andreas Huber 20072961230a5890071bcca436eb5630172ce84ec41Andreas Huber Item *allocateItem(const char *name); 2017ea429295a2eb31f2d9256c36c1ef53a195456acLajos Molnar void freeItemValue(Item *item); 20272961230a5890071bcca436eb5630172ce84ec41Andreas Huber const Item *findItem(const char *name, Type type) const; 20372961230a5890071bcca436eb5630172ce84ec41Andreas Huber 2042d8bedd05437b6fccdbc6bf70f673ffd86744d59Andreas Huber void setObjectInternal( 2052d8bedd05437b6fccdbc6bf70f673ffd86744d59Andreas Huber const char *name, const sp<RefBase> &obj, Type type); 2062d8bedd05437b6fccdbc6bf70f673ffd86744d59Andreas Huber 2077ea429295a2eb31f2d9256c36c1ef53a195456acLajos Molnar size_t findItemIndex(const char *name, size_t len) const; 2087ea429295a2eb31f2d9256c36c1ef53a195456acLajos Molnar 2095804a76ac5f9f3c311f1bbbcc5ebdc8f8568ae14Lajos Molnar void deliver(); 2105804a76ac5f9f3c311f1bbbcc5ebdc8f8568ae14Lajos Molnar 21172961230a5890071bcca436eb5630172ce84ec41Andreas Huber DISALLOW_EVIL_CONSTRUCTORS(AMessage); 21272961230a5890071bcca436eb5630172ce84ec41Andreas Huber}; 21372961230a5890071bcca436eb5630172ce84ec41Andreas Huber 21472961230a5890071bcca436eb5630172ce84ec41Andreas Huber} // namespace android 21572961230a5890071bcca436eb5630172ce84ec41Andreas Huber 21672961230a5890071bcca436eb5630172ce84ec41Andreas Huber#endif // A_MESSAGE_H_ 217