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

* 웹서비스 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>