| | |
|---|
| | |
|
|---|
| | | import java.util.List;
|
|---|
| | |
|
|---|
| | | import com.gitblit.models.TeamModel;
|
|---|
| | | import com.gitblit.models.UserModel;
|
|---|
| | |
|
|---|
| | | /**
|
|---|
| | |
|---|
| | | */
|
|---|
| | | public interface IUserService {
|
|---|
| | |
|
|---|
| | | /**
|
|---|
| | | * Setup the user service. This method allows custom implementations to
|
|---|
| | | * retrieve settings from gitblit.properties or the web.xml file without
|
|---|
| | | * relying on the GitBlit static singleton.
|
|---|
| | | * |
|---|
| | | * @param settings
|
|---|
| | | * @since 0.7.0
|
|---|
| | | */
|
|---|
| | | void setup(IStoredSettings settings);
|
|---|
| | |
|
|---|
| | | /**
|
|---|
| | | * Does the user service support changes to credentials?
|
|---|
| | | * |
|---|
| | | * @return true or false
|
|---|
| | | * @since 1.0.0
|
|---|
| | | */ |
|---|
| | | boolean supportsCredentialChanges();
|
|---|
| | |
|
|---|
| | | /**
|
|---|
| | | * Does the user service support changes to user display name?
|
|---|
| | | * |
|---|
| | | * @return true or false
|
|---|
| | | * @since 1.0.0
|
|---|
| | | */ |
|---|
| | | boolean supportsDisplayNameChanges();
|
|---|
| | |
|
|---|
| | | /**
|
|---|
| | | * Does the user service support changes to user email address?
|
|---|
| | | * |
|---|
| | | * @return true or false
|
|---|
| | | * @since 1.0.0
|
|---|
| | | */ |
|---|
| | | boolean supportsEmailAddressChanges();
|
|---|
| | | |
|---|
| | | /**
|
|---|
| | | * Does the user service support changes to team memberships?
|
|---|
| | | * |
|---|
| | | * @return true or false
|
|---|
| | | * @since 1.0.0
|
|---|
| | | */ |
|---|
| | | boolean supportsTeamMembershipChanges();
|
|---|
| | | |
|---|
| | | /**
|
|---|
| | | * Does the user service support cookie authentication?
|
|---|
| | | *
|
|---|
| | |
|---|
| | | */
|
|---|
| | | UserModel authenticate(String username, char[] password);
|
|---|
| | |
|
|---|
| | | /**
|
|---|
| | | * Logout a user.
|
|---|
| | | * |
|---|
| | | * @param user
|
|---|
| | | */
|
|---|
| | | void logout(UserModel user);
|
|---|
| | | |
|---|
| | | /**
|
|---|
| | | * Retrieve the user object for the specified username.
|
|---|
| | | *
|
|---|
| | |
|---|
| | | * @return list of all usernames
|
|---|
| | | */
|
|---|
| | | List<String> getAllUsernames();
|
|---|
| | | |
|---|
| | | /**
|
|---|
| | | * Returns the list of all users available to the login service.
|
|---|
| | | * |
|---|
| | | * @return list of all users
|
|---|
| | | * @since 0.8.0
|
|---|
| | | */
|
|---|
| | | List<UserModel> getAllUsers();
|
|---|
| | |
|
|---|
| | | /**
|
|---|
| | | * Returns the list of all teams available to the login service.
|
|---|
| | | * |
|---|
| | | * @return list of all teams
|
|---|
| | | * @since 0.8.0
|
|---|
| | | */ |
|---|
| | | List<String> getAllTeamNames();
|
|---|
| | | |
|---|
| | | /**
|
|---|
| | | * Returns the list of all teams available to the login service.
|
|---|
| | | * |
|---|
| | | * @return list of all teams
|
|---|
| | | * @since 0.8.0
|
|---|
| | | */ |
|---|
| | | List<TeamModel> getAllTeams();
|
|---|
| | | |
|---|
| | | /**
|
|---|
| | | * Returns the list of all users who are allowed to bypass the access
|
|---|
| | | * restriction placed on the specified repository.
|
|---|
| | | * |
|---|
| | | * @param role
|
|---|
| | | * the repository name
|
|---|
| | | * @return list of all usernames that can bypass the access restriction
|
|---|
| | | * @since 0.8.0
|
|---|
| | | */ |
|---|
| | | List<String> getTeamnamesForRepositoryRole(String role);
|
|---|
| | |
|
|---|
| | | /**
|
|---|
| | | * Sets the list of all teams who are allowed to bypass the access
|
|---|
| | | * restriction placed on the specified repository.
|
|---|
| | | * |
|---|
| | | * @param role
|
|---|
| | | * the repository name
|
|---|
| | | * @param teamnames
|
|---|
| | | * @return true if successful
|
|---|
| | | * @since 0.8.0
|
|---|
| | | */ |
|---|
| | | boolean setTeamnamesForRepositoryRole(String role, List<String> teamnames);
|
|---|
| | | |
|---|
| | | /**
|
|---|
| | | * Retrieve the team object for the specified team name.
|
|---|
| | | * |
|---|
| | | * @param teamname
|
|---|
| | | * @return a team object or null
|
|---|
| | | * @since 0.8.0
|
|---|
| | | */ |
|---|
| | | TeamModel getTeamModel(String teamname);
|
|---|
| | |
|
|---|
| | | /**
|
|---|
| | | * Updates/writes a complete team object.
|
|---|
| | | * |
|---|
| | | * @param model
|
|---|
| | | * @return true if update is successful
|
|---|
| | | * @since 0.8.0
|
|---|
| | | */ |
|---|
| | | boolean updateTeamModel(TeamModel model);
|
|---|
| | |
|
|---|
| | | /**
|
|---|
| | | * Updates/writes and replaces a complete team object keyed by teamname.
|
|---|
| | | * This method allows for renaming a team.
|
|---|
| | | * |
|---|
| | | * @param teamname
|
|---|
| | | * the old teamname
|
|---|
| | | * @param model
|
|---|
| | | * the team object to use for teamname
|
|---|
| | | * @return true if update is successful
|
|---|
| | | * @since 0.8.0
|
|---|
| | | */
|
|---|
| | | boolean updateTeamModel(String teamname, TeamModel model);
|
|---|
| | |
|
|---|
| | | /**
|
|---|
| | | * Deletes the team object from the user service.
|
|---|
| | | * |
|---|
| | | * @param model
|
|---|
| | | * @return true if successful
|
|---|
| | | * @since 0.8.0
|
|---|
| | | */
|
|---|
| | | boolean deleteTeamModel(TeamModel model);
|
|---|
| | |
|
|---|
| | | /**
|
|---|
| | | * Delete the team object with the specified teamname
|
|---|
| | | * |
|---|
| | | * @param teamname
|
|---|
| | | * @return true if successful
|
|---|
| | | * @since 0.8.0
|
|---|
| | | */ |
|---|
| | | boolean deleteTeam(String teamname);
|
|---|
| | |
|
|---|
| | | /**
|
|---|
| | | * Returns the list of all users who are allowed to bypass the access
|
|---|
| | |
|---|
| | | * @param role
|
|---|
| | | * the repository name
|
|---|
| | | * @return list of all usernames that can bypass the access restriction
|
|---|
| | | * @since 0.8.0
|
|---|
| | | */
|
|---|
| | | List<String> getUsernamesForRepositoryRole(String role);
|
|---|
| | |
|
|---|
