AdSelection Outcome
public class AdSelectionOutcome
extends Object
java.lang.object | |
↳ | android.adservices.adselection.AdSelectionOutcome |
این کلاس فیلدی را در OutcomeReceiver
نشان میدهد که ورودی AdSelectionManager.selectAds(AdSelectionConfig, Executor, OutcomeReceiver)
در AdSelectionManager
است. این فیلد در صورت تماس موفق AdSelectionManager#selectAds
پر می شود.
ممکن است نتیجه خالی از AdSelectionManager.selectAds(android.adservices.adselection.AdSelectionFromOutcomesConfig, java.util.concurrent.Executor, android.os.OutcomeReceiver)
برگردانده شود. از AdSelectionOutcome#hasOutcome()
برای بررسی اینکه آیا یک نمونه نتیجه معتبری دارد یا خیر استفاده کنید. وقتی hasOutcome()
false
را برمی گرداند، نتایج حاصل از #getAdSelectionId()
و AdSelectionOutcome#getRenderUri()
نامعتبر هستند و نباید استفاده شوند.
خلاصه
کلاس های تو در تو | |
---|---|
class | AdSelectionOutcome.Builder سازنده برای اشیاء |
فیلدها | |
---|---|
public static final AdSelectionOutcome | NO_OUTCOME یک AdSelectionOutcome را با نتایج خالی نشان می دهد. |
روش های عمومی | |
---|---|
boolean | equals ( Object o) نشان می دهد که آیا یک شی دیگر "برابر" این یکی است یا خیر. |
long | getAdSelectionId () adSelectionId را که AdSelection را مشخص می کند، برمی گرداند. |
Uri | getRenderUri () renderUri را که AdSelection برمی گرداند، برمی گرداند. |
boolean | hasOutcome () برمیگرداند که آیا نتیجه حاوی نتایج باشد یا خالی. |
int | hashCode () مقدار کد هش را برای شی برمیگرداند. |
روش های ارثی | |
---|---|
فیلدها
NO_OUTCOME
public static final AdSelectionOutcome NO_OUTCOME
یک AdSelectionOutcome را با نتایج خالی نشان می دهد.
روش های عمومی
برابر است
public boolean equals (Object o)
نشان می دهد که آیا یک شی دیگر "برابر" این یکی است یا خیر.
متد equals
یک رابطه هم ارزی را در مراجع شی غیر تهی پیاده سازی می کند:
- بازتابی است: برای هر مقدار مرجع غیر تهی
x
،x.equals(x)
بایدtrue
برگرداند. - متقارن است: برای هر مقدار مرجع غیر تهی
x
وy
،x.equals(y)
بایدtrue
را برگرداند اگر و فقط اگرy.equals(x)
true
را برگرداند. - انتقالی است: برای هر مقدار مرجع غیر تهی
x
،y
، وz
، اگرx.equals(y)
true
وy.equals(z)
true
را برمی گرداند، آنگاهx.equals(z)
بایدtrue
برگرداند. - سازگار است: برای هر مقدار مرجع غیر تهی
x
وy
، فراخوانی های متعددx.equals(y)
به طور پیوستهtrue
یا به طور پیوستهfalse
را برمی گرداند، مشروط بر اینکه هیچ اطلاعاتی که در مقایسه هایequals
بر روی اشیاء استفاده می شود اصلاح نشود. - برای هر مقدار مرجع غیر تهی
x
،x.equals(null)
بایدfalse
برگرداند.
متد equals
برای کلاس Object
متمایزترین رابطه هم ارزی ممکن را روی اشیا پیاده سازی می کند. یعنی، برای هر مقدار مرجع غیر تهی x
و y
، این روش اگر و فقط اگر x
و y
به یک شی اشاره داشته باشند، true
را برمی گرداند ( x == y
مقدار true
را دارد).
توجه داشته باشید که به طور کلی هر زمان که این روش نادیده گرفته می شود، باید متد hashCode
را لغو کرد تا قرارداد کلی برای متد hashCode
حفظ شود که بیان می کند که اشیاء مساوی باید دارای کدهای هش برابر باشند.
پارامترها | |
---|---|
o | Object : شی مرجعی که با آن مقایسه می شود. |
برمی گرداند | |
---|---|
boolean | true اگر این شی همان آرگومان obj باشد. false در غیر این صورت |
getAdSelectionId
public long getAdSelectionId ()
adSelectionId را که AdSelection را مشخص می کند، برمی گرداند.
برمی گرداند | |
---|---|
long | این مقدار نمی تواند null باشد. |
getRenderUri
public Uri getRenderUri ()
renderUri را که AdSelection برمی گرداند، برمی گرداند.
برمی گرداند | |
---|---|
Uri | این مقدار نمی تواند null باشد. |
نتیجه دارد
public boolean hasOutcome ()
برمیگرداند که آیا نتیجه حاوی نتایج باشد یا خالی. render uris
پیامدهای خالی نباید استفاده شود.
برمی گرداند | |
---|---|
boolean |
هش کد
public int hashCode ()
مقدار کد هش را برای شی برمیگرداند. این روش برای استفاده از جداول هش مانند آنهایی که توسط HashMap
ارائه شده است پشتیبانی می شود.
قرارداد کلی hashCode
به شرح زیر است:
- هر گاه در طول اجرای یک برنامه جاوا بیش از یک بار بر روی یک شیء فراخوانی شود، متد
hashCode
باید به طور پیوسته همان عدد صحیح را برگرداند، مشروط بر اینکه هیچ اطلاعاتی که در مقایسههایequals
روی شی مورد استفاده قرار میگیرد تغییر نکند. لازم نیست این عدد صحیح از یک اجرای یک برنامه به اجرای دیگری از همان برنامه ثابت بماند. - اگر دو شی با توجه به متد
equals(Object)
برابر باشند، فراخوانی متدhashCode
روی هر یک از دو شیء باید یک عدد صحیح را ایجاد کند. - لازم نیست که اگر دو شی مطابق با متد
equals(java.lang.Object)
نابرابر باشند، فراخوانی متدhashCode
روی هر یک از دو شیء باید نتایج اعداد صحیح متمایز ایجاد کند. با این حال، برنامه نویس باید آگاه باشد که تولید نتایج اعداد صحیح متمایز برای اشیاء نابرابر ممکن است عملکرد جداول هش را بهبود بخشد.
تا آنجا که عملی است، متد hashCode که توسط کلاس Object
تعریف شده است، اعداد صحیح متمایز را برای اشیاء مجزا برمی گرداند. (HashCode ممکن است به عنوان تابعی از آدرس حافظه یک شی در نقطه ای از زمان اجرا شود یا نباشد.)
برمی گرداند | |
---|---|
int | یک مقدار کد هش برای این شی. |
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2024-08-20 بهوقت ساعت هماهنگ جهانی.