기존의 CGI 방식은 사용자의 요구가 발생하는 경우마다 새로운 프로세스가 시작되어 사용자의 요구를 처리한다. 사용자가 새로운 요구를 하면 그 순간에 시스템의 운영체제가 그 프로그램에 해당하는 프로세스를 Fork하는 작업을 수행하게 한다. 새로운 프로세스를 Fork하는 작업은 시스템 자체에 부하를 걸게 되고, 이런 일이 많아지게 되면 시스템에 많은 부담을 준다. 이런 문제점 때문에 기존 CGI 사용자들은 점차 새로운 애플리케이션으로 관심을 돌리게 되었고, Servlet, PHP, ASP, JSP 등이 등장하였다.

이런 프로그램은 모두 C로 만들어진 프로그램이 아니라 Java나 스크립트 등을 이용한 새로운 형태의 프로그램들이다. 따라서 새로운 개발에는 용이할지 몰라도 기존 C Style로 CGI 프로그램들을 개발하여 운영해 온 사람들에게는 기존 프로그램들을 모두 폐기하고 새로 만들어야 하는 부담을 안겨주고 있다.

CGI 개발자들은 자신들이 운영하던 CGI를 버리고 완전히 새로운 프로그램을 도입할 것인지, 아니면 기존 프로그램을 운영하되 서버를 늘려서 CGI의 부담을 줄일 것인지 고민한다. WebtoB에서는 기존 CGI 개발자들의 고민을 해결해주기 위해 새로운 형태의 API를 개발하였다.

제공되는 API는 C Style의 프로그램을 위한 API로서 CGI 프로그램의 부담을 덜고 기존 CGI 프로그램의 수정은 최소화할 수 있게 한다. 이를 통해 기존 CGI 프로그램으로 서비스를 해 오던 많은 사용자들은 부담도 덜고, 성능도 향상시킨다.

CGI 방식은 위에서 언급한 대로 사용자가 요구할 때마다 매 순간 새로운 프로그램이 Fork되고 처리가 끝나는 순간 Exit되는 일을 반복한다. 이는 다른 처리를 해야 할 시간에 새로운 프로세스를 메모리에 로드하고 스케줄링을 해야 하는 등의 많은 작업을 해야 하기 때문에 시스템의 관점에서는 굉장히 큰 부담이다.

다음 그림은 Apache 웹 서버에서의 CGI를 사용하는 모습을 나타낸다.

[그림 9.1] Apache에서의 CGI 동작 방식

위 그림을 보면 웹 서버가 Request를 요청할 때마다 CGI가 Fork되는 로드가 생길 수 밖에 없다.

WebtoB에서 제공하는 WBAPI는 우선 CGI의 이런 점을 개선하였다. 즉, 사용자가 요구를 보내는 매 순간에 프로세스를 Fork하는 것이 아니라, 웹 서버가 Boot Up되는 시점에 이러한 프로그램들을 미리 Fork하여 메모리에 올려 놓는 것이다. 또한, 사용자의 요구에 대한 처리가 끝난 시점에서도 Exit 되는 것이 아니라, 계속 메모리에 상주하여 다음 요구를 기다리는 것이다. 결국 매 순간 프로세스가 Fork되고 Exit되는 부담이 줄어들게 되는 것이다.

또한 단순히 이러한 부담을 줄이는 외에도 이 WBAPI로 설계된 프로그램의 관리를 WebtoB가 담당하게 된다. 따라서 만약 사용자의 부주의나 설계 오류로 프로그램이 다운되거나 문제가 생겼을 때 즉각 새로운 프로그램을 다시 실행할 수 있게 하는 등의 기능이 추가되었다. WebtoB는 프로그램들의 수를 조정해서 특정 프로그램에 대한 요구가 많다고 판단되면 이를 미리 많이 실행시켜서 부하를 줄인다.

WebtoB의 WBAPI의 호출을 그림으로 나타내면 다음과 같다.

[그림 9.2] WebtoB에서의 WBAPI

WBAPI는 main()으로 시작하는 일반 함수와는 다르다. 이는 WBAPI로 작성한 프로그램들이 독립된 프로세스로 발생하기는 하지만, 실제 WebtoB의 내부와 연결된 프로세스로 동작하기 때문이다. 따라서 함수의 시작이 일반적인 main()이 아닌 Service Name이라는 것으로 시작하게 된다. 따라서 함수의 시작되는 이름이 반드시 Service Name이 되어야 하고, 이는 WebtoB의 환경 파일에 등록이 되어 있어야 한다. 이에 대한 자세한 내용은 이후에 설명될 “9.3. 환경설정”을 참고한다.

WebtoB에서 WBAPI를 사용하기 위해서는 프로그램의 작업과 함께 WebtoB의 환경설정이 필요하다. 즉, WebtoB에 WBAPI를 이용하여 프로그램을 개발하였고, 이는 이렇게 이용하겠다는 식의 등록을 한다.

