이 장에서는 이전 장에서 만든 서비스를 사용하여 넥사크로 애플리케이션을 개발하는 방법에 대해 설명합니다. 넥사크로 애플리케이션은 Nexacro Studio 툴을 이용하여 개발합니다. 서비스 개발은 이전 장을 참고합니다.

이 장에서 설명하는 Nexacro Studio를 이용한 Nex-UP 서비스를 사용한 애플리케이션 개발단계는 다음과 같습니다.

• TypeDefinition-Service 등록하기

• 서비스 인터페이스 정보 가져오기

• 서비스 호출 스크립트 작성하기

TypeDefinition-Module 등록하기

Nex-UP의 호출 스크립트를 사용하기 위하여 NexUpLibrary를 등록합니다. 아래와 같이 NexUpLibrary.json을 추가합니다.

TypeDefinition-Service 등록하기

Nex-UP Editor에서 생성한 서비스를 호출하기 위해 URL을 등록합니다. 아래와 같이 TypeDefinition에서 Service를 추가합니다.

서비스 인터페이스 정보 가져오기

서비스 인터페이스에 대한 정보를 가져오는 방법은 2가지 형태로 제공됩니다.

• Nex-UP Editor에서 정보 가져오기

• Nex-UP 서버에서 정보 가져오기

Nex-UP Editor에서 정보 가져오기

Nex-UP 서버에서 정보 가져오기

가져온 서비스 목록이 표시 됩니다.

서비스 호출 스크립트 작성하기

Nex-UP 서비스를 호출하기 위한 스크립트는 Nex-UP Editor에서 제공합니다.

조회

추가, 삭제

저장

서비스 호출 구조

nexup.AddService함수를 사용하여 서비스를 추가하고 nexup.CallService함수를 통하여 추가된 서비스를 실행하게 됩니다.

1. nexup.AddService

nexup.AddService(this, serviceId, inDataset, outDataset, strParam, useRowType, condition)

2. nexup.CallService

nexup.CallService(this, trId, CallbackFunc, Async, DataType, Compress, mybatisExecutorType)

서비스 호출 예시

1. 기본 호출

//Service Add(BOOK.EX_BOOKINFO_S)
nexup.AddService(this, "BOOK.EX_BOOKINFO_S", "", "dsBOOKINFO=dsBOOKINFO", "P_PARAM=" + this.edtTtitle.value);

//Call Service 호출
nexup.CallService(this, "serviceId", "fn_CallBack");

2. Dataset의 rowType에 따라 입력, 수정, 삭제 처리

//Service Add(BOOK.EX_BOOKINFO_I)
nexup.AddService(this, "BOOK.EX_BOOKINFO_I", "dsBOOKINFO=dsBOOKINFO:U", "", "");

//Service Add(BOOK.EX_BOOKINFO_D)
nexup.AddService(this, "BOOK.EX_BOOKINFO_D", "dsBOOKINFO=dsBOOKINFO:U", "", "");

//Service Add(BOOK.EX_BOOKINFO_U)
nexup.AddService(this, "BOOK.EX_BOOKINFO_U", "dsBOOKINFO=dsBOOKINFO:U", "", "");

//Call Service 호출
nexup.CallService(this, "serviceId", "fn_CallBack");

3. 상위 쿼리의 결과에 따른 분기 처리 (condition사용)

//Service Add(BOOK.EX_BOOKINFO_S)
nexup.AddService(this, "BOOK.EX_BOOKINFO_S", "", "dsBOOKINFO=dsBOOKINFO", "");

nexup.AddService(this, "BOOK.noname2", "", "Dataset0=Dataset0", "", "", "#{dsBOOKINFO.ISBN} == null");
nexup.AddService(this, "BOOK.noname3", "", "Dataset0=Dataset0", "", "", "#{dsBOOKINFO.ISBN} != null");

//Call Service 호출
nexup.CallService(this, "serviceId", "fn_CallBack");

• 첫 BOOK.EX_BOOKINFO_S를 실행하고 출력결과 dsBOOKINFO를 받습니다.

• dsBOOKINFO의 ISBN의 컬럼값이 있는지 없는지를 체크하여 선택적으로 서비스를 수행합니다.

• 조건식은 MyBatis 구문형식을 따릅니다.

공통 데이터 사용하기

• Config 메뉴를 클릭하고 좌측의 Common Data 메뉴를 선택

Common Data 구성요소

공통 데이터

• 공통 데이터셋을 관리하는 화면

• 공통 변수(Variable) 및 데이터셋(Dataset)을 관리한다

공통 변수 설정

공통 변수 설정 화면

• 공통 변수를 관리하는 화면

• 입력된 값은 로컬파일에 저장.

공통 데이터셋 설정

공통 데이터셋 설정 화면

• 공통 데이터셋을 관리하는 화면

• UI 프로젝트에 Dataset을 붙여 넣기 할 수 있도록 한다.

• Contents를 수정하면 Source탭에 xml이 변경되도록 한다.

• Source탭에 xml을 변경하면 Contents에 내용이 반영되도록 한다.

공통 데이터셋 XML파일(예시)

Nex-UP Editor 환경설정(Config)에서 OK버튼으로 저장시 자동 생성

1. 1.WEB-INF/common 폴더에 생성

2. 2.commonData1.xml 파일을 생성

