org.opennms.netmgt.config

Class UserManager

java.lang.Object

org.opennms.netmgt.config.UserManager

Direct Known Subclasses:

MockUserManager, UserFactory

public abstract class UserManager
extends Object

Abstract UserManager class.

Author:

David Hustace, Matt Brozowski, Benjamin Reed

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	UserManager.ContactType

Field Summary

Fields

Modifier and Type	Field and Description
protected HashMap<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

Methods

Modifier and Type	Method and Description
boolean	checkSaltedPassword(String raw, String encrypted)
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(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)
OnmsUserList	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	hasRole(String roleid) hasRole
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 user)
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	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()
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 HashMap<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)
              throws org.exolab.castor.xml.MarshalException,
                     org.exolab.castor.xml.ValidationException

parseXML

Parameters:

in - a InputStream object.

Throws:

org.exolab.castor.xml.MarshalException - if any.

org.exolab.castor.xml.ValidationException - if any.

saveUser

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

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

Parameters:

name - a String object.

details - a User object.

Throws:

Exception - if any.

save

public void save(OnmsUser user)
          throws Exception

Throws:

Exception

isUserOnDuty

public boolean isUserOnDuty(String user,
                   Calendar time)
                     throws IOException,
                            org.exolab.castor.xml.MarshalException,
                            org.exolab.castor.xml.ValidationException

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.

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.

org.exolab.castor.xml.MarshalException - if any.

org.exolab.castor.xml.ValidationException - if any.

getUsers

public Map<String,User> getUsers()
                          throws IOException,
                                 org.exolab.castor.xml.MarshalException,
                                 org.exolab.castor.xml.ValidationException

Return a Map of usernames to user instances.

Returns:

a Map object.

Throws:

IOException - if any.

org.exolab.castor.xml.MarshalException - if any.

org.exolab.castor.xml.ValidationException - if any.

getOnmsUserList

public OnmsUserList getOnmsUserList()
                             throws org.exolab.castor.xml.MarshalException,
                                    org.exolab.castor.xml.ValidationException,
                                    IOException

Throws:

org.exolab.castor.xml.MarshalException

org.exolab.castor.xml.ValidationException

IOException

getOnmsUser

public OnmsUser getOnmsUser(String username)
                     throws org.exolab.castor.xml.MarshalException,
                            org.exolab.castor.xml.ValidationException,
                            IOException

Throws:

org.exolab.castor.xml.MarshalException

org.exolab.castor.xml.ValidationException

IOException

hasUser

public boolean hasUser(String userName)
                throws IOException,
                       org.exolab.castor.xml.MarshalException,
                       org.exolab.castor.xml.ValidationException

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

Parameters:

userName - a String object.

Returns:

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

Throws:

IOException - if any.

org.exolab.castor.xml.MarshalException - if any.

org.exolab.castor.xml.ValidationException - if any.

getUserNames

public List<String> getUserNames()
                          throws IOException,
                                 org.exolab.castor.xml.MarshalException,
                                 org.exolab.castor.xml.ValidationException

getUserNames

Returns:

a List object.

Throws:

IOException - if any.

org.exolab.castor.xml.MarshalException - if any.

org.exolab.castor.xml.ValidationException - if any.

getUser

public User getUser(String name)
             throws IOException,
                    org.exolab.castor.xml.MarshalException,
                    org.exolab.castor.xml.ValidationException

Get a user by name

Parameters:

name - the name of the user to return

Returns:

the user specified by name

Throws:

IOException - if any.

org.exolab.castor.xml.MarshalException - if any.

org.exolab.castor.xml.ValidationException - if any.

getTuiPin

public String getTuiPin(String name)
                 throws IOException,
                        org.exolab.castor.xml.MarshalException,
                        org.exolab.castor.xml.ValidationException

Get a user's telephone PIN by name

Parameters:

name - the name of the user to return

Returns:

the telephone PIN of the user specified by name

Throws:

IOException - if any.

org.exolab.castor.xml.MarshalException - if any.

org.exolab.castor.xml.ValidationException - if any.

getTuiPin

public String getTuiPin(User user)
                 throws IOException,
                        org.exolab.castor.xml.MarshalException,
                        org.exolab.castor.xml.ValidationException

Get a user's telephone PIN by User object

Parameters:

user - a User object.

Returns:

the telephone PIN of the user specified by user

Throws:

IOException - if any.

org.exolab.castor.xml.MarshalException - if any.

org.exolab.castor.xml.ValidationException - if any.

getMicroblogName

public String getMicroblogName(String name)
                        throws org.exolab.castor.xml.MarshalException,
                               org.exolab.castor.xml.ValidationException,
                               FileNotFoundException,
                               IOException

Get a user's microblog username by username

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.

