불친절한자수씨

JAX-WS 의 Tool 을 사용하기 위해서는 metro 를 다운받아야 합니다.
https://metro.dev.java.net/1.3/ 에 접속하여 다운을 받습니다.

다운받은 metro-1_3.jar 파일을 설치할 경로에 옮겨놓고 더블클릭으로 실행을 시킵니다.
알집을 설치한 경우에는 바로 실행이 안되니 콘솔을 띄우고 java -jar metro-1_3.jar 명령으로 실행시킵니다.

스크롤을 맨 아래로 내린 후 Accept 버튼을 클릭

아래와 같이 설치가 완료되었습니다.

환경 변수에 JAVA_HOME 과 METRO_HOME 을 설정합니다.
이클립스의 경우 환경변수를 추가했을 때는 이클립스를 재시작해야지 Ant 에서 인식을 합니다.

기존 로직이 있는 프로젝트에 SEI 를 만듭니다.
com.idstrust.wiseone.engine.gw.webservice.workflowform.WorkflowFormWebService.java
@WebService(serviceName="WorkflowFormWebService") public class WorkflowFormWebService extends SpringBeanAutowiringSupport { @Autowired private IWorkflowFormService service; public void setService(IWorkflowFormService service) { this.service = service; } @WebMethod public List<FormCategory> getRootFormCategories() { System.out.println("invoke getRootFormCategories()"); return service.getRootFormCategories(99999); } @WebMethod public List<FormData> getCategoryFormDatas(int categoryIndex) { System.out.println("invoke getCategoryFormDatas() " + categoryIndex); return service.getCategoryFormDatas(categoryIndex); } }

Ant 를 통해서 서버/클라이언트 소스를 배포하기 위해  build.xml 을 생성합니다.
아래 build.xml 의 deploy-server-jar target 을 실행하여 SEI 를 빌드합니다.
<?xml version="1.0" encoding="utf-8" ?> <project name="WiseOne 2.0 - generate webservices" basedir="."> <property environment="env"/> <property name="jdk.home" value="${env.JAVA_HOME}"/> <property name="metro.home" value="${env.METRO_HOME}"/> <property name="build.home" value="${basedir}/build"/> <property name="build.classes.home" value="${build.home}/classes"/> <property name="deploy.server.library" value="${build.home}/com.idstrust.wiseone.engine.gw.webservice.jar"/> <taskdef name="apt" classname="com.sun.tools.ws.ant.Apt"> <classpath refid="jaxws.classpath"/> </taskdef> <taskdef name="wsimport" classname="com.sun.tools.ws.ant.WsImport"> <classpath refid="jaxws.classpath"/> </taskdef> <path id="jaxws.classpath"> <pathelement location="${basedir}/bin"/> <pathelement location="${jdk.home}/lib/tools.jar"/> <fileset dir="${metro.home}/lib"> <include name="*.jar"/> <exclude name="j2ee.jar"/> </fileset> </path> <target name="setup"> <echo message="빌드 경로를 초기화합니다."/> <mkdir dir="${build.classes.home}"/> </target> <target name="build-server-java" depends="setup"> <echo message="SEI 를 빌드합니다."/> <apt fork="true" debug="true" verbose="${verbose}" sourcedestdir="${build.classes.home}" sourcepath="${build.classes.home}"> <classpath> <path refid="jaxws.classpath"/> <pathelement location="${basedir}/src"/> </classpath> <option key="r" value="${build.home}"/> <source dir="${basedir}/src"> <include name="**/webservice/**/*.java"/> </source> </apt> </target> <target name="deploy-server-jar" depends="build-server-java"> <echo message="서버 라이브러리를 배포합니다."/> <jar destfile="${deploy.server.library}" basedir="${build.classes.home}"/> <delete dir="${build.classes.home}"/> </target> <target name="build-client-java" depends="setup"> <echo message="wsdl로 클라이언트 소스를 생성합니다."/> <wsimport debug="true" verbose="${verbose}" keep="true" package="${client.package}" destdir="${build.classes.home}" wsdl="${client.wsdl}"> </wsimport> </target> <target name="deploy-client-jar" depends="build-client-java"> <echo message="클라이언트 라이브러리를 배포합니다."/> <jar destfile="${build.home}/${client.package}.jar" basedir="${build.classes.home}"/> <delete dir="${build.classes.home}"/> </target> <target name="generate-WorkflowFormWebService"> <property name="client.package" value="com.idstrust.wiseone.engine.gw.webservice.workflowform" /> <property name="client.wsdl" value="http://localhost:9999/WorkflowFormWebService?wsdl" /> <antcall target="deploy-client-jar" /> </target> </project>

