BANANA.Web.Controls.FileUpload 사전 준비사항

http://doc.bananaframework.net/Views/BANANA-Web-Controls/FileUpload-Prepare.aspx

아래 링크에서 파일 업로드 컨트롤에 대한 상세 설명과 데모를 확인하실 수 있습니다.

파일 업로드 설명 바로가기
파일 업로드 데모 바로가기

본 컨트롤은 다음 어셈블리들을 함께 제공합니다.

ASP.NET용 파일 업로드 서버 컨트롤(BANANA.Web.Controls.FileUpload)
HTML5 기반, 포스트백, 뷰스테이트, 서버 이벤트, 클라이언트 자바스크립트 이벤트 제공
바나나 에이전트(BANANA.Agent)
Microsoft ClickOnce를 통해서 배포되는 윈도우 응용 프로그램입니다.
클라이언트의 컴퓨터에 대기중이며, 파일 업로드 서버 컨트롤로 부터 각종 프로토콜을 수신합니다.
프로토콜의 종류에 따라 여러 가지 응용 프로그램들을 추가적으로 호출할 수 있습니다.
- 다운로드 매니저(BANANA.Agent.DownloadManager)
  파일 업로드 서버 컨트롤로부터 수신한 프로토콜을 분석하여, 서버로부터 파일들을 다운로드합니다.
  여러 개의 파일들이 멀티 쓰레드를 통하여 다운로드 되므로, 일반적인 웹 브라우저를 통하여 다운로드 받는 방법 보다는 월등히 빠른 속도를 보장합니다.
- 도큐먼트 뷰어(BANANA.Agent.DocumentViewer)
  서버에 업로드된 문서 파일(워드, 엑셀 및 파워포인트 - 향후 한글 파일도 지원 예정)을 클릭하면, 서버에서 자동으로 PDF로 변환된 다음 사용자 컴퓨터에서 도큐먼트 뷰어에 내장된 PDF 뷰어로 열어 줍니다.
  사용자의 컴퓨터에 Adobe PDF Reader는 클라이언트가 설치되어 있을 필요는 없습니다.
  서버 컨트롤의 설정을 통하여 클라이언트는 문서를 읽기 전용 혹은 저장 가능 모드로 열 수 있습니다.
- 일반 압축 다운로드
  서버 컨트롤에서 다운로드 매니저 혹은 도큐먼트 뷰어를 사용하지 않겠다고 설정을 하면, 개별 파일 클릭 시에는 원본 파일을 웹 사이트로부터 다운로드 받고, 전체 파일 다운로드를 클릭하면 해당 파일들을 압축해서 다운로드 받을 수 있도록 지원하고 있습니다.

다음은 바나나 파일 업로드 및 에이전트를 구성하고 있는 주요 라이브러리에 대한 소개와 환경설정 방법을 설명합니다.

사전 준비사항

웹 서버에 OpenOffice를 설치해야 합니다.
OpenOffice(http://openoffice.org는 아파치 라이선스 2.0을 준수하고 있으며, 누구나 무료로 다운로드하여 사용할 수 있습니다.
https://www.openoffice.org/license.html 이 링크에서 OpenOffice에 대한 라이선스 정보를 상세히 확인하실 수 있습니다.
사용자가 개별 파일을 클릭하여 클라이언트 컴퓨터의 도큐먼트 뷰어를 실행하려고 할 때, 서버에서 PDF로 자동변환을 한 후 바나나 프레임워크 고유의 암호화된 payload에 실어서 클라이언트 컴퓨터로 전송합니다.
이때 바나나 프레임워크가 독자적으로 개발한 전송 프로토콜을 사용하고 있으며, 해당 프로토콜은 웹 브라우저에 관계없이 Windows OS에서는 정상적으로 구동할 수 있게끔 설계되어 있습니다.
웹 서버에서 OpenOffice를 정상적으로 구동하기 위해서는 아래의 web.config 항목을 수정해야 합니다.
```
<configuration>
	
	<startup uselegacyv2runtimeactivationpolicy="true">
		<supportedruntime version="v4.0" sku=".NETFramework,Version=v4.5" />
	</startup>
</configuration>
```
서버가 64비트일 경우, 아래 그림과 같이 "파일이나 어셈블리 'cli_cppuhelper' 또는 여기에 종속되어 있는 파일이나 어셈블리 중 하나를 로드할 수 없습니다. 프로그램을 잘못된 형식으로 로드하려고 했습니다."라는 오류가 발생할 수 있습니다.
이 경우는 IIS 응용 프로그램 풀에서 32비트 응용 프로그램의 사용을 허가하지 않아서 발생하는 문제입니다.
IIS 응용 프로그램 풀의 기본 설정값은 32비트 응용 프로그램을 사용하지 않는 것으로 설정되어 있습니다.
이 "32비트 응용 프로그램 사용" 값을 True로 설정해 주면 오류를 해결할 수 있습니다.

관리도구 > IIS(인터넷 정보 서비스) 관리자를 클릭해서 해당 웹 사이트가 사용 중인 응용 프로그램 풀을 선택합니다.
고급 설정을 클릭하여, 해당 응용 프로그램 풀의 고급 설정 창을 엽니다.

아래 그림과 같이 "32비트 응용 프로그램 사용" 확인 란을 True로 변경해 주고 확인 버튼을 클릭하면 됩니다.

위 작업을 진행하고 나면, "프로그램을 잘못된 형식으로 로드하려고 했습니다" 오류는 처리가 가능합니다.
보통 "프로그램을 잘못된 형식으로 로드하려고 한다"는 오류는 32비트 응용 프로그램을 64비트로 열려고 할 때나 그 반대의 경우에 발생합니다.
Ajax 지원 어셈블리 사용
Ajax를 지원하기 위해서 AjaxPro(http://www.ajaxpro.info)를 사용하고 있습니다.
AjaxPro는 MIT 라이선스를 준수하고 있으며, 누구나 무료로 사용할 수 있습니다.
AjaxPro의 MIT 라이선스에 대해서는 홈페이지의 메인에서 확인하실 수 있습니다.
정상적인 구동을 위해서는 아래와 같이 web.config를 수정해야 합니다.
```

<configuration>
	<system.web>
		<httpHandlers>
			<add verb="POST,GET" path="ajaxpro/*.ashx" type="AjaxPro.AjaxHandlerFactory, AjaxPro"/>
		</httpHandlers>
	</system.web>
</configuration>




<configuration>
	<system.webServer>
		<handlers>
			<add name="AjaxPro" verb="POST,GET" path="ajaxpro/*.ashx" type="AjaxPro.AjaxHandlerFactory, AjaxPro" />
		</handlers>
	</system.webServer>
</configuration>

```
Windows Server 2008 이상이라면, IIS 7.0 Ajax 핸들러 등록을 참고 하시면 됩니다. 이전 버전의 Windows라면, IIS 6.0에 맞춰서 설정해 주시면 됩니다.

TOP