농부지기

* 웹서비스 프로젝트 구축방법론 *

.

1. 정의

   - 웹서비스를 구축하려고 하려고 하면 웹서비스와 관련된 java 소스를 개발해야 된다.

     이 웹서비스용 java소스를 어디에 구축 하는게 좋을지 나름 내 생각을 정리 했다.

   - 2일동안 테스트 해본 결과물이다. 

2. 아래 설명을 보기 전 선행 학습

   - 웹서비스 서버(Server)단 구축 예제 샘플 따라 하기

   - 웹서비스 클라이언트(Client)단 구축 예제 샘플 따라 하기

3. axis2를 이용해서 webservice 정상 환경 

   a. eclipse : Indigo  (Build id : 20120216-1857)
      jdk : 1.6.0_45
      tomcat : 6.0
      axis2 : 1.7.9
   b. eclipse : Helios (Build id : 20100917-0705)
      jdk : 1.6.0_45
      tomcat : jeus 6.0
      axis2 : 1.6.2 ~ 1.7.9 까지 모두 가능

   c. eclipse : 2021-12 (4.22.0)
      jdk : 17.0.2
      tomcat : tomcat 9.0
      axis2 : 1.7.9

4. 웹서비스 서버(Server)단 구축 프로젝트

    a. 예, 기 존재 하는 인사급여 프로젝트(hr)에 웹서비스를 구축하다고 생각 하고 설명

       o  웹서비스 목록 : 부서조회, 사원조회

       > eclipse에 hr 프로젝트가 존재 한다.

       > hr 프로젝트에  서버용 웹서비스 java 파일을 만들어 /src/java/main/webservice/EmpSearch.java 을 만들었다.

       > EmpSearch.java 파일 -> wizard를 이용해  webservice를 생성한다.

       > wizard 결과물로 : /webapp/WEB-INF/services/....    하위폴더에 

                                 웹서비스와 관계가 없는 hr 프로젝트 모든 java 소스가 compile되어 생성된다.

                                 물론, 이때 EmpSearch.java 와 관련 없는 hr 업무 class들은 모두 삭제 하면 된다.

                                 하지만, 개발 하다보면 여러번 수정등을 해야 하기 때문에 삭제도 계속 해줘야 된다.

     b. 결론,

        - 웹서비스 서버(Server)용 소스는 별도 프로젝트를 만들어서 진행한다.

        - 업무용 hr 프로젝트 별개로 hrWS 프로젝트를 만들어

           이곳에 EmpSearch.java(웹서비스 서버용 소스)를 개발한다.

        - 참고, 부서 검색용 웹서비스가 필요하게 되면 DeptSearch.java도 개발 해야 된다.

           이때 DeptSearch.java 파일을 이용해 webservice를 생성하게 되면 Empsearch.class들도 생성 된다.

           EmpSearch관련된 package들을 삭제 하면 된다.

      c. 테스트된 Project로 확인

         * 아래 이미지를 보면

           - DeptSearchCmd.java , EmpSearchCmd.java  2개의 서버용 웹서비스가 존재한다.

           - DeptSearchCmd.java , EmpSearchCmd.java 2개 각각 > create web service wizard를 통해 진행한다.

           - 결과물로 > /WEB-INF/services/  하위로 각각 생성된다.

           - 이때, 이슈 

              o /WEB-INF/services/DeptSearchCmd/ 하위로는  부서검색 웹서비스용인데, emp class들도 생성된다.

                 /WEB-INF/services/EmpSearchCmd/ 하위로는  사원검색 웹서비스용인데, dept class들도 생성된다.

              o 그래서 필요없는 폴더들을 각각 삭제해줘야 된다.

                 삭제 안해도 되지만, 사용하지 않고 존재 하는 class들이기 때문에 삭제하는게 유지보수상 편하다.

           ** 최종 결론 : 이와 같은 이유로 웹서비스 서버단 소스들은 별로 프로젝트를 만들어서 개발하는게 좋을거 같다.

5. 웹서비스 클라이언트(Client)단 구축 프로젝트

     a. 웹서비스 클라이언트(Client)단 소스를 개발 시 별도 프로젝트를 만들어서 진행하는게 좋다.

     b. 서버단에서 받은 wsdl 파일을 이용해 

        generate web service client  Wizard를 이용해 stub.java 파일을 생성하게 되는데

        이때 필요없는 jar, 폴더등이 생성된다.

        필요없는 jar, 폴더등을 삭제 해도 되지만, 

        wsdl파일이 여러번 수정되게 되면 삭제 작업도 여러번 해줘야 된다.

     c. Generate web service client  Wizard로 자동 생성된 폴더 구조 (전 -> 후)

         - 오른쪽 이미지 (wizard 처리 후)

         - web service Client프로젝트에서는 자동생성된 폴더들은 모두 사용되지 않는다.

            만약, 업무용 프로젝트에 아래 같은 폴더들이 생성된다면.. 매번 삭제하기도 힘들고

            삭제하지 않는다면.. 유지보수 하기도 힘들어 진다.

         - 결론, Web Service Client 소스들은 별도 프로젝트를 만들어서 관리하는게 좋을거 같다.

                   이때는 필요없는 폴더들은 삭제하지 않아도 될거 같다.

                   딱 client source들만 있기 때문이다.

