개발 가이드

1. Red Hat 고객 포털에서 JBoss EAP 다운로드 페이지에 로그인합니다.
2. Version(버전) 드롭다운 메뉴에서 7.4 를 선택합니다.
3. 목록에서 Red Hat JBoss Enterprise Application Platform 7.4 Maven 리포지토리 항목을 찾고 다운로드를 클릭하여 리포지토리가 포함된 ZIP 파일을 다운로드합니다.
4. ZIP 파일을 원하는 디렉토리에 저장합니다.
5. ZIP 파일을 추출합니다.

1. Red Hat 고객 포털에서 JBoss EAP 다운로드 페이지에 로그인합니다.
2. Version(버전) 드롭다운 메뉴에서 7.4 를 선택합니다.
3. 목록에서 Red Hat JBoss Enterprise Application Platform 7.4 Maven Repository Offliner Content List 항목을 찾고 다운로드를 클릭합니다.

4. 텍스트 파일을 원하는 디렉터리에 저장합니다.

   참고

   이 파일에는 라이센스 정보가 포함되어 있지 않습니다. Offliner 애플리케이션에서 다운로드한 아티팩트는 JBoss EAP와 함께 배포되는 Maven 리포지토리 ZIP 파일에 지정된 것과 동일한 라이센스를 갖습니다.

5. Maven 중앙 리포지토리에서 Offliner 애플리케이션을 다운로드합니다.

6. 다음 명령을 사용하여 Offliner 애플리케이션을 실행합니다.

   $ java -jar offliner.jar -r http://repository.redhat.com/ga/ -d DOWNLOAD_FOLDER jboss-eap-7.4.0-maven-repository-content-with-sha256-checksums.txt

   Copy to Clipboard Toggle word wrap

   JBoss EAP Maven 리포지토리의 아티팩트는 DOWNLOAD_FOLDER 디렉터리에 다운로드됩니다.

1. JBoss EAP Maven 리포지토리 ZIP 파일을 로컬 파일 시스템에 다운로드 했는지 확인합니다.

2. 선택한 로컬 파일 시스템에서 파일의 압축을 풉니다.

   그러면 maven-repository/ 라는 하위 디렉토리에 Maven 리포지토리가 포함된 새 jboss-eap-7.4.0-maven-repository/ 디렉터리가 생성됩니다.

1. JBoss EAP Maven 리포지토리 ZIP 파일이 로컬 파일 시스템에 다운로드되었는지 확인합니다.
2. Apache 서버에서 웹에 액세스할 수 있는 디렉터리에서 파일의 압축을 풉니다.

3. 생성된 디렉토리에서 읽기 액세스 및 디렉토리 검색을 허용하도록 Apache를 구성합니다.

   이 구성을 사용하면 다중 사용자 환경에서 Apache httpd의 Maven 리포지토리에 액세스할 수 있습니다.

1. 아직 완료하지 않은 경우 JBoss EAP Maven 리포지토리를 사용하도록 Maven 설정을 구성합니다.

   자세한 내용은 Configure the JBoss EAP Maven Repository using the Maven Settings 에서 참조하십시오.

2. JBoss Logging Tools를 사용하도록 프로젝트의 pom.xml 파일을 구성합니다.

   자세한 내용은 JBoss Logging Tools Maven Configuration을 참조하십시오.

3. 로그 메시지 정의를 포함하도록 프로젝트에 Java 인터페이스를 추가하여 메시지 로거 인터페이스를 만듭니다.

   정의할 로그 메시지를 설명하도록 인터페이스의 이름을 지정합니다. 로그 메시지 인터페이스에는 다음 요구 사항이 있습니다.

   • @org.jboss.logging.annotations.MessageLogger 에 주석을 달아야 합니다.
   • 선택적으로 org.jboss.logging.BasicLogger 를 확장할 수 있습니다.

   • 인터페이스는 인터페이스와 동일한 유형의 메시지 로거인 필드를 정의해야 합니다. 이를 @org.jboss.logging. Logger의 getMessageLogger () 메서드로 수행합니다.

     예제: 메시지 로거 생성

     package com.company.accounts.loggers;
     
     import org.jboss.logging.BasicLogger;
     import org.jboss.logging.Logger;
     import org.jboss.logging.annotations.MessageLogger;
     
     @MessageLogger(projectCode="")
     interface AccountsLogger extends BasicLogger {
        AccountsLogger LOGGER = Logger.getMessageLogger(
              AccountsLogger.class,
              AccountsLogger.class.getPackage().getName() );
     }

     Copy to Clipboard Toggle word wrap

