: Class XecureHttpServlet

Overview

Package

Class

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: INNER | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

xecure.servlet
Class XecureHttpServlet

java.lang.Object
  |
  +--javax.servlet.GenericServlet
        |
        +--javax.servlet.http.HttpServlet
              |
              +--xecure.servlet.XecureHttpServlet

public class XecureHttpServlet
extends javax.servlet.http.HttpServlet

XecureHttpServlet 클래스는 XecureWeb 을 일반 Servlet 에 적용할때 extend 해야 하는 서블릿 클래스이다.
일반 서블릿이 암호/복호를 적용하기 위해서는 반드시 이 클래스를 extend 해야 한다.
클라이언트 Request 가 get 방식일 경우, doGet 함수, post 방식일 경우, doPost 함수가 호출된다.
이 클래스를 extend 한 서블릿 클래스는 service 함수를 overriding 하면 안된다.
init 함수를 overriding 할 경우에는 반드시 이 클래스의 init 함수를 호출해야 한다.

See Also:: Serialized Form

Field Summary
`java.lang.String`	`sXecureClientObject` XecureWeb Client Control 을 Web browser 에 embed 하는 HTML 문자열

Constructor Summary
`XecureHttpServlet()`

Method Summary
`void`	`doGet(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response)` HttpServlet 클래스의 doGet 함수를 overriding 하여 XecureHttpServlet 에서 사용할 수 있도록 해준다.
`void`	`doPost(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response)` HttpServlet 클래스의 doPost 함수를 overriding 하여 XecureHttpServlet 에서 사용할 수 있도록 해준다.
`void`	`doStartSession(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response)` 암호 세션이 연결되지 않았을때 호출되는 함수이다.
`XecureConfig`	`getXecureConfig()` XecureConfig Object Reference 를 리턴한다.
`java.lang.String`	`getXecureConfigFilePath(javax.servlet.ServletConfig config)` Xecure Servlet Configuration File Path 를 얻는다.
`void`	`init(javax.servlet.ServletConfig config)` HttpServlet 클래스의 init 함수를 overriding 한다. getXecureConfigFilePath () 함수로 부터 XecureConfig 설정파일의 위치를 얻는다. XecureConfig 설정 파일을 읽어 XecureServlet 을 초기화 한다.
`void`	`service(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response)` 서블릿 엔진에 의해 호출된다.

Methods inherited from class javax.servlet.http.HttpServlet

doDelete, 
doOptions, 
doPut, 
doTrace, 
getLastModified, 
service

Methods inherited from class javax.servlet.GenericServlet

destroy, 
getInitParameter, 
getInitParameterNames, 
getServletConfig, 
getServletContext, 
getServletInfo, 
init, 
log, 
log

Methods inherited from class java.lang.Object

clone, 
equals, 
finalize, 
getClass, 
hashCode, 
notify, 
notifyAll, 
toString, 
wait, 
wait, 
wait

Field Detail

sXecureClientObject

public java.lang.String sXecureClientObject

XecureWeb Client Control 을 Web browser 에 embed 하는 HTML 문자열

Constructor Detail

XecureHttpServlet

public XecureHttpServlet()

Method Detail

getXecureConfig

public XecureConfig getXecureConfig()

XecureConfig Object Reference 를 리턴한다.

Returns:: XecureConfig object reference

init

public void init(javax.servlet.ServletConfig config)
          throws javax.servlet.ServletException

HttpServlet 클래스의 init 함수를 overriding 한다.
getXecureConfigFilePath () 함수로 부터 XecureConfig 설정파일의 위치를 얻는다.
XecureConfig 설정 파일을 읽어 XecureServlet 을 초기화 한다.

Parameters:: config - ServletConfig reference
Throws:: javax.servlet.ServletException - if servlet has problem
Overrides:: init in class javax.servlet.GenericServlet

getXecureConfigFilePath

public java.lang.String getXecureConfigFilePath(javax.servlet.ServletConfig config)

Xecure Servlet Configuration File Path 를 얻는다. 디폴트로 구현된 방식은 서블릿 엔진에서 서블릿 InitParameter 로 전달된 값을 얻도록 되어 있다. 만일 서블릿 엔진에서 InitParameter 를 전달하는 방법을 지원하지 않을 경우에는 이 함수를 Overriding 해서 full path로 설정파일의 위치를 지정하면 된다. 이 함수는 XecureHttpServlet 클래스의 init 함수에서 호출된다.

