AMessage.h revision 6d339f1f764bbd32e3381dae7bfa7c6c575bb493
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 130bbc2b8289458cfde931b133bad0c9d1026674ee7Andreas Huber AString debugString(int32_t indent = 0) const; 131bbc2b8289458cfde931b133bad0c9d1026674ee7Andreas Huber 13272961230a5890071bcca436eb5630172ce84ec41Andreas Huber enum Type { 13372961230a5890071bcca436eb5630172ce84ec41Andreas Huber kTypeInt32, 13472961230a5890071bcca436eb5630172ce84ec41Andreas Huber kTypeInt64, 13572961230a5890071bcca436eb5630172ce84ec41Andreas Huber kTypeSize, 13672961230a5890071bcca436eb5630172ce84ec41Andreas Huber kTypeFloat, 13772961230a5890071bcca436eb5630172ce84ec41Andreas Huber kTypeDouble, 13872961230a5890071bcca436eb5630172ce84ec41Andreas Huber kTypePointer, 13972961230a5890071bcca436eb5630172ce84ec41Andreas Huber kTypeString, 14072961230a5890071bcca436eb5630172ce84ec41Andreas Huber kTypeObject, 14172961230a5890071bcca436eb5630172ce84ec41Andreas Huber kTypeMessage, 14231e2508c75018145a8238925ff1a08cbde4e799aAndreas Huber kTypeRect, 1432d8bedd05437b6fccdbc6bf70f673ffd86744d59Andreas Huber kTypeBuffer, 14472961230a5890071bcca436eb5630172ce84ec41Andreas Huber }; 14572961230a5890071bcca436eb5630172ce84ec41Andreas Huber 1465778822d86b0337407514b9372562b86edfa91cdAndreas Huber size_t countEntries() const; 1475778822d86b0337407514b9372562b86edfa91cdAndreas Huber const char *getEntryNameAt(size_t index, Type *type) const; 1485778822d86b0337407514b9372562b86edfa91cdAndreas Huber 1495778822d86b0337407514b9372562b86edfa91cdAndreas Huberprotected: 1505778822d86b0337407514b9372562b86edfa91cdAndreas Huber virtual ~AMessage(); 1515778822d86b0337407514b9372562b86edfa91cdAndreas Huber 1525778822d86b0337407514b9372562b86edfa91cdAndreas Huberprivate: 1535804a76ac5f9f3c311f1bbbcc5ebdc8f8568ae14Lajos Molnar friend struct ALooper; // deliver() 1545804a76ac5f9f3c311f1bbbcc5ebdc8f8568ae14Lajos Molnar 15572961230a5890071bcca436eb5630172ce84ec41Andreas Huber uint32_t mWhat; 1565804a76ac5f9f3c311f1bbbcc5ebdc8f8568ae14Lajos Molnar 1575804a76ac5f9f3c311f1bbbcc5ebdc8f8568ae14Lajos Molnar // used only for debugging 15872961230a5890071bcca436eb5630172ce84ec41Andreas Huber ALooper::handler_id mTarget; 15972961230a5890071bcca436eb5630172ce84ec41Andreas Huber 1605804a76ac5f9f3c311f1bbbcc5ebdc8f8568ae14Lajos Molnar wp<AHandler> mHandler; 1615804a76ac5f9f3c311f1bbbcc5ebdc8f8568ae14Lajos Molnar wp<ALooper> mLooper; 1625804a76ac5f9f3c311f1bbbcc5ebdc8f8568ae14Lajos Molnar 16331e2508c75018145a8238925ff1a08cbde4e799aAndreas Huber struct Rect { 16431e2508c75018145a8238925ff1a08cbde4e799aAndreas Huber int32_t mLeft, mTop, mRight, mBottom; 16531e2508c75018145a8238925ff1a08cbde4e799aAndreas Huber }; 16631e2508c75018145a8238925ff1a08cbde4e799aAndreas Huber 16772961230a5890071bcca436eb5630172ce84ec41Andreas Huber struct Item { 16872961230a5890071bcca436eb5630172ce84ec41Andreas Huber union { 16972961230a5890071bcca436eb5630172ce84ec41Andreas Huber int32_t int32Value; 17072961230a5890071bcca436eb5630172ce84ec41Andreas Huber int64_t int64Value; 17172961230a5890071bcca436eb5630172ce84ec41Andreas Huber size_t sizeValue; 17272961230a5890071bcca436eb5630172ce84ec41Andreas Huber float floatValue; 17372961230a5890071bcca436eb5630172ce84ec41Andreas Huber double doubleValue; 17472961230a5890071bcca436eb5630172ce84ec41Andreas Huber void *ptrValue; 17572961230a5890071bcca436eb5630172ce84ec41Andreas Huber RefBase *refValue; 17672961230a5890071bcca436eb5630172ce84ec41Andreas Huber AString *stringValue; 17731e2508c75018145a8238925ff1a08cbde4e799aAndreas Huber Rect rectValue; 17872961230a5890071bcca436eb5630172ce84ec41Andreas Huber } u; 17972961230a5890071bcca436eb5630172ce84ec41Andreas Huber const char *mName; 1807ea429295a2eb31f2d9256c36c1ef53a195456acLajos Molnar size_t mNameLength; 18172961230a5890071bcca436eb5630172ce84ec41Andreas Huber Type mType; 1827ea429295a2eb31f2d9256c36c1ef53a195456acLajos Molnar void setName(const char *name, size_t len); 18372961230a5890071bcca436eb5630172ce84ec41Andreas Huber }; 18472961230a5890071bcca436eb5630172ce84ec41Andreas Huber 18572961230a5890071bcca436eb5630172ce84ec41Andreas Huber enum { 186e370bb62b89d2f2980f519392010ea08a24c558eAndreas Huber kMaxNumItems = 64 18772961230a5890071bcca436eb5630172ce84ec41Andreas Huber }; 18872961230a5890071bcca436eb5630172ce84ec41Andreas Huber Item mItems[kMaxNumItems]; 18972961230a5890071bcca436eb5630172ce84ec41Andreas Huber size_t mNumItems; 19072961230a5890071bcca436eb5630172ce84ec41Andreas Huber 19172961230a5890071bcca436eb5630172ce84ec41Andreas Huber Item *allocateItem(const char *name); 1927ea429295a2eb31f2d9256c36c1ef53a195456acLajos Molnar void freeItemValue(Item *item); 19372961230a5890071bcca436eb5630172ce84ec41Andreas Huber const Item *findItem(const char *name, Type type) const; 19472961230a5890071bcca436eb5630172ce84ec41Andreas Huber 1952d8bedd05437b6fccdbc6bf70f673ffd86744d59Andreas Huber void setObjectInternal( 1962d8bedd05437b6fccdbc6bf70f673ffd86744d59Andreas Huber const char *name, const sp<RefBase> &obj, Type type); 1972d8bedd05437b6fccdbc6bf70f673ffd86744d59Andreas Huber 1987ea429295a2eb31f2d9256c36c1ef53a195456acLajos Molnar size_t findItemIndex(const char *name, size_t len) const; 1997ea429295a2eb31f2d9256c36c1ef53a195456acLajos Molnar 2005804a76ac5f9f3c311f1bbbcc5ebdc8f8568ae14Lajos Molnar void deliver(); 2015804a76ac5f9f3c311f1bbbcc5ebdc8f8568ae14Lajos Molnar 20272961230a5890071bcca436eb5630172ce84ec41Andreas Huber DISALLOW_EVIL_CONSTRUCTORS(AMessage); 20372961230a5890071bcca436eb5630172ce84ec41Andreas Huber}; 20472961230a5890071bcca436eb5630172ce84ec41Andreas Huber 20572961230a5890071bcca436eb5630172ce84ec41Andreas Huber} // namespace android 20672961230a5890071bcca436eb5630172ce84ec41Andreas Huber 20772961230a5890071bcca436eb5630172ce84ec41Andreas Huber#endif // A_MESSAGE_H_ 208