.

* axis2 Webservice 오류 모음집 *

1. Tomcat start 도중 오류

   a. 오류 : java.lang.ClassNotFoundException: javax.servlet.http.HttpServlet

      발생시점 : tomcat start시점

      사유 : Server용 웹서비스는 tomcat10.0 일 경우 위와 같은 오류 발생

      해결 : tomcat 9 version을 사용

   b. 오류 : java.lang.ClassNotFoundException: javax.activation.DataSource

      발생시점 : tomcat start시점

      사유 : Server용 웹서비스는 axis2 1.8.0 version에서 위와 같은 오류 발생

      해결 : axis2 1.7.9 version을 사용

   c. 오류 : SEVERE: StandardWrapper.Throwable
                java.lang.NoClassDefFoundError: org/apache/ws/commons/schema/resolver/URIResolver.

      발생시점 : tomcat start시점

      사유 : project에 webservice 환경 구축 도중 xmlschema-core-2.2.1.jar 파일이 자동 복사 되지 않아 발생

      해결 : C:\axis2\axis2-1.7.9-bin\lib\xmlschema-core-2.2.1.jar  파일을 

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

2. java소스를 이용해서 'Create Web Service' Wizard 수행중 오류 

   a. 오류 : Exception occurred while reading or writing file {0} The Axis2 facets cannot be installed since the Axis2 runtime location has not been set.

               Go to the Web Services preference page and set the Axis2 runtime location under Axis2 Preferences.

   b. 사유 : eclipse에 Axis2 rentime이 연결되어 있지 않아서 발생

   c. 해결 : eclipse

               -> Window > Preferences

               -> Web Services > Axis2 Preferences > Axis2 Runtime tab.

               -> Axis2 runtime location [ axis2 folder 연결  ] 

3. wsdl 파일을 이용해 stub 소스 생성 도중 오류

   a. 오류 : The Apache Axis2 Web service runtime in Tomcat v10.0 Server does not support the client project axis2Client.

       발생시점 : wsdl 파일을 이용해 Generate Client Wizard 수행 시

       해결 : Dynamic Web Module Version 으로  2.5 또는 2.4 로 변경한다. (3.0도 가능할 듯)

4. 자동생성된 stub.java 소스에서 compile 오류

   a. 오류1 : The package javax.xml.namespace is accessible from more than one module: <unnamed>, java.xml

      오류2 : The package javax.xml.stream is accessible from more than one module: <unnamed>, java.xml 

      발생시점 : wsdl 파일을 이용해 Generate Client Wizard 수행 시 후 생성된 stub.java 소스

      사유 : javax.xml....  class가  2개의 jar에서 존재

              (jdk에 존재 하는 jar)와,  (jaxrpc.jar,   geronimo-stax-api_1.0_spec-1.0.1.jar)

      해결 : jaxrpc.jar,   geronimo-stax-api_1.0_spec-1.0.1.jar   이 2개의 jar 삭제

5. client에서 Server 호출도중 오류

   a. 오류 : The ServiceClass object does not implement the required method in the following form: OMElement searchEmp(OMElement e)

       발생시점 : client에서 Server호출도중 오류

       사유 : server단 프로젝트 > .. > services.xml

                자동 생성된 services.xml 파일 내부 내용 중 경로가 잘 못 되어 있다.

        해결방법 : 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>

6. Webg Service Client Wizard 수행 중

   a. 오류 : 아래 이미지처럼 - Service Name, Port Name, Custom package name 등이 공백으로 보여짐

      오류내용 : Exception occurred during code generation for WSDL  : null
    java.lang.NullPointerException: Cannot invoke "java.lang.Class.getConstructor(java.lang.Class[])" because "WSDL11ToAxisServiceBuilderClass" is null

      해결방법 : 1. Preferences > Axis2 Preferences > Axis2 runtime location [ ] 위치를 지운 후

                        eclipse restart

                     2. C:\axis2\axis2-1.7.9-bin\  하위 파일들을 삭제 후  [axis2-1.7.9-bin.zip] 다시 압축 해제

                        Preferences > Axis2 Preferences > Axis2 runtime location [ ] 위치를 지운 후

                        eclipse restart

        이유 : 특정한 환경에서 갑자기 eclipse가 이상작동함

* SoapUI 설치 및 Webservice server테스트 *

1. 정의

    - client project를 개발하지 않고도 webservice server project를 호출하여 테스트 할 수 있다.

2. 다운로드

    - Soap UI Pro 버전은 유료

    - Soap UI Open Source 버전은 무료 (?)  (2022.02.04일 기준 파일명 : SoapUI-x64-5.7.0.exe)

    - 다운로드 URL

