Package org.ametys.plugins.core.user

Class ImportUsers

java.lang.Object

org.ametys.runtime.plugin.component.AbstractLogEnabled

org.ametys.plugins.core.user.ImportUsers

All Implemented Interfaces:

LogEnabled, Component, Serviceable

public class ImportUsers
extends AbstractLogEnabled
implements Component, Serviceable

Import users from a CSV or text file.

Field Summary

Fields

Modifier and Type	Field	Description
protected CurrentUserProvider	_currentUserProvider	Current User Provider
protected I18nUtils	_i18nUtils	I18n utils
protected ObservationManager	_observationManager	Observation Manager
protected UserManager	_userManager	User Manager.
protected UserDAO	_usersDao	The subscribers DAO.
static final String	ROLE	Avalon Role

Constructor Summary

Constructors

Constructor	Description
ImportUsers()

Method Summary

Modifier and Type	Method	Description
protected List<Map<String,String>>	clearUserDirectory(String populationId, String userDirectoryId, List<UserIdentity> usersToSave)	Remove all users in a userDirectory, avoiding those in usersToSave list
Map<String,Object>	importUsers(Part filePart, String populationId, String userDirectoryId, boolean cleanDirectory, boolean hashedPasswords)	Read a file from disk and add users inside in the requested population/directory
protected Map<String,List<UserIdentity>>	parseFile(BOMInputStream bomIS, String populationId, String userDirectoryId, boolean hashedPassword)	Parse the file to add new users in the directory
void	service(ServiceManager smanager)

Methods inherited from class org.ametys.runtime.plugin.component.AbstractLogEnabled

getLogger, setLogger

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

ROLE

public static final String ROLE

Avalon Role

_usersDao

protected UserDAO _usersDao

The subscribers DAO.

_userManager

protected UserManager _userManager

User Manager.

_i18nUtils

protected I18nUtils _i18nUtils

I18n utils

_observationManager

protected ObservationManager _observationManager

Observation Manager

_currentUserProvider

protected CurrentUserProvider _currentUserProvider

Current User Provider

Constructor Details

ImportUsers

public ImportUsers()

Method Details

service

public void service(ServiceManager smanager)
             throws ServiceException

Specified by:

service in interface Serviceable

Throws:

ServiceException

importUsers

public Map<String,Object> importUsers(Part filePart,
 String populationId,
 String userDirectoryId,
 boolean cleanDirectory,
 boolean hashedPasswords)
                               throws FileNotFoundException,
InvalidModificationException

Read a file from disk and add users inside in the requested population/directory

Parameters:

filePart - file

populationId - population Id

userDirectoryId - user directory

cleanDirectory - true to clear every user that was not in the import file

hashedPasswords - true if the passwords are already hashed in the file (salt must be in the file too, and password hashed with "saltPassword" with nothing in-between)

Returns:

a map containing success, addedCount, existingCount, errorCount, deletedCount, message success : true if success addedCount, existingCount, errorCount : number of imported user added, modified, an error occured (see server log) message : error message if something wrong happened (usually malformed file)

Throws:

FileNotFoundException - error reading the file

InvalidModificationException - error modifying the directory

clearUserDirectory

protected List<Map<String,String>> clearUserDirectory(String populationId,
 String userDirectoryId,
 List<UserIdentity> usersToSave)
                                               throws InvalidModificationException

Remove all users in a userDirectory, avoiding those in usersToSave list

Parameters:

populationId - population Id

userDirectoryId - directory Id

usersToSave - list of users that need to be saved

Returns:

list of deleted users (containing login and populationId)

Throws:

InvalidModificationException - If modification is not possible

parseFile

protected Map<String,List<UserIdentity>> parseFile(BOMInputStream bomIS,
 String populationId,
 String userDirectoryId,
 boolean hashedPassword)
                                            throws IOException,
org.ametys.plugins.core.user.ImportUsers.ImportUserActionException

Parse the file to add new users in the directory

Parameters:

bomIS - input stream

populationId - population Id

userDirectoryId - directory Id

hashedPassword - true if the password is hashed

Returns:

a map, containing added/edited/error, each containing the logins in each list

Throws:

IOException - if an error occurs

org.ametys.plugins.core.user.ImportUsers.ImportUserActionException - file parsing failed