Parameters:: config - ServletConfig reference

service

public void service(javax.servlet.http.HttpServletRequest request,
                    javax.servlet.http.HttpServletResponse response)
             throws javax.servlet.ServletException,
                    java.io.IOException

서블릿 엔진에 의해 호출된다. 클라이언트로 부터 전달된 request 의 암호문을 해석하여 새로운 request object 를 생성하며, 서블릿이 암호화 할 수 있도록새로운 response 객체를 구성한다.

Parameters:: request - HttpServletRequest reference; response - HttpServletResponse reference
Overrides:: service in class javax.servlet.http.HttpServlet

doStartSession

public void doStartSession(javax.servlet.http.HttpServletRequest request,
                           javax.servlet.http.HttpServletResponse response)
                    throws javax.servlet.ServletException,
                           java.io.IOException

암호 세션이 연결되지 않았을때 호출되는 함수이다. 이 클래스를 상속받은 클래스는 이 함수를 overriding 해서 각 클래스 나름대로 오류 처리를 할 수 있다. xecure_servlet.conf 의 useStartSession 필드값이 true 로 설정되어 있어야 이 함수가 호출된다.

Parameters:: request - HttpServletRequest object; response - HttpServletResponse object
Throws:: javax.servlet.ServletException, - java.io.IOException

doPost

public void doPost(javax.servlet.http.HttpServletRequest request,
                   javax.servlet.http.HttpServletResponse response)
            throws javax.servlet.ServletException,
                   java.io.IOException

HttpServlet 클래스의 doPost 함수를 overriding 하여 XecureHttpServlet 에서 사용할 수 있도록 해준다. XecureHttpServlet 의 기능을 사용하기 위해서는 이 클래스를 상속받은 클래스에서 이 함수를 overriding 하면 안된다. 이 함수는 HttpServletRequest 로 부터 세션 정보와 암호문을 입력받아 해당 SSL 세션을 찾아 암호문을 복호화 하여 XecureHttpServletRequest Object 를 구성한다. 또한 XecureHttpServletResponse Object 를 생성하고 세션 정보를 제공하여 XecureHttpServletResponse Object 를 이용하여 서버에서 클라이언트에게 전달하는 데이타를 암호화 할 수 있도록 한다. 세션 정보를 얻고 입출력 Object 를 생성한후에 doXecurePost 함수를 호출한다. 만일 세션 정보를 얻을 수 없을 경우에는 doStartSession 을 호출한다.

Parameters:: request - HttpServletRequest object; response - HttpServletResponse object
Throws:: javax.servlet.ServletException, - java.io.IOException
Overrides:: doPost in class javax.servlet.http.HttpServlet

doGet

public void doGet(javax.servlet.http.HttpServletRequest request,
                  javax.servlet.http.HttpServletResponse response)
           throws javax.servlet.ServletException,
                  java.io.IOException

HttpServlet 클래스의 doGet 함수를 overriding 하여 XecureHttpServlet 에서 사용할 수 있도록 해준다. XecureHttpServlet 의 기능을 사용하기 위해서는 이 클래스를 상속받은 클래스에서 이 함수를 overriding 하면 안된다. 이 함수는 HttpServletRequest 로 부터 세션 정보와 암호문을 입력받아 해당 SSL 세션을 찾아 암호문을 복호화 하여 XecureHttpServletRequest Object 를 구성한다. 또한 XecureHttpServletResponse Object 를 생성하고 세션 정보를 제공하여 XecureHttpServletResponse Object 를 이용하여 서버에서 클라이언트에게 전달하는 데이타를 암호화 할 수 있도록 한다. 세션 정보를 얻고 입출력 Object 를 생성한후에 doXecurePost 함수를 호출한다. 만일 세션 정보를 얻을 수 없을 경우에는 doStartSession 을 호출한다.

Parameters:: request - HttpServletRequest object; response - HttpServletResponse object
Throws:: javax.servlet.ServletException, - java.io.IOException
Overrides:: doGet in class javax.servlet.http.HttpServlet