Java-Cookie源码

publicclassCookieimplementsCloneable{

privatestaticfinalStringLSTRING_FILE=
"javax.servlet.http.LocalStrings";
privatestaticResourceBundlelStrings=
ResourceBundle.getBundle(LSTRING_FILE);

//cookie本身的值
privateStringname;//NAME=..."$Name"styleisreserved
privateStringvalue;//valueofNAME

//cookie的头部信息
privateStringcomment;//;Comment=VALUE...describescookie'suse
//;Discard...impliedbymaxAge<0
privateStringdomain;//;Domain=VALUE...domainthatseescookie
privateintmaxAge=-1;//;Max-Age=VALUE...cookiesauto-expire
privateStringpath;//;Path=VALUE...URLsthatseethecookie
privatebooleansecure;//;Secure...e.g.useSSL
privateintversion=0;//;Version=1...meansRFC2109++style



/**
*Constructsacookiewithaspecifiednameandvalue.
*
*@paramnamea<code>String</code>specifyingthenameofthecookie
*
*@paramvaluea<code>String</code>specifyingthevalueofthecookie
*
*@throwsIllegalArgumentExceptionifthecookienamecontainsillegalcharacters
*(forexample,acomma,space,orsemicolon)
*oritisoneofthetokensreservedforuse
*bythecookieprotocol
*@see#setValue
*@see#setVersion
*
*/
//构造函数，指定特定的name和value
publicCookie(Stringname,Stringvalue){
if(!isToken(name)
||name.equalsIgnoreCase("Comment")//rfc2019
||name.equalsIgnoreCase("Discard")//2019++
||name.equalsIgnoreCase("Domain")
||name.equalsIgnoreCase("Expires")//(oldcookies)
||name.equalsIgnoreCase("Max-Age")//rfc2019
||name.equalsIgnoreCase("Path")
||name.equalsIgnoreCase("Secure")
||name.equalsIgnoreCase("Version")
||name.startsWith("$")
){
StringerrMsg=lStrings.getString("err.cookie_name_is_token");
Object[]errArgs=newObject[1];
errArgs[0]=name;
errMsg=MessageFormat.format(errMsg,errArgs);
thrownewIllegalArgumentException(errMsg);
}

this.name=name;
this.value=value;
}

/**
*
*Specifiesacommentthatdescribesacookie'spurpose.
*Thecommentisusefulifthebrowserpresentsthecookie
*totheuser.Comments
*arenotsupportedbyNetscapeVersion0cookies.
*
*@parampurposea<code>String</code>specifyingthecomment
*todisplaytotheuser
*
*@see#getComment
*
*/
//cookie的说明
publicvoidsetComment(Stringpurpose){
comment=purpose;
}
//返回cookie数目，为空返回null
publicStringgetComment(){
returncomment;
}
/**
*Specifiesthedomainwithinwhichthiscookieshouldbepresented.
*<p>TheformofthedomainnameisspecifiedbyRFC2109.Adomain
*namebeginswithadot(<code>.foo.com</code>)andmeansthat
*thecookieisvisibletoserversinaspecifiedDomainNameSystem
*(DNS)zone(forexample,<code>www.foo.com</code>,butnot
*<code>a.b.foo.com</code>).Bydefault,cookiesareonlyreturned
*totheserverthatsentthem.
*@parampatterna<code>String</code>containingthedomainname
*withinwhichthiscookieisvisible;
*formisaccordingtoRFC2109
*
*@see#getDomain
*/
//给cookie设置在某个domain中有效
publicvoidsetDomain(Stringpattern){
domain=pattern.toLowerCase();//IEallegedlyneedsthis
}
//获得作用域
publicStringgetDomain(){
returndomain;
}




/**
*Setsthemaximumageofthecookieinseconds.<p>Apositivevalueindicatesthatthecookiewillexpireafterthatmanysecondshavepassed.Notethatthevalueis
the<i>maximum</i>agewhenthecookiewillexpire,notthecookie'scurrentage.
*<p>Anegativevaluemeans
*thatthecookieisnotstoredpersistentlyandwillbedeleted
*whentheWebbrowserexits.Azerovaluecausesthecookie
*tobedeleted.
*@paramexpiryanintegerspecifyingthemaximumageofthecookieinseconds;ifnegative,meansthecookieisnotstored;ifzero,deletes
*thecookie
*@see#getMaxAge
*/
//cookie的生存时间
publicvoidsetMaxAge(intexpiry){
maxAge=expiry;
}
//获得最大生存时间
publicintgetMaxAge(){
returnmaxAge;
}
//客户端返回的cookie在某个路径
publicvoidsetPath(Stringuri){
path=uri;
}
//返回客户端返回的cookie在server上的地址
publicStringgetPath(){
returnpath;
}
/**
*Indicatestothebrowserwhetherthecookieshouldonlybesent
*usingasecureprotocol,suchasHTTPSorSSL.
*<p>Thedefaultvalueis<code>false</code>.
*@paramflagif<code>true</code>,sendsthecookiefromthebrowser
*totheserveronlywhenusingasecureprotocol;
*if<code>false</code>,sentonanyprotocol
*@see#getSecure
*/
publicvoidsetSecure(booleanflag){
secure=flag;
}
publicbooleangetSecure(){
returnsecure;
}
//返回cookie的name,一旦创建name不可变
publicStringgetName(){
returnname;
}
//给cookie赋值
publicvoidsetValue(StringnewValue){
value=newValue;
}
//获得cookie的值
publicStringgetValue(){
returnvalue;
}
//返回cookie依从的协议版本
publicintgetVersion(){
returnversion;
}
//设置版本
publicvoidsetVersion(intv){
version=v;
}

//Note--disabledfornowtoallowfullNetscapecompatibility
//fromRFC2068,tokenspecialcasecharacters
//
//privatestaticfinalStringtspecials="()<>@,;:\\\"/[]?={}\t";

privatestaticfinalStringtspecials=",;";




/*
*Testsastringandreturnstrueifthestringcountsasa
*reservedtokenintheJavalanguage.
*
*@paramvaluethe<code>String</code>tobetested
*
*@return<code>true</code>ifthe<code>String</code>is
*areservedtoken;<code>false</code>
*ifitisnot
*/

privatebooleanisToken(Stringvalue){
intlen=value.length();

for(inti=0;i<len;i++){
charc=value.charAt(i);

if(c<0x20||c>=0x7f||tspecials.indexOf(c)!=-1)
returnfalse;
}
returntrue;
}
//复制cookie
publicObjectclone(){
try{
returnsuper.clone();
}catch(CloneNotSupportedExceptione){
thrownewRuntimeException(e.getMessage());
}
}
}

</pre><pre>