4. 각 로그 메시지의 인터페이스에 메서드 정의를 추가합니다.

   각 메서드가 나타내는 로그 메시지에 대해 설명적으로 이름을 지정합니다. 각 방법에는 다음 요구 사항이 있습니다.

   • 메서드는 void 을 반환해야 합니다.
   • @org.jboss.logging.annotation.LogMessage 주석을 사용하여 주석을 달아야 합니다.
   • @org.jboss.logging.annotations.Message 주석을 사용하여 주석을 달아야 합니다.
   • 기본 로그 수준은 INFO(정보) 입니다.

   • @org.jboss.logging.annotations.Message 의 value 속성에는 번역을 사용할 수 없는 경우 사용되는 기본 로그 메시지가 포함되어 있습니다.

     @LogMessage
     @Message(value = "Customer query failed, Database not available.")
     void customerQueryFailDBClosed();

     Copy to Clipboard Toggle word wrap

5. 메시지가 로깅되어야 하는 코드의 인터페이스 메서드에 호출을 추가하여 메서드를 호출합니다.

   인터페이스 구현을 생성할 필요가 없으며, 프로젝트를 컴파일할 때 주석 프로세서가 이 작업을 수행합니다.

   AccountsLogger.LOGGER.customerQueryFailDBClosed();

   Copy to Clipboard Toggle word wrap

   사용자 지정 로거는 BasicLogger 에서 하위 분류되므로 BasicLogger 의 로깅 방법도 사용할 수 있습니다. 비 국제화 메시지를 기록하기 위해 다른 로거를 생성할 필요는 없습니다.

   AccountsLogger.LOGGER.error("Invalid query syntax.");

   Copy to Clipboard Toggle word wrap
6. 이 프로젝트는 이제 지역화할 수 있는 하나 이상의 국제화된 로거를 지원합니다.

1. 아직 완료하지 않은 경우 JBoss EAP Maven 리포지토리를 사용하도록 Maven 설정을 구성합니다. 자세한 내용은 Configure the JBoss EAP Maven Repository using the Maven Settings 에서 참조하십시오.
2. JBoss Logging Tools를 사용하도록 프로젝트의 pom.xml 파일을 구성합니다. 자세한 내용은 JBoss Logging Tools Maven Configuration을 참조하십시오.

3. 예외에 대한 인터페이스를 만듭니다. JBoss Logging Tools는 인터페이스에서 국제화된 메시지를 정의합니다. 포함된 메시지에 대해 각 인터페이스를 설명적으로 지정합니다. 인터페이스에는 다음 요구 사항이 있습니다.

   • 공용 으로 선언해야 합니다.
   • @org.jboss.logging.annotations.MessageBundle 으로 주석을 달아야 합니다.

   • 인터페이스는 인터페이스와 동일한 유형의 메시지 번들인 필드를 정의해야 합니다.

     예제: MessageBundle 인터페이스 만들기

     @MessageBundle(projectCode="")
     public interface GreetingMessageBundle {
        GreetingMessageBundle MESSAGES = Messages.getBundle(GreetingMessageBundle.class);
     }

     Copy to Clipboard Toggle word wrap

     참고

     Messages.getBundle(GreetingMessagesBundle.class) 호출은 Messages.getBundle(GreetingMessagesBundle.class, Locale.getDefault()) 을 호출하는 것과 같습니다.

     locale .getDefault() 는 Java 가상 머신의 이 인스턴스에 대한 기본 로케일의 현재 값을 가져옵니다. Java Virtual Machine은 호스트 환경에 따라 시작 중에 기본 로케일을 설정합니다. 로케일이 명시적으로 지정되지 않은 경우 로케일이 중요한 여러 메서드에서 사용됩니다. setDefault 방법을 사용하여 변경할 수 있습니다.

     자세한 내용은 JBoss EAP 구성 가이드에서 서버의 기본 로케일 설정을 참조하십시오.

