lonelycat's cellar

• 스트럿츠2는 사용자가 필요한 프레임워크의 기능을 적합하게 변경하기 위한 여러가지 프로퍼티를 가진다.
  이러한 프로퍼티를 변경하기 위해 struts.properties 파일에 프로퍼티 키와 값으로 선언한다.
  
• properties 파일은 클래스 경로 어떤 곳이라도 위치할 수 있다. 보통 /WEB-INF/classes 하위에 위치한다.
  
• 이클립스에서는 Java Resources (src) 의 바로 밑에서 struts.xml파일을 하나 추가해준다. ( default package )
  그러면 자동으로 빌드되면서 classes폴더로 들어가게 된다. 확인은 webapps 에서 할 수 있다.
  

• key=value로 이루어져 있는 프라퍼티 값들을 통해서 스트럿츠2의 동작을 제어하게 된다.
  

• struts.properties 파일은 struts2-core-2.x.jar 의 org/apache/struts2/default.properties 에 있는 디폴트 값을 오버라이드 할 수 있는데 그때는 디폴트값과 다른 것만 설정하면 된다.
  

struts.properties

struts.i18n.reload=true #properties 파일들을 수정하고 저장하면,다음 요청에 변경사항이 반영됨을 볼 수 있음. struts.devMode=true struts.configuration.xml.reload=true struts.continuations.package=org.apache.struts2.showcase struts.custom.i18n.resources=globalMessages struts.url.http.port=9090 struts.action.extension=action struts.serve.static=true struts.serve.static.browserCache=false struts.multipart.maxSize=2097252 #디폴트로 임시디렉토리 지정. 최대 사이즈 지정

• 스트럿츠2의 액션 확장자의 디폴트 값은 .action 이지만 struts.action.extension=do 라고 작성해주면 스트럿츠1 처럼 .do를 액션 요청으로 인식하게 된다.

    http://hostname.com/mywebapp/servlet/MyServlet/a/b;c=123?d=789

    // http://hostname.com/mywebapp/servlet/MyServlet/a/b;c=123?d=789

    public static String getUrl(HttpServletRequest req) {

        String reqUrl = req.getRequestURL().toString();

        String queryString = req.getQueryString();   // d=789

        if (queryString != null) {

            reqUrl += "?"+queryString;

        }

        return reqUrl;

    }

    // /mywebapp/servlet/MyServlet/a/b;c=123?d=789

    public static String getUrl2(HttpServletRequest req) {

        String reqUri = req.getRequestURI().toString();

        String queryString = req.getQueryString();   // d=789

        if (queryString != null) {

            reqUri += "?"+queryString;

        }

        return reqUri;

    }

    // http://hostname.com:80/mywebapp/servlet/MyServlet/a/b;c=123?d=789

    public static String getUrl3(HttpServletRequest req) {

        String scheme = req.getScheme();             // http

        String serverName = req.getServerName();     // hostname.com

        int serverPort = req.getServerPort();        // 80

        String contextPath = req.getContextPath();   // /mywebapp

        String servletPath = req.getServletPath();   // /servlet/MyServlet

        String pathInfo = req.getPathInfo();         // /a/b;c=123

        String queryString = req.getQueryString();          // d=789

    

        // Reconstruct original requesting URL

        String url = scheme+"://"+serverName+":"+serverPort+contextPath+servletPath;

        if (pathInfo != null) {

            url += pathInfo;

        }

        if (queryString != null) {

            url += "?"+queryString;

        }

        return url;

    }

■ SOAP (Simple Object Access Protocol)이란 무엇인가?

SOAP이란 것은 무엇일까?

검색엔진에서 SOAP을 검색하면 무슨 비누, 향수, 샴푸등등... 이딴 것들만 검색된다.

그럼 SOAP은 세제란 뜻인가?  절대 그럴리 없다..

이 강좌가 무슨 “빨래 이런 세제를 쓰면 살균 소독까지.. ” 강좌도 아니고 무슨 비누란 말인가?

아직은 SOAP이 표준화 과정에 있고 따라서 많은 자료들이 만들어지지 못해서 이런 일이 일어나는 것 뿐이다..   "(,. )a

SOAP은 XML과 HTTP 통신을 기반으로 하여 네트워크 상에 존재하는 각종 컴포넌트간의 호출을 효율적으로 실현하기 위한 방법을 제시하는 규약이다.

말이 좀 어렵다.. 쉽게 말하면 네트워크 상에서 Client와 Service Provider간에 메시지를 요청하고 이에 응답해주는 방법을 제공하는 것이다..  이러한 방식들은 기존의 RPC(Remote Procedure Call)라 묶여서 불려오던 것들이다.. 따라서 SOAP은 RPC의 한가지 방법이라 할 수가 있다..  더 어려운가? ^^:

