DEXTUploadX5 샘플 적용 방법

DEXTUploadX5 샘플을 사용하려면 제품의 인증키가 필요하다. 평가판을 다운로드하면 30일간 테스트할 수 있는 인증키가 이메일로 전달된다. 라이선스 적용법에 대해서는 매뉴얼 상의 라이선스 항목을 참고한다.

샘플 구성
  • 공통: sample_x5_ko
  • 자바 서블릿 환경: sample_x5_nj_servlet_ko
  • 자바 스프링 환경: sample_x5_nj_spring_ko
  • 자바 스프링 부트 환경(NJ, Gradle): sample_x5_nj_boot_gradle_jar_ko
  • 자바 스프링 부트 환경(JK, Gradle): sample_x5_jk_boot_gradle_jar_ko
  • 자바 스프링 환경: sample_x5_nj_spring_ko
  • ASP.NET 환경: sample_x5_net5_ko
  • ASP.NET MVC 환경: sample_x5_net5_mvc5_ko
  • Classic ASP 환경: sample_x5_pro4_ko
공통 샘플

sample_x5_ko_{version}.zip 파일은 기본 샘플이다. DEXTUploadX5 전반적인 조작 및 UI 기능에 대해 설명한다.

샘플을 살펴보기 위해서 웹서버에서 샘플을 웹응용프로그램 또는 가상 디렉터리로 설정해야 한다.

모든 샘플은 UTF-8 형식으로 저장되어 있으며 DEXTUploadX5는 dx5 디렉터리에 존재한다.

자바 서블릿 샘플

sample_x5_nj_servlet_ko_{version}.zip 파일은 JSP/Java Servlet 환경을 기준으로 작성이 되었으며, 파일 업로드, 다운로드에 관한 DEXTUploadX5 전반적인 기능에 대해 설명한다.

샘플의 서버측 구성은 JDK 1.8 이상, Java Servlet API 3.1 스펙을 기준으로 잡았으며, 개발 환경은 Eclipse를 사용한다. 샘플을 살펴보기 위해서 Eclipse가 기본적으로 설치가 되어 있어야 하며, 샘플을 구동하기 위해서 JDK, Apache Tomcat가 설치되어야 한다.

모든 샘플은 UTF-8 형식으로 저장되어 있다. Eclipse는 ANSI를 기본으로 사용하기 때문에 한글 문장이 모두 깨져 보일 수 있다. 샘플을 Eclipse Workspace에 import 하기 전에 Preference > General > Workspace 화면에서 기본 텍스트 인코딩을 UTF-8로 먼저 지정해주면 문장이 깨지는 현상을 방지할 수 있다.

DEXTUploadX5는 src/main/webapp/dx5 디렉터리에 존재한다. 더불어 서버 측에서 파일 업로드 및 다운로드를 처리하기 위한 컴포넌트로써 자사의 DEXTUploadNJ가 사용된다. DEXTUploadNJ는 샘플에 포함(lib)되어 있으며, 제품에 대한 자세한 사용법이나 라이선스 적용법은 DEXTUploadNJ 제품의 매뉴얼 및 샘플을 참고한다.

개발 환경이 구성되지 않은 경우, 다음의 순서를 먼저 진행한다.

  1. 최신 JDK 버전을 다운로드 받아 설치한다.
  2. Apache Tomcat을 다운로드 받아 설치한다.
  3. Eclipse IDE for Java EE Developers를 다운로드 받는다.
  4. Eclipse를 실행하고 JDK를 설정한다. (Preference > Java > Installed JREs)
  5. Preference > Server > Runtime Environments 화면에서 Tomcat을 추가한다.
  6. Preference > General > Workspace 화면에서 기본 텍스트 인코딩을 UTF-8로 설정한다.

개발 환경이 구성된 경우, 다음 순서대로 샘플 프로젝트를 로드할 수 있다. (환경 구성의 차이로 인한 오류는 직접 해결해야 한다.)

  1. Import > General > Existing Projects into Workspace > Select archive file 을 사용하여 샘플 프로젝트를 추가한다.
  2. 샘플을 실행하려면 Eclipse Servers 창에서 오른쪽 마우스 클릭 > New > Server를 선택하여 New Server 창을 실행한다.
  3. Tomcat을 선택하고 Server name를 입력한 후 다음으로 넘어간다.
  4. 좌측 리스트에서 sample_x5_nj_servlet_ko를 선택하여 오른쪽으로 추가한 후 완료하면 Servers 창에 등록이 된다.
  5. 등록된 대상을 선택하여 마우스 우클릭을 한 후 Start를 실행하면 샘플이 구동된다.
  6. 기본 설정의 경우 브라우저를 열고 http://localhost:8080/sample_x5_nj_servlet_ko 주소를 입력하면 샘플을 확인할 수 있다.
자바 스프링 샘플

sample_x5_nj_spring_ko_{version}.zip 파일은 Spring Framework를 사용하는 샘플이다. Spring Framework 환경을 기준으로 작성이 되었으며, 파일 업로드, 다운로드에 관한 기능에 대해 설명한다.

  1. Import > General > Existing Projects into Workspace > Select archive file 을 사용하여 샘플 프로젝트를 추가한다.
  2. 샘플을 실행하려면 Eclipse Servers 창에서 오른쪽 마우스 클릭 > New > Server를 선택하여 New Server 창을 실행한다.
  3. Tomcat을 선택하고 Server name을 입력한 후 다음으로 넘어간다.
  4. 좌측 리스트에서 sample_x5_nj_spring_ko를 선택하여 오른쪽으로 추가한 후 완료하면 Servers 창에 등록이 된다.
  5. 등록된 대상을 선택하여 마우스 우클릭을 한 후 Start를 실행하면 샘플이 구동된다.
  6. 기본 설정의 경우 브라우저를 열고 http://localhost:8080/sample_x5_nj_spring_ko 주소를 입력하면 샘플을 확인할 수 있다.
