Skip to content

Commit f789695

Browse files
topframetopframe
committed
Update Quick Start Guide
1 parent 0d0c036 commit f789695

File tree

1 file changed

+58
-58
lines changed

1 file changed

+58
-58
lines changed

‎_docs/getting-started/quickstart.md‎

Lines changed: 58 additions & 58 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ layout: page
33
format: "plate article"
44
title: "Quick Start Guide"
55
subheadline: "Getting Started with Aspectran"
6-
teaser: "Aspectran을 이용해서 간단한 Java 웹 어플리케이션을 만드는 방법에 대해 설명합니다."
6+
teaser: "Aspectran으로 간단한 Java 웹 어플리케이션을 만드는 과정을 설명합니다."
77
outside_heading: true
88
breadcrumb: true
99
sidebar: toc
@@ -16,8 +16,8 @@ Aspectran을 이용해서 Java 웹 어플리케이션을 개발하기 위해서
1616
* Java 8 이상
1717
* Servlet 3.1.0 이상
1818

19-
빠른 시작을 위해 다음 GitHub 저장소를 Clone 또는 소스 파일을 다운로드해서 새로운 Maven 프로젝트를 생성해 주세요.
20-
본 문서에서 사용된 모든 소스 파일이 포함되어 있습니다.
19+
빠른 시작을 위해 GitHub 저장소를 Clone 또는 소스 파일을 다운로드해서 새로운 Maven 프로젝트를 생성해 주세요.
20+
본 문서에서 사용된 모든 소스 파일은 아래의 GitHub 저장소에서 구할 수 있습니다.
2121

2222
{% include link-box href="https://github.com/aspectran-guides/ga-quick-start" %}
2323

