때로는 varags 메소드라고도 불리는 가변 arity 메소드는 임의의 인자(argument) 세트를 받는다. JDK 5.0 이전에는 임의의 인자 세트를 메소드에 패스하려면 오브젝트의 array를 패스해야 했다. 게다가, MessageFormat 클래스의 format 또는 JDK 5.0에 새로 도입된 PrintStream의 printf method와 같은 메소드가 포함된 가변 인자 리스트를 이용하여 존재하는 각 포매팅 스트링에 대해 인자를 추가할 수 없었다. 가변 인자 리스트를 이용하는 이전의 방식은 2002년 2월 4일자 팁 Using Variable Argument Lists(영문)에 설명되어 있다.

JDK 5.0은 훨씬 더 유연한 varags 기능을 추가한다. 그러면, varags 기능에 대해 알아보기 위해 PrintStream 클래스 내 printf 메소드의 JDK 5.0 버전을 살펴보기로 하자.

   public PrintStream printf(String format,
                             Object... args)

이 메소드는 2004년 10월의 테크 팁 Formatting Output With the New Formatter(영문) 에 설명되어 있다.

본질적으로 첫 번째 인자는 후속 인자를 place holders에 기입한 스트링이고, 두 번째 인자에 있는 세 개의 점은 마지막 인자가 인자의 array 또는 sequence로 패스될 수 있음을 나타낸다. 세 개의 점은 C 및 C++ 프로그램에서 가변 인자가 지정되는 방식과 유사하다는 점에 유의하도록 한다.

포매팅 스트링 내의 place holders의 수는 얼마나 많은 인자가 필요한지를 결정하는데, 예를 들어 포매팅 스트링 "Hello, %1s\nToday is %2$tB %2$te, %2$tY"의 경우에는 타입 스트링의 첫 번째 인자와 타입 날짜의 두 번째 인자 등 2개의 인자를 제공한다. 다음은 이에 대한 예제이다.

   import java.util.*;

   public class Today {
     public static void main(String args[]) {
       System.out.printf(
         "Hello, %1s%nToday is %2$tB %2$te, %2$tY%n",
         args[0], new Date());
     }
   }

이름에 대한 인자를 패스할 경우, 결과는 다음과 같을 것이다.

   > java Today Ed
   Hello, Ed
   Today is October 18, 2005

autoboxing과 unboxing은 (아래의 printf 메소드와 같이) 기본 타입(primitive type) 인자를 제공할 수 있게 해준다.

   System.out.printf("Pi is approximately  %f", Math.PI, %n);

여기서 Math.PI는 double 타입이고, autoboxing은 이를 Double 타입의 오브젝트로 전환한다. (autoboxing에 관한 자세한 내용을 보려면 2005년 5월 31일자 팁 Autoboxing 소개 내용을 참조할 것.)

가변 인자 리스트를 받기 위해 자체 메소드를 생성할 경우, 메소드의 마지막 인자만이 가변 리스트를 받는 것으로 선언될 수 있다. 가변 길이 인자를 먼저 put할 수는 없다. 예를 들어, 다음 메소드 선언은 유효하며, 가변 수의 String 인자를 받는 하나의 매개변수를 가지는 메소드를 정의한다.

  private static void method1(String... args)