자바 스프링 부트 샘플

sample_x5_nj_boot_gradle_jar_ko_{version}.zip 파일은 Spring Boot 기반 샘플이다.

  1. Import > General > Existing Projects into Workspace > Select archive file 을 사용하여 샘플 프로젝트를 추가한다.
  2. 샘플을 실행하려면, 등록된 프로젝트를 선택하여 마우스 우클릭을 한 후 Run as > Spring Boot App를 선택한다.
  3. 기본 설정의 경우 브라우저를 열고 http://localhost:8080 주소를 입력하면 샘플을 확인할 수 있다.
자바 스프링 부트(Jakarta EE) 샘플

sample_x5_jk_boot_gradle_jar_ko_{version}.zip 파일은 Jakarta EE를 지원하는 DEXTUploadJK를 사용한 Spring Boot 기반 샘플이다.

  1. Import > General > Existing Projects into Workspace > Select archive file 을 사용하여 샘플 프로젝트를 추가한다.
  2. 샘플을 실행하려면, 등록된 프로젝트를 선택하여 마우스 우클릭을 한 후 Run as > Spring Boot App를 선택한다.
  3. 기본 설정의 경우 브라우저를 열고 http://localhost:8080 주소를 입력하면 샘플을 확인할 수 있다.
ASP.NET 샘플

sample_x5_net5_ko_{version}.zip 파일은 ASP.NET 환경으로 제작된 샘플이다. 샘플은 .NET Frameowrk 4.6.1 버전을 사용하며, Visual Studio 2019를 사용하여 제작되었다. (ASP.NET Core가 아닌 .NET Framework을 사용하는 ASP.NET이다.)

서버 측에서 파일 업로드 및 다운로드를 처리하기 위한 컴포넌트로서 자사의 DEXTUpload.NET Pro가 사용된다. 제품을 사용하기 위해서는 라이선스를 적용해야 하므로 DEXTUpload.NET Pro 제품의 매뉴얼을 참고한다.

샘플 테스트를 위한 단계는 다음과 같다.

  1. sample_x5_net5_ko.csproj을 더블 클릭하여 Visual Studio로 로드한다.
  2. 프로젝트를 바로 저장하여 sample_x5_net5_ko.sln 파일을 생성한다.
  3. Solution Explorer에서 프로젝트 이름을 마우스로 우클릭하고 Debug > Start New Instance 메뉴를 선택한다.
  4. http://localhost:3060/sample_x5_net5_ko 주소로 기본 브라우저가 열리면서 샘플을 확인할 수 있다.
ASP.NET MVC 샘플

sample_x5_net5_mvc5_ko_{version}.zip 파일은 ASP.NET MVC 환경으로 제작된 샘플이다. 샘플은 .NET Frameowrk 4.6.1 버전을 사용하며, Visual Studio 2019를 사용하여 제작되었다. (ASP.NET Core가 아닌 .NET Framework을 사용하는 ASP.NET이다.)

서버 측에서 파일 업로드 및 다운로드를 처리하기 위한 컴포넌트로서 자사의 DEXTUpload.NET Pro가 사용된다. 제품을 사용하기 위해서는 라이선스를 적용해야 하므로 DEXTUpload.NET Pro 제품의 매뉴얼을 참고한다.

샘플 테스트를 위한 단계는 다음과 같다.

  1. sample_x5_net5_mvc5_ko.csproj을 더블 클릭하여 Visual Studio로 로드한다.
  2. 프로젝트를 바로 저장하여 sample_x5_net5_mvc5_ko.sln 파일을 생성한다.
  3. Solution Explorer에서 프로젝트 이름을 마우스로 우클릭하고 Debug > Start New Instance 메뉴를 선택한다.
  4. http://localhost:4223/sample_x5_net5_mvc5_ko 주소로 기본 브라우저가 열리면서 샘플을 확인할 수 있다.
Classic ASP 샘플

sample_x5_pro4_ko_{version}.zip 파일은 Classic ASP 환경으로 제작된 샘플이다. 샘플은 Visual Studio 2019를 사용하여 제작되었다.

서버 측에서 파일 업로드 및 다운로드를 처리하기 위한 컴포넌트로서 자사의 DEXTUpload Professional 제품이 사용된다. 제품을 사용하기 위해서는 제품을 먼저 설치하고, 라이선스를 적용해야 하므로 DEXTUpload Professional 제품의 매뉴얼을 참고한다.

샘플 테스트를 위한 단계는 다음과 같다.

  1. sample_x5_pro4_ko.csproj을 더블 클릭하여 Visual Studio로 로드한다.
  2. 프로젝트를 바로 저장하여 sample_x5_pro4_ko.sln 파일을 생성한다.
  3. Solution Explorer에서 프로젝트 이름을 마우스로 우클릭하고 Debug > Start New Instance 메뉴를 선택한다.
  4. http://localhost:3082/sample_x5_pro4_ko 주소로 기본 브라우저가 열리면서 샘플을 확인할 수 있다.