4. 각 메시지의 인터페이스에 메서드 정의를 추가합니다. 각 메서드가 나타내는 메시지에 대해 설명적으로 이름을 지정합니다. 각 방법에는 다음 요구 사항이 있습니다.

   • String 유형의 오브젝트를 반환해야 합니다.
   • @org.jboss.logging.annotations.Message 주석을 사용하여 주석을 달아야 합니다.

   • @org.jboss.logging.annotations.Message 의 value 특성은 기본 메시지로 설정해야 합니다. 이 메시지는 번역을 사용할 수 없는 경우 사용됩니다.

     @Message(value = "Hello world.")
     String helloworldString();

     Copy to Clipboard Toggle word wrap

5. 메시지를 가져와야 하는 애플리케이션에서 인터페이스 메서드를 호출합니다.

   System.out.println(helloworldString());

   Copy to Clipboard Toggle word wrap

1. JBoss Logging Tools를 사용하도록 프로젝트의 pom.xml 파일을 구성합니다. 자세한 내용은 JBoss Logging Tools Maven Configuration을 참조하십시오.

2. 예외에 대한 인터페이스를 만듭니다. JBoss Logging Tools는 인터페이스에서 국제화된 예외를 정의합니다. 정의하는 예외에 대해 각 인터페이스를 설명하여 이름을 지정합니다. 인터페이스에는 다음 요구 사항이 있습니다.

   • 공용 으로 선언해야 합니다.
   • @MessageBundle 으로 주석을 달아야 합니다.

   • 인터페이스는 인터페이스와 동일한 유형의 메시지 번들인 필드를 정의해야 합니다.

     예제: 예외Bundle 인터페이스 만들기

     @MessageBundle(projectCode="")
     public interface ExceptionBundle {
        ExceptionBundle EXCEPTIONS = Messages.getBundle(ExceptionBundle.class);
     }

     Copy to Clipboard Toggle word wrap

3. 각 예외에 대해 인터페이스에 메서드 정의를 추가합니다. 각 메서드가 나타내는 예외에 대해 설명적으로 이름을 지정합니다. 각 방법에는 다음 요구 사항이 있습니다.

   • Exception 오브젝트 또는 하위 유형인 Exception 을 반환해야 합니다.
   • @org.jboss.logging.annotations.Message 주석을 사용하여 주석을 달아야 합니다.
   • @org.jboss.logging.annotations.Message 의 value 특성은 기본 예외 메시지로 설정해야 합니다. 이 메시지는 번역을 사용할 수 없는 경우 사용됩니다.

   • 반환되는 예외에 메시지 문자열 외에도 매개 변수가 필요한 생성자가 있는 경우 @Param 주석을 사용하여 메서드 정의에 해당 매개 변수를 제공해야 합니다. 매개변수는 예외 생성자에 있는 것과 동일한 유형 및 순서여야 합니다.

     @Message(value = "The config file could not be opened.")
     IOException configFileAccessError();
     
     @Message(id = 13230, value = "Date string '%s' was invalid.")
     ParseException dateWasInvalid(String dateString, @Param int errorOffset);

     Copy to Clipboard Toggle word wrap

4. 예외 중 하나를 가져와야 하는 코드에서 인터페이스 메서드를 호출합니다. 메서드에서 예외를 발행하지 않고 예외 오브젝트를 반환하여 트리거할 수 있습니다.

   try {
      propsInFile=new File(configname);
      props.load(new FileInputStream(propsInFile));
   }
   catch(IOException ioex) {
     //in case props file does not exist
      throw ExceptionBundle.EXCEPTIONS.configFileAccessError();
   }

   Copy to Clipboard Toggle word wrap

번역 속성 파일 생성