org.exolab.castor.xml.ValidationException - if any.

org.exolab.castor.xml.MarshalException - if any.

getMicroblogName

public String getMicroblogName(User user)
                        throws org.exolab.castor.xml.MarshalException,
                               org.exolab.castor.xml.ValidationException,
                               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.

org.exolab.castor.xml.ValidationException - if any.

org.exolab.castor.xml.MarshalException - if any.

getContactInfo

public String getContactInfo(String userID,
                    String command)
                      throws IOException,
                             org.exolab.castor.xml.MarshalException,
                             org.exolab.castor.xml.ValidationException

Get the contact info given a command string

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.

org.exolab.castor.xml.MarshalException - if any.

org.exolab.castor.xml.ValidationException - if any.

getContactInfo

public String getContactInfo(User user,
                    String command)
                      throws IOException,
                             org.exolab.castor.xml.MarshalException,
                             org.exolab.castor.xml.ValidationException

getContactInfo

Parameters:

user - a User object.

command - a String object.

Returns:

a String object.

Throws:

IOException - if any.

org.exolab.castor.xml.MarshalException - if any.

org.exolab.castor.xml.ValidationException - if any.

getContactServiceProvider

public String getContactServiceProvider(String userID,
                               String command)
                                 throws IOException,
                                        org.exolab.castor.xml.MarshalException,
                                        org.exolab.castor.xml.ValidationException

Get the contact service provider, given a command string

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.

org.exolab.castor.xml.MarshalException - if any.

org.exolab.castor.xml.ValidationException - if any.

getContactServiceProvider

public String getContactServiceProvider(User user,
                               String command)
                                 throws IOException,
                                        org.exolab.castor.xml.MarshalException,
                                        org.exolab.castor.xml.ValidationException

getContactServiceProvider

Parameters:

user - a User object.

command - a String object.

Returns:

a String object.

Throws:

IOException - if any.

org.exolab.castor.xml.MarshalException - if any.

org.exolab.castor.xml.ValidationException - if any.

getEmail

public String getEmail(String userID)
                throws IOException,
                       org.exolab.castor.xml.MarshalException,
                       org.exolab.castor.xml.ValidationException

Get a email by name

Parameters:

userID - the user ID of the user to return

Returns:

String the email specified by name

Throws:

IOException - if any.

org.exolab.castor.xml.MarshalException - if any.

org.exolab.castor.xml.ValidationException - if any.

getEmail

public String getEmail(User user)
                throws IOException,
                       org.exolab.castor.xml.MarshalException,
                       org.exolab.castor.xml.ValidationException

Get a email by user

Parameters:

user - the user to find the email for

Returns:

String the email specified by name

Throws:

IOException - if any.

org.exolab.castor.xml.MarshalException - if any.

org.exolab.castor.xml.ValidationException - if any.

getPagerEmail

public String getPagerEmail(String userID)
                     throws IOException,
                            org.exolab.castor.xml.MarshalException,
                            org.exolab.castor.xml.ValidationException

Get a pager email by name

Parameters:

userID - the user ID of the user to return

Returns:

String the pager email

Throws:

IOException - if any.

org.exolab.castor.xml.MarshalException - if any.

org.exolab.castor.xml.ValidationException - if any.

getPagerEmail

public String getPagerEmail(User user)
                     throws IOException,
                            org.exolab.castor.xml.MarshalException,
                            org.exolab.castor.xml.ValidationException

Get a pager email by user

Parameters:

user - a User object.

Returns:

String the pager email

Throws:

IOException - if any.

org.exolab.castor.xml.MarshalException - if any.

org.exolab.castor.xml.ValidationException - if any.

getNumericPin

public String getNumericPin(String userID)
                     throws IOException,
                            org.exolab.castor.xml.MarshalException,
                            org.exolab.castor.xml.ValidationException

Get a numeric pin

Parameters:

userID - the user ID of the user to return

Returns:

String the numeric pin

Throws:

IOException - if any.

org.exolab.castor.xml.MarshalException - if any.

org.exolab.castor.xml.ValidationException - if any.

getNumericPin

public String getNumericPin(User user)
                     throws IOException,
                            org.exolab.castor.xml.MarshalException,
                            org.exolab.castor.xml.ValidationException

Get a numeric pin

Parameters:

user - a User object.

Returns:

String the numeric pin

Throws:

IOException - if any.

org.exolab.castor.xml.MarshalException - if any.

org.exolab.castor.xml.ValidationException - if any.

getXMPPAddress

public String getXMPPAddress(String userID)
                      throws IOException,
                             org.exolab.castor.xml.MarshalException,
                             org.exolab.castor.xml.ValidationException

Get an XMPP address by name

Parameters:

