📄 user.java
字号:
package com.gs.db;
import java.util.*;
/**
* The User interface provides information about and services for users
* of the forum system. Users can be identified by a unique id or username.
* Users can also be organized into Groups for easier management of
* permissions at the forum level.
* <p>
* The name and email field will normally be required fields when creating
* user accounts for most implementations of forums. <p>
* Security for User objects is provide by UserProxy protection proxy objects.
*
* @see Group
*/
public interface User {
/**
* Returns the user's id. All ids must be unique in the system.
*
* @return the user's id.
*/
public int getID();
/**
* Returns true if the User object is an anonymous user object.
*
* @return true if the user is anonymous.
*/
public boolean isAnonymous();
/**
* Returns the user's username. All usernames must be unique in the system.
*
* @return the username of the user.
*/
public String getUsername();
/**
* Returns the user's name. The user's name does not have to be to be
* unique in the system. Some users may opt to not let others see their
* name for privacy reasons. In that case, the user can set nameVisible to
* false. In that case, a call to this method will return null.
*
* @return the name of the user.
*/
public String getName();
public void setUserName(String userName)throws UnauthorizedException;
/**
* Sets the user's name. The user's name does not have to be to be
* unique in the system.
*
* @param name new name for the user.
* @throws UnauthorizedException if does not have ADMIN permissions.
*/
public void setName(String name) throws UnauthorizedException;
/**
* Sets the users's password. The password should be passed in as
* plain text. The way the password is stored is implementation dependent.
* However, it is recommended to at least hash passwords with an
* algorithm such as MD5.
*
* @param password new password for the user.
* @throws UnauthorizedException if does not have ADMIN permissions.
*/
public void setPassword(String password) throws UnauthorizedException;
/**
* Returns the user's password in hashed form. This method is only intended
* for system administration functions and can be ignored by skin writers.
*
* @return the hashed password.
* @throws UnauthorizedException if does not have ADMIN permissions.
*/
public String getPasswordHash() throws UnauthorizedException;
/**
* Sets the user's password in hashed form. This method is only intended
* for system administration functions and can be ignored by skin writers.
*
* @param hashedPassword the hashedPassword for the user.
* @throws UnauthorizedException if does not have ADMIN permissions.
*/
public void setPasswordHash(String passwordHash) throws UnauthorizedException;
/**
* Returns the user's email address. Email should be considered to be
* a required field of a user account since it is critical to many
* user operations performing. If the user sets emailVisible to false,
* this method will always return null.
*
* @return the email address of the user.
*/
public String getEmail();
/**
* Sets the user's email address. Email should be considered to be
* a required field of a user account since it is critical to many
* user operations performing.
*
* @param email new email address for the user.
* @throws UnauthorizedException if does not have ADMIN permissions.
*/
public void setEmail(String email) throws UnauthorizedException;
/**
* Returns an extended property of the user. Each user can have an
* arbitrary number of extended properties. This lets particular skins
* or filters provide enhanced functionality that is not part of the base
* interface.
*
* @param name the name of the property to get.
* @return the value of the property
*/
public String getProperty(String name);
/**
* Returns an Enumeration of all the names of the extended user properties.
*
* @return an Enumeration of the property names.
*/
public Enumeration propertyNames();
/**
* Sets an extended property of the user. Each user can have an
* arbitrary number of extended properties. This lets particular skins
* or filters provide enhanced functionality that is not part of the base
* interface.
*
* @param name the name of the property to set.
* @param value the new value for the property.
*/
public void setProperty(String name, String value)throws UnauthorizedException;
/**
* Returns the permissions for the user that correspond to the
* passed-in Authorization.
*
* @param authorization the auth token to look up permissions with.
*/
public abstract IofficePermissions getPermissions(Authorization authorization);
/**
* Returns true if the handle on the object has the permission specified.
* A list of possible permissions can be found in the ForumPermissions
* class. Certain methods of this class are restricted to certain
* permissions as specified in the method comments.
*
* @see ForumPermissions
*/
public boolean hasPermission(int type);
public boolean isDisabled();
public boolean isDelete();
public void setStatue(int st)throws UnauthorizedException;
/**
* enable/diable the user, if the user is disabled it cannot
* login any more
*
* @param flag: true-enable / false -disable
* @throws UnauthorizedException if does not have ADMIN permissions.
*/
public void enable(boolean flag) throws UnauthorizedException;
}
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -