CatalogFeatures

CatalogFeatures (카탈로그 기능 설정)

카탈로그 기능과 속성들의 모음(FEATURES, PREFER, DEFER, RESOLVE)을 담는 클래스예요. 카탈로그 처리 동작을 설정해요.

출처: Java API Reference

본문

public class CatalogFeatures
    extends Object

CatalogFeatures는 카탈로그 기능과 속성들을 담고 있어요. 주요 기능으로 FILES, PREFER, DEFER, RESOLVE가 있어요.

FILES는 카탈로그 파일을 찾을 URI 목록(세미콜론 구분)이고, PREFER는 public과 system 식별자 중 어느 쪽을 선호할지(기본 public)를, DEFER는 대체 카탈로그를 필요할 때까지 읽지 않을지(기본 true)를, RESOLVE는 모든 카탈로그를 다 사용한 뒤에도 매칭이 없을 때의 동작(strict, continue, ignore)을 결정해요.

빌더 패턴으로 손쉽게 만들 수 있어요. 예를 들어 CatalogFeatures.builder().with(Feature.FILES, "file:///etc/xml/catalog").build()처럼 사용해요.

카탈로그 기능은 SAX·DOM·StAX 파서, 스키마 검증, XML 변환 등 모든 JAXP 프로세서에서 지원돼요. JAXP 프로세서는 USE_CATALOG 기능이 true이고 유효한 카탈로그 파일이 지정될 때만 카탈로그를 사용해요.

이 속성들은 시스템 속성, API 속성, JAXP 설정 파일에서 우선순위에 따라 값을 가져오며, 카탈로그 파일 안의 엔트리 속성으로 지정되면 다른 설정보다 우선해요.

더 알아보기

Java 공식 API