AdSelectionOutcome

public class AdSelectionOutcome
extends Object

java.lang.Object
   ↳ android.adservices.adselection.AdSelectionOutcome


이 클래스는 AdSelectionManager에 있는 AdSelectionManager.selectAds(AdSelectionConfig, Executor, OutcomeReceiver)의 입력인 OutcomeReceiver의 필드를 나타냅니다. 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

AdSelectionOutcome 객체의 빌더입니다. 

필드

public static final AdSelectionOutcome NO_OUTCOME

결과가 비어 있는 AdSelectionOutcome을 나타냅니다.

공개 메서드

boolean equals(Object o)

일부 다른 개체가 이 개체와 '같은'지 여부를 나타냅니다.

long getAdSelectionId()

AdSelection을 식별하는 adSelectionId를 반환합니다.

Uri getRenderUri()

AdSelection에서 반환하는 drawUri를 반환합니다.

boolean hasOutcome()

결과에 결과가 포함되어 있는지 아니면 비어 있는지 여부를 반환합니다.

int hashCode()

객체의 해시 코드 값을 반환합니다.

상속된 메서드

필드

결과 없음

public static final AdSelectionOutcome NO_OUTCOME

결과가 비어 있는 AdSelectionOutcome을 나타냅니다.

공개 메서드

같음

API 수준 34에 추가되었습니다.
public boolean equals (Object o)

일부 다른 개체가 이 개체와 '같은'지 여부를 나타냅니다.

equals 메서드는 null이 아닌 객체 참조에서 등가 관계를 구현합니다.

  • 반사적입니다. null이 아닌 참조 값 x의 경우 x.equals(x)true를 반환해야 합니다.
  • 대칭적입니다. null이 아닌 참조 값 xy의 경우 x.equals(y)y.equals(x)true를 반환하는 경우에만 true를 반환해야 합니다.
  • 전이적입니다. null이 아닌 참조 값 x, y, z의 경우 x.equals(y)true를 반환하고 y.equals(z)true를 반환하면 x.equals(z)true를 반환해야 합니다.
  • 일관적입니다. null이 아닌 참조 값 xy의 경우 객체에서 equals 비교에 사용된 정보가 수정되지 않았다고 가정할 때 x.equals(y)를 여러 번 호출하면 일관되게 true를 반환하거나 일관되게 false를 반환합니다.
  • null이 아닌 참조 값 x의 경우 x.equals(null)false를 반환해야 합니다.

Object 클래스의 equals 메서드는 객체에서 가장 구분 가능한 등가 관계를 구현합니다. 즉 null이 아닌 참조 값 xy의 경우 이 메서드는 xy가 동일한 객체를 참조하는 경우에만 true를 반환합니다(x == y의 값이 true임).

동일한 객체에 동일한 해시 코드가 있어야 한다고 명시하는 hashCode 메서드의 일반 계약을 유지하기 위해 일반적으로 hashCode 메서드가 재정의될 때마다 이 메서드를 재정의해야 합니다.

매개변수
o Object: 비교할 참조 객체입니다.

반환 값
boolean 이 객체가 obj 인수와 동일한 경우 true, 동일하지 않은 경우에는 false입니다.

getAdSelectionId

public long getAdSelectionId ()

AdSelection을 식별하는 adSelectionId를 반환합니다.

반환 값
long 이 값은 null일 수 없습니다.

getRenderUri

public Uri getRenderUri ()

AdSelection에서 반환하는 drawUri를 반환합니다.

반환 값
Uri 이 값은 null일 수 없습니다.

hasResult

public boolean hasOutcome ()

결과에 결과가 포함되어 있는지 아니면 비어 있는지 여부를 반환합니다. 빈 결과의 render uris는 사용하면 안 됩니다.

반환 값
boolean

hashCode

API 수준 34에 추가되었습니다.
public int hashCode ()

객체의 해시 코드 값을 반환합니다. 이 메서드는 HashMap에서 제공하는 것과 같은 해시 테이블을 활용하기 위해 지원됩니다.

hashCode의 일반 계약은 다음과 같습니다.

  • 객체의 equals 비교에 사용된 정보가 수정되지 않았다고 가정할 때, hashCode 메서드는 Java 애플리케이션이 실행되는 동안 동일한 객체에서 두 번 이상 호출될 때마다 동일한 정수를 일관되게 반환해야 합니다. 이 정수는 애플리케이션의 한 실행에서 동일한 애플리케이션의 또 다른 실행까지 일관되게 유지될 필요가 없습니다.
  • equals(Object) 메서드에 따라 두 객체가 같다면 두 객체 각각에서 hashCode 메서드를 호출하면 동일한 정수 결과가 생성되어야 합니다.
  • equals(java.lang.Object) 메서드에 따라 두 객체가 같지 않은 경우 두 객체 각각에서 hashCode 메서드를 호출하면 별개의 정수 결과가 생성되어야 하는 것은 아닙니다. 하지만 프로그래머는 같지 않은 객체에 별개의 정수 결과를 생성하면 해시 테이블의 성능이 향상될 수 있음을 알고 있어야 합니다.

Object 클래스에서 정의한 hashCode 메서드는 상당히 실용적인 만큼 서로 다른 객체에 대해 별개의 정수를 반환합니다. hashCode는 특정 시점에 객체 메모리 주소의 일부 함수로 구현되거나 구현되지 않을 수 있습니다.

반환 값
int 이 객체의 해시 코드 값입니다.