다음은 WebtoB의 환경 파일에 대한 예이다. 아래 설정 파일에서 진한색으로 처리된 부분이 실제 WBAPI를 사용하기 위한 기본 설정이다.

*DOMAIN
webtob1

*NODE
webmain
    WebtoBDir = "/usr/local/webtob", 
    SHMKEY = 99000,
    Docroot = "/usr/local/webtob/docs",
    AppDir = "/usr/local/webtob/ap",
    Hostname = "webmain.tmax.co.kr",
    Port = "8080",
    JsvPort = 9099

*SVRGROUP
htmlg   NodeName = webmain, SvrType = HTML
cgig    NodeName = webmain, SvrType = CGI
jsvg    NodeName = webmain, SvrType = JSV
ssig    NodeName = webmain, SvrType = SSI
wbapg  NodeName = webmain, SvrType = WEBSTD

*SERVER
html    SvgName = htmlg, MinProc = 10, MaxProc = 10
cgi     SvgName = cgig, MinProc = 10, MaxProc = 10 
ssi     SvgName = ssig, MinProc = 2, MaxProc =2
jsv1    SvgName = jsvg, MinProc = 10, MAXProc = 10
webaps SvgName = wbapg, MinProc = 5, MAXProc = 5

*SERVICE
write_board  SvrName = webaps

*URI
uri1  Uri ="/svct/", SvrType = WEBSTD, SvrName = webaps

SVRGROUP 절, SERVER 절이 항상 설정되어야 할 기본이다. 이는 대부분의 환경에서 Host 머신의 이름만 다를 뿐 별 차이가 없다. 실제 서비스를 응용하기 위해서는 각 서비스에 대한 설정이 추가로 필요하게 된다.

보통 WebtoB를 기동하기 위해서는 wscfl을 통해서 컴파일만 하면 되지만 WBAPI를 사용하기 위해서는 wscfl로 컴파일한 후 서비스 테이블을 생성해야 한다. bin/ 디렉터리 안에 있는 wsgst라는 명령어를 사용해서 생성한다. wsgst를 수행하면 WebtoB는 WBAPI를 쓰기 위한 '_svctab.c'라는 확장자를 가진 서비스 테이블을 지정된 경로에 생성한다.

wsgst

다음은 wsgst 명령을 사용해서 서비스 테이블을 사용하는 방법과 옵션에 대한 설명이다.

이로써 WBAPI를 사용하기 위한 모든 준비가 완료되었다. 이제 WBAPI로 개발된 프로그램을 컴파일하여 실행 파일을 생성하고 이를 위와 같은 형식으로 등록한다.

WBAPI로 개발된 프로그램은 C에서 기본적으로 제공되는 라이브러리 외에도 WebtoB에서 제공하는 특수한 라이브러리 및 서비스 테이블 파일을 이용하기 때문에 이를 컴파일할 때 연결해 주어야 한다.

아래는 UNIX/Linux에서 사용하는 컴파일을 위한 Makefile 파일의 예제이다.

#Makefile.common
TARGET= webaps
APOBJS= ap.o

#hp 32bit
CFLAGS = -Ae +DA1.1 +DD32 -O -I$(WEBTOBDIR)
#hp 64bit
#CFLAGS = -Ae +DA2.0W +DD64 +DS2.0 -O -I$(WEBTOBDIR)
#sun 32bit
#CFLAGS = -O -I$(WEBTOBDIR)
#sun 64bit
#CFLAGS = -xarch=v9 -O -I$(WEBTOBDIR)
#Linux
#CFLAGS = -O -I$(WEBTOBDIR)
#ibm 32bit
#CFLAGS = -q32 -O -I$(WEBTOBDIR) -brtl
#ibm 64bit
#CFLAGS = -q64 -O -I$(WEBTOBDIR) -brtl

WEBTOB_INCDIR = $(WEBTOBDIR)/usrinc
WEBTOB_BINDIR = $(WEBTOBDIR)/bin
WEBTOB_LIBDIR = $(WEBTOBDIR)/lib
OBJS    = $(APOBJS) $(SVCTOBJ)
SVCTOBJ = $(TARGET)_svctab.o

.SUFFIXES : .v
.c.o: 
        $(CC) $(CFLAGS) -c $<

wbaps: $(APOBJS) svct
        $(CC) $(CFLAGS) -L$(WEBTOB_LIBDIR) -o $(TARGET) $(OBJS) $(LIBS) $(USERLIBS)

svct:
        cp $(WEBTOBDIR)/svct/$(TARGET)_svctab.c .
        $(CC) $(CFLAGS) -I$(WEBTOB_INCDIR) –c $(TARGET)_svctab.c

다음은 Windows의 경우이다.

#Makefile for Windows
TARGET = webaps.exe