3. 설치 방법

    - SoapUI-x64-5.7.0.exe 파일 실행

    - 실행 후  몇 단계는 [next]

     - Soap UI만 설치.  나머진 해제

4. Web Service 테스트

   - New SOAP Project 생성

      . Initial WSDL 경로 찾는 방법 : 아래에 존재

5. Initial WSDL 경로 찾아 내기

    a. web service Server Project 수행 (http://localhost:8080/axis2Server/axis2-web/)

                  - 테스트를 원하는 Webservice 클릭

           - 아래처럼 : wsdl 파일 내용(xml)이 보이는 경로를 Soup UI의 Initial wsdl 파일 경로가 된다

6. 위에서 테스트 했던 webservice server용 Project

     - Project 내용 보러 가기

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

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

1. 환경

    -  jdk : 17.0.2
    - eclipse : Version:2021-12(4.22.0),    Build id : 20211202-1639
    - axis2 : axis2-1.7.9
    - tomcat : 10.0.16  (9.0.8 도 가능) (9 버전으로 테스트 하는게 도 용이)

    - 실재 프로젝트에선 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 파일 다운로드

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

                  Project를 구축하고 wsdl 파일을 이용해서 stub.java파일을 만들면 필요한 jar들은 자동 생성 된다.

3. eclipse  환경설정

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

3. Project생성 및 Project 환경설정

    a. Project생성 - Client용

 b. web.xml

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

   c. 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) 표시 오류가 없어 진다.

4. wsdl 파일을 이용해서 stub 파일 생성

    a. Client 개발팀으로 부터 wsdl 파일을 받는다.
       wsdl 파일은  생성한 프로젝트에 적당한 폴더를 생성 후 복사 한다.

    b. stub 파일 생성
        > EmpSearch.wsdl 
        > 오른쪽 마우스 클릭
        > Web Services
        > Generate Client

        c. 자동생성된 stub.java 위치 이동

            - stub.java 소스가 /src/main/java  package 하위로 생성되어야 하는데 /java/ 밑으로 생성 된다.

            - /src/main/java/... 밑으로 이동 시킨다.

            - 이동 후 stub.java소스에 오류가 발생 하면 
               jaxrpc.jar,   geronimo-stax-api_1.0_spec-1.0.1.jar   이 2개의 jar를 삭제 한다.

            - 예전 eclipse에서는 정상적으로 /src/ package 하위로 생성 된다.

     d. web.xml 파일 수정

        - web.xml 파일 내부에 client project에서 필요없는 tag들을 삭제 한다.

        - wizard를 이용해 stub.java 파일이 생성되는대

          이때 web.xml 파일 내부에 webservice server용 tag들이 추가 된다.

          client용 project에서는 필요가 없다.

        - 삭제내용 : Aixs 관련 tag들을 삭제 한다.

5. webservice client 소스 목록

    - WebServiceCall.java : stub.java 소스를 활용하여 서버 호출 등을 담당하는 client main java source

    - EmpSearchCmdStub.java : eclipse > Webservice Generate Client Wizard를 이용해 생성된 client stub java source

6. 테스트 및 결과

    - Tomcat10, Tomcat9 2개의 was를 사용시 port를 반드시 중복되지 않게 수정해야 된다.

    - WebServiceCall.java > 오른쪽 마우스 > Run As > 2. Java Application

9. 소스 내용

    - EmpSearchCmdStub.java 소스는 자동생성된 파일이기에 생략

    - WebServiceCall.java

    - targetEndpoint 찾는방법 : 위쪽 이미지중 Generate Client Wizard 마지막 단계에서

                                        /Service Name/Port Name 을 기준으로 만들면 된다.