SOAP은 여러 Application Layer Protocol 들 중에 HTTP를 사용함으로써 여러 시스템간의 통신과 통합을 위한 좀더 단순하면서도 가벼운 메카니즘을 제공한다,,

이외에... HTTP를 사용하게 된 중요한 이유는 바로 방화벽에 제한을 받지 않는 범용성 때문이라 말할 수 있다.

다른 Application Layer Protocol의 경우 그들만의 약정된 TCP 또는 UDP 포트를 사용하기 때문에 인터넷상에 설치되어있는 방화벽에 많은 제약을 받게 된다.. 하지만 SOAP은 HTTP를 채택함으로써 방화벽의 제약을 받지 않고 불특정 다수의 클라이언트 또는 인터넷 상의 특정한 서버와의 RPC를 효율적으로 수행할 수 있도록 해준다.   

그렇다면 보안의 문제는 아예 생각지 않는 것인가? 이렇게 생각하는 사람도 있을지 모르겠다.. SOAP은 SOAP만이 가지는 특정한 HTTP Header를 방화벽의 필터링 부분에 보냄으로써 메시지의 통과여부를 가릴 수 있게 하는 방법으로 보안이라는 문제를 해결한다. 

SOAP은 현재 1.1버전이 널리 사용되고 있으며, w3c와 Microsoft등과 같은 쟁쟁한 몇몇 단체들이 모여 표준화 작업이 한창이다,, 현재는 1.2 버전까지 나온 상태이다..

자세한 내용은 www.w3c.org나 www.microsoft.com을 참조하기 바란다..

그럼 본격적으로 SOAP의 내부를 살펴보도록 하자..

SOAP은 크게 다음의 4가지로 구성되어있다..

° SOAP envelope

Message에 무엇이 있는가, 누가 무엇을 다루는가, 어떤 것이 Optional이고 mandatory인가를 나타내기 위한 전체적인 framework를 제공한다..

° SOAP encoding rules

Application에 정의된 data type들의 instance를 교환하는데 사용되는 메카니즘이다.

° SOAP RPC 표현

Remote procedure call과 response들을 나타내는데 사용되는 규약을 정의한다.

° SOAP binding

두 peer 간의 전송프로토콜을 사용하여 SOAP envelope 교환에 대한 규약을 정의한다.

위의 4가지 중에 envelope와 encoding rule은 서로 다른 namespace에 정의되어있는 XML 이며, link를 걸어놓음으로써 정의된 내용들을 사용할 수 있다. 

SOAP은 Message Based Protocol이기 때문에 두 시스템간의 통합 시 쌍방 간의 Message Format만을 약속하면 되므로 통합시간 및 효율을 높일 수 있으며, 매우 간단하다.

1. SOAP Message Exchange Model

SOAP은 HTTP 통신을 위한 Webserver, XML과 Service Provider의 3가지로 구성되어있다.

                                        < SOAP의 동작방식 >

1) Client가 어떤 Service Provider의 Service가 어떤 것이 있는지를 파악하기 위해 제공하는 Service의 목록을 HTTP를 통해 XML형태로 요청한다. (만약 목록을 이미 알고 있는 경우라면 이 과정은 생략가능)

2) Server는 자신이 제공하는 Service의 목록을 XML로 응답을 보낸다. (만약 목록을 이미 알고 있는 경우라면 이 과정은 생략가능)

3) 응답을 받은 Client는 그 중 자신이 원하는 Service를 알아내어 다시 Provider에 요청을 한다.

4) Provider는 받은 요청에 대한 처리를 한 후 결과를 되돌려 준다.

2. SOAP Message

다음은 HTTP Request 속에 포함된 SOAP Message의 구조이다..

POST /StockQuote HTTP/1.1

Host: www.stockquoteserver.com

Content-Type: text/xml; charset="utf-8"

Content-Length: nnnn

SOAPAction: "http://example.org/2001/06/quotes"

<Envelope ...>

   <Header>

      ......

   </Header>

   <Body>

      <Content>

         ......

      </Content>

   </Body>

</Envelope>

° Envelope : Root Tag로써 SOAP Message가 시작됨을 나타낸다.

° Header : 가외의 정보를 나타내기 위한 것으로 생략이 가능하다.

° Body : 주 내용이 들어가는 Tag이며 다양한 형태의 태그들이 들어간다.

° Content : 서비스에 대한 요청이나 응답이 들어간다.

일단 간단한 예제를 보면서 이해해보자..

SOAP은 XML의 형태로 Message를 교환한다,,,

