Ӧ
COMPUTER APPLICATIONS
1999 19 10 Vol.19 No.10 1999



NSAPIǿWeb Server 
֣
ժҪĽHTTPЭļ򵥹̺NSAPIй֪ʶNSAPIдԶSAF
ؼʡHTTP, NSAPI, SAF, CGI
1NSAPI
11
NSAPINetscape Server Application Programming InterfaceдʵSAFs(Server Application FunctiionsServerһSAFsNSAPIдԼSAFsԱչServer)ģ÷ܹѶĴֳСĲɣͿԺÿһСĲ裬ӶϺõٶȺԵҪNSAPINCSACERN Web ServerĿƵ,ΪԱṩٶȡServerϵĽԼԣͬʱֶҪWeb ServerĴн⡣дCGI(Common Gateway Interface,ͲõNSAPIֻWAIWeb Application Interface뿪Լɫ֤¼̣޸еServerΪͻõNSAPI
1.2HTTP
HTTPЭǿ١򵥺ͿչЭ飬Эľڴ˲⣬ȤĶ߿Լйס棬ǶHTTPĹһ
. ͷӲҷ
. 󣬲𸴲ϿӣյһҪ󱣳ӵ򲻶Ͽֱһ
Method,Universal Resource Identifier(URI)ԼɿոֿHTTPЭ汾Ϣɡͨɼͷheadersͱ־ͷһпոʱݣbody dataɡHeaderṩͻйϢBody data͵POSTGET
͵һ㶼ӣ
GET /index.html HTTP/1.0
User-agent: Mozilla
Accept: text/html, text/plain, 
image/jpeg, image/gif, */*
յ󲢴ÿֻһȻܹͬʱ󡣴һ뾭衣ǳִʽΪ-ӦRequest-Response processNSAPIдSAFsִбִС
һHTTPЭ汾HTTP״̬(status code)ԼոֿĽͶreason phraseӦͨӦǼͷheaderӦݣbody data͵Ӧʾ
HTTP/1.0 200 OK
Server: Netscape Enterprise Server/3.0
Content-type: text/html
Content-length: 83
<HTML>
<HEAD><TITLE>Hello World</Title></HEAD>
<BODY>Hello World</BODY>
</HTML>
״̬ͽͶδһ״̬200ɹݺҪĿ״̬ضĻ棨cacheǳ˴404ҲĿ
1.3-𸴴
һʱҪִһЩʼȻȴHTTP
-𸴴ͨĲ蹹ɣ
a) AuthTrans(authorization translation)֤룩
b) NameTrans(name translation)߼URIͳһԴʶתΪļϵͳ·
c) PathCheck(pathe checking)鱾ļϵͳ·ЧԺûȨޣ
d) ObjectType(object typing)ȷԴMIMEMulti-purpose Internet Mail Encoding(text/html,image/gifȵ)
e) Service(service)𸴷ظͻ
f) AddLog(adding log entries)־ļһ¼
ÿһΪﵽĿĶҪִһЩͨSAFsʵֵġڴжSAFsЩSAFsʵַĹܺĸ߼ԡ
ÿһSAFԼãȨʵϢǰSAFs޸ĹķServer VariablesSAFЩϢִԼĲSAFԸĿǰΧڵĿļ顢޸Ļ򴴽
ÿһSAFзشԱ߷ǷִгɹЩشԾһִеǰһһSAFȡ
ͨЩǰ˳ɵģĴ𸴷͸ͻServiceһȻ־ļһ¼ȻΪʲôԭȡԴڻûȨʵȣһµĳErrorĲ裬ErrorServiceError SAFͻHTMLҳ棬Ȼ־ļ
2ָʾͷںSAFs
Enterprise Serverͨıļõġ⼸ļڷĿ¼home directoryconfigĿ¼£https-<servername>/configǸȤmagnus.conf,obj.confmime.typesmagnus.confļǷļ֡˿ںźһЩȫãmime.confļνļչӳHTTPļͣobj.confļóʼ-ӦÿһSAFsĲɱ༭ļԱ㰲װԼSAFs
obj.confļкָʼ-ӦÿһSAFsĲָʾУdirective line-Ӧָʾdirectives<Object> ǷֳɶObjects, Աǩ<Object>ʼԱǩ</Object>ǳΪΪǼ̳ΪȱʡĶƷȱʡҪض̳кͣ޸ȱʡĶΪ
ĲĿǰеֵƥʱͱʹܣEnabledһǩnameppathǶԼͨ磺
<Object name="cgi">  <Object
ppath="/usr/netscape/suitespot/docs/private/*">
ָʾnameΪdefaultʱʹܵġʹ״̬ʱеָʾȱʡеָͬʾһǿԸıȱʡΪ
ָʾо-ӦÿһӦִЩSAFָʾ﷨ʽ£
Directive fn=func-name
name1="value1"ݡnameN="valueN"
DirectiveǷһָʾfunc-nameҪִеSAFnameN="valueN"ǴSAFĲƺֵ
Ƿָʾ
Initʼϵͳ͹Դ
AuthTrans֤HTTPеϢתûͣ飩Ȩ޿ƷΪ׶ΣAuthTrans֤ûݣPathCheckûҪԴĴȡȨޡ
NameTransеURLеתΪļϵͳ·
PathCheckNameTransת·ЧԺʹȡȨޡ
ObjectTypeԴMIME͡
Serviceͽͻ
ErrorHTTPREQABORTED
AddLog¼йصϢ
3ԼSAFs
3.1SAFӿ
еSAFͬġCӿڣΪһġSAFһЩΪ-ӦеĳһʵضܵСǴobj.confļserverǰSAFнܲSAFġCӿڣ
int function(pblock *pb, Session *sn, Request *rq);
pbobj.confļеSAFвsn뵥TCP/TPỰйصϢrq뵱ǰصϢSAFзʾúִеݷδǰ
3.2һԶSAF
ԶSAFһɷغ͵õĹеĺǴԶSAFĲ裺渽һ
a) NSAPIдԶSAFԴÿһSAFΪһָʾdirective
ע⣺дSAFʱҪд̰߳ȫthread-safeĳκblockingӰܣÿSAFвobj.confá
b) 벢Դ򣬴⣨.so, .sl, or .dllļҪضƽ̨ıWindows NTMicrosoftVisual C++6.0Ŀ¼µincludeĿ¼NSAPIͷļеͷļϢڡnsapi.hļУͷļݵģֻҪ򵥵İnsapi.hɡ
c) ޸obj.confļ÷ԱغԶSAFĹ⣬ʹʵʱԶSAF
obj.confļʼָʾһУ
Init fn=load-modules shlib=pathsharedlibname
funcs="SAF1,...,SAFn"
shlibǹڱļϵͳе·funcsһϵɶŷֿĿɴӿмصĵĺִСдġ
ȻټһԱʵʱԶSAF
Directive fn=func-name
name1="value1"...nameN="valueN"
DirectiveǷһָʾfunc-nameҪִеĺ
d) ֹͣȻWindows NTɴӿֹͣunixstopstartrestartΪ¼ؿ⡣
e) ʷԱԶSAFעһҪֹcacheܡNavigatorٵreloadťʱסshift
ִ֤ĺ
#include "base/pblock.h"
#include "base/session.h"
#include "frame/req.h"
typedef struct {
char *name;
char *pw;
} users;
static users usersetۣ = {
{"joe", "shmoe"},
{"suzy", "creamcheese"},
{NULL, NULL}
};
#include "frame/log.h"
#ifdef XPWIN32
#define NSAPIPUBLIC declspec(dllexport)
#else /* !XPWIN32 */
#define NSAPIPUBLIC
#endif /* !XPWIN32 */
NSAPIPUBLIC int hardcodedauth
(pblock *param, Session *sn,Request *rq)
{ 
/* û֤õĲ */
char *pwfile = pblockfindval("userdb", param);
char *user = pblockfindval("user", param);
char *pw = pblockfindval("pw", param);
/* ʱ*/
register int x;
for(x = 0; usersetx.name != NULL; ++x) {
/* Ԥڵû */
if(strcmp(user, usersetx.name) != 0)
continue;
/* ֤ */
if(strcmp(pw, usersetx.pw)) {
logerror(LOGSECURITY, "hardcoded-auth", sn,
rq,"user %s entered wrong password", user);
/* һԱǿ */
return REQNOACTION;
}
/* REQPROCEED, ûΪ*/
return REQPROCEED;
}
/* ƥ䣬һ*/
logerror(LOGSECURITY, "hardcoded-auth", sn, rq,
"unknown user %s", user);
return REQNOACTION;
}
߼飺˶ʿоо򣺼Ϣͨϵͳ
֣ԡڡо򣺼ͨšǰҪԶ̽о
ߵλ㽭ѧϵ㽭.ݣ310027
ο
1ݡT.Berners-Lee,R.Fielding,H.Nielsen. Hypertext Transfer Protocol HTTP/1.0. RFC194519965(17)
2ݡTony Beveridge,Paul Mcglashan. ISAPI/NSAPI Web߼. йˮˮ磬19991
ո:1999-05-05
