org.opennms.netmgt.config

Class UserManager

java.lang.Object

org.opennms.netmgt.config.UserManager

All Implemented Interfaces:

UserConfig

Direct Known Subclasses:

MockUserManager, UserFactory

public abstract class UserManager
extends Object
implements UserConfig

Abstract UserManager class.

Author:

David Hustace, Matt Brozowski, Benjamin Reed, Jeff Gehlbach

Nested Class Summary

Nested classes/interfaces inherited from interface org.opennms.netmgt.config.api.UserConfig

UserConfig.ContactType

Field Summary

Fields

Modifier and Type	Field and Description
protected Map<String,List<DutySchedule>>	m_dutySchedules The duty schedules for each user
protected GroupManager	m_groupManager
protected Map<String,User>	m_users A mapping of user IDs to the User objects

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	UserManager(GroupManager groupManager) Constructor for UserManager.

Method Summary

Modifier and Type	Method and Description
boolean	checkSaltedPassword(String raw, String encrypted) checkSaltedPassword
boolean	comparePasswords(String userID, String aPassword) This method compares two encrypted strings for equality.
int	countUsersWithRole(String roleid) countUsersWithRole
void	deleteUser(String name) Removes the user from the list of users.
protected abstract void	doUpdate() update
String	encryptedPassword(String aPassword, boolean useSalt) encryptedPassword
String	getContactInfo(String userID, String command) Get the contact info given a command string
String	getContactInfo(String userId, UserConfig.ContactType contactType) getContactInfo
String	getContactInfo(User user, String command) getContactInfo
String	getContactServiceProvider(String userID, String command) Get the contact service provider, given a command string
String	getContactServiceProvider(User user, String command) getContactServiceProvider
String	getEmail(String userID) Get a email by name
String	getEmail(User user) Get a email by user
abstract long	getFileSize()
String	getHomePhone(String userID) Get a home phone number
String	getHomePhone(User user) Get a home phone number
abstract long	getLastModified()
String	getMicroblogName(String name) Get a user's microblog username by username
String	getMicroblogName(User user) Get a user's microblog username by User
String	getMobilePhone(String userID) Get a mobile phone number
String	getMobilePhone(User user) Get a mobile phone number
String	getNumericPage(String userID) Get a numeric service provider
String	getNumericPage(User user) Get a numeric service provider
String	getNumericPin(String userID) Get a numeric pin
String	getNumericPin(User user) Get a numeric pin
OnmsUser	getOnmsUser(String username) getOnmsUser
OnmsUserList	getOnmsUserList() getOnmsUserList
String	getPagerEmail(String userID) Get a pager email by name
String	getPagerEmail(User user) Get a pager email by user
String	getTextPage(String userID) Get a Text Page Service Provider
String	getTextPage(User user) Get a Text Page Service Provider
String	getTextPin(String userID) Get a text pin
String	getTextPin(User user) Get a text pin
String	getTuiPin(String name) Get a user's telephone PIN by name
String	getTuiPin(User user) Get a user's telephone PIN by User object
User	getUser(String name) Get a user by name
List<String>	getUserNames() getUserNames
Map<String,User>	getUsers() Return a Map of usernames to user instances.
String[]	getUsersScheduledForRole(String roleid, Date time) getUsersScheduledForRole
String[]	getUsersWithRole(String roleid) getUsersWithRole
String	getWorkPhone(String userID) Get a work phone number
String	getWorkPhone(User user) Get a work phone number
String	getXMPPAddress(String userID) Get an XMPP address by name
String	getXMPPAddress(User user) Get an XMPP address by name
boolean	hasOnCallRole(String roleid) hasOnCallRole
boolean	hasUser(String userName) Returns a boolean indicating if the user name appears in the XML file
abstract boolean	isUpdateNeeded()
boolean	isUserOnDuty(String user, Calendar time) Determines if a user is on duty at a given time.
boolean	isUserScheduledForRole(User user, String roleid, Date time) isUserScheduledForRole
void	parseXML(InputStream in) parseXML
abstract void	reload()
void	renameUser(String oldName, String newName) When this method is called users name is changed, so also is the username belonging to the group and the view.
void	save(OnmsUser onmsUser) save
void	saveUser(String name, User details) Adds a new user and overwrites the "users.xml"
void	saveUsers(Collection<User> usersList) saveUsers
protected abstract void	saveXML(String writerString) saveXML
void	setContactInfo(String userId, UserConfig.ContactType contactType, String contactValue) setContactInfo
void	setEncryptedPassword(String userID, String aPassword, boolean salted) Sets the password for this user, assuming that the value passed in is already encrypted properly
void	setUnencryptedPassword(String userID, String aPassword) Sets the password for this user, first encrypting it
void	update() update
boolean	userHasRole(User user, String roleid) userHasRole

