Expression Language

Spring Web Flow는 데이타 모델 및 action실행을 위해 Expression Language(EL)을 이용한다.

Unified EL과 OGNL(Object Graph Navigation Language)을 사용할 수 있다. Unified EL과 OGNL은 비슷한 문법을 가지고 있다.
Spring Web Flow에는 Unified EL만을 사용하는 것을 권장한다.

기본으로는 Unified EL을 사용하도록 되어 있다. jboss-el이 기본 구현체로 되 있다.

참고 : web 컨테이너에서는 일반적으로 el-api를 지원하고 있다.

ONGL은 SWF2에서 제공하는 또 다른 EL. 클래스패스에 추가하면 사용할 수 있다..

Flow에서 EL 사용하는 경우

• 클라이언트에서 제공되는 데이터에 접근하는 경우. 입력 속성이나 요청 파라미터
• FlowScope처럼 내부 데이터 구조에 접근하는 경우
• 스프링 빈에 있는 메소드 호출
• 생성자 결정할 때

Flow에 의해 보여지는 View는 EL을 사용해서 Flow 데이터 구조에 접근하게 됨.

가장 일반적인 방법은 eval 표현으로 이 경우 ${}나 #{}을 사용하면 안 됨. 이 예는 searchCriteria에 있는 nextPage() 호출.

<evaluate expression="searchCriteria.nextPage()" />

다음은 “template” 표현식으로 아래와 같은 형태로 ${} 을 사용할 수 있다.

<view-state id="error" view="error-${externalContext.locale}.xhtml" />

externalContext 에 세팅되어 있는 locale 결과를 대체하여 error-결과.xhtml 로 생성된다.

• flowScope: flow 변수에 할당되며, Flow 범위를 가진 객체. 기본적으로 Flow범위에 저장되는 모든 객체는 Serializable이 되야 함.
  

<evaluate expression="searchService.findHotel(hotelId)" result="flowScope.hotel" />

• viewScope: view 변수에 할당되며, view-state 내 범위를 갖음. 그러므로 view-state 내에서만 참조 가능. 역시 모든 객체는 Serializable 되야 함.
  

<on-render>
  <evaluate expression="searchService.findHotels(searchCriteria)" result="viewScope.hotels" result-type="dataModel" />
</on-render>

• requestScope: request 변수에 할당. 한 번의 Flow 내에서 공유
  

<set name="requestScope.hotelId" value="requestParameters.id" type="long" />

• flashScope: falsh 변수에 할당. Flow가 시작될 때 할당되고, 뷰가 보여지고 난 후 clear 됐다가, Flow가 종료되면 정리되는 범위. 객체는 Serializable 해야 함.
  

<set name="flashScope.statusMessage" value="'Booking confirmed'" />

• conversationScope

converation 변수에 할당. 최상위 Flow가 시작할 때 할당되며, 최상위 Flow가 종료될 때 정리. 최상위 Flow의 자식 Flow에서 공유. HTTP session에 저장되며, 세션 복제를 할 경우를 대비해 Serizalizable를 구현해야 함.

<evaluate expression="searchService.findHotel(hotelId)" result="conversationScope.hotel"/>

• flowRequestcontext: 현재 Flow 요청을 표현. RequestContext API.
• messageContext: 에러나 성공 메세지를 포함해서 Flow 실행 메세지를 받아오고, 만드는데 대한 context에 접근할 수 있음. MessageContext 참조.

<evaluate expression="bookingValidator.validate(booking, messageContext)" />

• flowExecutionContext: 현재 Flow 상태를 표현. FlowExecutionContext API.
• externalContext: 사용자 세션 속성 등 외부 환경에 접근할 수 있음. ExternalContext API.

<evaluate expression="searchService.suggestHotels(externalContext.sessionMap.userProfile)" result="viewScope.hotels" />

• requestParameters: 사용자로부터 넘어온 request 매개변수 접근

<set name="requestScope.hotelId" value="requestParameters.id" type="long" />

• currentEvent: 현재 Event 객체에 접근

<evaluate expression="booking.guests.add(currentEvent.guest)" />

• currentUser: 인증된 Principal에 접근

<evaluate expression="bookingService.createBooking(hotelId, currentUser.name)" result="flowScope.booking" />

• resourceBundle: message 자원 관리

<set name="flashScope.successMessage" value="resourceBundle.successMessage" />

• flowExecutionUrl: 현재 flow execution view-state에 대한 context-relative URI에 접근

특정 범위에 변수를 할당할 때는 반드시 범위를 명시해야 한다.

<set name="requestScope.hotelId" value="requestParameters.id" type="long" />

특정 범위에 있는 변수에 접근할 때는 꼭 범위를 명시할 필요는 없다.

<evaluate expression="entityManager.persist(booking)" />

booking처럼 범위를 명시하지 않은 경우, 범위 검색 알고리즘(scope searching algorithm)이 동작하며,
이 알고리즘은 request→flash→view→flow→conversation 범위의 순서로 찾게 된다. 없을 경우 EvaluationException 발생.
아래그림은 검색되는 Scope 순서를 잘 보여주고 있다.

• Spring Web Flow 2.3.3 Reference - Expression Language(EL)