JRas 자원 번들 및 메시지 파일 작성

WebSphere® Application Server 메시지 로거는 message 및 msg 메소드를 제공하여 사용자가 로컬화된 메시지를 로그할 수 있도록 합니다. 또한 메시지 로거는 로컬화되지 않은 메시지를 로그하기 위한 textMessage 메소드를 제공합니다. 애플리케이션은 경우에 따라 이들 중 하나나 둘 모두를 사용할 수 있습니다.

시작하기 전에

이 태스크 및 그 하위 태스크에서 설명한 JRas 프레임워크는 더 이상 사용되지 않습니다. 그러나 Java™ 로깅을 사용하여 유사한 결과를 얻을 수 있습니다.

이 태스크 정보

로컬화된 메시지를 제공하기 위한 메커니즘은 IBM® Developer Kit, Java Technology Edition에서 제공하는 자원 번들 지원입니다. Developer Kit을 구현한 자원 번들에 대해 잘 알지 못하는 경우 다양한 텍스트로부터 또는 java.util.ResourceBundle, java.util.ListResourceBundle 및 java.util.PropertyResourceBundle classes, java.text.MessageFormat 클래스에 대한 API 문서를 읽어 자세한 정보를 얻을 수 있습니다.

PropertyResourceBundle 클래스가 사용에 선호되는 메커니즘입니다. 또한 JRas 확장은 MessageFormat 클래스에서 제공하는 확장된 형식화 옵션(예: {1, date} 또는 {0, number, integer})을 지원하지 않습니다.

내부 WebSphere Application Server 로그에 기록된 메시지를 표시하기 위해 다른 프로세스로 전달할 수 있습니다. 예를 들어, 서버 프로세스가 아닌 다른 위치에서 실행할 수 있는 관리 콘솔에 표시되는 메시지는 동적 바인딩 프로세스를 사용하여 로컬화할 수 있습니다. 동적 바인딩은 메시지가 로그될 때 WebSphere Application Server가 메시지를 로컬화하지 않고 메시지를 표시하는 프로세스에 대한 로컬화를 지연함을 의미합니다.

메시지를 올바르게 로컬화하려면 표시 프로세스에 메시지 텍스트가 저장되는 자원 번들에 대한 액세스 권한이 있어야 합니다. 애플리케이션과는 별도로 자원 번들을 패키지화하고 보기 프로세스가 액세스할 수 있는 위치에 이를 설치해야 합니다. 이러한 단계를 수행하지 않으려는 경우 메시지가 로그될 때 메시지를 로컬화하기 위해 정적 바인딩 기술을 사용할 수 있습니다.

이 두 기술은 다음과 같이 설명됩니다.
정적 바인딩
애플리케이션이 메시지를 로깅하기 전에 메시지를 로컬화해야 합니다. 애플리케이션은 자원 번들에서 로컬화된 텍스트를 검색하고 메시지를 형식화합니다. 형식화가 완료되면 애플리케이션이 textMessage 메소드를 사용하여 메시지를 로그합니다. 이 기술을 사용하여 애플리케이션 자원 번들을 애플리케이션과 패키지화하십시오.
동적 바인딩
애플리케이션은 WebSphere Application Server 런타임이 메시지가 표시되는 프로세스에서 메시지를 로컬화하도록 선택할 수 있습니다. 이 기술을 사용하여 애플리케이션과는 별도로 자원 번들을 독립형 .jar 파일로 패키지화합니다. 그런 다음, 관리 콘솔 또는 로그 보기 프로그램이 실행될 수 있는 설치에서 모든 시스템에 자원 번들 .jar 파일을 설치해야 합니다. 확장 클래스 경로의 일부인 디렉토리에 .jar 파일을 설치해야 합니다. 또한 로그를 IBM 서비스에 전달하는 경우 자원 번들을 포함하는 .jar 파일도 전달해야 합니다.

자원 번들을 작성하려면 다음 단계를 수행하십시오.

프로시저

  1. 메시지 키 및 그에 해당하는 메시지를 나열하는 텍스트 특성 파일을 작성하십시오. 특성 파일에는 다음 특성이 있어야 합니다.
    • 파일의 각 특성은 행 종료 문자로 종료됩니다.
    • 행에 공백만 있거나 행의 첫 번째 비공백 문자가 숫자 부호 기호(#) 또는 느낌표(!)인 경우, 이 행은 무시됩니다. 따라서 #! 문자는 파일에 주석을 삽입할 때 사용할 수 있습니다.
    • 주석이거나 공백만으로 이루어지지 않은 경우, 파일의 각 행은 단일 특성을 표시합니다. 백슬래시(\)는 행 연속 문자로 처리됩니다.
    • 특성 파일의 구문은 키, 구분 기호 및 요소로 구성됩니다. 유효한 구분 기호에는 등호(=), 콜론(:) 및 공백( ) 등이 있습니다.
    • 키는 첫 번째 비공백 문자에서 첫 번째 구분 기호까지 행에 있는 모든 문자로 구성됩니다. 구분 기호 문자를 백슬래시(\)로 이스케이프하여 키에 포함시킬 수 있지만 문자를 이스케이프하면 오류가 발생하기 쉽고 복잡하기 때문에 이 접근법 사용은 권장되지 않습니다. 대신 특성 파일의 어떤 키에도 표시되지 않는 유효한 구분 기호 문자를 사용하십시오.
    • 첫 번째 비공백 문자가 나타날 때까지 키 및 구분 기호 뒤 공백은 무시됩니다. 행 종료 문자 앞에 남아 있는 모든 문자는 요소를 정의합니다.

    특성 파일의 구문 및 구성에 대한 전체 설명은 java.util.Properties 클래스에 대한 Java 문서를 참조하십시오.

  2. 파일을 언어별 파일 이름을 가지는 로컬화된 파일 버전으로 변환하십시오. 예를 들어, DefaultMessages.properties 파일은 독일어의 경우 DefaultMessages_de.properties, 일본어의 경우 DefaultMessages_ja.properties로 변환될 수 있습니다.
  3. 변환된 자원 번들이 사용 가능한 경우 시스템 관리 지속 스토리지 매체에 기록하십시오. 자원 번들은 메시지를 요청된 자국어 및 로케일로 변환하는 데 사용됩니다.
  4. 메시지 로거를 JRas 관리자로부터 얻는 경우 이 로거가 특정 자원 번들을 사용하도록 구성하십시오. 메시지 API를 통해 로그된 메시지는 메시지 로컬화가 수행될 때 이 자원 번들을 사용합니다. 런타임 시, 사용자의 로케일 설정은 메시지가 올바른 언어로 전달되는지 확인하여 메시지 키로 지정되는 메시지를 추출할 특성 파일을 판별하는 데 사용됩니다.
  5. 메시지 로거 msg 메소드가 호출될 때 자원 번들 이름을 명시적으로 식별하십시오.

다음에 수행할 작업

애플리케이션은 클래스 경로에서 디렉토리의 상대적인 파일 위치에 따라 자원 번들을 찾습니다. 예를 들어, DefaultMessages.properties 특성 자원 번들이 baseDir/subDir1/subDir2/resources 디렉토리에 있고 baseDir이 클래스 경로에 있는 경우, 자원 번들을 식별하기 위해 이름 subdir1.subdir2.resources.DefaultMessage가 메시지 로거에 전달됩니다.

주제 유형을 표시하는 아이콘 태스크 주제



시간소인 아이콘 마지막 업데이트 날짜: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=ttrb_jrasmkrbs
파일 이름:ttrb_jrasmkrbs.html