1. Maven 컴파일러 플러그인 구성에 -AgenereatedTranslationFilePath 컴파일러 인수를 추가하여 Maven 구성을 추가하고 새 파일이 생성될 경로를 할당합니다.

   이 구성은 Maven 프로젝트의 target/generated-translation-files 디렉터리에 새 파일을 생성합니다.

   예제: 변환 파일 경로 정의

   <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-compiler-plugin</artifactId>
      <version>2.3.2</version>
      <configuration>
         <source>1.6</source>
         <target>1.6</target>
         <compilerArgument>
         -AgeneratedTranslationFilesPath=${project.basedir}/target/generated-translation-files
         </compilerArgument>
         <showDeprecation>true</showDeprecation>
      </configuration>
   </plugin>

   Copy to Clipboard Toggle word wrap

2. Maven을 사용하여 프로젝트를 빌드합니다.

   $ mvn compile

   Copy to Clipboard Toggle word wrap

   @MessageBundle 또는 @Message Logger 로 주석이 추가된 각 인터페이스에 대해 하나의 속성 파일이 생성됩니다.

   • 새 파일은 각 인터페이스가 선언되는 Java 패키지에 해당하는 하위 디렉터리에 생성됩니다.

   • 각 새 파일은 파일을 생성하는 데 사용되는 인터페이스의 이름인 다음 패턴을 사용하여 이름이 지정됩니다.

     INTERFACE_NAME.i18n_locale_COUNTRY_VARIANT.properties

     Copy to Clipboard Toggle word wrap

국제화된 로거, 예외 또는 메시지 변환

1. 다음 명령을 실행하여 템플릿 변환 속성 파일을 생성합니다.

   $ mvn compile

   Copy to Clipboard Toggle word wrap
2. 생성된 디렉터리에서 프로젝트의 src/main/resources 디렉터리로 변환하려는 인터페이스의 템플릿을 복사합니다. 속성 파일은 변환 중인 인터페이스와 동일한 패키지에 있어야 합니다.
3. 복사한 템플릿 파일의 이름을 변경하여 포함할 언어를 나타냅니다. 예를 들면 다음과 같습니다. GreeterLogger.i18n_fr_FR.properties.

4. 적절한 번역을 포함하도록 새로운 번역 속성 파일의 내용을 편집합니다.

   # Level: Logger.Level.INFO
   # Message: Hello message sent.
   logHelloMessageSent=Bonjour message envoyé.

   Copy to Clipboard Toggle word wrap
5. 템플릿을 복사하고 번들의 각 변환에 대해 수정하는 과정을 반복합니다.

사전 요구 사항

1. 국제화된 로그 메시지가 있는 프로젝트가 이미 있어야 합니다. 자세한 내용은 국제화된 로그 메시지 생성을 참조하십시오.
2. 사용할 프로젝트 코드를 알아야 합니다. 단일 프로젝트 코드를 사용하거나 각 인터페이스에 대해 다른 코드를 정의할 수 있습니다.

로그 메시지에 메시지 ID 및 프로젝트 코드 추가

1. 사용자 지정 로거 인터페이스에 연결된 @MessageLogger 주석의 projectCode 특성을 사용하여 인터페이스에 대한 프로젝트 코드를 지정합니다. 인터페이스에서 정의된 모든 메시지는 해당 프로젝트 코드를 사용합니다.

   @MessageLogger(projectCode="ACCNTS")
   interface AccountsLogger extends BasicLogger {
   
   }

   Copy to Clipboard Toggle word wrap

2. 메시지를 정의하는 메서드에 연결된 @Message 주석의 id 특성을 사용하여 각 메시지의 메시지 ID를 지정합니다.

   @LogMessage
   @Message(id=43, value = "Customer query failed, Database not available.")  void customerQueryFailDBClosed();

   Copy to Clipboard Toggle word wrap

3. 메시지 ID와 프로젝트 코드가 연결된 로그 메시지 앞에는 로그 메시지가 기록된 메시지 앞에 추가됩니다.

   10:55:50,638 INFO  [com.company.accounts.ejb] (MSC service thread 1-4) ACCNTS000043: Customer query failed, Database not available.

   Copy to Clipboard Toggle word wrap

1. 로그 메시지 메서드 정의의 @LogMessage 주석에 level 속성을 추가합니다.