package com.webservice.server.emp; import java.rmi.RemoteException; public class WebServiceCall { public static void main(String[] args) { webServiceCall(); } public static void webServiceCall() { String targetEndpoint = "http://localhost:8080/axis2Server/services/EmpSearchCmd.EmpSearchCmdHttpSoap12Endpoint/"; try { EmpSearchCmdStub stub = new EmpSearchCmdStub(targetEndpoint); //1. Authenticator /* 권한 이 필요한 경우 아래와 같이 기술 HttpTransportPropertiesImpl.Authenticator auth = HttpTransportPropertiesImpl.Authenticator(); auth.setUsername("username"); auth.setPassword("password"); final Options clientOptions = stub._getServiceClient().getOptions(); clientOptions.setProperties(HTTPConstants.AUTHENTICATE, auth); */ //2. request parameter 생성 // - EmpSearchCmdStub : 서버단 call되는 java명 + Stub EmpSearchCmdStub.EmpRequestVO empRequestVO = new EmpSearchCmdStub.EmpRequestVO(); empRequestVO.setSearchStDt("20220101"); empRequestVO.setSearchEdDt("20221231"); //3. request parameter set // - EmpSearchCmdStub.SearchEmp : EmpSearchCmdStub.method명 EmpSearchCmdStub.SearchEmp request = new EmpSearchCmdStub.SearchEmp(); request.setParam(empRequestVO); //4. server call EmpSearchCmdStub.SearchEmpResponse response = stub.searchEmp(request); //5. 결과값 얻기 EmpSearchCmdStub.EmpResponseVO ifResult = response.get_return(); //6. log int cnt = ifResult.getEmpRecordVO().length; System.out.println("resultCode=>" + ifResult.getResultCode()); System.out.println("resultMessage=>" + ifResult.getResultMessage()); System.out.println("result count=>" + cnt); if (cnt > 0) { for(int i=0; i<cnt; i++) { EmpSearchCmdStub.EmpRecordVO recVO = ifResult.getEmpRecordVO()[i]; //arrRecVO[i]; //new EmpSearchCmdStub.EmpRecordVO(); System.out.println("empRecordVO.emp id=>" + recVO.getEmpId()); System.out.println("empRecordVO.emp name=>" + recVO.getEmpNm()); } } } catch (RemoteException e) { e.printStackTrace(); } } }

* 웹서비스 프로젝트 생성 샘플 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 파일 다운로드

                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) 표시 오류가 없어 진다.

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) *

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

* 웹서비스 SOAP방식-Server단 개발 (* 별도 war 배포방식) *

1. 별도 war 배포방식
   a. 정의
      1. 구글 검색을 통해서 Server단 개발방법을 보면 axis2를 배포하면서 웹서비스 목록을 보여주는 방식이다.
         예)http://egloos.zum.com/js7309/v/10644853
         하지만 이번 war배포방식은 기존 프로젝트와 관계 없이 별도 프로젝트를 생성해서 개발 후 war파일을 만들어 배포하면 된다.
         꼭 별도 프로젝트를 만들지 않고 기존 프로젝트 내부에 개발해도 된다.
   b. war를 만들기 위해 ant를 이용(아래에서 설명)
   
2. 웹서비스 server단 개발방법 및 절차
   a. 별도 Web Dynamic Project생성
      - Project생성도중  [ ] Aixs2 Web Services는 체크 안해도 된다.
   b. client단에서 호출시 필요한 자료를 전송해줄 server단 업무 소스(java)개발
      - 기본개발소스
        . Cmd : client단에서 soap을 이용해서 처음 호출 되는  server단 java source
        . Biz : server단 개발업무 소스
        . ReqeustVO : client에서 호출시 필요한 argument
        . ResponseVO : client단에서 호출시 넘겨받은 argument를 이용해

                            db에서 자료를 조회 후 setting할 VO. 이 vo를 client로 넘겨준다.
        . RecordVO : 만약, client단으로 자료를 넘겨줄 경우 여러레코드가 존재 할 경우 해당 되는 VO
   c. war파일을 만들기 위한 폴더 구조
      - soapWar - aar
                - axis2_war - axis2

                                      ....

                                      - WEB/INF/services

                                      ....
                            - EmpWebServices
                            - war_app
                            - war_dev
                            - war_local
                - META-INF
                - wsdl
                - ant_build_prod.xml
                  ant_build_dev.xml
                  ant_build_local.xml

3. war파일을 만들기 위한 폴더 구조 설명
      - soapWar - aar                        : war파일 만들기 전 웹서비스 aar 압축파일 위치하는 곳

                                                   이 aar압축파일 내부에 server단 class파일들이 포함되어 있다.
                - axis2_war - axis2          : axis2.war 파일을 압축해제된 폴더 및 파일들을 위치 시킴
                                      ....

                                      - WEB/INF/services : 배포될 aar파일 위치 (예, EmpWebServices.aar )

                                      ....

                            - EmpWebServices : 임시용. java 파일을 컴파일을 class파일을 들을 위치시킬 폴더
                            - war_prod       : 운영서버에 배포할 war파일이 위치할 폴더
                            - war_dev        : 개발서버에 배포할 war파일이 위치할 폴더
                            - war_local      : 로컬서버에 배포할 war파일이 위치할 폴더
                - META-INF                   : 웹서비스 목록 및 java package경로
                - wsdl                       : 임시용. server단 개발자에게 넘겨줄 wsdl을 위치시킬 폴더
                - ant_build_prod.xml         : 운영서버에 배포할 war파일 생성용 ant builder
                  ant_build_dev.xml          : 개발서버에 배포할 war파일 생성용 ant builder
                  ant_build_local.xml        : 로컬서버에 배포할 war파일 생성용 ant builder

4. 아래는 소스
   1. Server단 소스
   2. /META-INF/services.xml 파일
   3. /axis2_war/axis2/WEB-INF/web.xml
   4. ant_build_local.xml   (ant설명은 별도 카테고리에 존재)

5. ant파일 실행 과정
   1. java소스 컴파일시 필요한 jar파일 위치 설정
   2. class파일들이 위치할 필요한 폴더들 생성
   3. java소스 컴파일
   4. 컴파일된 class파일들을 *.aar 압축
   5. *.aar파일을 특정위치로 copy
   6. *.war압축파일 생성

