APON(Aspectran Parameters Object Notation) 소개

import com.aspectran.utils.apon.DefaultParameters;
import com.aspectran.utils.apon.ParameterKey;
import com.aspectran.utils.apon.ValueType;
import com.aspectran.utils.apon.Parameters;

public class RootConfig extends DefaultParameters implements Parameters {

    public static final ParameterKey server;

    private static final ParameterKey[] parameterKeys;

    static {
        // 다른 Parameter를 포함하는 계층적 구조를 가짐
        server = new ParameterKey("server", ServerConfig.class);

        parameterKeys = new ParameterKey[] {
                server
        };
    }

    public RootConfig() {
        super(parameterKeys);
    }
}

import com.aspectran.utils.apon.DefaultParameters;
import com.aspectran.utils.apon.ParameterKey;
import com.aspectran.utils.apon.ValueType;
import com.aspectran.utils.apon.Parameters;

public class ServerConfig extends DefaultParameters implements Parameters {

    public static final ParameterKey name;
    public static final ParameterKey port;
    public static final ParameterKey features;

    private static final ParameterKey[] parameterKeys;

    static {
        name = new ParameterKey("name", ValueType.STRING);
        port = new ParameterKey("port", ValueType.INT);
        // features Parameter는 string 타입이며, 여러 값을 가질 수 있는 배열임 (세 번째 인자 true)
        features = new ParameterKey("features", ValueType.STRING, true);

        parameterKeys = new ParameterKey[] {
                name,
                port,
                features
        };
    }

    public ServerConfig() {
        super(parameterKeys);
    }
}

import com.aspectran.utils.apon.AponReader;
import com.aspectran.utils.apon.Parameters;
import com.aspectran.utils.apon.RootConfig; // 1단계에서 정의된 RootConfig 가정
import com.aspectran.utils.apon.ArrayParameters; // ArrayParameters 임포트
import com.aspectran.utils.apon.DefaultParameters; // DefaultParameters 임포트

public class AponReaderTest {
    public static void main(String[] args) {
        try {
            // 예제 1: 루트 객체 읽기 (컴팩트 또는 비컴팩트 스타일 가능)
            String apon1 = """
                name: John Doe
                age: 30
                """;
            Parameters params1 = AponReader.read(apon1, new RootConfig());
            System.out.println("객체 이름: " + params1.getString("name"));

            // 예제 2: 루트 배열 읽기
            String apon2 = """
                [
                  "apple"
                  "banana"
                  "cherry"
                ]
                """;
            // 루트 배열의 경우, 명시적으로 ArrayParameters 인스턴스를 제공해야 합니다.
            ArrayParameters arrayParams = AponReader.read(apon2, new ArrayParameters());
            System.out.println("배열 내용: " + arrayParams.getValueList());

            // 루트 배열에 대해 ArrayParameters가 아닌 객체를 제공하면,
            // AponReader는 배열을 "" (ArrayParameters.NONAME) 이름의 파라미터로 추가합니다.
            Parameters defaultParams = AponReader.read(apon2, new DefaultParameters());
            System.out.println("이름 있는 파라미터로서의 배열: " + defaultParams.getValueList(ArrayParameters.NONAME));

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

import com.aspectran.utils.apon.AponParser;
import com.aspectran.utils.apon.ArrayParameters;
import com.aspectran.utils.apon.Parameters;
import java.util.List;

public class AponParserTest {
    public static void main(String[] args) {
        try {
            String apon = """
                [
                  [ "a", "b" ],
                  [ "c", "d", "e" ]
                ]
                """;

            // AponParser를 사용하여 문자열을 ArrayParameters 객체로 파싱
            ArrayParameters rootArrayParams = AponParser.parse(apon, ArrayParameters.class);

            // AponParser는 중첩된 배열을 List<List<Object>>로 올바르게 파싱합니다.
            List<List<String>> matrix = (List<List<String>>)rootArrayParams.getValueList();

            System.out.println("Matrix: " + matrix);
            // 출력: Matrix: [[a, b], [c, d, e]]

            // AponParser로 루트 객체도 파싱할 수 있습니다.
            String objectApon = """
                {
                  name: John Doe
                  age: 30
                }
                """;
            Parameters rootObjectParams = AponParser.parse(objectApon);
            System.out.println("Object Name: " + rootObjectParams.getString("name"));
            // 출력: Object Name: John Doe

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

import com.aspectran.utils.apon.AponWriter;
import com.aspectran.utils.apon.Parameters;
import java.io.StringWriter;
import java.io.Writer;

public class AponWriteTest {
    public static void main(String[] args) {
        try {
            // 1. APON으로 변환할 Parameters 객체 생성 및 값 설정
            Parameters serverConfig = new ServerConfig();
            serverConfig.putValue("name", "NewServer");
            serverConfig.putValue("port", 9090);
            serverConfig.putValue("features", new String[] {"WebService", "Security"});

            Parameters rootParams = new RootConfig(); // RootConfig는 server Parameter를 포함
            rootParams.putValue("server", serverConfig);

            // 예제: 기본 컴팩트 스타일 출력 (바깥쪽 중괄호 없음)
            String apon = new AponWriter().write(rootParams).toString();
            System.out.println("기본 컴팩트 스타일 출력:\n" + apon);
            // 출력:
            // server: {
            //   name: NewServer
            //   port: 9090
            //   features: [
            //     WebService
            //     Security
            //   ]
            // }

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

// 압축 출력 예제 (들여쓰기 없이, 하지만 구분자로서의 개행 문자는 유지)
String compactApon = new AponWriter().prettyPrint(false).write(rootParams).toString();
System.out.println(compactApon);
// 출력: server:{
// name:NewServer
// port:9090
// features:[
// HTTP2
// SSL
// ]
// }

import com.aspectran.utils.apon.AponLines;

public class AponLinesTest {
    public static void main(String[] args) {
        AponLines lines = new AponLines()
            .block("server")
                .line("name", "MyWebApp")
                .line("port", 8080)
                .array("features")
                    .line("HTTP2")
                    .line("SSL")
                .end()
            .end();

        String apon = lines.toString();
        System.out.println(apon);
    }
}

import com.aspectran.utils.apon.JsonToParameters;
import com.aspectran.utils.apon.Parameters;

String json = "{\"name\":\"John\", \"age\":30, \"cars\":[\"Ford\", \"BMW\"]}";
Parameters params = JsonToParameters.from(json);

System.out.println(params.getString("name")); // John
System.out.println(params.getInt("age")); // 30

import com.aspectran.utils.apon.XmlToParameters;
import com.aspectran.utils.apon.Parameters;

String xml = "<user><name>John</name><age>30</age></user>";
Parameters params = XmlToParameters.from(xml);

System.out.println(params.getParameters("user").getString("name")); // John

import com.aspectran.utils.apon.ObjectToParameters;
import com.aspectran.utils.apon.Parameters;

public class User {
    public String getName() { return "John"; }
    public int getAge() { return 30; }
}

User user = new User();
Parameters params = ObjectToParameters.from(user);

System.out.println(params.getString("name")); // John
System.out.println(params.getInt("age")); // 30