APON을 소개합니다.

APON의 특징

Aspectran은 XML 문서를 APON 문서로 변환해서 사용하는 기능을 내장하고 있습니다. APON을 이용하면 대량의 XML 문서를 파싱하는데 드는 비용을 줄일 수 있으며, 정확한 데이터를 주고 받을 수 있습니다.

APON은 다음과 같은 특징을 가지고 있습니다.

매개변수가 가지고 있는 값(Value)의 Type을 명시할 수 있습니다. Value Type을 명시하지 않으면 variable Type이 기본 Type이 됩니다.
여러 개의 Name/Value 쌍 또는 배열로 된 여러 값을 구분하기 위해 , (comma) 문자를 사용하지 않고 \n (개행 문자)를 사용합니다.
문자열 표기를 위한 string Value Type 외에 text Value Type이 추가되었습니다. 긴 문자열을 표기할 때 text Value Type은 가독성을 확연히 향상시켜 줍니다.
문자열을 큰따옴표(") 또는 작은따옴표(')로 감싸지 않아도 됩니다.
데이터의 구조와 값의 Type을 정의할 수 있기 때문에 정확하고 명확한 데이터 전달이 가능합니다.

APON의 데이터 표기 규칙

매개변수의 이름과 값에 해당하는 Name/Value 쌍을 Parameter라고 합니다. Name 뒤에 콜론(:) 문자를 붙여서 Name과 Value를 구분합니다.
Parameter를 여러 개 모아 놓은 것을 Parameters라고 합니다.
Parameter는 Name을 부여받고, Value를 가질 수 있습니다. Value의 Type에는 string, text, int, long, float, double, boolean, variable, parameters가 있습니다. Value는 null 값도 가질 수 있습니다.
Value의 Type을 명시하기 위해서는 Name과 콜론(:) 문자 사이에 Value Type을 ( )(Round Bracket)으로 감싸서 넣으면 됩니다.
ex) param1(long): 1234
Value Type은 소문자로 표기해야 합니다.
Parameter의 Value Type이 parameters이면 { }(Curly Bracket)으로 감싸서 표기합니다. Curly Bracket 내에서 각 Parameter를 구분하기 위해 콤마(,) 문자가 아닌 개행문자(\n)를 사용합니다.
Parameter의 값이 Array 형식이면 [ ](Square Bracket)으로 감싸서 표기합니다. Square Bracket 내에서 각 Array 요소를 구분하기 위해 콤마(,) 문자가 아닌 개행문자(\n)를 사용합니다.
Parameter의 Value Type이 string이면 문자열을 큰따옴표(")로 감싸거나, 큰따옴표를 생략할 수도 있습니다. 큰따옴표로 감싸지 않으면 문자열의 앞뒤에 있는 공백문자는 모두 제거됩니다. 큰따옴표로 감쌀 경우 큰 따옴표 또는 개행문자를 표현하기 위해 Escape 문자(\)를 사용할 수 있습니다.
Parameter의 Value Type이 text이면 ( )(Round Bracket)으로 감싸야 하고, 각 라인의 선두에 파이프 문자(|)를 붙여야 합니다. 라인 수 만큼 파이프 문자(|)를 사용하게 되며, 특수 문자를 표현하기 위한 Escape 문자를 전혀 사용하지 않습니다.
Curly Bracket, Square Bracket, Round Bracket은 모두 Bracket이 시작된 후에 반드시 개행을 해야 하고, Brakcket이 끝난 뒤에도 반드시 개행을 해야 합니다.

APON의 Value Type

APON의 매개변수(Parameter)는 다음과 같은 Value Type을 가질 수 있습니다.

Value Type	Java Object Type	사용할 수 있는 값
string	java.lang.String	Hello, World.
text	java.lang.String	아래 `text` Value Type 사용 예제 참조
int	java.lang.Integer	123
long	java.lang.Long	123L
float	java.lang.Float	123.0f
double	java.lang.Double	123.0d
boolean	java.lang.Boolean	true or false
variable	java.lang.Object	실제 값에 따라 자동으로 Type을 정합니다.
parameters	com.aspectran.core.util.apon.Parameters	여러 `Parameter`를 가집니다.

`text` Value Type 사용 예제

desc: (  
    | 여러 라인으로 구성된 문자열은
    | 괄호로 감싸고 수직문자를 각 라인 앞에 붙입니다.
    | 세 번째 줄입니다.
    | 수직문자가 시작되면 특수문자 사용이 자유로워집니다.
)

APON 활용 사례

Aspectran 초기화 설정

다음은 Aspectran 데모 애플리케이션(demo-app)을 위한 초기화 설정 파일(aspectran-config.apon)의 내용입니다.

APON 형식으로 작성된 초기화 설정 값은 AspectranConfig 객체로 변환될 수 있습니다.

context: {
    root: /config/app-config.xml
    resources: [
        /config
    ]
    scan: [
        app.demo
    ]
    profiles: {
        default: [
            h2
        ]
    }
    autoReload: {
        reloadMode: hard
        scanIntervalSeconds: 5
        enabled: false
    }
    singleton: true
}
scheduler: {
    startDelaySeconds: 3
    waitOnShutdown: true
    enabled: false
}
shell: {
    greetings: (
        |
        |     ___                         __
        |    /   |  ___  ____  ___  ___  / /____   ___  ____
        |   / /| | / __|/ __ |/ _ |/ __|/ __/ __|/ __ |/ __ |
        |  / ___ |(__  ) /_/ /  __/ /  / / / /  / /_/ / / / /
        | /_/  |_|____/ .___/|___/|___/|__/_/   |__(_(_/ /_/   Shell
        |=========== /_/ =============================================
        |
        |Welcome To Aspectran Shell #{class:com.aspectran.core.util.Aspectran^version}
        |
        |If you want a list of all supported built-in commands, type 'help'.
        |To get help on a specific command, type 'command_name -h'.
        |If you want a list of all available translets, type 'translet -l'.
        |To run a translet, type 'translet <translet_name>' or 'translet_name'.
    )
    prompt: "demo-app> "
    commands: [
        com.aspectran.shell.command.builtins.UndertowCommand
        com.aspectran.shell.command.builtins.JettyCommand
        com.aspectran.shell.command.builtins.TransletCommand
        com.aspectran.shell.command.builtins.AspectCommand
        com.aspectran.shell.command.builtins.JobCommand
        com.aspectran.shell.command.builtins.PBEncryptCommand
        com.aspectran.shell.command.builtins.PBDecryptCommand
        com.aspectran.shell.command.builtins.SysInfoCommand
        com.aspectran.shell.command.builtins.EchoCommand
        com.aspectran.shell.command.builtins.HistoryCommand
        com.aspectran.shell.command.builtins.ClearCommand
        com.aspectran.shell.command.builtins.VerboseCommand
        com.aspectran.shell.command.builtins.HelpCommand
        com.aspectran.shell.command.builtins.RestartCommand
        com.aspectran.shell.command.builtins.QuitCommand
    ]
    session: {
        enabled: true
    }
    workingDir: /work
    verbose: true
    exposals: {
        -: /**
    }
}
daemon: {
    poller: {
        pollingInterval: 5000
        maxThreads: 5
        requeuable: false
        incoming: /commands/incoming
    }
    commands: [
        com.aspectran.daemon.command.builtins.JettyCommand
        com.aspectran.daemon.command.builtins.InvokeActionCommand
        com.aspectran.daemon.command.builtins.TransletCommand
        com.aspectran.daemon.command.builtins.ComponentCommand
        com.aspectran.daemon.command.builtins.PollingIntervalCommand
        com.aspectran.daemon.command.builtins.RestartCommand
        com.aspectran.daemon.command.builtins.QuitCommand
    ]
    session: {
        enabled: true
    }
    exposals: {
        -: /**
    }
}
web: {
    uriDecoding: utf-8
    defaultServletName: default
    exposals: {
        +: /**
    }
}

Parameters 객체 생성

Parameters 객체는 여러 파라메터를 포함하며, 각 파라메터의 속성을 정의하는 역할을 합니다. 위의 APON 형식의 텍스트를 Object로 변환하기 위해 4개의 Parameters 클래스를 작성했습니다.

아래 4개의 Parameters 클래스는 com.aspectran.core.util.apon.Parameters 인터페이스의 구현체입니다.

AspectranConfig.java

루트 Parameters로써 context, scheduler Parameter를 가지고 있습니다.

package com.aspectran.core.context.loader.config;

import com.aspectran.core.util.apon.AbstractParameters;
import com.aspectran.core.util.apon.ParameterDefinition;
import com.aspectran.core.util.apon.Parameters;

public class AspectranConfig extends AbstractParameters implements Parameters {

  public static final ParameterDefinition context;
  public static final ParameterDefinition scheduler;

  private static final ParameterDefinition[] parameterDefinitions;

  static {
    context = new ParameterDefinition("context", AspectranContextConfig.class);
    scheduler = new ParameterDefinition("scheduler", AspectranSchedulerConfig.class);

    parameterDefinitions = new ParameterDefinition[] {
        context,
        scheduler
    };
  }

  public AspectranConfig() {
    super(parameterDefinitions);
  }

  public AspectranConfig(String text) {
    super(parameterDefinitions, text);
  }

}

AspectranContextConfig.java

context Parameters의 멤버 Parameter로는 root, encoding, resources, hybridLoad, autoReload가 있습니다.

package com.aspectran.core.context.loader.config;

import com.aspectran.core.util.apon.AbstractParameters;
import com.aspectran.core.util.apon.ParameterDefinition;
import com.aspectran.core.util.apon.ParameterValueType;
import com.aspectran.core.util.apon.Parameters;

public class AspectranContextConfig extends AbstractParameters implements Parameters {

  public static final ParameterDefinition root;
  public static final ParameterDefinition encoding;
  public static final ParameterDefinition resources;
  public static final ParameterDefinition hybridLoad;
  public static final ParameterDefinition autoReload;

  private final static ParameterDefinition[] parameterDefinitions;

  static {
    root = new ParameterDefinition("root", ParameterValueType.STRING);
    encoding = new ParameterDefinition("encoding", ParameterValueType.STRING);
    resources = new ParameterDefinition("resources", ParameterValueType.STRING, true);
    hybridLoad = new ParameterDefinition("hybridLoad", ParameterValueType.BOOLEAN);
    autoReload = new ParameterDefinition("autoReload", AspectranContextAutoReloadConfig.class);

    parameterDefinitions = new ParameterDefinition[] {
        root,
        encoding,
        resources,
        hybridLoad,
        autoReload
    };
  }

  public AspectranContextConfig() {
    super(parameterDefinitions);
  }

  public AspectranContextConfig(String text) {
    super(parameterDefinitions, text);
  }

}

AspectranContextAutoReloadConfig.java

autoReload Parameters의 멤버 Parameter로는 reloadMethod, observationInterval, startup이 있습니다.

package com.aspectran.core.context.loader.config;

import com.aspectran.core.util.apon.AbstractParameters;
import com.aspectran.core.util.apon.ParameterDefinition;
import com.aspectran.core.util.apon.ParameterValueType;
import com.aspectran.core.util.apon.Parameters;

public class AspectranContextAutoReloadConfig extends AbstractParameters implements Parameters {

  public static final ParameterDefinition reloadMethod;
  public static final ParameterDefinition observationInterval;
  public static final ParameterDefinition startup;

  private final static ParameterDefinition[] parameterValues;

  static {
    reloadMethod = new ParameterDefinition("reloadMethod", ParameterValueType.STRING);
    observationInterval = new ParameterDefinition("observationInterval", ParameterValueType.INT);
    startup = new ParameterDefinition("startup", ParameterValueType.BOOLEAN);

    parameterValues = new ParameterDefinition[] {
        reloadMethod,
        observationInterval,
        startup
    };
  }

  public AspectranContextAutoReloadConfig() {
    super(parameterValues);
  }

  public AspectranContextAutoReloadConfig(String text) {
    super(parameterValues, text);
  }

}

AspectranSchedulerConfig.java

scheduler Parameters의 멤버 Parameter로는 startDelaySeconds, waitOnShutdown, startup이 있습니다.

package com.aspectran.core.context.loader.config;

import com.aspectran.core.util.apon.AbstractParameters;
import com.aspectran.core.util.apon.ParameterDefinition;
import com.aspectran.core.util.apon.ParameterValueType;
import com.aspectran.core.util.apon.Parameters;

public class AspectranSchedulerConfig extends AbstractParameters implements Parameters {

  public static final ParameterDefinition startDelaySeconds;
  public static final ParameterDefinition waitOnShutdown;
  public static final ParameterDefinition startup;

  private final static ParameterDefinition[] parameterDefinitions;

  static {
    startDelaySeconds = new ParameterDefinition("startDelaySeconds", ParameterValueType.INT);
    waitOnShutdown = new ParameterDefinition("waitOnShutdown", ParameterValueType.BOOLEAN);
    startup = new ParameterDefinition("startup", ParameterValueType.BOOLEAN);

    parameterDefinitions = new ParameterDefinition[] {
        startDelaySeconds,
        waitOnShutdown,
        startup
    };
  }

  public AspectranSchedulerConfig() {
    super(parameterDefinitions);
  }

  public AspectranSchedulerConfig(String plaintext) {
    super(parameterDefinitions, plaintext);
  }

}

AponWriter 사용 예제

AponWriter 클래스를 사용하면 Parameters Object를 APON 형식의 텍스트 문서로 쉽게 변환할 수 있습니다. APON 형식의 텍스트 문서를 Parameters Object로 변환하고, 다시 Parameters Object를 APON 형식의 문자열로 변환해서 콘솔에 출력하는 예제입니다.

package com.aspectran.core.util.apon;

import java.io.File;
import java.io.FileReader;
import java.io.Reader;
import java.io.StringWriter;
import java.io.Writer;

import com.aspectran.core.context.loader.config.AspectranConfig;

public class AponWriterTest {

  public static void main(String argv[]) {
    try {
      Reader reader = new FileReader(new File(argv[0]));

      Parameters aspectranConfig = new AspectranConfig();

      AponReader aponReader = new AponReader(reader);
      aponReader.read(aspectranConfig);
      aponReader.close();

      System.out.println(aspectranConfig);

      Writer writer = new StringWriter();

      AponWriter aponWriter = new AponWriter(writer);
      aponWriter.write(aspectranConfig);
      aponWriter.close();

      System.out.println(writer.toString());

    } catch(Exception e) {
      e.printStackTrace();
    }
  }

}

AponReader 사용 예제

AponReader 클래스를 사용하면 APON 형식의 텍스트 문서를 Parameters Object로 쉽게 변환할 수 있습니다.

package com.aspectran.core.util.apon;

import java.io.File;
import java.io.FileReader;
import java.io.Reader;

import com.aspectran.core.context.loader.config.AspectranConfig;

public class AponReaderTest {

  public static void main(String argv[]) {
    try {
      Reader fileReader = new FileReader(new File(argv[0]));
      AponReader reader = new AponReader(fileReader);

      try {
        Parameters aspectranConfig = new AspectranConfig();  

        reader.read(aspectranConfig);

        System.out.println(aspectranConfig);
      } finally {
        reader.close();
      }
    } catch(Exception e) {
      e.printStackTrace();
    }
  }

}

APON 라이브러리

현재 APON 라이브러는 Aspectran의 공통 유틸 패키지의 일부로 포함되어 있습니다.

APON 패키지: com.aspectran.core.util.apon

Source