authorization.java

来自「Jive是基于JSP/JAVA技术构架的一个大型BBS论坛系统,这是Jive论坛」· Java 代码 · 共 47 行

/**
 * $RCSfile: Authorization.java,v $
 * $Revision: 1.2 $
 * $Date: 2002/07/08 14:29:32 $
 *
 * Copyright (C) 1999-2001 CoolServlets, Inc. All rights reserved.
 *
 * This software is the proprietary information of CoolServlets, Inc.
 * Use is subject to license terms.
 */

package com.jivesoftware.forum;

/**
 * Proves that a user has successfully logged in. The existence of an
 * Authorization object indicates that a person has logged in correctly
 * and has authentication to act as the user associated with the
 * authentication. An instance of this object can be obtained from an
 * AuthorizationFactory and must be passed in to to get an intstance of
 * ForumFactory.
 * <p>
 * In the case of using the core forum services through a web interface, the
 * expected behavior is to have a user login and then store the Authorization
 * object in their session. In some app servers, all objects put in the session
 * must be seriablizable. The default Authorization implementation obeys this
 * rule, but ensure that custom Authorization classes do as well.
 *
 * @see AuthorizationFactory
 * @see ForumFactory
 */
public interface Authorization {

    /**
     * Returns the userID associated with this Authorization. The value -1 should be returned
     * for anonymous authorization tokens.
     *
     * @return the userID associated with this Authorization.
     */
    public long getUserID();

    /**
     * Returns true if this Authorization is the Anonymous authorization token.
     *
     * @return true if this token is the anonymous Authorization.
     */
    public boolean isAnonymous();
}