userID - the user ID of the user to return

Returns:

String the XMPP address

Throws:

IOException - if any.

org.exolab.castor.xml.MarshalException - if any.

org.exolab.castor.xml.ValidationException - if any.

getXMPPAddress

public String getXMPPAddress(User user)
                      throws IOException,
                             org.exolab.castor.xml.MarshalException,
                             org.exolab.castor.xml.ValidationException

Get an XMPP address by name

Parameters:

user - a User object.

Returns:

String the XMPP address

Throws:

IOException - if any.

org.exolab.castor.xml.MarshalException - if any.

org.exolab.castor.xml.ValidationException - if any.

getNumericPage

public String getNumericPage(String userID)
                      throws IOException,
                             org.exolab.castor.xml.MarshalException,
                             org.exolab.castor.xml.ValidationException

Get a numeric service provider

Parameters:

userID - the user ID of the user to return

Returns:

String the service provider

Throws:

IOException - if any.

org.exolab.castor.xml.MarshalException - if any.

org.exolab.castor.xml.ValidationException - if any.

getNumericPage

public String getNumericPage(User user)
                      throws IOException,
                             org.exolab.castor.xml.MarshalException,
                             org.exolab.castor.xml.ValidationException

Get a numeric service provider

Parameters:

user - a User object.

Returns:

String the service provider

Throws:

IOException - if any.

org.exolab.castor.xml.MarshalException - if any.

org.exolab.castor.xml.ValidationException - if any.

getTextPin

public String getTextPin(String userID)
                  throws IOException,
                         org.exolab.castor.xml.MarshalException,
                         org.exolab.castor.xml.ValidationException

Get a text pin

Parameters:

userID - the user ID of the user to return

Returns:

String the text pin

Throws:

IOException - if any.

org.exolab.castor.xml.MarshalException - if any.

org.exolab.castor.xml.ValidationException - if any.

getTextPin

public String getTextPin(User user)
                  throws IOException,
                         org.exolab.castor.xml.MarshalException,
                         org.exolab.castor.xml.ValidationException

Get a text pin

Parameters:

user - a User object.

Returns:

String the text pin

Throws:

IOException - if any.

org.exolab.castor.xml.MarshalException - if any.

org.exolab.castor.xml.ValidationException - if any.

getTextPage

public String getTextPage(String userID)
                   throws IOException,
                          org.exolab.castor.xml.MarshalException,
                          org.exolab.castor.xml.ValidationException

Get a Text Page Service Provider

Parameters:

userID - the user ID of the user to return

Returns:

String the text page service provider.

Throws:

IOException - if any.

org.exolab.castor.xml.MarshalException - if any.

org.exolab.castor.xml.ValidationException - if any.

getTextPage

public String getTextPage(User user)
                   throws IOException,
                          org.exolab.castor.xml.MarshalException,
                          org.exolab.castor.xml.ValidationException

Get a Text Page Service Provider

Parameters:

user - a User object.

Returns:

String the text page service provider.

Throws:

IOException - if any.

org.exolab.castor.xml.MarshalException - if any.

org.exolab.castor.xml.ValidationException - if any.

getWorkPhone

public String getWorkPhone(String userID)
                    throws org.exolab.castor.xml.MarshalException,
                           org.exolab.castor.xml.ValidationException,
                           IOException

Get a work phone number

Parameters:

userID - the user ID of the user to return

Returns:

String the work phone number

Throws:

IOException - if any.

org.exolab.castor.xml.ValidationException - if any.

org.exolab.castor.xml.MarshalException - if any.

getWorkPhone

public String getWorkPhone(User user)
                    throws org.exolab.castor.xml.MarshalException,
                           org.exolab.castor.xml.ValidationException,
                           IOException

Get a work phone number

Parameters:

user - a User object.

Returns:

String the work phone number

Throws:

IOException - if any.

org.exolab.castor.xml.ValidationException - if any.

org.exolab.castor.xml.MarshalException - if any.

getMobilePhone

public String getMobilePhone(String userID)
                      throws org.exolab.castor.xml.MarshalException,
                             org.exolab.castor.xml.ValidationException,
                             IOException

Get a mobile phone number

Parameters:

userID - the user ID of the user to return

Returns:

String the mobile phone number

Throws:

IOException - if any.

org.exolab.castor.xml.ValidationException - if any.

org.exolab.castor.xml.MarshalException - if any.

getMobilePhone

public String getMobilePhone(User user)
                      throws org.exolab.castor.xml.MarshalException,
                             org.exolab.castor.xml.ValidationException,
                             IOException

Get a mobile phone number

Parameters:

user - a User object.

Returns:

String the mobile phone number

Throws:

IOException - if any.

org.exolab.castor.xml.ValidationException - if any.

org.exolab.castor.xml.MarshalException - if any.

getHomePhone

public String getHomePhone(String userID)
                    throws org.exolab.castor.xml.MarshalException,
                           org.exolab.castor.xml.ValidationException,
                           IOException

Get a home phone number

Parameters:

userID - the user ID of the user to return

Returns:

String the home phone number

Throws:

IOException - if any.

org.exolab.castor.xml.ValidationException - if any.

org.exolab.castor.xml.MarshalException - if any.

getHomePhone

public String getHomePhone(User user)
                    throws org.exolab.castor.xml.MarshalException,
                           org.exolab.castor.xml.ValidationException,
                           IOException

Get a home phone number

Parameters:

user - a User object.

Returns:

String the home phone number

Throws:

IOException - if any.

org.exolab.castor.xml.ValidationException - if any.

org.exolab.castor.xml.MarshalException - if any.

saveUsers

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

saveUsers

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"

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

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

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

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

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.

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)

doUpdate

protected abstract void doUpdate()
                          throws IOException,
                                 FileNotFoundException,
                                 org.exolab.castor.xml.MarshalException,
                                 org.exolab.castor.xml.ValidationException

update

Throws:

IOException - if any.

FileNotFoundException - if any.

org.exolab.castor.xml.MarshalException - if any.

org.exolab.castor.xml.ValidationException - if any.

update

public final void update()
                  throws IOException,
                         FileNotFoundException,
                         org.exolab.castor.xml.MarshalException,
                         org.exolab.castor.xml.ValidationException

Throws:

IOException

FileNotFoundException

org.exolab.castor.xml.MarshalException

org.exolab.castor.xml.ValidationException

getUsersWithRole

public String[] getUsersWithRole(String roleid)
                          throws IOException,
                                 org.exolab.castor.xml.MarshalException,
                                 org.exolab.castor.xml.ValidationException

getUsersWithRole

Parameters:

roleid - a String object.

Returns:

an array of String objects.

Throws:

IOException - if any.

org.exolab.castor.xml.MarshalException - if any.

org.exolab.castor.xml.ValidationException - if any.

userHasRole

public boolean userHasRole(User user,
                  String roleid)
                    throws FileNotFoundException,
                           org.exolab.castor.xml.MarshalException,
                           org.exolab.castor.xml.ValidationException,
                           IOException

userHasRole

Parameters:

user - a User object.

roleid - a String object.

Returns:

a boolean.

Throws:

FileNotFoundException - if any.

org.exolab.castor.xml.MarshalException - if any.

org.exolab.castor.xml.ValidationException - if any.

IOException - if any.

isUserScheduledForRole

public boolean isUserScheduledForRole(User user,
                             String roleid,
                             Date time)
                               throws FileNotFoundException,
                                      org.exolab.castor.xml.MarshalException,
                                      org.exolab.castor.xml.ValidationException,
                                      IOException

isUserScheduledForRole

Parameters:

user - a User object.

roleid - a String object.

time - a Date object.

Returns:

a boolean.

Throws:

FileNotFoundException - if any.

org.exolab.castor.xml.MarshalException - if any.

org.exolab.castor.xml.ValidationException - if any.

IOException - if any.

getUsersScheduledForRole

public String[] getUsersScheduledForRole(String roleid,
                                Date time)
                                  throws org.exolab.castor.xml.MarshalException,
                                         org.exolab.castor.xml.ValidationException,
                                         IOException

getUsersScheduledForRole

Parameters:

roleid - a String object.

time - a Date object.

Returns:

an array of String objects.

Throws:

org.exolab.castor.xml.MarshalException - if any.

org.exolab.castor.xml.ValidationException - if any.

IOException - if any.

hasRole

public boolean hasRole(String roleid)
                throws org.exolab.castor.xml.MarshalException,
                       org.exolab.castor.xml.ValidationException,
                       IOException

hasRole

Parameters:

roleid - a String object.

Returns:

a boolean.

Throws:

org.exolab.castor.xml.MarshalException - if any.

org.exolab.castor.xml.ValidationException - if any.

IOException - if any.

countUsersWithRole

public int countUsersWithRole(String roleid)
                       throws org.exolab.castor.xml.MarshalException,
                              org.exolab.castor.xml.ValidationException,
                              IOException

countUsersWithRole

Parameters:

roleid - a String object.

Returns:

a int.

Throws:

org.exolab.castor.xml.MarshalException - if any.

org.exolab.castor.xml.ValidationException - if any.

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,
                            org.exolab.castor.xml.MarshalException,
                            org.exolab.castor.xml.ValidationException

Throws:

IOException

FileNotFoundException

org.exolab.castor.xml.MarshalException

org.exolab.castor.xml.ValidationException