@@ -33,15 +33,15 @@ Aspectran 서비스 구동환경을 설정하기 위한 초기화 파라메터 `
3333

3434
> AspectranServiceListener는 Aspectran Service 인스턴스를 생성하는 역할을 합니다.
3535
> WebActivityServlet은 클라이언트로부터 받은 요청을 Aspectran Service에 위임하는 역할을 합니다.
36-
> 만약 WebActivityServlet이 처리하지 못하는 요청은 DefaultServlet으로 처리권을 넘겨줍니다.
37-
> DefaultServlet의 이름은 명시적으로 지정하지 않았지만, 내부적으로 웹어플리케이션 서버 종류에 따라서 자동으로 판단합니다.
36+
> 만약 WebActivityServlet이 처리할 수 없는 요청은 DefaultServlet이 대신 처리하도록 합니다.
37+
> DefaultServlet의 이름은 명시적으로 지정하지 않았지만, 내부적으로 웹어플리케이션 서버 종류에 따라서 자동으로 지정됩니다.
3838
> 잘 알려진 웹어플리케이션 서버가 아닐 경우 DefaultServlet의 이름을 수동으로 명시할 수도 있습니다.
3939
4040
`/ga-quick-start/`로 시작되는 요청 URI에 대해서는 `aspectran-activity`라는 이름을 가진 서블릿이 처리하도록 설정을 합니다.
4141

4242
`/scheduler/`로 시작되는 요청 URI도 `aspectran-activity` 서블릿이 처리하도록 설정되어 있습니다.
4343
이는 스케쥴러에 의해 실행되는 Job을 웹브라우저에서도 실행할 수 있도록 하기 위한 것이며,
44-
실제 운영환경에서는 스케쥴러의 Job에 직접 접근할 수 없도록 서블릿 맵핑을 반드시 제거해야 합니다.
44+
실제 운영환경에서는 스케쥴러의 Job에 직접 접근할 수 없도록 서블릿 맵핑을 반드시 제거하도록 합니다.
4545

4646
[***web.xml***](https://github.com/aspectran-guides/ga-quick-start/blob/master/src/main/webapp/WEB-INF/web.xml)
4747
{% highlight xml %}
@@ -50,58 +50,58 @@ Aspectran 서비스 구동환경을 설정하기 위한 초기화 파라메터 `
5050
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
5151
xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
5252
version="3.1">
53-
<display-name>aspectran-examples</display-name>
54-
<welcome-file-list>
55-
<welcome-file>index.html</welcome-file>
56-
<welcome-file>index.jsp</welcome-file>
57-
</welcome-file-list>
58-
<context-param>
59-
<param-name>aspectran:config</param-name>
60-
<param-value>
61-
context: {
62-
root: /WEB-INF/aspectran/config/simplest-configuration.xml
63-
encoding: utf-8
64-
resources: [
65-
/WEB-INF/aspectran/config
66-
/WEB-INF/aspectran/classes
67-
/WEB-INF/aspectran/lib
68-
]
69-
hybridLoad: false
70-
autoReload: {
71-
reloadMethod: hard
72-
observationInterval: 5
73-
startup: true
53+
<display-name>aspectran-examples</display-name>
54+
<welcome-file-list>
55+
<welcome-file>index.html</welcome-file>
56+
<welcome-file>index.jsp</welcome-file>
57+
</welcome-file-list>
58+
<context-param>
59+
<param-name>aspectran:config</param-name>
60+
<param-value>
61+
context: {
62+
root: /WEB-INF/aspectran/config/root-configuration.xml
63+
encoding: utf-8
64+
resources: [
65+
/WEB-INF/aspectran/config
66+
/WEB-INF/aspectran/classes
67+
/WEB-INF/aspectran/lib
68+
]
69+
hybridLoad: false
70+
autoReload: {
71+
reloadMode: hard
72+
observationInterval: 5
73+
startup: true
74+
}
75+
profiles: {
76+
}
7477
}
75-
profiles: {
78+
scheduler: {
79+
startDelaySeconds: 10
80+
waitOnShutdown: true
81+
startup: false
7682
}
77-
}
78-
scheduler: {
79-
startDelaySeconds: 10
80-
waitOnShutdown: true
81-
startup: false
82-
}
83-
web: {
84-
uriDecoding: utf-8
85-
}
86-
</param-value>
87-
</context-param>
88-
<listener>
89-
<listener-class>com.aspectran.web.startup.listener.AspectranServiceListener</listener-class>
90-
</listener>
91-
<servlet>
92-
<servlet-name>aspectran-activity</servlet-name>
93-
<servlet-class>com.aspectran.web.startup.servlet.WebActivityServlet</servlet-class>
94-
<load-on-startup>1</load-on-startup>
95-
</servlet>
96-
<servlet-mapping>
97-
<servlet-name>aspectran-activity</servlet-name>
98-
<url-pattern>/ga-quick-start/*</url-pattern>
99-
</servlet-mapping>
100-
<!-- 실제 운영환경에서는 스케쥴러의 Job에 직접 접근할 수 없도록 서블릿매핑을 제거하도록 합니다. -->
101-
<servlet-mapping>
102-
<servlet-name>aspectran-activity</servlet-name>
103-
<url-pattern>/scheduler/*</url-pattern>
104-
</servlet-mapping>
83+
web: {
84+
uriDecoding: utf-8
85+
}
86+
</param-value>
87+
</context-param>
88+
<listener>
89+
<listener-class>com.aspectran.web.startup.listener.AspectranServiceListener</listener-class>
90+
</listener>
91+
<servlet>
92+
<servlet-name>aspectran-activity</servlet-name>
93+
<servlet-class>com.aspectran.web.startup.servlet.WebActivityServlet</servlet-class>
94+
<load-on-startup>1</load-on-startup>
95+
</servlet>
96+
<servlet-mapping>
97+
<servlet-name>aspectran-activity</servlet-name>
98+
<url-pattern>/ga-quick-start/*</url-pattern>
99+
</servlet-mapping>
100+
<!-- 실제 운영환경에서는 스케쥴러의 Job에 직접 접근할 수 없도록 서블릿매핑을 제거하도록 합니다. -->
101+
<servlet-mapping>
102+
<servlet-name>aspectran-activity</servlet-name>
103+
<url-pattern>/scheduler/*</url-pattern>
104+
</servlet-mapping>
105105
</web-app>
106106
{% endhighlight %}
107107

@@ -111,8 +111,8 @@ Aspectran 서비스 구동환경을 설정하기 위한 초기화 파라메터 `
111111
**APON**(*Aspectran Parameter Object Notation*) 형식의 설정 값을 가질 수 있습니다.
112112

113113
> ***APON***(Aspectran Parameter Object Notation)은 ***JSON*** 과 표기법이 유사하며,
114-
> 정해진 형식의 파라메터를 주고 받기 위해서 새롭게 개발된 표기법입니다.
115-
> 주로 초기 설정 값을 작성하기에 매우 편리하고, 자동으로 Java Object로 맵핑을 하기 때문에 설정 값을 정확하게 전달받을 수 있습니다.
114+
> 미리 정의된 형식의 파라메터를 주고 받기 위해서 새롭게 개발된 표기법입니다.
115+
> 어플리케이션의 초기 설정 값을 APON 형식으로 작성하면 자동으로 Java Object로 맵핑되기 때문에 정확한 설정 값을 편리하게 전달받을 수 있습니다.
116116
> 참고로 Aspectran은 설정 메터데이터를 XML 형식뿐만 아니라 APON 형식으로도 작성할 수 있습니다.
117117
118118
다음은 초기화 파라메터를 구성하는 세부 항목에 대한 설명입니다.

0 commit comments

Comments
 (0)