4. (eclipse)웹서비스 프로젝트 생성 샘플 1 - Server용 (axis2)

* (eclipse)웹서비스 프로젝트 생성 샘플 1 - Server용 (axis2) *

* (eclipse)웹서비스 프로젝트 생성 샘플 1 - Client용 (axis2) *

 

1. 환경

    -  jdk : 17.0.2
    - eclipse : Version:2021-12(4.22.0),    Build id : 20211202-1639
    - axis2 : axis2-1.7.9
    - tomcat 9.0.8

 

    - 실재 프로젝트에선 VO를 받고, VO를 return하는 경우로 진행하기 때문에 이와 같이 개발.

 

2. download

    - axis2 : new http://axis.apache.org/axis2/java/core/download.cgi 

               old : https://archive.apache.org/dist/axis/axis2/java/core/

 

    - 아래 샘플용 프로젝트 

              o 소스용 war 파일 다운로드

axis2Server.war

0.31MB

                o /WEB-INF/lib/  하위 jar 파일들은   파일 용량이 10M 이상으로 위 war파일에 존재 하지 않음

                  Project를 구축하고 axis2 환경설정으로 하면 필요한 jar들은 자동 생성 된다.

 

3. eclipse  환경설정

    a. download받은 axis2-1.8.0-bin.zip  파일을 압축 해제
    b. eclipse > Windows > Preferences > Web Services > Axis2 Preferences 에 폴더 위치 설정

 

3. Project생성 및 Project 환경설정

   a. Project생성 - Server용

   b. Project에서 axis2 server용 환경설정
      -  이 과정은 webservice개발중 server용인 경우에만 수행

     - axis2 환경설정 후 Project 구성 결과

   c. web.xml

       - 상단 아래와 같이 (;) 콜론을 삽입한다.

   d. jar 복사
      - C:\axis2\axis2-1.7.9-bin\lib\xmlschema-core-2.2.1.jar  파일을 

                >> Project > /webapp/WEB-INF/lib  밑으로 복사 한다.

       - jstl-1.2.jar 파일 웹상에서 download 후 
                >> Project > /webapp/WEB-INF/lib  밑으로 복사 한다.
                >> 이 jar를 복사 해야 jsp파일에서  (x) 표시 오류가 없어 진다.

jstl-1.2.jar

0.40MB

5. axis2  Server 정상 구동 확인

   a. tomcat start
   b. http://localhost:8080/axis2Server/axis2-web/  수행하면  아래 와 같은 화면이 나오면 정상

 

6. webservice 서버소스 개발

    - 업무내용 : client단에서 입사일자(from~to)를 받아
                    자료를 조회 후
                    해당 결과를 client로 넘겨 준다.
    - 소스 목록 : EmpRequestVO.java     - client단에서 넘겨받은 parameter를 받을 VO
                     EmpRecordVO.java       - 사원 검색결과를 저장할 vo.
                     EmpResponseVO.java    - client로 넘겨줄 vo
                                                       사원 검색결과는 여러건이 된다.  배열로 객체를 생성 후 set한다.

                     EmpSearchCmd.java      - web service 호출될 main java

                     EmpSearchBiz.java         - 업무 개발용 Biz

      - 소스 내용 : 하단에 존재  

 

7. wsdl 파일 생성

    a. 첫번째 단계

       EmpSearchCmd.java  파일 선택
       > 오른쪽 마우스 클릭 
       > Web Services > Create Web Service

    b. 첫번째 단계 결과

        - /WEB-INF/services/ 하위로 아래와 같이  폴더 및 파일이 생성 된다.

    c. 두번째 단계

       

 

               > 페이지 소스 보기
               > Ctrl + A > Ctrl + C
               > EmpSearch.wsdl  파일 생성 후  붙여 넣기
                  (참고, 저장 시 상단 첫줄, 하단 마지막줄  빈 줄은 삭제 한다.)

               > EmpSearch.wsdl 파일을 client개발자에게 전달한다.

 

    d. 자동생성된 services.xml 파일 보정

        - 위치 : /webapp/WEB-INF/services/EmpSearchCmd/META-INF/services.xml

[변경 전] <messageReceivers> <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-only" class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver" /> <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out" class="org.apache.axis2.rpc.receivers.RPCMessageReceiver"/> </messageReceivers> [변경 후] <messageReceivers> <messageReceiver mep="http://www.w3.org/ns/wsdl/in-only" class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver" /> <messageReceiver mep="http://www.w3.org/ns/wsdl/in-out" class="org.apache.axis2.rpc.receivers.RPCMessageReceiver"/> </messageReceivers>

 

 

99. 소스 내용

   - EmpRequestVO.java

   package com.webservice.server.emp; //client에서 받은 request param vo public class EmpRequestVO { private String searchStDt; private String searchEdDt; public String getSearchStDt() { return searchStDt; } public void setSearchStDt(String searchStDt) { this.searchStDt = searchStDt; } public String getSearchEdDt() { return searchEdDt; } public void setSearchEdDt(String searchEdDt) { this.searchEdDt = searchEdDt; } }

  - EmpRecordVO.java

   package com.webservice.server.emp; public class EmpRecordVO { private String empId; private String empNm; public String getEmpId() { return empId; } public void setEmpId(String empId) { this.empId = empId; } public String getEmpNm() { return empNm; } public void setEmpNm(String empNm) { this.empNm = empNm; } }

  - EmpResponseVO.java

   package com.webservice.server.emp; public class EmpResponseVO { private EmpRecordVO[] empRecordVO; private String resultCode; private String resultMessage; public EmpRecordVO[] getEmpRecordVO() { return empRecordVO; } public void setEmpRecordVO(EmpRecordVO[] empRecordVO) { this.empRecordVO = empRecordVO; } public String getResultCode() { return resultCode; } public void setResultCode(String resultCode) { this.resultCode = resultCode; } public String getResultMessage() { return resultMessage; } public void setResultMessage(String resultMessage) { this.resultMessage = resultMessage; } }

  - EmpSearchCmd.java

   package com.webservice.server.emp; public class EmpSearchCmd { public EmpResponseVO searchEmp(EmpRequestVO param) { EmpSearchBiz biz = new EmpSearchBiz(); EmpResponseVO resVO = new EmpResponseVO(); try { //1. 목록조회 resVO = biz.searchEmpList(param); return resVO; } catch (Exception e) { String errMsg = e.getMessage(); System.out.println("EmpSearchCmd exception:" + errMsg); resVO.setResultCode("F"); resVO.setResultMessage(errMsg); return resVO; } } }

  - EmpSearchBiz.java

    package com.webservice.server.emp; public class EmpSearchBiz { public EmpResponseVO searchEmpList(EmpRequestVO param) throws Exception { System.out.println("webservice Server start.............."); EmpResponseVO resVO = new EmpResponseVO(); //1. 자료 강제 생성 int resultCnt = 2; EmpRecordVO[] arrRecVO = new EmpRecordVO[resultCnt]; for(int i=0; i<resultCnt; i++) { EmpRecordVO recVO = new EmpRecordVO(); recVO.setEmpId(Integer.toString(100+i)); recVO.setEmpNm(Integer.toString(i) + " 성명"); arrRecVO[i] = recVO; } resVO.setEmpRecordVO(arrRecVO); resVO.setResultCode("S"); resVO.setResultMessage("SUCCESS"); System.out.println("webservice Server end.............."); return resVO; } }

 

 

* 웹서비스 프로젝트 생성 샘플 1 - Client용 (axis2) *

* 개발도중 오류 발생 시 해결방법 *