====================================================================== VisualAge for Java 버전 2.0 서블릿 빌더 Windows, AIX 및 OS/2용 릴리스 정보 ======================================================================= 목차 ---- 1.0 사용 위치 2.0 *중요사항* 이주 정보 3.0 문서 4.0 자국어 "문자 세트" 및 JSDK 고려 사항 5.0 Windows 95의 JSDK POST 문제점(tm) 6.0 느린 첫번째 열기 7.0 HTTP 서버 구성 8.0 검색기 구성 9.0 IP 구성 10.0 제품 서버는 1.1 서블릿을 지원해야 함 11.0 404 클래스가 제품 서버에 없음 12.0 문제점 해결방안 13.0 JDBC 샘플 14.0 새로운 프로젝트 및 패키지로 비주얼 서블릿 SmartGuide 작성 15.0 HtmlServlet 빈(bean)의 기본 코드값 16.0 수행 단추 고려사항 ================================== 1.0 사용 위치 서블릿 빌더를 사용가능하게 하려면, Workbench 파일 메뉴에서 "빠른 시작", "기능", "기능 추가"를 차례로 선택하고 "IBM Servlet Builder 2.0"을 선택하십시오. 빠른 시작 메뉴를 사용하여 서블릿 빌더 기능을 로드해야 합니다. 저장소에서 프로젝트를 로드하면 비주얼 구성 및 수행 단추 지원이 제대로 초기화되지 않습니다. 이 릴리스 정보는 다음을 포함한 모든 서블릿 빌더 버전에 적용됩니다. Windows, AIX 및 OS/2의 2.0 Windows, AIX 및 OS/2의 2.0.2 NL Windows의 2.0.3 2.0 *중요사항* 이주 정보 서블릿 빌더를 사용하여 빌드한 서블릿을 이주시키는 경우, 사용자의 비주얼 서블릿이 웹 서버의 "/servlets" 디렉토리 뿐만 아니라 클래스 경로에도 있어야 합니다. 증상은 양식 데이터 단추 누르기 이벤트가 처리되지 않는 것입니다. 이를 수행하는 가장 쉬운 방법은 서블릿 디렉토리를 클래스 경로에 추가하는 것입니다. WebSphere 응용프로그램 서버를 사용할 때 클래스 경로가 응용프로그램 애플릿(http://myserver:9090)에 설정됩니다. 이러한 요구조건은 서블릿 빌더의 후속 릴리스에서는 필요하지 않습니다. 또한, 제품 웹 서버에서 비주얼 서블릿을 수행하려면 사용자의 클래스 경로에 "IBM Servlet Builder Class Library" 프로젝트를 포함시켜야 합니다. 이 프로젝트는 VisualAge 디렉토리 트리에 있는 다음 파일로 반출됩니다. /eab/runtime20/ivjsb20.jar, 및 /eab/runtime20/ivjsb20.zip. WebSphere를 사용할 때 .jar 파일이 관리 애플릿을 사용하여 클래스 경로에 추가되어야 합니다. 3.0 문서 서블릿 빌더 기능을 사용하는 시작하기 전에 도움말 문서를 참조하십시오. VisualAge IDE에서, 웹 검색기에서 "도움말"->"개념"을 선택하고, "비주얼 컴포지션"과 "서블릿"을 확장한 후 "서블릿 개요"를 선택하십시오. 4.0 자국어 "문자 세트" 및 JSDK 고려 사항 Sun Microsystems에서 제공하는 Sun JSDK(Java Server Development Kit)는 내용 유형을 위에 표시된 대로 설정하여 문자 세트를 지정하지 않을 경우 2바이트 문자 세트를 지원하지 않습니다. IBM WebSphere 응용프로그램 서버는 응답의 문자 세트를 설정하기 위해 웹 검색기가 지정하는 대로 수신되는 요청의 문사 세트를 사용합니다. 수정된 JSDK 버전은 이 기능을 제공하는 IBM에서 사용할 수 있습니다. VisualAge로 반입시, 이러한 갱신된 JSDK 버전은 "Sun JSDK Class Library" 프로젝트의 2.0 NL 버전 번호를 가집니다. 갱신된 JSDK 로드 지침 1) 새로운 JSDK와 unzip을 a .dat 파일로 다운로드하십시오(VisualAge 반입). 2) 프로젝트: "Sun JSDK Class Library" 버전 2.0 NL을 .dat 파일에서 반입하십시오. 3) 사용자 콘솔로 이동하고 수행 중인 모든 프로세스를 닫으십시오. 4) 아직 로드되지 않은 경우 서블릿 빌더 기능을 로드하십시오. 5) Sun JSDK Class Library 프로젝트의 2.0 NL 버전을 로드하십시오. 서블릿 빌더는 서블릿 생성시 문자세트를 지정하지 않습니다. 서블릿이 "문자세트" 특성을 필요로 하는 경우 다음 중 하나를 수행해야 합니다. a) 빈 작업 영역에서 "요청 수신" 이벤트를 서블릿의 "contentType" 특성에 연결하십시오(예, 빈 작업 영역에서 빈 작업 영역으로 연결). 그런 다음 연결의 특성을 열고 "매개변수 설정" 단추를 사용하여 연결의 매개변수를 변경하십시오. 매개변수를 변경하여 문자세트 값을 포함한 내용 유형을 지정하십시오. 예를 들어, 한자(Simplified): \"text/html; charset=iso-2022-cb-ext\" 한자(Traditional): \"text/html; charset=x-euc-tw\" 일어: \"text/html; charset=iso-2022-jp\" 한글: \"text/html; charset=euc-kr\" b) 서블릿의 초기설정 메소드를 수정하고 다음 코드 행 중 하나를 추가하여 내용 유형과 문자세트를 설정하십시오. setContentType("text/html; charset=iso-2022-cb-ext"); setContentType("text/html; charset=euc-tw"); setContentType("text/html; charset=iso-2022-jp"); setContentType("text/html; charset=euc-kr"); 기타 문자세트가 많이 있습니다. 이 중 몇 가지는 다음에서 찾을 수 있습니다. http://people.netscape.com/ftang/meta.html ftp://ftp.isi.edu/in-notes/iana/assignments/character-sets 2바이트 문자 세트(DBCS)를 사용하여 테스트하려면 이를 수행할 수 있도록 웹 검색기를 적절히 구성해야 합니다. 이 작업에는 검색기가 지원하는 열람 인코딩 및 글꼴 설정이 포함됩니다. 몇몇 검색기 버전은 DBCS 문자를 지원하지 않습니다. 경우에 따라 AIX 및 OS/2 대신 Windows 운영 시스템에서 사용할 수 있는 웹 검색기를 구성하는 것이 더 쉽습니다. 이 경우, Windows 시스템을 사용하여 AIX 또는 OS/2의 개발 시스템을 지시하는 URL로 웹 검색기를 여는 것을 고려해 볼 수 있습니다. JSDK는 일어(ja_JP) UNIX 로케일로 세션 데이터 사용과 관련된 문제점을 문서화했습니다. 이러한 문제점으로 인해 서블릿 빌더 컴포넌트를 사용한 세션 데이터 지원용 일어(JA_JP) UNIX 로케일을 사용하십시오. 쿠키의 DBCS 문자열은 현재 서블릿에서 지원되지 않습니다. 일부 DBCS 시스템(예, 한국)에서는 비주얼 서블릿을 열 때 "Swing" 빈 팔레트가 기본 팔레트가 됩니다. 이 경우, 비주얼 컴포지션 편집기의 왼쪽에 있는 팔레트 범주 목록에 나타나는 "서블릿"(또는 "서블릿의 번역)으로 전환해야 합니다. 한글 AIX 시스템에서 한글이 잘 보이지 않을 경우, 다음과 같이 환경을 설정해야 합니다. APAR IX77575이 설치된 AIX 4.2.1 시스템 및 Netscape 4.06 또는 AIX 4.3.1 시스템 및 Netscape 4.06. 5.0 Windows 95의 JDSK POST 문제점(tm) 일부 Sun JSDK(및 Sun JavaServer) 버전은 Window 95(tm)의 몇몇 구성에 대한 POST를 지원하지 않습니다. 그 증상은 "피어에 의한 연결 재설정"이라는 메시지가 검색기에 나타나는 것입니다. POST를 사용하는 서블릿 빌더 샘플이 Windows 95에서 작동되지 않을 수도 있습니다. Windows 95를 수행하는 데 이러한 문제를 경험하게 되면 양식 파트의 "메소드" 특성을 "POST"에서 "GET"로 변경할 수 있습니다. 서블릿이 제대로 작동됩니다. 6.0 느린 첫번째 열기 맨 처음 비주얼 서블릿을 열 경우, 초기설정 완료 및 캐쉬 설정에 상당한 시간이 걸립니다. 결과적으로 비주얼 서블릿을 여는 것이 훨씬 빨라집니다. 7.0 HTTP 서버 구성 버전 2.0.2 NL 및 2.0.3에서 구성 파일은 다음에 위치합니다(디렉토리 이름은 반복됨). ...project_resources/IBM Servlet IDE Utility class libraries/com/ibm/ivj/ servlet/runner/configuration.properties 서블릿 빌더 버전 2.0에서 구성 파일은 다음에 위치합니다(디렉토리 이름은 반복됨). ...project_resources/IBM Servlet Builder class libraries/com/ibm/ivj/ servlet/runner/configuration.properties HTTP 서버가 시작되고 웹 검색기가 시작되는 방식을 변경하도록 설정할 수 있는 몇가지 특성이 포함됩니다. IP 127.0.0.1에서 검색기가 시작될 때 일부 시스템이 작동되지 않으므로, 이 파일이 "localhost", 또는 사용자 PC의 호스트명이나 IP 주소로 변경되어야 할 것입니다. 기본 서버 포트는 8080입니다. 8080 포트를 사용하는 시스템에서 제품 웹 서버를 수행하려면 구성 파일에 있는 기본 포트를 8081과 같은 다른 값으로 변경할 수 있습니다. 이런 식으로 쉽게 제품 및 개발 모드에서 테스트를 수행할 수 있습니다. 버전 2.0.2 NL 또는 2.0.3을 버전 2.0에 설치하는 경우, .../IBM 서블릿 빌더 클래스 라이브러리/...에 있는 2.0 구성 파일을 다른 이름으로 변경하거나 삭제해야 합니다. 8.0 검색기 구성 서블릿에서 시작된 기본 웹 검색기는 VisualAge 도움말에 사용되는 것과 동일합니다. 검색기 구성에 대한 도움말 페이지의 옵션을 변경하면 서블릿 시작에 대해서도 변경됩니다. 위 항목에서의 구성 파일은 검색기가 시작되는 포트 및 IP와 같은 검색기 시작 특성을 변경하도록 변경될 수 있습니다. Windows에서 기본 구성이 "파일 연관 사용"을 지시하는 경우, 서블릿 빌더만이 검색기를 적절하게 시작하고 "UR 연관"이 존재합니다. URL 연관은 좀더 최신 버전의 Netscape 및 Internet Explorer가 설치되어 있는 경우 설정됩니다. 서블릿 빌더가 접두어로 "http://"가 붙은 전체 URL에서 검색기를 시작하므로 .html 파일의 "파일 연관"은 충분하지 않습니다. 9.0 IP 구성 Microsoft Internet Explorer를 기본 검색기로 사용하는 몇몇 시스템은 비주얼 서블릿에 대해 "수행" 단추를 누를 경우 현재 시스템을 다시 지시하는 데 사용되는 기본값인 IP 127.0.0.0에 액세스할 수 없습니다. 이를 수정하는 방법은 두 가지가 있습니다. 첫번째 방법은, "serverAddress" 값을 호스트명이나 IP 주소로 변경하기 위해 위에서 언급한 구성 파일을 수정하는 것입니다. 두번째 방법은, Internet Explorer가 127.0.0.1을 허용하도록 수정하는 것입니다. Internet Explorer에서 보기를 선택한 다음, -> 인터넷 옵션 -> 연결 탭 -> 프록시 서버를 사용한 인터넷 액세스 -> "고급..." 단추를 클릭하여 프록시 설정 창을 여십시오. -> "다음 주소에는 Proxy 서버 사용 안함" 영역의 "예외 그룹"에 127.0.0.1을 입력하십시오. -> 확인 -> 확인을 클릭하십시오. 10.0 제품 서버는 1.1 서블릿을 지원해야 함 제품 환경에서 서블릿을 이주시키는 경우, Sun의 1.1 버전 또는 JDSK의 이후 버전을 지원하는 웹 서버를 사용해야 합니다. 최신 서블릿 버전을 지원하도록 웹 서버를 업그레이드하려면 (ServletExpress라고 알려진 소프트웨어가 포함된) IBM WebSphere 응용프로그램 서버와 함께 사용하도록 구성하십시오. IBM WebSphere 응용프로그램 서버는 Netscape Enterprise Server, Netscape FastTrack Server, Microsoft Internet Information Server, Apache Server, Lotus Domino Go Webserver와 같은 주요 산업 HTTP 서버에서 수행됩니다. 자세히 알려면 다음을 참조하십시오. http://www.software.ibm.com/webservers/appserv/ WebSphere 사용시, 다음을 참조하고 로드된 관리 애플릿을 사용함으로써 클래스 경로를 설정합니다. http://myserver:9090 바르게 작동하려면 ivjsb20.jar 파일 및 servlet 경로를 런타임 비주얼 서블릿용 인터페이스를 사용하여 클래스 경로에 추가하여야 합니다. 버전 2.0.3에서 더 이상 서블릿 경로를 클래스 경로에 추가할 필요가 없습니다. 11.0 404 클래스가 제품 서버에 없음 제품 시스템의 /servlets 디렉토리에서 서블릿을 이주시키는 경우, 클래스를 생성할 수 없으면 "404 클래스가 없음" 오류를 받게 됩니다. Swing TableModel 클래스와 같은 다른 클래스들이 로드 중인 서블릿에 대한 클래스 경로에 없을 때 이런 오류가 발생합니다. 사용자의 서블릿은 사용하는 클래스가 서버에 대한 클래스 경로에 있어야 합니다. 12.0 문제점 해결방안 웹 검색기로부터 서블릿을 적재하는 중에 문제가 발생하면 다음과 같은 URL을 사용하여 Router 클래스를 사용할 수 있습니다(URL은 랩되어 있음). http://myserver:8080/com.ibm.ivj.servlet.http.Router/ com.ibm.ivj.servlet.sample.HelloWorldSample 이로써 대상 서블릿을 로드하는 라우터 서블릿이 로드됩니다(이 경우는 HelloWorldSample). 테스트를 위해 HelloWorldSample 클래스를 서블릿 클래스로 변경하십시오. 13.0 JDBC 샘플 JDBC 샘플을 사용하려면 JDBC를 제대로 설치 및 구성해야 합니다. com.ibm.ivj.servlet.sample.jdbc 패키지에 있는 README 서블릿을 참조하십시오. 14.0 새로운 프로젝트 및 패키지로 비주얼 서블릿 SmartGuide 작성 "비주얼 서블릿 작성" SmartGuide는 새로운 프로젝트 또는 패키지 작성시 제대로 기능하지 않습니다. 대신, 검색 단추를 사용하여 이미 작업공간에 로드된 프로젝트와 패키지를 선택하십시오. 15.0 HtmlServlet 빈의 기본 코드값 HtmlServlet 빈(bean) 드롭시, 'code' 특성의 기본값은 없음(NULL)입니다. 이 값은 사용자가 VCE에서 편집 중인 빈을 저장할 수 없게 합니다. 없음 값을 원할 경우, 특성 시트(sheet) 편집기에서 코드 특성을 선택하고 '서비스 핸들러:' 단일 선택 단추를 선택하십시오. 그런 다음 드롭다운 메뉴 목록 박스에서 '<없음>'을 선택하십시오. 16.0 수행 단추 고려 사항 일부 조건 하에서 수행 단추를 누르면 웹 서버 시작전에 검색기가 시작됩니다. 이러한 상황이 발생하면, 간단히 서버 시작후 다시 수행 단추를 누르십시오. 버전 2.0.3에서 configuration.properties 파일의 serverPollingCount 옵션을 서버 시작을 기다리는 데 소요되는 최대 시간을 증가시키도록 조정할 수 있습니다. VisualAge 클래스가 필드를 추가하여 변경된 경우, 해당 클래스와 관련된 모든 프로세스는 종료됩니다. 따라서 서블릿에서 수행 단추를 눌러 웹 서버를 시작하고 서블릿을 변경한 후 재저장할 경우, 서버 프로세스가 then 종료될 수 있습니다. 이를 방지하려면, 변경하지 않을 기타 비주얼 서블릿 또는 샘플에 대한 수행 단추를 누르십시오. 그러면 작업 중인 서블릿이 변경될 때 서버가 종료됩니다.