6. Server단 소스

//1. Command 단 public class EmpCmd { public EmpResponseVO getContryAreaList(EmpRequestVO param) { EmpBiz biz = new EmpBiz(); EmpResponseVO resVO = new EmpResponseVO(); try { //1. 목록조회 resVO = biz.getContryAreaList(param); return resVO; } catch (Exception e) { String errMsg = e.getMessage(); System.out.println("ContryAreaCmd exception:" + errMsg); resVO.setResultCode("F"); resVO.setResultMessage(errMsg); return resVO; } } } //2. Biz 단 public class EmpBiz { public EmpResponseVO getContryAreaList(EmpRequestVO param) throws Exception { EmpResponseVO resVO = new EmpResponseVO(); LData data = new LData(); //1. 조회조건 얻기 (client에서 넘겨받은 VO를 LData객체로 변환) WebserviceUtil.moveVoToLData(param, data); //2. 필수값 처리 String[][] essentialCol = {{"searchStDt", ":조회시작일"},{"searchEdDt",":조회종료일"}}; String rtnMsg = WebserviceUtil.checkEssentialCol(essentialCol, data); if (rtnMsg != null && !"".equals(rtnMsg)) { throw new LBizException(rtnMsg); } //3. 자료조회 LCommonDao dao = new LCommonDao("/emp/EmpListRetrieve",data, "TESTDB"); LMultiData result = dao.executeQuery(); //4. db에서 조회된 LMultiData를 EmpRecordVO[]로 변환 int recCnt = result.getDataCount(); EmpRecordVO[] arrRecVO = new EmpRecordVO[recCnt]; WebserviceUtil.moveLMultiDataToVo(result, arrRecVO); resVO.setContryAreaRecVO(arrRecVO); resVO.setResultCode("S"); resVO.setResultMessage("SUCCESS"); return resVO; } } //3. client에서 받은 request param vo public class EmpRequestVO implements Serializable { private String searchStDt; private String searchEdDt; // 하단에 setting, getting 생량 } //4. client로 넘겨줄 response vo public class EmpResponseVO { private EmpRecordVO[] contryAreaRecVO; private String resultCode; private String resultMessage; public EmpRecordVO[] getContryAreaRecVO(){ return contryAreaRecVO; } public void setContryAreaRecVO(EmpRecordVO[] contryAreaRecVO){ this.contryAreaRecVO = contryAreaRecVO; } // 하단에 setting, getting 생량 } //5. 레코드 public class EmpRecordVO implements Serializable { private String empId; private String empNm; // 하단에 setting, getting 생량 } import java.lang.reflect.Field; import java.lang.reflect.Method; import devon.core.collection.LData; import devon.core.collection.LMultiData; /** * 6. webservice 공통 유킬 * */ public class WebserviceUtil { public static final String JNDI_NAME = "empDS"; public static final String MSG_REQUIRED = " is required."; //(는)은 필수항목입니다. public static final String INIT_OFFSET = "1"; //default offset(page index) public static final String INIT_LIMIT = "20"; //default limit (page row size) public static void main2(String[] args){ /* 2. method name, field name test */ //EmpRequestVO[] vo = new EmpRequestVO[10]; //LMultiData result = null; //setLDataWithVO(vo, result); } /* * VO 객체를 LData 객체로 전환 */ public static void moveVoToLData(Object vo, LData data) throws Exception { Class<?> voClass = vo.getClass(); Field[] fields = voClass.getDeclaredFields(); try { for(int idx=0; idx<fields.length; idx++) { String member = fields[idx].getName(); Field field = voClass.getDeclaredField(member); field.setAccessible(true); Class<?> type = field.getType(); Object val = field.get(vo); if (val != null && !"".equals(val)) { field.set(vo, val); if (type.equals(int.class)) { data.setInt(member, (Integer)val); } else if (type.equals(String.class)) { data.setString(member, (String)val); } //주의 : class member변수 주의 } } } catch (Exception e) { e.printStackTrace(); throw e; } } /* * LData값을 VO객채로 전환 */ public static void moveLDataToVo(LData data, Object vo) throws Exception { Class<?> voClass = vo.getClass(); Field[] fields = voClass.getDeclaredFields(); try { for(int idx=0; idx<fields.length; idx++) { String member = fields[idx].getName(); Field field = voClass.getDeclaredField(member); field.setAccessible(true); Class<?> type = field.getType(); if (type.equals(int.class)) { int val = data.getInt(member); field.set(vo, val); } else if (type.equals(String.class)) { field.set(vo, data.getString(member)); } //주의 : class member변수 주의 } } catch (Exception e) { e.printStackTrace(); throw e; } } /* * LMultiData값을 VO객채로 전환 */ public static void moveLMultiDataToVo(LMultiData mData, Object[] vo) throws Exception { //Class<?> voClass = vo.getClass(); String classNm = vo.getClass().getName().replace("[L", "").replace("[", "").replace(";", ""); int recCnt = mData.getDataCount(); try { for(int row=0; row<recCnt; row++) { LData oneData = mData.getLData(row); Class<?> oneVo = Class.forName(classNm); Object voObj = oneVo.newInstance(); Field[] fields = oneVo.getDeclaredFields(); for(int idx=0; idx<fields.length; idx++) { String member = fields[idx].getName(); String methodNm = "set" + upperCaseFirst(member); Field field = oneVo.getDeclaredField(member); Class<?> type = field.getType(); if (type.equals(int.class)) { Method method = oneVo.getDeclaredMethod(methodNm, int.class); method.invoke(voObj, oneData.getInt(member)); } else if (type.equals(String.class)) { Method method = oneVo.getDeclaredMethod(methodNm, String.class); method.invoke(voObj, oneData.getString(member)); } //주의 : class member변수 주의 } vo[row] = voObj; } } catch (Exception e) { e.printStackTrace(); throw e; } } /* * Param으로 받은 페이징값을 Ldata에 Set */ @SuppressWarnings({ "unchecked", "rawtypes" }) public static void setPageProperty(Object vo, LData data) throws Exception { Class voClass = vo.getClass(); try { Method methodOffset = voClass.getMethod("getOffset"); Method methodLimit = voClass.getMethod("getLimit"); String sOffset = (String)methodOffset.invoke(vo); String sLimit = (String)methodLimit.invoke(vo); // if (sOffset == null || "".equals(sOffset)) { sOffset = INIT_OFFSET; } if (sLimit == null || "".equals(sLimit)) { sLimit = INIT_LIMIT; } int iOffset = Integer.parseInt(sOffset)-1; int iLimit = Integer.parseInt(sLimit); int startRowIdx = iOffset * iLimit + 1; data.setString("devonTargetRow", String.valueOf(startRowIdx)); //start row index data.setString("pagingSpec" , sLimit); //페이지당 조회 row수 data.setString("devonRowSize" , sLimit); //data.setString("pageNumber", String.valueOf(offSet)); //페이지 index } catch (Exception e) { e.printStackTrace(); throw e; } } /* * 조회조건 필수 항목 검사 */ public static String checkEssentialCol(String[][] essentialCol, LData data) { for(String[] arrOne : essentialCol) { String val = data.getString(arrOne[0]); if (val == null || "".equals(val)) return arrOne[1] + WebserviceUtil.MSG_REQUIRED; } return null; } /* * 문자열에서 첫글자만 대문자로 변경 */ public static String upperCaseFirst(String val) { char[] arr = val.toCharArray(); arr[0] = Character.toUpperCase(arr[0]); return new String(arr); } }