2. level 특성을 사용하여 이 메시지의 로그 수준을 할당합니다. 수준에 유효한 값은 org.jboss.logging.Logger.Level에 정의된 6개의 열거된 상수입니다. DEBUG,ERROR,FATAL,INFO,TRACE, WARN.

   import org.jboss.logging.Logger.Level;
   
   @LogMessage(level=Level.ERROR)
   @Message(value = "Customer query failed, Database not available.")
   void customerQueryFailDBClosed();

   Copy to Clipboard Toggle word wrap

매개 변수를 사용하여 로그 메시지 사용자 지정

1. 모든 유형의 매개 변수를 메서드 정의에 추가합니다. 유형에 관계없이 매개 변수의 String 표시는 메시지에 표시됩니다.

2. 로그 메시지에 매개 변수 참조를 추가합니다. 참조는 명시적 또는 일반 인덱스를 사용할 수 있습니다.

   • 일반 인덱스를 사용하려면 각 매개 변수를 표시하려는 메시지 문자열에 %s 문자를 삽입합니다. %s 의 첫 번째 인스턴스는 첫 번째 매개 변수를 삽입하고, 두 번째 인스턴스는 두 번째 매개 변수를 삽입합니다.
   • 명시적 인덱스를 사용하려면 메시지에 %#$s 문자를 삽입합니다. 여기서 #은 표시하려는 매개 변수 수를 나타냅니다.

로그 메시지의 원인으로 예외를 지정합니다.

1. Throwable 또는 하위 클래스 유형의 매개 변수를 메서드에 추가합니다.

   @LogMessage
   @Message(id=404, value="Loading configuration failed. Config file:%s")
   void loadConfigFailed(Exception ex, File file);

   Copy to Clipboard Toggle word wrap

2. @ causes 주석을 매개 변수에 추가합니다.

   import org.jboss.logging.annotations.Cause
   
   @LogMessage
   @Message(value = "Loading configuration failed. Config file: %s")
   void loadConfigFailed(@Cause Exception ex, File file);

   Copy to Clipboard Toggle word wrap

3. 메서드를 호출합니다. 코드에서 메서드를 호출하면 올바른 유형의 오브젝트를 전달해야 하며 로그 메시지 뒤에 표시됩니다.

   try
   {
      confFile=new File(filename);
      props.load(new FileInputStream(confFile));
   }
   catch(Exception ex) //in case properties file cannot be read
   {
        ConfigLogger.LOGGER.loadConfigFailed(ex, filename);
   }

   Copy to Clipboard Toggle word wrap

사전 요구 사항

1. 국제화된 예외가 있는 프로젝트가 이미 있어야 합니다. 자세한 내용은 Create Internationalized Exceptions를 참조하십시오.
2. 사용할 프로젝트 코드를 알아야 합니다. 단일 프로젝트 코드를 사용하거나 각 인터페이스에 대해 다른 코드를 정의할 수 있습니다.

예외 메시지에 메시지 ID 및 프로젝트 코드 추가

1. 예외 번들 인터페이스에 연결된 @MessageBundle 주석의 projectCode 특성을 사용하여 프로젝트 코드를 지정합니다. 인터페이스에서 정의된 모든 메시지는 해당 프로젝트 코드를 사용합니다.

   @MessageBundle(projectCode="ACCTS")
   interface ExceptionBundle
   {
      ExceptionBundle EXCEPTIONS = Messages.getBundle(ExceptionBundle.class);
   }

   Copy to Clipboard Toggle word wrap

2. 예외를 정의하는 메서드에 연결된 @Message 주석의 id 특성을 사용하여 각 예외에 대해 메시지 ID를 지정합니다.

   @Message(id=143, value = "The config file could not be opened.")
   IOException configFileAccessError();

   Copy to Clipboard Toggle word wrap

매개 변수를 사용하여 예외 메시지 사용자 정의

1. 모든 유형의 매개 변수를 메서드 정의에 추가합니다. 유형에 관계없이 매개 변수의 String 표시는 메시지에 표시됩니다.

