주제

public final class Topic
extends Object

java.lang.Object
   ↳ android.adservices.topics.Topic


getTopics API의 주제 결과를 나타냅니다.

요약

공개 생성자

Topic(long mTaxonomyVersion, long mModelVersion, int mTopicId)

getTopics API의 결과를 나타내는 객체를 만듭니다.

공개 메서드

boolean equals(Object object)

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

long getModelVersion()

ModelVersion을 가져옵니다.

long getTaxonomyVersion()

TaxonomyVersion을 가져옵니다.

int getTopicId()

주제 ID를 가져옵니다.

int hashCode()

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

String toString()

객체의 문자열 표현을 반환합니다.

상속된 메서드

공개 생성자

주제

public Topic (long mTaxonomyVersion, 
                long mModelVersion, 
                int mTopicId)

getTopics API의 결과를 나타내는 객체를 만듭니다.

매개변수
mTaxonomyVersion long: 분류의 버전을 나타내는 long입니다.

mModelVersion long: 모델의 버전을 나타내는 long입니다.

mTopicId int: 주제의 고유 ID를 나타내는 정수입니다.

공개 메서드

equals

API 수준 34에 추가됨
public boolean equals (Object object)

일부 다른 객체가 이 객체와 '동일한지'를 나타냅니다.

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 메서드가 재정의될 때마다 이 메서드를 재정의해야 합니다.

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

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

getModelVersion

public long getModelVersion ()

ModelVersion을 가져옵니다.

반환 값
long

getTaxonomyVersion

public long getTaxonomyVersion ()

TaxonomyVersion을 가져옵니다.

반환 값
long

getTopicId

public int getTopicId ()

주제 ID를 가져옵니다.

반환 값
int

hashCode

API 수준 34에 추가됨
public int hashCode ()

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

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

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

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

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

toString

API 수준 34에 추가됨
public String toString ()

객체의 문자열 표현을 반환합니다. 일반적으로 toString 메서드는 이 객체를 '텍스트로 표현'하는 문자열을 반환합니다. 결과는 사람이 읽기 쉬우며 간결하지만 정보를 제공하도록 표현되어야 합니다. 모든 서브클래스는 이 메서드를 재정의하는 것이 좋습니다.

Object 클래스의 toString 메서드는 객체가 인스턴스인 클래스의 이름, at 기호 문자 `@' 및 객체 해시 코드의 부호 없는 16진수 표현으로 구성된 문자열을 반환합니다. 즉, 이 메서드는 다음 값과 동일한 문자열을 반환합니다.

 getClass().getName() + '@' + Integer.toHexString(hashCode())
 

반환 값
String 객체의 문자열 표현입니다.