7. /META-INF/services.xml 파일 (웹서비스가 2개 인경우 예제)

<serviceGroup> <service name="EmpList" > <Description>1. 사원목록조회</Description> <messageReceivers> <messageReceiver mep="http://www.w3.org/ns/wsdl/in-out" class="org.apache.axis2.rpc.receivers.RPCMessageReceiver"/> </messageReceivers> <parameter name="ServiceClass" locked="false">webserver.server.emp.EmpCmd</parameter> </service> <service name="CustList" > <Description>2. 거래처목록조회</Description> <messageReceivers> <messageReceiver mep="http://www.w3.org/ns/wsdl/in-out" class="org.apache.axis2.rpc.receivers.RPCMessageReceiver"/> </messageReceivers> <parameter name="ServiceClass" locked="false">webserver.server.emp.CustCmd</parameter> </service> </serviceGroup>

8. /axis2_war/axis2/WEB-INF/web.xml

<?xml version="1.0" encoding="ISO-8859-1"?> <web-app xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" version="2.5"> <display-name>Apache-Axis2</display-name> <servlet> <display-name>Apache-Axis Servlet</display-name> <servlet-name>AxisServlet</servlet-name> <servlet-class>org.apache.axis2.transport.http.AxisServlet</servlet-class> <load-on-startup>1</load-on-startup> </servlet> <servlet> <display-name>Apache-Axis AxisAdmin Servlet (Web Admin)</display-name> <servlet-name>AxisAdminServlet</servlet-name> <servlet-class>org.apache.axis2.webapp.AxisAdminServlet</servlet-class> </servlet> <!-- 위쪽에 반드시 필요한 servlet만 기술했음 --> <!-- 아래쪽에 더 많은 tag들이 위치하지만 게시글에서는 삭제 했음. axis2.war파일 압축해제 하면 web.xml 파일 거의 그대로 사용하면 됨 --> </web-app>

9. ant_build_local.xml