빌드된 서버쪽 jar 파일 내부를 보면 SEI 패키지 경로의 jaxws 서브패키지에 클래스들이 생성됩니다.

Spring 설정 xml 을 아래와 같이 구성합니다.
Spring 에서 제공하는 SimpleJaxWsServiceExporter 를 이용하여 서비스를 공개합니다.
<?xml version="1.0" encoding="UTF-8"?> <beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.0.xsd"> <bean class="org.springframework.remoting.jaxws.SimpleJaxWsServiceExporter"> <property name="baseAddress" value="http://localhost:9999/"/> </bean> <bean id="workflowFormWebService" class="com.idstrust.wiseone.engine.gw.webservice.workflowform.WorkflowFormWebService"> <property name="service" ref="workflowFormService" /> </bean> </beans>

WAS (Tomcat) 의 WEB-INF/lib 폴더에 서버쪽 jar 를 배포하고 web.xml 에 Spring 설정을 추가합니다.
... <context-param> <param-name>contextConfigLocation</param-name> <param-value> ... classpath:com/idstrust/wiseone/engine/gw/conf/webserviceContext.xml </param-value> </context-param> ...

서버를 실행시키고 http://localhost:9999/WorkflowFormWebService?wsdl 에 접속해서 아래와 같은 wsdl 이 나오면
서버쪽 배포는 성공한 것입니다.

이제는 클라이언트 쪽 소스를 만들어서 테스트를 해봐야겠죠?
build.xml 의 generate-WorkflowFormWebService target 을 실행시키면 클라이언트 소스가 jar로 묶여서 나옵니다.
jar 를 풀어서 보면 아래와 같은 파일들이 있습니다. 저기 아래보이는 WorkflowFormWebService 가 serviceInterface 입니다.

위에 있는 wsdl 파일을 참조하여 아래 내용을 채워 넣습니다.
<?xml version="1.0" encoding="UTF-8"?> <beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.0.xsd"> <bean id="workflowFormWebService" class="org.springframework.remoting.jaxws.JaxWsPortProxyFactoryBean"> <property name="serviceInterface" value="com.idstrust.wiseone.engine.gw.webservice.workflowform.WorkflowFormWebService"/> <property name="wsdlDocumentUrl" value="http://localhost:9999/WorkflowFormWebService?wsdl"/> <property name="namespaceUri" value="http://workflowform.webservice.gw.engine.wiseone.idstrust.com/"/> <property name="serviceName" value="WorkflowFormWebService"/> <property name="portName" value="WorkflowFormWebServicePort"/> </bean> </beans>

클라이언트 소스 테스트는 아래와 같이...
BeanFactory factory = new ClassPathXmlApplicationContext( "com/idstrust/wiseone/formwizard/webservice/conf/webservicesContext.xml"); WorkflowFormWebService service = (WorkflowFormWebService) factory.getBean("workflowFormWebService"); for (FormCategory formCategory : service.getRootFormCategories()) { System.out.println(formCategory.getName()); }

1차적으로 그냥 HashMap 형식으로 Marshaller 를 만들어서 처리를 하였으나...
Marshaller marshaller = JAXBContext.newInstance(HashMap.class).createMarshaller(); marshaller.setProperty(Marshaller.JAXB_ENCODING, "UTF-8"); marshaller.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, true);