가변 인자 매개변수가 유일한 인자일 필요는 없다. 예를 들어, 다음 메소드는 임의의 수의 인자가 따르는 하나의 정수 인자를 취한다.

  private static void method2(int arg, Object... args) {

위에 표시한 2개의 포맷을 가지는 메소드를 예제 클래스에 put하면 다양한 수의 인자를 가지는 메소드를 호출할 수 있다.

      method1("Hello", "World");
      method1(args);
      method2(12, 'a', "Hello", Math.PI, 1/3.0);
      method2(18, 94.0);      

위에서 두번째 호출은 다른 것들과는 약간 다르게 main() 메소드로 들어오는 SString[] 인자를 취하게 된다. varags 퍼실리티는 array를 생성/패스하기 위한 절대 구문(implicit syntax)에 불과하기 때문에, array를 직접 패스할 수 있다. 이 경우, 컴파일러는 array를 수정하지 않은 채 그대로 패스하게 된다.

다음은 두 종류의 메소드를 포함하고 있는 예제 클래스 MyArgs이다.

    import java.util.*;
    public class MyArgs {
      public static void main(String args[]) {
        method1("Hello", "World");
        method1(args);
        method2(12, 'a', "Hello", Math.PI, 1/3.0);
        method2(18, 94.0);
      }
      private static void method1(String... args) {
        System.out.println(Arrays.asList(args) +
          " // " + args.length);
      }
      private static void method2(int arg, Object... args) {
        System.out.println(Arrays.asList(args) + " / " + arg);
      }
    }

다음은 MyArgs의 실행 예제이다.

    > java MyArgs x y z
   [Hello, World] // 2
   [x, y, z] // 3
   [a, Hello, 3.141592653589793, 0.3333333333333333] / 12
   [94.0] / 18

MyArgs는 Arrays.asList() 메소드에 패스함으로써 가변 인자에 액세스한다. 다시 말해서, 인자는 마치 array처럼 액세스되는데, 일반적으로 enhanced for loop에서는 아래와 유사한 형태로 진행될 것이다.

  for (String arg: args) {
    ...
  }

이로써 한번에 하나의 엘리먼트를 처리할 수 있게 된다.

보다시피 varargs 기능은 별다른 프로그래밍 없이 가변 수의 인자를 받는 메소드를 정의할 수 있게 해준다. varargs에 관한 자세한 내용은 Varargs(영문)를 참조하기 바란다.

2005년 8월 17일자 테크 팁 J2SE 5.0 그 이후와 Mustang에 기여하기에서 우리는 Java SE 6을 시작하는 방법을 배운 바 있다. 플랫폼은 아직 프리 베타 버전이지만 미리 방향을 살펴보고 몇 가지 기능을 시험해 보기에는 충분하며, 새로운 기능은 리소스 번들의 사용을 보다 효과적으로 제어할 수 있게 해준다.

리소스 번들은 애플리케이션의 로컬라이제이션에 사용된다. 그 사용법은 2005년 1월 19일자 테크팁 리소스 번들 로딩에 소개되어 있다. 기본적으로, 리소스 번들은 리소스를 로컬라이즈하기 위한 다양한 스트링을 매핑하여 텍스트 스트링이나 아이콘이 다양한 언어로 해석되는 이미지와 트랜잭션을 표시할 수 있도록 해준다.

리소스 번들의 사용은 java.util package 패키지에 있는 ResourceBundle 클래스에 의해 관리되며, 리소스 번들로 작업할 경우의 기본 프로세스는 다음 프로그램에서 보는 것처럼 ResourceBundle의 getBundle() 메소드를 통해 번들을 얻는 것이다.

   import java.util.*;

   public class Test1 {
     public static void main(String args[]) {
       Locale locale = Locale.ENGLISH;
       ResourceBundle myResources =
         ResourceBundle.getBundle("MyResources", locale);
       String string = myResources.getString("HelpKey");
       System.out.println("HelpKey: " + string);
     }
   }

Test1 프로그램은 MyResources라 불리는 번들을 얻는다. 그런 다음, 번들로부터 HelpKey라는 이름의 리소스를 얻어서 리소스의 값을 프린트한다.

MyResources는 다음의 클래스 파일일 수도 있고,

   import java.util.*;
   
      public class MyResources extends ListResourceBundle {
        public Object[][] getContents() {
          return new Object[][] {
            {"OkKey", "OK"},
            {"CancelKey", "Cancel"},
            {"HelpKey", "Help"},
            {"YesKey", "Yes"},
            {"NoKey", "No"},
          };
        }
   } 

또는 다음과 같은 키 값의 쌍을 가지는 MyResources.properties라는 이름의 파일일 수도 있다.

   OkKey=OK
   CancelKey=Cancel
   HelpKey=Help
   YesKey=Yes
   NoKey=No

그러나, 리소스 번들을 XML 파일로 만들려면 어떻게 해야 할까? 우선, java.util.Properties 클래스는 파일을 로드하는 두 가지 방법을 제공한다. 첫 번째 방법은 load() 메소드를 통해 key=value 타입 파일을 읽어 들이는 것이고, 두 번째 방법은 loadFromXML() 메소드를 통해 XML 파일의 속성을 로드하는 것이다. Control이라는 이름의 Mustang 내의 ResourceBundle의 새로운 이너 클래스(inner class) 덕분에 리소스 번들을 XML 파일로 저장할 수 있다.

이 시점에서 사용자는 Mustang project home page(영문)에서 제공하는 최신의 Mustang 스냅샷 릴리즈를 설치하고 싶을 수도 있겠다.

ResourceBundle.Control 클래스는 ResourceBundle.getBundle()이 번들을 검색하고 로드할 때 호출되는 일련의 callback 메소드를 제공한다. 여러분은 자체 Control 클래스를 제공함으로써 기본값 로딩 및 캐싱 동작을 오버라이드할 수 있다.

그러한 커스텀 Control 클래스를 구현하기 위해서는 getFormats()와 newBundle() 메소드를 오버라이드하기만 하면 된다. getFormats() 메소드는 여러분이 XML을 포맷으로 지원한다는 사실을 알려줄 것이고, 그러면 newBundle()은 해당 번들을 찾게 된다. 기본 Control 클래스 내에는 기본 번들 이름을 실제 리소스 이름으로 전환하기 위한 보조 메소드가 있다.

커스텀 ResourceBundle.Control 구현과 함께 XMLResourceBundle이라 불리는 ResourceBundle의 서브클래스가 포함되어 있다. 이 서브클래스는 XML 파일을 로드하고 이를 ResourceBundle로 처리하는 데 사용된다.

다음은 Control 클래스와 ResourceBundle에 대한 전체 클래스 정의식이다.

   import java.io.*;
   import java.net.*;
   import java.util.*;

   public class XMLResourceBundleControl extends 
      ResourceBundle.Control {
     private static String XML = "xml";

     public List getFormats(String baseName) {
         return Collections.singletonList(XML);
     }

     public ResourceBundle newBundle(String baseName, 
         Locale locale, String format, ClassLoader loader, 
         boolean reload)
             throws IllegalAccessException, 
                 InstantiationException, IOException {
       if ((baseName == null) || (locale == null) ||
           (format == null) || (loader == null)) {
         throw new NullPointerException();
       }
       ResourceBundle bundle = null;
       if (format.equals(XML)) {
         String bundleName = toBundleName(baseName, locale);
         String resourceName = 
            toResourceName(bundleName, format);
         URL url = loader.getResource(resourceName);
         if (url != null) {
           URLConnection connection = url.openConnection();
           if (connection != null) {
             if (reload) {
               connection.setUseCaches(false);
             }
             InputStream stream = connection.getInputStream();
             if (stream != null) {
               BufferedInputStream bis = 
                  new BufferedInputStream(stream);
               bundle = new XMLResourceBundle(bis);
               bis.close();
             }
           }
         }
       }
       return bundle;
     }
     private static class XMLResourceBundle extends 
        ResourceBundle {
       private Properties props;

        XMLResourceBundle(InputStream stream) throws IOException {
         props = new Properties();
         props.loadFromXML(stream);
       }
       protected Object handleGetObject(String key) {
         return props.getProperty(key);
       }
       public Enumeration getKeys() {
         Set handleKeys = props.stringPropertyNames();
         return Collections.enumeration(handleKeys);
       }
     }

     public static void main(String args[]) {
       ResourceBundle bundle = ResourceBundle.getBundle("Test2",
         new XMLResourceBundleControl());
        String string = bundle.getString("HelpKey");
       System.out.println("HelpKey: " + string);
    }
  }

커스텀 Control 클래스에는 3행의 테스트 프로그램이 포함되어 있다.

      ResourceBundle bundle = ResourceBundle.getBundle("Test2",
        new XMLResourceBundleControl());
       String string = bundle.getString("HelpKey");
       System.out.println("HelpKey: " + string);

여기서 중요한 행이 바로 첫 번째 행인데, 반드시 커스텀 control을 getBundle() 메소드에 패스해야 한다. 그런 다음, 다른 번들과 동일한 방식으로 번들을 사용하면 된다.

다음은 Test2.xml이라는 이름의 XML 리소스 번들 파일의 형태이다.

<?xml version="1.0" encoding="UTF-8"?>
   <!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
   <properties>
     <entry key="OkKey">OK</entry>
     <entry key="CancelKey">Cancel</entry>
     <entry key="HelpKey">Help</entry>
     <entry key="YesKey">Yes</entry>
     <entry key="NoKey">No</entry>
   </properties>
   

XMLResourceBundleControl 프로그램을 실행하면 다음과 같은 결과물이 산출된다.

   > java XMLResourceBundleControl

     HelpKey: Help

getTimeToLive() 및 needsReload() 메소드는 상기 ResourceBundle.Control의 구현에 표시되어 있지 않다.

    public long getTimeToLive(String baseName,
                              Locale locale)

    public boolean needsReload(String baseName,
                               Locale locale,
                               String format,
                               ClassLoader loader,
                               ResourceBundle bundle,
                               long loadTime)

getTimeToLive() 메소드는 ResourceBundle.Control 아래에 로드된 리소스 번들에 대해 ‘time-to-live’ 값을 반환하고, 리소스 번들은 다음에 사용할 때 성능을 높이기 위해 캐시에 보관된다. 이는 동일 클래스 로더에서 번들을 로드하기 위한 두 번째 호출이 이미 로드되고 캐시된 번들을 발견하게 된다는 것을 의미한다. 양의 time-to-live 값은 번들이 재검증(revalidate) 없이 캐시에 머무를 수 있는 밀리초의 수를 지정한다. getTimeToLive()의 기본 반환 값은 TTL_NO_EXPIRATION_CONTROL으로, 이는 expiration control을 디스에이블 한다. 번들이 캐시되는 것을 원치 않을 경우에는 getTimeToLive()가 ResourceBundle.Control.TTL_DONT_CACHE를 반환하도록 한다. 0이 반환될 경우 번들은 캐시되지만 getBundle()이 호출될 때마다 번들이 마지막 호출로부터 재검증된다. 캐시를 소거하려면 ResourceBundle의 정적(static) clearCache() 메소드를 호출한다. 특정 클래스 로더를 통해 로드된 번들을 소거하려면 옵션 ClassLoader 인자를 사용하고, 지정되지 않은 경우에는 호출자의 클래스 로더를 사용하면 된다.

needsReload() 메소드는 캐시 내의 만료된 번들을 재로드할 필요가 있는지 여부를 결정한다. true의 반환 값은 번들을 재로드할 필요가 있음을, false는 필요가 없음을 의미한다. 또한, Control 클래스가 needsReload() 메소드를 오버라이드하도록 하여 리소스 번들을 재로드할 필요가 있는지 여부를 제어할 수 있다. 예를 들어, 번들을 항상 재로드하기를 원한다면 needsReload() 메소드가 항상 true를 반환하도록 한다. needsReload()가 항상 true를 반환할 경우에는 반드시 getTimeToLive() 메소드가 0을 반환하도록 해야 한다. 그렇지 않을 경우 데이터가 필요 이상으로 오랫동안 캐시되는 현상이 발생하게 된다.

리소스 번들에서 강화된 기능과 Mustang 내의 기타 국제화(internationalization) 기능에 관한 자세한 내용은 썬 소프트웨어 아키텍트 John O’Conner의 블로그 Overview of Mustang's internationalization features(영문)를 참조하기 바란다.

지난 달 테크팁 CookieHandler를 이용한 Cookie 관리에 Cookie 클래스에 만료일 포맷을 정의하는 두 행의 소스 코드가 있었다는 것을 기억할 것이다.

     private static DateFormat expiresFormat1
         = new SimpleDateFormat("E, dd MMM yyyy k:m:s 'GMT'");

     private static DateFormat expiresFormat2
        = new SimpleDateFormat("E, dd-MMM-yyyy k:m:s 'GMT'");

이전 테크팁에서 설명한 Fetch 프로그램을 US English 이외의 locale에서 실행할 경우 프로그램은 작동하지 않게 된다. 프로그램이 US English 이외의 locale에서 제대로 실행되려면 Cookie 클래스에서 locale을 다음과 같이 정확하게 설정해야 한다.

     private static DateFormat expiresFormat1
         = new SimpleDateFormat
            ("E, dd MMM yyyy k:m:s 'GMT'", Locale.US);

     private static DateFormat expiresFormat2
        = new SimpleDateFormat
           ("E, dd-MMM-yyyy k:m:s 'GMT'", Local.US);

이전 테크팁의 아카이브 버전은 이 변경 사항을 반영하여 업데이트되었다.