Methods inherited from class java.lang.Object

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

Field Detail

m_groupManager

protected GroupManager m_groupManager

m_users

protected Map<String,User> m_users

A mapping of user IDs to the User objects

m_dutySchedules

protected Map<String,List<DutySchedule>> m_dutySchedules

The duty schedules for each user

Constructor Detail

UserManager

protected UserManager(GroupManager groupManager)

Constructor for UserManager.

Parameters:

groupManager - a GroupManager object.

Method Detail

parseXML

public void parseXML(InputStream in)

parseXML

Specified by:

parseXML in interface UserConfig

Parameters:

in - a InputStream object.

saveUser

public void saveUser(String name,
                     User details)
              throws Exception

Adds a new user and overwrites the "users.xml"

Specified by:

saveUser in interface UserConfig

Parameters:

name - a String object.

details - a User object.

Throws:

Exception - if any.

save

public void save(OnmsUser onmsUser)
          throws Exception

Description copied from interface: UserConfig

save

Specified by:

save in interface UserConfig

Throws:

Exception

isUserOnDuty

public boolean isUserOnDuty(String user,
                            Calendar time)
                     throws IOException

Determines if a user is on duty at a given time. If a user has no duty schedules listed in the configuration file, that user is assumed to always be on duty.

Specified by:

isUserOnDuty in interface UserConfig

Parameters:

user - the user id

time - the time to check for a duty schedule

Returns:

boolean, true if the user is on duty, false otherwise.

Throws:

IOException - if any.

getUsers

public Map<String,User> getUsers()
                          throws IOException

Return a Map of usernames to user instances.

Specified by:

getUsers in interface UserConfig

Returns:

a Map object.

Throws:

IOException - if any.

getOnmsUserList

public OnmsUserList getOnmsUserList()
                             throws IOException

Description copied from interface: UserConfig

getOnmsUserList

Specified by:

getOnmsUserList in interface UserConfig

Returns:

an OnmsUserList

Throws:

IOException

getOnmsUser

public OnmsUser getOnmsUser(String username)
                     throws IOException

Description copied from interface: UserConfig

getOnmsUser

Specified by:

getOnmsUser in interface UserConfig

Returns:

an OnmsUser

Throws:

IOException

hasUser

public boolean hasUser(String userName)
                throws IOException

Returns a boolean indicating if the user name appears in the XML file

Specified by:

hasUser in interface UserConfig

Parameters:

userName - a String object.

Returns:

true if the user exists in the XML file, false otherwise

Throws:

IOException - if any.

getUserNames

public List<String> getUserNames()
                          throws IOException

getUserNames

Specified by:

getUserNames in interface UserConfig

Returns:

a List object.

Throws:

IOException - if any.

getUser

public User getUser(String name)
             throws IOException

Get a user by name

Specified by:

getUser in interface UserConfig

Parameters:

name - the name of the user to return

Returns:

the user specified by name

Throws:

IOException - if any.

getTuiPin

public String getTuiPin(String name)
                 throws IOException

Get a user's telephone PIN by name

Specified by:

getTuiPin in interface UserConfig

Parameters:

name - the name of the user to return

Returns:

the telephone PIN of the user specified by name

Throws:

IOException - if any.

getTuiPin

public String getTuiPin(User user)
                 throws IOException

Get a user's telephone PIN by User object

Specified by:

getTuiPin in interface UserConfig

Parameters:

user - a User object.

Returns:

the telephone PIN of the user specified by user

Throws:

IOException - if any.

getMicroblogName

