This chapter explains how to use the model created in the Developing a Model Using SAP RFC Invoke section within a Web Application to interact with models available in X-UP.

The application development process using X-UP Builder to integrate X-UP is as follows.

• Create a Web Application

• Integrate X-UP into the Web Application

• Developing a Model Using SAP RFC Invoke

• Export the Developed Model to the Web Application Server

• Invoke the Model from the Web Application

• Test

Create a Web Application

WebApplication 에 X-UP을 설정하기 위해선 하나의 WebApplication이 필요합니다.

To create a project, select File > New > eGovFrame Web Project.

Enter the Project Name and click the Next button.

Generate an example using Generate Example (EgovSampleController.java).

This is the structure of the generated project.

Integrate X-UP into the Web Application

To integrate X-UP into a Web Application, follow these steps

Extract the contents of xup.war, then copy the libraries from xup/WEB-INF/lib into the src/main/webapp/WEB-INF/lib directory of the generated project.

Copy the XPLATFORM_Server_License.xml file, issued for X-API usage, into the lib folder.

Add the required library files to the Build Path to use them in the Web Application.

Copy the xup folder from xup/WEB-INF (after extracting xup.war) into src/main/webapp/WEB-INF in the project.

After copying, the directory structure and files in the project are as follows.

Copy the X-UP_Server_License.xml file, issued for X-UP usage, into the src/main/webapp/WEB-INF/xup/conf/ directory.

Additionally, to enable all X-UP functionalities, register the X-UP Servlet in the web.xml file.

The servlet name is FrontControllerServlet, and since its URL pattern is the same as the Dispatcher-Servlet provided by eGovFrame, change its URL pattern to “.xup”.

Add the servlet configuration from the web.xml inside xup.war to the web.xml of the e-Government framework.

xup/WEB-INF/web.xml > src/main/webapp/WEB-INF/web.xml

<listener>
   <listener-class>com.nexacro.xup.service.XupContextListener</listener-class>
</listener>


<servlet>
	<servlet-name>action</servlet-name>
	<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
	<init-param>
		<param-name>contextConfigLocation</param-name>
		<param-value>/WEB-INF/config/egovframework/springmvc/dispatcher-servlet.xml,/WEB-INF/config/egovframework/springmvc/urlfilename-servlet.xml
		</param-value>
	</init-param>
	<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
	<servlet-name>action</servlet-name>
	<url-pattern>*.do</url-pattern>
</servlet-mapping>

<servlet>
	<servlet-name>FrontControllerServlet</servlet-name>
	<servlet-class>com.nexacro.xup.service.FrontControllerServlet</servlet-class>
	<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
	<servlet-name>FrontControllerServlet</servlet-name>
	<url-pattern>/FrontControllerServlet.xup</url-pattern>
</servlet-mapping>

<servlet>
   <servlet-name>ServiceInfoServiceServlet</servlet-name>
  <servlet-class>com.nexacro.xup.service.ServiceInfoServiceServlet</servlet-class>
	<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
	<servlet-name>ServiceInfoServiceServlet</servlet-name>
	<url-pattern>/ServiceInfoServiceServlet.xup</url-pattern>
</servlet-mapping>
	

In addition, if you need to use X-UP's administration features, copy the xup_manage_ui folder and index.jsp from xup.war into the WEB-INF directory.

The final configured screen appears as follows.

Developing a Model Using SAP RFC Invoke

To develop SAP RFC Invoke, refer to Developing a Model Using SAP RFC Invoke

Export the Developed Model to the Web Application Server

Here is the method for exporting the developed model to the Web Application server.

First, change the Perspective in the e-Government Framework (located at the top right) to X-UP.

Start the WAS (Web Application Server), then navigate to Window > Preferences > X-UP > Export Path to configure the export path.

After configuring the Export Path, right-click on the 'NexawebInc' project, and the following screen will appear.

Click "Export Generated Files", and as shown in the image below, the NexawebInc project will be copied.

Invoke the Model from the Web Application

To call the model in the Web Application, create the following Controller.

You can call the developed X-UP model using the following code.

package egovframework.rte.cmmn.web;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

import com.nexacro.xapi.data.PlatformData;
import com.nexacro.xapi.tx.HttpPlatformRequest;
import com.nexacro.xapi.tx.HttpPlatformResponse;
import com.nexacro.xup.connector.XIConnector;
import com.nexacro.xup.service.xi.XIServiceRequest;
import com.nexacro.xup.service.xi.XIServiceResponse;

@Controller
public class XIServiceController {

    @RequestMapping(value="/xi/getFlightList.do")
    public String getFlightList(HttpServletRequest request, HttpServletResponse response) throws Exception {
        // HttpServletRequest를 이용하여 HttpPlatformRequest 생성
        HttpPlatformRequest req = new HttpPlatformRequest(request);
        // XML 데이터 분석
        req.receiveData();
        // 데이터를 PlatformData 형태로 저장
        PlatformData platformData = req.getData();

        String domainName = "NexawebInc";
        String modelName = "INVOKE_SAP_RFC";
        
        // XIConnector 생성
        XIConnector connector = XIConnector.getConnector();
        // X-UP 으로 전송하기 위한 Request 생성
        XIServiceRequest serviceRequest = connector.createXIRequest(domainName, modelName, platformData);

        XIServiceResponse serviceResponse = (XIServiceResponse)connector.execute(serviceRequest);
        PlatformData resultPlatformData = serviceResponse.getPlatformData();

        //HttpServletResponse를 이용하여 HttpPlatformResponse 생성
        HttpPlatformResponse res = new HttpPlatformResponse(response);
        res.setData(resultPlatformData);
        //데이터 송신
        res.sendData();
        return null;
    }
}

Test

Call the developed Controller to verify whether the X-UP model is invoked correctly.

Call the developed Controller to verify whether the X-UP model is invoked correctly.

The URL to verify in the browser is as follows

http://localhost:8080/connector/xi/getFlightList.do

Target WAS Server / ApplicationContext Name / Request Mapping

Confirm the result data. (sample)