결과는

javax.xml.bind.MarshalException
 - with linked exception:
[com.sun.istack.internal.SAXException2: unable to marshal type "java.util.HashMap" as an element because it is missing an @XmlRootElement annotation]

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<content>
    <contentMap>
        <entry>
            <key xsi:type="xs:string" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">abc</key>
            <value xsi:type="xs:string" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">abcd</value>
        </entry>
        <entry>
            <key xsi:type="xs:string" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">abc1</key>
            <value xsi:type="xs:string" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">abcd</value>
        </entry>
    </contentMap>
</content>

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<content>
    <contentMap>
        <item value="abcd" key="abc"/>
        <item value="abcd" key="abc1"/>
    </contentMap>
</content>

{abc=abcd, abc1=abcd} 

java.lang.Class
이름에도 느낄 수 있듯이 클래스의 클래스입니다.
몇가지 쓸만한 메소드들을 나열합니다.

ㅁ getAnnotation(Class annotationClass)
  - 클래스의 해당 어노테이션을 반환합니다. 없으면 null 을 반환

ㅁ getAnnotations()
  - 모든 어노테이션들을 반환합니다.

ㅁ getConstructor(Class... parameterTypes), getConstructors()
  - 생성자를 반환합니다.

ㅁ getField(String name), getFields()
  - 프로퍼티을 반환합니다. (public 으로 선언된.. 상속받은 필드들도 반환됩니다.)

ㅁ getMethod(String name), getMethods()
  - 메소드를 반환합니다.

ㅁ getDeclaredXXXXX()
  - 위 메소드들은 상속받은 것들도 반환하지만 이런 메소드들은 해당 클래스 소스에 정의된 것들만 반환합니다.
    예를 들어 getField 로는 private 프로퍼티를 가지고 올 수 없지마녀 getDeclaredField 로는 private 프로퍼티에
    접근할 수 있습니다. (이거 찾느라 쪼끔 고생을...)


java.lang.reflect.Method
메소드 클래스 입니다.

ㅁ getModifires()
  - 메소드의 접근 지정자를 반환 (private, protected, public ...)

ㅁ getParameterTypes()
  - 메소드 파라미터의 타입을 반환합니다.

ㅁ ★★ invoke(Object obj, Object... args)
  - 메소드를 실행시킵니다. 첫번째인자는 실행을 할 객체를 넘겨주고 두번째 인자부터는 메소드의 파라미터를 주르륵...
    제일 중요한 메소드죠 ㅋㅋㅋ


java.lang.reflect.Field
... 설명은 따로 안해도..

ㅁ get(Object obj)
  - public 프로퍼티의 값을 가지고 올 때 사용합니다. 접근만 할 수 있다면 프로퍼티 값을 얻어올 수 있습니다.


위의 메소드들만 알고 있어도 어노테이션 가지고 노는데는 충분합니다.
이클립스에서 contents assist 를 이용하면 필요한 메소드들을 확인가능!!!!

일단 해볼 것은 toString 메소드 자동화를 해보려고 한다.
프로퍼티의 값을 설정하고 출력 테스트를 해보려면 각 클래스마다 toString 을 오버라이딩 해야하는데
귀찮은 건 딱 질색이므로... 일단 고고싱..

ㅁ PrintToString - Annotation
package kr.co.vicki.test.annotations; import java.lang.annotation.ElementType; import java.lang.annotation.Retention; import java.lang.annotation.RetentionPolicy; import java.lang.annotation.Target; @Retention(RetentionPolicy.RUNTIME) @Target(ElementType.FIELD) public @interface PrintToString {}

간단하게 설명 들어갑니다.
 @Retention 의 설명을 아래와 같다.

Indicates how long annotations with the annotated type are to be retained.

해석을 하자면 ... 안되겠다. 그냥 언제까지 어노테이션이 유지되는지를 설정한다.
속성으로는 RetentionPolicy.RUNTIME, CLASS, SOURCE 가 있다. 런타임에서 가지고 놀 것이므로
RUNTIME 을 선택!!

