Facet 클래스는 문서 속성을 나타내는 추상 기본 클래스입니다. 이 클래스를 직접 인스턴스화할 수 없습니다.
Facet은 모듈 google.appengine.api.search에 정의됩니다.
속성
Facet 클래스의 인스턴스에는 다음 속성이 있습니다.
- name
속성 이름입니다. 속성 이름은 MAXIMUM_FIELD_NAME_LENGTH의 최대 길이여야 하고 '[A-Za-z][A-Za-z0-9_]*' 패턴과 일치해야 합니다.
- value
속성 값이며 문자열, 유니코드 또는 숫자일 수 있습니다.
서브클래스
Facet 클래스에는 다음 서브클래스가 있습니다.
- class AtomFacet
색인 생성을 위한 단일 토큰으로 취급될 콘텐츠가 있는 속성입니다.
속성 값은 분할될 수 없는 텍스트 값으로 취급되는 문자열 또는 유니코드 객체입니다. 다음 예는 wine_type이라는 원자 속성을 보여 줍니다.
AtomFacet(name='wine_type', value='Red')
-
예외
- TypeError
제공된 값이 텍스트 문자열이 아닙니다.
- ValueError
값이 최대 허용 길이를 초과합니다.
- class NumberFacet
숫자 값을 가진 속성입니다.
다음 예는 wine_vintage라는 숫자 속성을 보여 줍니다.
NumberFacet(name='wine_vintage', value=2000)
-
예외
- TypeError
제공된 값이 숫자가 아닙니다.
- ValueError
값이 범위를 벗어났습니다.