3. 3.공통 데이터셋 레이아웃을 정의

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<layout xmlns="http://www.nexacro.com/nexup/service" name="commonData1">
    <input>
        <variables>
            <variable name="commonVar1" size="0" dataType="string"/>
        </variables>
        <dataSets>
            <dataSet description="" name="gdsCommonIn1">
                <columnInfo dataType="string" description="" isConstant="false" name="userId" size="255"/>
                <columnInfo dataType="string" description="" isConstant="false" name="clientIP" size="255"/>
            </dataSet>
        </dataSets>
    </input>
    <output>
        <variables/>
        <dataSets/>
    </output>
</layout>

Spring Interceptor Java Class파일 생성(예시)

• UI화면과 Nex-UP서비스 사이에서 Session 또는 서버아이피와 같은 데이터를 삽입할 수 있도록 함.

• preHandle 메서드를 Override하여 작성

public class ConverterKeywordInterceptor implements HandlerInterceptor {

	private static final String LOGIN_DATASET_NAME = "dsLogin";
	private static final String LOGIN_DATASET_COL_NAME = "USERID";
	private static final String COMM_DATASET_USERID_COL_NAME = "userId";
	private static final String COMM_DATASET_IP_COL_NAME = "clientIP";
	
	@Autowired
	DefaultSessionHandler defaultSessionHandler;

	@Override
	public boolean preHandle(HttpServletRequest request,
			HttpServletResponse response, Object handler) throws Exception {

		NexacroContext nexacroContext = NexacroContextHolder.getNexacroContext();
		PlatformData platformData = nexacroContext.getPlatformData();

		//변경할 Variable
		Variable var = platformData.getVariable("commonVar1");
		if(var != null && "#{clientIP}".equals(var.getString())){
			var.set(request.getRemoteAddr());
		}
		
		//변경할 Dataset
		DataSet dataSet = platformData.getDataSet("gdsCommonIn1");
		if (dataSet != null && dataSet.getRowCount() > 0) {
			//일반 Data에서 처리
			convertDataSet(request, dataSet);
			//sessionData에서 처리
			convertFromSessionData(request, dataSet);
		}
		return true;
	}
.............
........
...
}

Interceptor Java Class에 치환 로직 추가(예시)

• Session데이터나 아이피를 추가한 공통데이터셋에 삽입할 수 있도록 로직을 추가함.

//세션정보 치환
private void convertFromSessionData(HttpServletRequest request,DataSet dataSet) {
    if (defaultSessionHandler.isUseSession()) {
        // session check
        ServiceData loginServiceData = (ServiceData) WebUtils.getSessionAttribute(request,defaultSessionHandler.getSessionName());
        if (loginServiceData != null) {            
            // #{userId} --> session에 담긴 data로 변경된다.
            String columnName = this.COMM_DATASET_USERID_COL_NAME;
            int row = 0;
            
            String strValue = dataSet.getString(row, columnName);
            if (strValue.equals("#{userId}")) {
                //sessionData에 담긴 값
                //login할때 호출할 서비스의 결과 Dataset이름("dsLogin")과 column이름("USERID")을 지정하면 된다.
                Object value = getDatasetColumn(loginServiceData, this.LOGIN_DATASET_NAME, this.LOGIN_DATASET_COL_NAME, 0);
                dataSet.set(row, columnName, value);                                                  
                System.err.println("userId="+ dataSet.getString(0, "userId"));
            }
        }
    }
}
//아이피정보 치환
private void convertDataSet(HttpServletRequest request, DataSet dataSet) {
    // #{remoteIP} --> getRemoteAddr의 값으로 변경된다.
    String columnName = this.COMM_DATASET_IP_COL_NAME;
    int row = 0;
    
    String remoteIP = dataSet.getString(row, columnName);
    if (remoteIP.equals("#{clientIP}")) {
        dataSet.set(row, columnName, request.getRemoteAddr());
        System.err.println("clientIP="+ dataSet.getString(row, "clientIP"));
    }
}
//데이터셋정보 추출
private Object getDatasetColumn(ServiceData loginServiceData,String dsName, String columnName, int index) {
    List<Map> dsDataset2 = (List<Map>) loginServiceData.getDataSet(dsName);
    Map row = dsDataset2.get(index);
    Object value = row.get(columnName);
    return value;
}

Interceptor 설정 추가

• dispatcher-servlet.xml의 interceptors설정에 Class 추가

......................
...........
...
 <mvc:interceptors>
    <mvc:interceptor>
        <mvc:mapping path="/**"/>
        <bean class="com.nexacro.spring.servlet.NexacroInterceptor" />
    </mvc:interceptor>
    <mvc:interceptor>
        <mvc:mapping path="/dynamicService*"/>
        <bean class="com.nexacro.nexup.web.servlet.SessionInterceptor">
            <property name="errorView" ref="nexacroView" />
        </bean>
    </mvc:interceptor>
    <mvc:interceptor>
        <mvc:mapping path="/**"/>
        <bean class="nexacro.sample.interceptor.ConverterKeywordInterceptor"/>
    </mvc:interceptor>                              
</mvc:interceptors>
......................
...........
...

Nexacro 프로젝트에 공통데이터셋 추가

• Nex-UP Editor에서 Copy Common Data 버튼을 클릭한 후 Studio에 붙여넣기하여 글로벌 데이터셋을 추가한다.