@Target <<< javadoc 은 아래와 같이 설명을 해준다.

Indicates the kinds of program element to which an annotation type is applicable.

어떤 종류의 어노테이션이냐 라는 것을 설정하는 것이다. 하나의 값을 설정해도 되고 여러개를 설정해도 된다.
속성의 종류는 ElementType.FIELD, TYPE, METHOD, PARAMETER, LOCAL_VARIABLE,
CONSTRUCTOR, PACKAGE 가 있다. 여기서는 프로퍼티에 설정할 것이므로 FILED 로 낙찰...


ㅁ 헬퍼 클래스들...
package kr.co.vicki.test.reflect; import java.lang.reflect.Field; import java.lang.reflect.Method; import kr.co.vicki.test.annotations.PrintToString; public class ToStringHelper { public static String toString(Object obj) { StringBuffer buffer = new StringBuffer(); try { Class clazz = obj.getClass(); buffer.append(clazz.getName()).append(" { "); for (Field field : clazz.getDeclaredFields()) { PrintToString pts = field.getAnnotation(PrintToString.class); if (pts != null) { Method getter = BeansHelper.getGetterMethod(clazz, field); Object value = getter.invoke(obj, null); buffer.append(field.getName()).append("=") .append(value).append(","); } } buffer.append(" }"); } catch (Exception e) { e.printStackTrace(); } return buffer.toString(); } }
package kr.co.vicki.test.reflect; import java.lang.reflect.Field; import java.lang.reflect.Method; public class BeansHelper { /** * getter 메소드를 찾습니다. * @param clazz * @param field * @return * @throws Exception */ public static Method getGetterMethod(Class clazz, Field field) throws Exception { String prefix = "get"; if (Boolean.class == field.getType() || boolean.class == field.getType()) prefix = "is"; return getBeansMethod(clazz, field, prefix); } /** * setter 메소드를 찾습니다. * @param clazz * @param field * @return * @throws Exception */ public static Method getSetterMethod(Class clazz, Field field, Class... paramType) throws Exception { return getBeansMethod(clazz, field, "set", paramType); } /** * beans 의 메소드를 찾습니다. * @param clazz * @param field * @param prefix * @param params * @return * @throws Exception */ private static Method getBeansMethod(Class clazz, Field field, String prefix, Class... params) throws Exception { String fieldName = field.getName(); fieldName = prefix + fieldName.substring(0, 1).toUpperCase() + fieldName.substring(1); Method method = clazz.getMethod(fieldName, params); return method; } }
ToStringHelper 클래스는 toString 의 조작에 도움을 주는 클래스이며, BeansHelper 는 자바빈의
getter, setter 메소드를 가지고 오는데 사용합니다. (사실 어딨는지 몰라서 그냥 만든거임..)


ㅁ 가지고 놀기~~
package kr.co.vicki.test; import kr.co.vicki.test.annotations.PrintToString; import kr.co.vicki.test.reflect.ToStringHelper; public class Person { @PrintToString private String name; @PrintToString private int age; @PrintToString private String remark; public String getName() { return name; } public void setName(String name) { this.name = name; } public int getAge() { return age; } public void setAge(int age) { this.age = age; } public String getRemark() { return remark; } public void setRemark(String remark) { this.remark = remark; } public String toString() { return ToStringHelper.toString(this); } public static void main(String[] args) { Person person = new Person(); person.setName("자수씨"); person.setAge(26); person.setRemark("치킨 먹고 싶어요.."); System.out.println(person); } }
실행을 해보면 어노테이션이 있는 프로퍼티만 toString 에서 보여주게 됩니다.

@PrintToString 어노테이션을 주석처리하고 실행해보면 나머지 것들만 보여줍니다.
public class Person { @PrintToString private String name; @PrintToString private int age; // @PrintToString private String remark; ... }

소스코드 - 이클립스에서 작성

invalid-file