/* * Copyright (C) 2020 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ /** * @addtogroup NdkBinder * @{ */ /** * @file binder_parcelable_utils.h * @brief Helper for parcelable. */ #pragma once #include #include namespace ndk { // Also see Parcelable.h in libbinder. typedef int32_t parcelable_stability_t; enum { STABILITY_LOCAL, STABILITY_VINTF, // corresponds to @VintfStability }; #define RETURN_ON_FAILURE(expr) \ do { \ binder_status_t _status = (expr); \ if (_status != STATUS_OK) return _status; \ } while (false) // AParcelableHolder has been introduced in 31. #if __ANDROID_API__ >= 31 class AParcelableHolder { public: AParcelableHolder() = delete; explicit AParcelableHolder(parcelable_stability_t stability) : mParcel(AParcel_create()), mStability(stability) {} AParcelableHolder(const AParcelableHolder& other) : mParcel(AParcel_create()), mStability(other.mStability) { AParcel_appendFrom(other.mParcel.get(), this->mParcel.get(), 0, AParcel_getDataSize(other.mParcel.get())); } AParcelableHolder(AParcelableHolder&& other) = default; virtual ~AParcelableHolder() = default; binder_status_t writeToParcel(AParcel* parcel) const { RETURN_ON_FAILURE(AParcel_writeInt32(parcel, static_cast(this->mStability))); int32_t size = AParcel_getDataSize(this->mParcel.get()); RETURN_ON_FAILURE(AParcel_writeInt32(parcel, size)); size = AParcel_getDataSize(this->mParcel.get()); RETURN_ON_FAILURE(AParcel_appendFrom(this->mParcel.get(), parcel, 0, size)); return STATUS_OK; } binder_status_t readFromParcel(const AParcel* parcel) { AParcel_reset(mParcel.get()); parcelable_stability_t wireStability; RETURN_ON_FAILURE(AParcel_readInt32(parcel, &wireStability)); if (this->mStability != wireStability) { return STATUS_BAD_VALUE; } int32_t dataSize; binder_status_t status = AParcel_readInt32(parcel, &dataSize); if (status != STATUS_OK || dataSize < 0) { return status != STATUS_OK ? status : STATUS_BAD_VALUE; } int32_t dataStartPos = AParcel_getDataPosition(parcel); if (dataStartPos > INT32_MAX - dataSize) { return STATUS_BAD_VALUE; } status = AParcel_appendFrom(parcel, mParcel.get(), dataStartPos, dataSize); if (status != STATUS_OK) { return status; } return AParcel_setDataPosition(parcel, dataStartPos + dataSize); } template binder_status_t setParcelable(const T& p) { if (this->mStability > T::_aidl_stability) { return STATUS_BAD_VALUE; } AParcel_reset(mParcel.get()); AParcel_writeString(mParcel.get(), T::descriptor, strlen(T::descriptor)); p.writeToParcel(mParcel.get()); return STATUS_OK; } template binder_status_t getParcelable(std::optional* ret) const { const std::string parcelableDesc(T::descriptor); AParcel_setDataPosition(mParcel.get(), 0); if (AParcel_getDataSize(mParcel.get()) == 0) { *ret = std::nullopt; return STATUS_OK; } std::string parcelableDescInParcel; binder_status_t status = AParcel_readString(mParcel.get(), &parcelableDescInParcel); if (status != STATUS_OK || parcelableDesc != parcelableDescInParcel) { *ret = std::nullopt; return status; } *ret = std::make_optional(); status = (*ret)->readFromParcel(this->mParcel.get()); if (status != STATUS_OK) { *ret = std::nullopt; return status; } return STATUS_OK; } void reset() { AParcel_reset(mParcel.get()); } inline bool operator!=(const AParcelableHolder& rhs) const { return this != &rhs; } inline bool operator<(const AParcelableHolder& rhs) const { return this < &rhs; } inline bool operator<=(const AParcelableHolder& rhs) const { return this <= &rhs; } inline bool operator==(const AParcelableHolder& rhs) const { return this == &rhs; } inline bool operator>(const AParcelableHolder& rhs) const { return this > &rhs; } inline bool operator>=(const AParcelableHolder& rhs) const { return this >= &rhs; } inline AParcelableHolder& operator=(const AParcelableHolder& rhs) { this->reset(); if (this->mStability != rhs.mStability) { syslog(LOG_ERR, "AParcelableHolder stability mismatch: this %d rhs %d!", this->mStability, rhs.mStability); abort(); } AParcel_appendFrom(rhs.mParcel.get(), this->mParcel.get(), 0, AParcel_getDataSize(rhs.mParcel.get())); return *this; } private: mutable ndk::ScopedAParcel mParcel; parcelable_stability_t mStability; }; #endif // __ANDROID_API__ >= 31 #undef RETURN_ON_FAILURE } // namespace ndk /** @} */