public String getMicroblogName(String name)
                        throws FileNotFoundException,
                               IOException

Get a user's microblog username by username

Specified by:

getMicroblogName in interface UserConfig

Parameters:

name - the username of the user whose microblog username should be returned

Returns:

the microblog username of the specified user

Throws:

IOException - if any.

FileNotFoundException - if any.

getMicroblogName

public String getMicroblogName(User user)
                        throws FileNotFoundException,
                               IOException

Get a user's microblog username by User

Parameters:

user - the user object of the user whose microblog username should be returned

Returns:

the microblog username of the specified user

Throws:

IOException - if any.

FileNotFoundException - if any.

setContactInfo

public void setContactInfo(String userId,
                           UserConfig.ContactType contactType,
                           String contactValue)
                    throws Exception

Description copied from interface: UserConfig

setContactInfo

Specified by:

setContactInfo in interface UserConfig

Throws:

Exception

getContactInfo

public String getContactInfo(String userId,
                             UserConfig.ContactType contactType)
                      throws IOException

Description copied from interface: UserConfig

getContactInfo

Specified by:

getContactInfo in interface UserConfig

Returns:

a String

Throws:

IOException

See Also:

#getContactInfo(String, String)}

getContactInfo

public String getContactInfo(String userID,
                             String command)
                      throws IOException

Get the contact info given a command string

Specified by:

getContactInfo in interface UserConfig

Parameters:

userID - the name of the user

command - the command to look up the contact info for

Returns:

the contact information

Throws:

IOException - if any.

getContactInfo

public String getContactInfo(User user,
                             String command)
                      throws IOException

getContactInfo

Specified by:

getContactInfo in interface UserConfig

Parameters:

user - a User object.

command - a String object.

Returns:

a String object.

Throws:

IOException - if any.

getContactServiceProvider

public String getContactServiceProvider(String userID,
                                        String command)
                                 throws IOException

Get the contact service provider, given a command string

Specified by:

getContactServiceProvider in interface UserConfig

Parameters:

userID - the name of the user

command - the command to look up the contact info for

Returns:

the contact information

Throws:

IOException - if any.

getContactServiceProvider

public String getContactServiceProvider(User user,
                                        String command)
                                 throws IOException

getContactServiceProvider

Specified by:

getContactServiceProvider in interface UserConfig

Parameters:

user - a User object.

command - a String object.

Returns:

a String object.

Throws:

IOException - if any.

getEmail

public String getEmail(String userID)
                throws IOException

Get a email by name

Specified by:

getEmail in interface UserConfig

Parameters:

userID - the user ID of the user to return

Returns:

String the email specified by name

Throws:

IOException - if any.

getEmail

public String getEmail(User user)
                throws IOException

Get a email by user

Specified by:

getEmail in interface UserConfig

Parameters:

user - the user to find the email for

Returns:

String the email specified by name

Throws:

IOException - if any.

getPagerEmail

public String getPagerEmail(String userID)
                     throws IOException

Get a pager email by name

Specified by:

getPagerEmail in interface UserConfig

Parameters:

userID - the user ID of the user to return

Returns:

String the pager email

Throws:

IOException - if any.

getPagerEmail

public String getPagerEmail(User user)
                     throws IOException

Get a pager email by user

Specified by:

getPagerEmail in interface UserConfig

Parameters:

user - a User object.

Returns:

String the pager email

Throws:

IOException - if any.

getNumericPin

public String getNumericPin(String userID)
                     throws IOException

Get a numeric pin

Specified by:

getNumericPin in interface UserConfig

Parameters:

userID - the user ID of the user to return

Returns:

String the numeric pin

Throws:

IOException - if any.

getNumericPin

public String getNumericPin(User user)
                     throws IOException

Get a numeric pin

Specified by:

getNumericPin in interface UserConfig

Parameters:

user - a User object.

Returns:

String the numeric pin

Throws:

IOException - if any.

getXMPPAddress

public String getXMPPAddress(String userID)
                      throws IOException

Get an XMPP address by name

Specified by:

getXMPPAddress in interface UserConfig

Parameters:

userID - the user ID of the user to return

Returns:

String the XMPP address

Throws:

IOException - if any.