▷ Example 1 ( Request Message 형태 )

POST /StockQuote HTTP/1.1

Host: www.stockquoteserver.com

Content-Type: text/xml; charset="utf-8"

Content-Length: nnnn

SOAPAction: "http://example.org/2001/06/quotes"

<env:Envelope xmlns:env="http://www.w3.org/2001/06/soap-envelope" >

 <env:Body>

  <m:GetLastTradePrice

        env:encodingStyle="http://www.w3.org/2001/06/soap-encoding"

        xmlns:m="http://example.org/2001/06/quotes">

    <symbol>DIS</symbol>

  </m:GetLastTradePrice>

 </env:Body>

</env:Envelope>

Service Provider가 가지고 있는 서비스 중에 LastTradePrice 정보를 요청하는 SOAP Message로 DIS의 값을 요구하고 있다.

▷ Example 2 (Response Message 형태 )

HTTP/1.1 200 OK

Content-Type: text/xml; charset="utf-8"

Content-Length: nnnn

<env:Envelope xmlns:env="http://www.w3.org/2001/06/soap-envelope" >

 <env:Body>

  <m:GetLastTradePriceResponse

        env:encodingStyle="http://www.w3.org/2001/06/soap-encoding"

        xmlns:m="http://example.org/2001/06/quotes">

   <Price>34.5</Price>

  </m:GetLastTradePriceResponse>

 </env:Body>

</env:Envelope>

Response Message의 경우에는 Client가 요청한 Service 이름에 Response가 붙게되며 (GetLastTradePriceResponse) Request에 대한 결과 값을 가지고 있다.

그럼 좀더 구체적으로 살펴보자,,

2-1. SOAP Envelope

SOAP Message는 필수항목인 SOAP envelope와 생략 가능한 SOAP Header 그리고 SOAP Body로  구성되어 있는 XML Document이다.

2-2. SOAP Header

SOAP는 Header라는 element를 통해 통신을 하는 쌍방 간의 어떤 제약없이 Message를 확장할 수 있는 융통성 있는 구조를 제공한다. 일반적으로 Header는 authentication이나 transaction과 같은 비교적 연관성이 없는 정보들을 구현할 수 있도록 해준다.  Header element는 SOAP Envelope 바로 다음에 오는 첫 번째 Child element로서 모든 Header 다음에 오는 Child element들을 Header Entry라고 한다.

Example 3 ( SOAP Header block )

<env:Header xmlns:env="http://www.w3.org/2001/06/soap-envelope" >

  <t:Transaction xmlns:t="http://example.org/2001/06/tx" env:mustUnderstand="1" >

    5

  </t:Transaction>

</env:Header>

2-3 SOAP Body

SOAP Body element는 필수 정보를 교환하기 위해 사용되는 간단한 메카니즘을 제공한다, 일반적으로 Body는 어떤 결과나 error를 보고하기 위해 사용된다. Body는 SOAP Envelope 바로 다음에 오는 Child element로서 만약 Header가 존재하면 Header 다음에 와야하고 Header가 정의되어있지 않으면 Envelope 바로 다음에 와야한다. Header와 마찬가지로 Body element 바로 다음에 오는 Child element들을 Body entry라고 부른다.

2-4. Fault Code

SOAP은 error를 reporting 하기 위해 Fault element를 사용한다. 이 Fault element는 다음과 같은 Child element로 구성된다.

° faultcode : Software나 Provider가 사용하는 error number로 error를 구분하기 위해 사용된다. 반드시 존재해야하는 element이다.

° faultstring : error에 대한 간단한 이유나 제목을 기술하며 반드시 존재해야하는 element이다.

° faultactor : message 경로에서 누구에 의해 야기되는 error인지에 대한 정보를 나타낸다. 반드시 존재해야하는 것은 아니다.

° detail : error에 대한 상세 정보를 기술한다. 반드시 요구되는 것은 아니고 사용자가 정의한 error tag가 올 수 있다.

Example 4 ( SOAP Fault Code )

<env:Envelope xmlns:env='http://www.w3.org/2001/06/soap-envelope'

                      xmlns:f='http://www.w3.org/2001/06/soap-faults' >

  <env:Header>

    <f:Misunderstood qname='abc:Extension1'

                                xmlns:abc='http://example.org/2001/06/ext' />

    <f:Misunderstood qname='def:Extension2'

                                xmlns:def='http://example.com/stuff' />

  </env:Header>

  <env:Body>

    <env:Fault>

      <faultcode>MustUnderstand</faultcode>

      <faultstring>One or more mandatory headers not understood</faultstring>

    </env:Fault>

  </env:Body>