<!-- * EmpWebservices.war : 파일 만드는 용도 * 로컬,개발,운영 다른점 1. 경로 <property name="system" value="_local" /> <property name="system" value="_dev" /> <property name="system" value="_app" /> 2. 로컬 : war를 /JEUS6.0/webhome/autodeply/ 밑으로 복사한다. 개발,운영 : war를 복사하지 않는다. (개발,운영서버에 배포) <copy file="${war.dir}/${war.name}" toFile="C:/TmaxSoft/JEUS6.0/webhome/autodeploy/${war.name}" overwrite="true"/> --> <project name="EmpWebservices(war)-1.7.9(local)" basedir="." default="java.xml.rename"> <property environment="env"/> <property name="axis2.home" value="${env.AXIS2_HOME}" /> <property name="proj.webinf" value="../war/WEB-INF" /> <property name="src.main.dir" value="webserver" /> <property name="src.sub.dir" value="server" /> <property name="service.name" value="EmpWebservices" /> <property name="system" value="_local" /> <!-- 로컬 --> <!-- <property name="system" value="_dev" /> --> <!-- 개발 --> <!-- <property name="system" value="_app" /> --> <!-- 운영 --> <property name="axis2.root.dir" value="axis2_war" /> <property name="war.dir" value="${axis2.root.dir}/war${system}" /> <!-- war파일위치--> <property name="war.name" value="EmpWebservices.war" /> <property name="dest.dir" value="axis2_war/${service.name}/build" /> <property name="aar.dir" value="aar" /> <!-- .aar 기본생성될 경로 --> <property name="dest.dir.classes" value="${dest.dir}/classes" /> <property name="axis2.files.dir" value="axis2_war/axis2" /> <property name="axis2.web.xml.dir" value="axis2_war/axis2/WEB-INF/" /> <!-- web.xml 경로 --> <property name="axis2.aar.dir" value="axis2_war/axis2/WEB-INF/services" /> <!-- axis2.war 내부에 .aar 파일 위치할 경로 --> <path id="build.class.path"> <fileset dir="${proj.webinf}/lib"> <include name="*.jar" /> </fileset> <pathelement location="${dest.dir.classes}" /> </path> <target name="clean"> <delete dir="${dest.dir}" /> </target> <target name="prepare"> <mkdir dir="${dest.dir}" /> <mkdir dir="${dest.dir.classes}" /> <mkdir dir="${dest.dir.classes}/META-INF" /> <mkdir dir="${aar.dir}" /> </target> <!-- Webservices.aar 파일 생성 --> <target name="generate.aar"> <copy file="META-INF/services.xml" tofile="${dest.dir.classes}/META-INF/services.xml" overwrite="true" /> <javac srcdir="../src" destdir="${dest.dir.classes}" includes="${src.main.dir}/${src.sub.dir}/**" classpathref="build.class.path"></javac> <jar basedir="${dest.dir.classes}" destfile="${aar.dir}/${service.name}.aar" /> <antcall target="copy.aar" /> </target> <!-- 생성한 Webservices.aar 파일을 원하는 위치에 copy --> <target name="copy.aar"> <echo message="COPY RESOURCE(S) TO JEUS DIR....." /> <copy file="${aar.dir}/${service.name}.aar" toFile="${axis2.aar.dir}/${service.name}.aar" overwrite="true"/> <antcall target="generate.war" /> </target> <!-- axis2.war 생성, jeus폴더에 복사--> <target name="generate.war"> <jar basedir="${axis2.files.dir}" destfile="${war.dir}/${war.name}" /> <echo message="COPY RESOURCE(S) TO JEUS DIR....." /> <copy file="${war.dir}/${war.name}" toFile="C:/TmaxSoft/JEUS6.0/webhome/autodeploy/${war.name}" overwrite="true"/> </target> </project>

* 웹서비스 SOAP방식-Client기준 개발 *

0. 웹서비스 client개발방법 및 절차
   a. aixs.jar 파일 배포(lib폴더에 복사)
   b. 웹서비스 server단 개발자에게 wsdl파일을 받는다.
   c. wsdl을 이용해서 axis client생성 interface모듈을 자동생성 (보통 java소스 8~10개쯤 생성됨)
   d. client 업무단에서 interface모듈을 호출하는 java 개발

1. 웹서비스 Client란

    - 자료요청자 -> 자료수신자

      . 자료요청자 사이드를 Cllient안으로 본다.

      . 자료수신자 사이드를 Server단으로 본다.

2. axis jar배포

    - lib 폴더에  axis.jar 파일을 배포(copy)한다.

3. WSDL 받기

    - 웹서비스 서버단 개발 담당자가 WSDL을 만들어서 Client개발담당자에게 전달한다.