getXMPPAddress

public String getXMPPAddress(User user)
                      throws IOException

Get an XMPP address by name

Specified by:

getXMPPAddress in interface UserConfig

Parameters:

user - a User object.

Returns:

String the XMPP address

Throws:

IOException - if any.

getNumericPage

public String getNumericPage(String userID)
                      throws IOException

Get a numeric service provider

Specified by:

getNumericPage in interface UserConfig

Parameters:

userID - the user ID of the user to return

Returns:

String the service provider

Throws:

IOException - if any.

getNumericPage

public String getNumericPage(User user)
                      throws IOException

Get a numeric service provider

Specified by:

getNumericPage in interface UserConfig

Parameters:

user - a User object.

Returns:

String the service provider

Throws:

IOException - if any.

getTextPin

public String getTextPin(String userID)
                  throws IOException

Get a text pin

Specified by:

getTextPin in interface UserConfig

Parameters:

userID - the user ID of the user to return

Returns:

String the text pin

Throws:

IOException - if any.

getTextPin

public String getTextPin(User user)
                  throws IOException

Get a text pin

Specified by:

getTextPin in interface UserConfig

Parameters:

user - a User object.

Returns:

String the text pin

Throws:

IOException - if any.

getTextPage

public String getTextPage(String userID)
                   throws IOException

Get a Text Page Service Provider

Specified by:

getTextPage in interface UserConfig

Parameters:

userID - the user ID of the user to return

Returns:

String the text page service provider.

Throws:

IOException - if any.

getTextPage

public String getTextPage(User user)
                   throws IOException

Get a Text Page Service Provider

Specified by:

getTextPage in interface UserConfig

Parameters:

user - a User object.

Returns:

String the text page service provider.

Throws:

IOException - if any.

getWorkPhone

public String getWorkPhone(String userID)
                    throws IOException

Get a work phone number

Specified by:

getWorkPhone in interface UserConfig

Parameters:

userID - the user ID of the user to return

Returns:

String the work phone number

Throws:

IOException - if any.

getWorkPhone

public String getWorkPhone(User user)
                    throws IOException

Get a work phone number

Specified by:

getWorkPhone in interface UserConfig

Parameters:

user - a User object.

Returns:

String the work phone number

Throws:

IOException - if any.

getMobilePhone

public String getMobilePhone(String userID)
                      throws IOException

Get a mobile phone number

Specified by:

getMobilePhone in interface UserConfig

Parameters:

userID - the user ID of the user to return

Returns:

String the mobile phone number

Throws:

IOException - if any.

getMobilePhone

public String getMobilePhone(User user)
                      throws IOException

Get a mobile phone number

Specified by:

getMobilePhone in interface UserConfig

Parameters:

user - a User object.

Returns:

String the mobile phone number

Throws:

IOException - if any.

getHomePhone

public String getHomePhone(String userID)
                    throws IOException

Get a home phone number

Specified by:

getHomePhone in interface UserConfig

Parameters:

userID - the user ID of the user to return

Returns:

String the home phone number

Throws:

IOException - if any.

getHomePhone

public String getHomePhone(User user)
                    throws IOException

Get a home phone number

Specified by:

getHomePhone in interface UserConfig

Parameters:

user - a User object.

Returns:

String the home phone number

Throws:

IOException - if any.

saveUsers

public void saveUsers(Collection<User> usersList)
               throws Exception

saveUsers

Specified by:

saveUsers in interface UserConfig

Parameters:

usersList - a Collection object.

Throws:

Exception - if any.

deleteUser

public void deleteUser(String name)
                throws Exception

Removes the user from the list of users. Then overwrites to the "users.xml"

Specified by:

deleteUser in interface UserConfig

Parameters:

name - a String object.

Throws:

Exception - if any.

saveXML

protected abstract void saveXML(String writerString)
                         throws IOException

saveXML

Parameters:

writerString - a String object.

Throws:

IOException - if any.

renameUser

public void renameUser(String oldName,
                       String newName)
                throws Exception

When this method is called users name is changed, so also is the username belonging to the group and the view. Also overwrites the "users.xml" file

Specified by:

renameUser in interface UserConfig

Parameters:

oldName - a String object.

newName - a String object.

Throws:

Exception - if any.

setEncryptedPassword

public void setEncryptedPassword(String userID,
                                 String aPassword,
                                 boolean salted)
                          throws Exception

Sets the password for this user, assuming that the value passed in is already encrypted properly

Specified by:

setEncryptedPassword in interface UserConfig

Parameters:

userID - the user ID to change the password for

aPassword - the encrypted password

Throws:

Exception - if any.

setUnencryptedPassword

public void setUnencryptedPassword(String userID,
                                   String aPassword)
                            throws Exception

Sets the password for this user, first encrypting it

Specified by:

setUnencryptedPassword in interface UserConfig

Parameters:

userID - the user ID to change the password for

aPassword - the password

Throws:

Exception - if any.

encryptedPassword

public String encryptedPassword(String aPassword,
                                boolean useSalt)

encryptedPassword

Specified by:

encryptedPassword in interface UserConfig

Parameters:

aPassword - a String object.

useSalt - TODO

Returns:

a String object.

comparePasswords

public boolean comparePasswords(String userID,
                                String aPassword)

This method compares two encrypted strings for equality.

Specified by:

comparePasswords in interface UserConfig

Parameters:

userID - the user ID to check against.

aPassword - the password to check for equality

Returns:

true if the two passwords are equal (after encryption), false otherwise

checkSaltedPassword

public boolean checkSaltedPassword(String raw,
                                   String encrypted)

Description copied from interface: UserConfig

checkSaltedPassword

Specified by:

checkSaltedPassword in interface UserConfig

Returns:

a boolean

doUpdate

protected abstract void doUpdate()
                          throws IOException,
                                 FileNotFoundException

update

Throws:

IOException - if any.

FileNotFoundException - if any.

update

public final void update()
                  throws IOException,
                         FileNotFoundException

Description copied from interface: UserConfig

update

Specified by:

update in interface UserConfig

Throws:

IOException

FileNotFoundException

getUsersWithRole

public String[] getUsersWithRole(String roleid)
                          throws IOException

getUsersWithRole

Specified by:

getUsersWithRole in interface UserConfig

Parameters:

roleid - a String object.

Returns:

an array of String objects.

Throws:

IOException - if any.

userHasRole

public boolean userHasRole(User user,
                           String roleid)
                    throws FileNotFoundException,
                           IOException

userHasRole

Specified by:

userHasRole in interface UserConfig

Parameters:

user - a User object.

roleid - a String object.

Returns:

a boolean.

Throws:

FileNotFoundException - if any.

IOException - if any.

isUserScheduledForRole

public boolean isUserScheduledForRole(User user,
                                      String roleid,
                                      Date time)
                               throws FileNotFoundException,
                                      IOException

isUserScheduledForRole

Specified by:

isUserScheduledForRole in interface UserConfig

Parameters:

user - a User object.

roleid - a String object.

time - a Date object.

Returns:

a boolean.

Throws:

FileNotFoundException - if any.

IOException - if any.

getUsersScheduledForRole

public String[] getUsersScheduledForRole(String roleid,
                                         Date time)
                                  throws IOException

getUsersScheduledForRole

Specified by:

getUsersScheduledForRole in interface UserConfig

Parameters:

roleid - a String object.

time - a Date object.

Returns:

an array of String objects.

Throws:

IOException - if any.

hasOnCallRole

public boolean hasOnCallRole(String roleid)
                      throws IOException

hasOnCallRole

Specified by:

hasOnCallRole in interface UserConfig

Parameters:

roleid - a String object.

Returns:

a boolean.

Throws:

IOException - if any.

countUsersWithRole

public int countUsersWithRole(String roleid)
                       throws IOException

countUsersWithRole

Specified by:

countUsersWithRole in interface UserConfig

Parameters:

roleid - a String object.

Returns:

a int.

Throws:

IOException - if any.

isUpdateNeeded

public abstract boolean isUpdateNeeded()

getLastModified

public abstract long getLastModified()

getFileSize

public abstract long getFileSize()

reload

public abstract void reload()
                     throws IOException,
                            FileNotFoundException

Throws:

IOException

FileNotFoundException