LIBS    = /link $(WEBTOBDIR)\lib\aps.lib ws2_32.lib 
CFLAGS  = /D _DEBUG /I $(WEBTOBDIR) /Gd /MD /nologo 

APOBJ   = $(TARGET:.exe=.obj)
SVCTSRC = $(TARGET:.exe=_svctab.c)
SVCTOBJ = $(TARGET:.exe=_svctab.obj)
OBJS    = $(APOBJ) $(SVCTOBJ)

$(TARGET): svct $(OBJS)
        cl $(CFLAGS) -o $@ $(OBJS) $(LIBS)
        copy $@ $(WEBTOBDIR)\ap

svct:
        copy $(WEBTOBDIR)\svct\$(SVCTSRC)

clean:
        -del $(OBJS) $(TARGET)

작업이 완료되면 WebtoB가 기동될 때 WBAPI로 개발된 프로그램을 같이 실행시켜 프로세스 형태로 메모리에 로드된다.

CGI를 변환하는 것은 WBAPI의 기능 중의 일부이다. 기존 CGI의 변환 외에도 C Style에 능숙한 사람들은 새로운 애플리케이션을 개발할 때 이 WBAPI를 이용하면 개발의 편의성 및 성능 향상에도 많은 도움이 될 것이다. WebtoB는 지속적으로 WBAPI를 제공하고 또 향상할 것이므로 차후의 확장성이나 지원등에서 무리가 없을 것이다.

그리고 이 WBAPI를 통해서 기존 TP-Monitor에서 제공한 서비스 기능을 이용하는 것도 가능하다.

WBAPI는 각각 INIT/DONE, ALLOC, GET, PUT/SET, SEND, COOKIE, SESSION, ETC 계열로 구성되어 있다. WBAPI는 기능별로 나누어진 것으로 각각의 API에 대한 간단한 설명을 한다.

WBAPI는 차후에 Multi Thread 기능을 제공할 예정이다. 이를 위하여 각각의 함수마다 특정 자료 구조(Data Structure)를 선언하는 것이 필요하다. 처음 WBAPI 프로그램을 작성하게 되면 Service Name을 등록하게 되는데 이때 WBSVCINFO라는 구조를 선언하게 되어 있다. 이를 WBAPI 내부의 각각의 함수의 앞에 반드시 입력해야 한다. 따라서 한 WBAPI 프로그램 내부의 모든 WBAPI 함수는 Service Name이 선언된 구조를 함수의 첫 번째 인자로 가지고 있어야 한다.

본 절에서는 WBAPI를 이용하여 기존의 CGI 프로그램을 변환할 때 어떤 방식으로 이루어지는지 설명한다.

#include "qDecoder.h"

int strcheck(char *str) {
       if (str == NULL)
              return 0;
       if (strlen(str) == 0)
              return 0;
       return 1;
}

int main(void) {
       char *name, *title, *doc;
       char *email, *homepage;

       /* 입력값들을 얻어냄 */
       name = qValue("writer");
       title = qValue("title");
       doc = qValue("doc");
       email = qValue("email");
       homepage = qValue("homepage");

       /* 입력값들이 올바른지 검사 */
       if (!strcheck(name))
              qError("이름을 입력하세요.");
       if (!strcheck(title))
              qError("글 제목을 입력하세요.");
       if (!strcheck(doc))
              qError("본문을 입력하세요.");
       if (strcheck(email))
              if (!qCheckEmail(email))
                        qError("E-Mail 주소를 정확히 입력하세요.");
       if (strcheck(homepage))
              if (!qCheckURL(homepage))
                        qError("Homepage URL을 정확히 입력하세요.");

       /* 처리결과출력 – 입력확인 */
       qContentType("text/html");
       printf("<HTML>\n\n");
       printf("<HEAD><TITLE>Bestbook 게시판 – 글 올리기 확인</TITLE></HEAD>\n\n");
       printf("<BODY>\n");
       printf("<H2> Bestbook 게시판 - 글 올리기 확인 </H2>\n");
       printf("<HR WIDTH=600 ALIGN=left>\n<BR>");

       if (strcheck(email))
             printf("<A HREF=\"mailto:%s\">%s</A>", email, name);
       else printf("%s", name);

       if (strcheck(homepage))
             printf("<SMALL>(<A HREF=\"%s\">%s</A>)</SMALL>", homepage, homepage);

             printf("올리신 글은 다음과 같습니다.<BR><BR>\n");
             printf("<TABLE WIDTH=600 BORDER=1>\n");
             printf("<TR><TD><B>제목</B> : %s</TD></TR>\n", title);
             printf("<TR><TD>%s</TD></TR>\n", doc);
             printf("</TABLE>\n\n<BR>이 글이 정상적으로 게시판에 올려졌습니다.\n");
             printf("</BODY>\n\n</HTML>");
             qFree();
}