2. 매개 변수 참조를 예외 메시지에 추가합니다. 참조는 명시적 또는 일반 인덱스를 사용할 수 있습니다.

   • 일반 인덱스를 사용하려면 각 매개 변수를 표시하려는 메시지 문자열에 %s 문자를 삽입합니다. %s 의 첫 번째 인스턴스는 첫 번째 매개 변수를 삽입하고, 두 번째 인스턴스는 두 번째 매개 변수를 삽입합니다.
   • 명시적 인덱스를 사용하려면 메시지에 %#$s 문자를 삽입합니다. 여기서 #은 표시하려는 매개 변수 수를 나타냅니다.

1. Throwable 또는 하위 클래스 유형의 매개 변수를 메서드에 추가합니다.

   @Message(id=328, value = "Error calculating: %s.")
   ArithmeticException calculationError(Throwable cause, String msg);

   Copy to Clipboard Toggle word wrap

2. @ causes 주석을 매개 변수에 추가합니다.

   import org.jboss.logging.annotations.Cause
   
   @Message(id=328, value = "Error calculating: %s.")
   ArithmeticException calculationError(@Cause Throwable cause, String msg);

   Copy to Clipboard Toggle word wrap

3. interface 메서드를 호출하여 예외 오브젝트를 가져옵니다. 가장 일반적인 사용 사례는 캡처된 예외를 원인으로 지정하여 캐치 블록에서 새로운 예외를 생성하는 것입니다.

   try
   {
      ...
   }
   catch(Exception ex)
   {
      throw ExceptionBundle.EXCEPTIONS.calculationError(
                                       ex, "calculating payment due per day");
   }

   Copy to Clipboard Toggle word wrap

1. 아직 완료하지 않은 경우 JBoss EAP 리포지토리를 사용하도록 Maven 설정을 구성합니다. 자세한 내용은 Configure the JBoss EAP Maven Repository using the Maven Settings 에서 참조하십시오.

   프로젝트의 pom.xml 파일의 <dependencyManagement> 섹션에 jboss-eap-jakartaee8 BOM을 포함합니다.

   <dependencyManagement>
     <dependencies>
       <!-- JBoss distributes a complete set of Jakarta EE APIs including
         a Bill of Materials (BOM). A BOM specifies the versions of a "stack" (or
         a collection) of artifacts. We use this here so that we always get the correct versions of artifacts.
         Here we use the jboss-javaee-7.0 stack (you can
         read this as the JBoss stack of the Jakarta EE APIs). You can actually
         use this stack with any version of JBoss EAP that implements Jakarta EE. -->
       <dependency>
         <groupId>org.jboss.bom</groupId>
          <artifactId>jboss-eap-jakartaee8</artifactId>
          <version>7.4.0.GA</version>
          <type>pom</type>
          <scope>import</scope>
       </dependency>
     <dependencies>
   <dependencyManagement>

   Copy to Clipboard Toggle word wrap

2. 프로젝트의 pom.xml 파일에 Maven 종속성을 추가합니다.

   1. JBoss Logging 프레임워크에 액세스하려면 jboss-logging 종속성을 추가합니다.

   2. JBoss Logging Tools를 사용하려는 경우 jboss-logging-processor 종속성도 추가합니다.

      이러한 종속성은 이전 단계에서 추가한 JBoss EAP BOM에서 사용 가능하므로 각각의 범위 요소를 표시된 대로 provided 로 설정할 수 있습니다.

      <!-- Add the JBoss Logging Tools dependencies -->
      <!-- The jboss-logging API -->
      <dependency>
         <groupId>org.jboss.logging</groupId>
         <artifactId>jboss-logging</artifactId>
         <scope>provided</scope>
      </dependency>
      <!-- Add the jboss-logging-tools processor if you are using JBoss Tools  -->
      <dependency>
         <groupId>org.jboss.logging</groupId>
         <artifactId>jboss-logging-processor</artifactId>
         <scope>provided</scope>
      </dependency>

      Copy to Clipboard Toggle word wrap

3. maven-compiler-plugin은 버전 3.1 이상이어야 하며 1.8 의 대상 및 생성된 소스에 맞게 구성해야 합니다.

   <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-compiler-plugin</artifactId>
      <version>3.1</version>
      <configuration>
         <source>1.8</source>
         <target>1.8</target>
      </configuration>
   </plugin>

   Copy to Clipboard Toggle word wrap