Added clarification to documentation indicating the valid range of values

for site identifiers.


git-svn-id: https://samskivert.googlecode.com/svn/trunk@426 6335cc39-0255-0410-8fd6-9bcaacd3b74c
This commit is contained in:
mdb
2001-11-06 04:48:35 +00:00
parent e65d5436a7
commit d9622d84de
@@ -1,5 +1,5 @@
// //
// $Id: SiteIdentifier.java,v 1.1 2001/10/31 23:38:37 mdb Exp $ // $Id: SiteIdentifier.java,v 1.2 2001/11/06 04:48:35 mdb Exp $
// //
// samskivert library - useful routines for java programs // samskivert library - useful routines for java programs
// Copyright (C) 2001 Michael Bayne // Copyright (C) 2001 Michael Bayne
@@ -24,10 +24,11 @@ import javax.servlet.http.HttpServletRequest;
/** /**
* Responsible for determining the unique site identifier based on * Responsible for determining the unique site identifier based on
* information available in the HTTP request. Because the site identifier * information available in the HTTP request. Site identifiers are
* implementation is likely to have access to the site classification * integers ranging from 1 to {@link Integer#MAX_VALUE}. Because the site
* metadata, this interface is also used to map integer site identifiers * identifier implementation is likely to have access to the site
* to string site identifiers. * classification metadata, this interface is also used to map integer
* site identifiers to string site identifiers.
*/ */
public interface SiteIdentifier public interface SiteIdentifier
{ {
@@ -49,7 +50,8 @@ public interface SiteIdentifier
* trying to identify. * trying to identify.
* *
* @return the unique site identifier requestsed or {@link * @return the unique site identifier requestsed or {@link
* #DEFAULT_SITE_ID} if the site could not be identified. * #DEFAULT_SITE_ID} if the site could not be identified. No site
* should ever have a site id value of 0.
*/ */
public int identifySite (HttpServletRequest req); public int identifySite (HttpServletRequest req);