4. 웹서비스 Client interface모듈 자동생성

    ㄱ. 생성과정

       -> eclipse

       -> 전달받은 WSDL 파일 선택 -> 오른쪽 마우스 클릭

       -> Web Service -> Web Service Client

       -> Server runtime : Tomcat 또는 JEUS 선택

       -> Web service runtime : Apache Axis 또는  Apache Axis2 선택

                                        (Spring project이면 Apache CXF 2.x 선택)

   ㄴ. Client interface모듈 자동생성도중 이슈 및 해결방법

       - 오류내역 : Web service runtime 버전을 [Apache Axis2]로 선택 시 오류 발생 하는 경우

       - 해결방법

          a. 해당 프로젝트에서 Axis2 web service 모듈을 추가 한다.

             : eclipse -> Project -> 오른쪽 마우스 -> Properties

               -> Project Facets -> [v] Axis2 Web Services    선택 후 [적용]

          b.  위(a)작업도중 Axis2 web service 모듈을 추가가 안되는 경우

              Web service runtime -[Apache Axis] 를 선택 해서 Client interface 모듈을 생성한다.

              (참고, Axis2 버전으로 client모듈을 생성하는 경우에는 java소스의 package경로를 변경할 수 있지만

                       Axis  버전으로 client모듈을 생성하는 경우네느 java소스의 package경로를 변경할 수 없다.)

5. Client 개발 테스트 - proxy java class 사용 Sample

public class ClientTest { public static void main(String[] args){ //1. 서버단으로 전송/호출한 VO ReqeustVO[] reqVO = new ReqeustVO[1]; System.out.println("b"); reqVO[0] = new ReqeustVO(); reqVO[0].setEmpNo("10000"); reqVO[0].setId("1"); reqVO[0].setName("첫번째 이름"); reqVO[0].setSize("1000"); reqVO[0].setDelYn("N"); reqVO[0].setUploadDttm("20210728101010"); callService(reqVO); } public static String callService(ReqeustVO[] reqVO) { try { String endpoint = "http://service ip:port?j_username=AAA&j_password=BBB"; SOAP_INTERFACE_NAME_01_SOProxy proxy = new SOAP_INTERFACE_NAME_01_SOProxy(); proxy.setEndpoint(endpoint); DT_SOAP_INTERFACE_NAME_01_response result = proxy.SOAP_INTERFACE_NAME_01_SO(reqVO); System.out.println("ShipmentFileChange resultCode=" + result.getResVO().getResultCode()); System.out.println("ShipmentFileChange resultMessage=" + result.getResVO().getResultMessage()); } catch (Exception e) { e.printStackTrace(); } return ""; } }

6. Client 개발 테스트 - stub java class 사용 Sample

public class ClientTest { /** * @param args */ public static void main(String[] args){ ReqeustVO[] reqVO = new ReqeustVO[1]; System.out.println("b"); reqVO[0] = new ReqeustVO(); reqVO[0].setEmpNo("10000"); reqVO[0].setId("1"); reqVO[0].setName("첫번째 이름"); reqVO[0].setSize("1000"); reqVO[0].setDelYn("N"); reqVO[0].setUploadDttm("20210728101010"); callServer(reqVO); } public static String callServer(ReqeustVO[] reqVO) { try { String endpoint = "http://service ip:port?j_username=AAA&j_password=BBB"; PDPO_B2BI_EA_SHIPMENT_FILE_01_SOServiceLocator locator = new PDPO_B2BI_EA_SHIPMENT_FILE_01_SOServiceLocator(); locator.setHTTP_PortEndpointAddress(endpoint); URL url = new URL(locator.getHTTP_PortAddress()); PDPO_B2BI_EA_SHIPMENT_FILE_01_SOBindingStub stub = new PDPO_B2BI_EA_SHIPMENT_FILE_01_SOBindingStub(url, locator); stub.setPortName(locator.getHTTP_PortWSDDServiceName()); //stub.setUsername("AAA"); //stub.setPassword("BBB"); SOAP_INTERFACE_NAME_01_response result = stub.PDPO_B2BI_EA_SHIPMENT_FILE_01_SO(reqVO); String resultCode = result.getResVO().getResultCode(); String resultMessage = result.getResVO().getResultMessage(); System.out.println("ShipmentFileChange resultCode=" + resultCode); System.out.println("ShipmentFileChange resultMessage=" + resultMessage); } catch (Exception e) { e.printStackTrace(); } return ""; } }

* 웹서비스 환경 및 버전 *

1. jdk

   - jdk 1.6.0_31 : 버전에서 실패. 

                       web.xml에 웹서비스 관련 servlet container를 등록 후 was를 restart시키면 start도중 오류 발생

                        (servlet container 목록 :
                          org.apache.axis.transport.http.AxisServlet,  org.apache.axis.transport.http.AdminServlet)

   - jdk 1.6.0_45 : 웹서비스 정상 구동

2. axis2를 이용해서 webservice 정상 환경 

   a. eclipse : Indigo  (Build id : 20120216-1857)
      jdk : 1.6.0_45
      tomcat : 6.0
      axis2 : 1.7.9
   b. eclipse : Helios (Build id : 20100917-0705)
      jdk : 1.6.0_45
      tomcat : jeus 6.0
      axis2 : 1.6.2 ~ 1.7.9 까지 모두 가능

   c. eclipse : 2021-12 (4.22.0)
      jdk : 17.0.2
      tomcat : tomcat 9.0
      axis2 : 1.7.9

3. axis2 다운로드

    * 모든 버전 다운로드 : https://archive.apache.org/dist/axis/axis2/java/core/