Spring Surf Presets

http://blogs.alfresco.com/wp/developer/2011/11/01/spring-surf-presets/ 를 이해한대로 정리해봅니다.

배경

대시보드와 같이 사용자 별로 유니크한 페이지에서 사용자가 최초로 접속할 때 생성되어야 하는 것들은 "presets"을 이용한다.

Presets는 "spring-surf-presets-context.xml"에 "org.springframework.extensions.surf.PresetsManager" 클래스를 통해 관리된다.

기본적으로 "presets.xml" 는 "classes/alfresco/site-data/presets" 이나 "classes/alfresco/web-extension/site-data/presets" 에 위치한다. 기본적인 구조는 아래와 같다.

<?xml version='1.0' encoding='UTF-8'?> <presets> <preset id="MyPreset"> <components> <component id="${componentId}"> ... </component> </components> <template-instances> <template-instance id="${templateId}"> ... </template-instance> </template-instances> <pages> <page id="${pageId}"> ... </page> </pages> </preset> </presets>

Presets 예시

PresetsManager 빈은 "constructPresets" 메소드를 호출하여 Presets 환경을 설정한다. 다른 방법으로는 custom Spring Surf JSP 태그를 이용하는 것이다. 이 방법은 아래와 같이 사용할 수 있다.

<%@ taglib prefix="surf" uri="http://www.springframework.org/tags/surf" %> <surf:constructPreset preset="myPreset"> <surf:presetToken key="pageId" value="MyPage"/> <surf:presetToken key="templateId" value="MyTemplate"/> <surf:presetToken key="componentId" value="MyComponent"/> </surf:constructPreset>

preset은 다수의 인스턴스를 생성하기 원하는 objects를 초기 정의 시에만 제공되어 진다. 

"source-id" 속성을 정의하여 컴포넌트의 scope를 설정할 수 있다.

Presets Manager 대안

Presets Manager를 커스터마이징 하기를 원한다면 Spring Surf FVT application을 사용한다.

"PresetsManager"는 "ModelObjects"를 생성하고 저장하는 "ModelObjectService"를 필요로 한다. 기본적으로 "PresetsManager"는 로컬 파일 시스템에 접근하는 것이 포함되어 있지 않은 "MultiObjectServer"를 사용한다. "ModelObjectService"는 "Store"를 필요로 하는 "Persister"를 필요로 하는 "PersisterService"를 필요로 한다.

<bean id="presets.model.object.service"> <property name="objectPersistenceService" ref="presets.object.persistence.service"/> </bean> <bean id="presets.object.persistence.service" > <property name="persisterService" ref="presets.persister.service"/> </bean> <bean id="presets.persister.service" > <property name="persister" ref="presets.persister"/> <property name="webFrameworkConfig" ref="webframework.config.element"/> </bean> <bean id="presets.persister" parent="webframework.sitedata.persister.abstract"> <property name="store" ref="presets.store"/> <property name="pathPrefix"><value>/</value></property> </bean> <bean id="presets.store" > <property name="root"><value>./WEB-INF</value></property> <property name="path"><value>/presetConstructs</value></property> </bean>

기본 "PresetsManager"를 오버라이드하고 "ModelObjectService"가 참조되기를 보장한다.

<bean id="webframework.presets.manager" > <property name="modelObjectService" ref="presets.model.object.service"/> <property name="searchPath" ref="webframework.presets.searchpath"/> <property name="files"> <list> <value>presets.xml</value> </list> </property> </bean>

마지막으로 새로운 persist를 사용할 수 있도록 추가하는 기본 "Autowire" 서비스를 오버라이드 한다.

<bean id="webframework.service.autowire" parent="webframework.service.autowire.abstract"> <property> <list> <ref bean="webframework.sitedata.persister.classpath"/> <ref bean="presets.persister"/> </list> </property> </bean>

흠... 일단은 뭔말인지는 알겠음...