מזהה AppSetId
public
class
AppSetId
extends Object
java.lang.Object | |
↳ | android.adservices.appsetid.AppSetId |
מזהה ייחודי לפי מכשיר שניתן לאיפוס על ידי המשתמש, לכל חשבון פיתוח, לפרסום שאינו מפעיל מונטיזציה במקרים שונים.
מייצג את ה-appSetID וההיקף של appSetId מה-API AppSetIdManager.getAppSetId(Executor, OutcomeReceiver)
. ההיקף של המזהה יכול להיות לכל אפליקציה
או לכל חשבון פיתוח שמשויך למשתמש. AppSetId משמש לניתוח נתונים, ספאם
של זיהוי, מכסת תדירות ומניעת הונאות במכשיר נתון, שנדרשים
כדי לקשר בין שימוש או פעולות בקבוצת אפליקציות שבבעלות ארגון.
סיכום
קבועים | |
---|---|
int |
SCOPE_APP
השדה appSetId הוא בהיקף של אפליקציה. |
int |
SCOPE_DEVELOPER
מזהה ה-appSetId הוא בהיקף של חשבון פיתוח בחנות אפליקציות. |
בנאים ציבוריים | |
---|---|
AppSetId(String appSetId, int appSetIdScope)
יצירת מופע של |
שיטות ציבוריות | |
---|---|
boolean
|
equals(Object o)
מציין אם אובייקט אחר הוא "שווה ל" הזה. |
String
|
getId()
אחזור של appSetId. |
int
|
getScope()
אחזור ההיקף של appSetId. |
int
|
hashCode()
מחזירה ערך גיבוב (hash) של האובייקט. |
שיטות שעברו בירושה | |
---|---|
קבועים
Scope_APP
public static final int SCOPE_APP
השדה appSetId הוא בהיקף של אפליקציה. לכל האפליקציות במכשיר יהיה מזהה appSetId שונה.
ערך קבוע: 1 (0x00000001)
SCOPE_developers
public static final int SCOPE_DEVELOPER
מזהה ה-appSetId הוא בהיקף של חשבון פיתוח בחנות אפליקציות. כל האפליקציות מאותה אפליקציה למפתח במכשיר יהיה אותו appSetId ברמת המפתח.
ערך קבוע: 2 (0x00000002)
בנאים ציבוריים
מזהה AppSetId
public AppSetId (String appSetId, int appSetIdScope)
יצירת מופע של AppSetId
פרמטרים | |
---|---|
appSetId |
String : נוצר על ידי השירות של הספק.
הערך הזה לא יכול להיות null . |
appSetIdScope |
int : ההיקף של הפרמטר appSetId.
הערך הוא SCOPE_APP , או SCOPE_DEVELOPER |
שיטות ציבוריות
שווה ל-
public boolean equals (Object o)
מציין אם אובייקט אחר הוא "שווה ל" הזה.
השיטה equals
מטמיעים יחס שקילות
בהפניות לאובייקטים שאינם אפס:
- הגדרה רפלקטיבית: לכל ערך הפניה שהוא לא null
x
,x.equals(x)
אמור לחזורtrue
- הערך הוא סימטרי: לכל ערכי הפניה שאינם אפס
x
וגםy
,x.equals(y)
צריך להחזיר את הערךtrue
אם ורק אם הפונקציהy.equals(x)
מחזירהtrue
. - הוא מעבר: לכל ערכי הפניה שאינם null
x
,y
וגםz
, אםx.equals(y)
מחזירהtrue
וy.equals(z)
מחזירהtrue
, ואזx.equals(z)
אמור להחזירtrue
. - הוא עקבי: לכל ערכי הפניה שאינם null
x
ו-y
, מספר הפעלות שלx.equals(y)
מחזירtrue
באופן עקבי או להחזיר בעקביותfalse
, בתנאי שלא מידע שמשמש בהשוואות שלequals
אובייקטים הם משתנים. - לכל ערך הפניה שהוא לא אפס,
x
הפונקציהx.equals(null)
צריכה להחזיר את הערךfalse
.
ה-method equals
למחלקה Object
מיושמת
את יחס השקילות האפשריים ביותר על אובייקטים;
כלומר, לכל ערכי הפניה שאינם אפסיים x
וגם
y
, השיטה הזו מחזירה true
אם ורק
אם x
ו-y
מתייחסים לאותו אובייקט
(x == y
יש את הערך true
).
לתשומת ליבכם: בדרך כלל יש צורך בשינוי מברירת המחדל של hashCode
בכל פעם שמחליפים את השיטה, כדי לשמור על
חוזה כללי ל-method hashCode
, שקובעת
שאובייקטים שווים חייבים להיות בעלי קודי גיבוב (hash) שווים.
פרמטרים | |
---|---|
o |
Object : אובייקט ההפניה שאליו תשוו. |
החזרות | |
---|---|
boolean |
true אם האובייקט הזה זהה ל-obj
ארגומנט; אחרת, false . |
getId
public String getId ()
אחזור של appSetId. ה-API תמיד מחזיר appSetId שאינו ריק.
החזרות | |
---|---|
String |
הערך הזה לא יכול להיות null . |
getScope
public int getScope ()
אחזור ההיקף של appSetId.
החזרות | |
---|---|
int |
הערך הוא SCOPE_APP , או SCOPE_DEVELOPER |
קוד גיבוב (hashCode)
public int hashCode ()
מחזירה ערך גיבוב (hash) של האובייקט. השיטה הזאת
נתמך לטובת טבלאות גיבוב (hash), כמו אלה שמסופקות על ידי
HashMap
החוזה הכללי של hashCode
הוא:
- בכל פעם שהוא מופעל על אותו אובייקט יותר מפעם אחת במהלך
הרצה של אפליקציה ב-Java, ה-method
hashCode
צריך להחזיר בעקביות את אותו מספר שלם, כל עוד אין מידע שנעשה בו שימוש בהשוואות שלequals
באובייקט. המספר השלם הזה לא צריך להיות עקבי מהפעלה אחת של לביצוע אחר של אותה האפליקציה. - אם שני אובייקטים שווים לפי
equals(Object)
ואז קריאה ל-methodhashCode
בכל אחד שני האובייקטים חייבים להפיק את אותה תוצאה של מספר שלם. - לא נדרש שאם שני אובייקטים אינם שווים
בהתאם ל
equals(java.lang.Object)
ואז קריאה ל-methodhashCode
בכל אחד שני אובייקטים חייבים להניב תוצאות נפרדות של מספרים שלמים. אבל, מתכנת צריך להיות מודע לכך שהפקת תוצאות של מספרים שלמים נפרדים לאובייקטים לא שווים, עשויה לשפר את הביצועים של טבלאות גיבוב.
עד כמה שהדבר מעשי באופן סביר, שיטת ה-hashCode מוגדרת
לפי מחלקה Object
מחזיר מספרים שלמים ייחודיים
של אובייקטים ייחודיים. (ייתכן שה-hashCode לא הוטמע
בתור פונקציה כלשהי של כתובת הזיכרון של אובייקט בשלב כלשהו
בזמן).
החזרות | |
---|---|
int |
ערך קוד גיבוב (hash) של האובייקט הזה. |