org.opennms.netmgt.config

Class GroupManager

java.lang.Object

org.opennms.netmgt.config.GroupManager

All Implemented Interfaces:

GroupConfig

Direct Known Subclasses:

GroupFactory, MockGroupManager

public abstract class GroupManager
extends Object
implements GroupConfig

Abstract GroupManager class.

Author:

David Hustace, Matt Brozowski, Bill Ayres, DJ Gregor

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	GroupManager.OnmsGroupListMapper
static class	GroupManager.OnmsGroupMapper

Field Summary

Fields

Modifier and Type	Field and Description
protected static Map<String,List<DutySchedule>>	m_dutySchedules The duty schedules for each group

Constructor Summary

Constructors

Constructor and Description
GroupManager()

Method Summary

Modifier and Type	Method and Description
void	deleteGroup(String name) Removes the group from the list of groups.
void	deleteRole(String name) deleteRole
void	deleteUser(String name) Removes the user from the list of groups.
List<Group>	findGroupsForUser(String user) findGroupsForUser
Group	getGroup(String name) Get a group using its name
List<String>	getGroupNames() getGroupNames
Map<String,Group>	getGroups() Get the groups
OnmsGroup	getOnmsGroup(String groupName) getOnmsGroup
OnmsGroupList	getOnmsGroupList() getOnmsGroupList
Role	getRole(String roleName) getRole
String[]	getRoleNames() getRoleNames
Collection<Role>	getRoles() getRoles
OwnedIntervalSequence	getRoleScheduleEntries(String roleid, Date start, Date end) getRoleScheduleEntries
List<Schedule>	getSchedulesForRoleAt(String roleId, Date time) getSchedulesForRoleAt
List<Schedule>	getUserSchedulesForRole(String userId, String roleId) getUserSchedulesForRole
long	groupNextOnDuty(String group, Calendar time) Determines when a group is next on duty.
boolean	hasGroup(String groupName) Returns a boolean indicating if the group name appears in the xml file
boolean	isGroupOnDuty(String group, Calendar time) Determines if a group is on duty at a given time.
boolean	isUserScheduledForRole(String userId, String roleId, Date time) isUserScheduledForRole
protected void	parseXml(InputStream stream) parseXml
void	renameGroup(String oldName, String newName) Renames the group from the list of groups.
void	renameUser(String oldName, String newName) When this method is called group name is changed, so also is the group name belonging to the view.
void	save(OnmsGroup group) save
void	saveGroup(String name, Group details) Adds a new user and overwrites the "groups.xml"
void	saveGroups() saveGroups
void	saveRole(Role role) saveRole
protected abstract void	saveXml(String data) saveXml
void	setGroups(Map<String,Group> grp) Set the groups data
abstract void	update() update
boolean	userHasRole(String userId, String roleid) userHasRole

Methods inherited from class java.lang.Object

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

Field Detail

m_dutySchedules

protected static Map<String,List<DutySchedule>> m_dutySchedules

The duty schedules for each group

Constructor Detail

GroupManager

public GroupManager()

Method Detail

parseXml

protected void parseXml(InputStream stream)
                 throws org.exolab.castor.xml.MarshalException,
                        org.exolab.castor.xml.ValidationException

parseXml

Parameters:

stream - a InputStream object.

Throws:

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

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

setGroups

public void setGroups(Map<String,Group> grp)

Set the groups data

Specified by:

setGroups in interface GroupConfig

Parameters:

grp - a Map object.

getGroups

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

Get the groups

Specified by:

getGroups in interface GroupConfig

Returns:

a Map object.

Throws:

IOException - if any.

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

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

getOnmsGroupList

public OnmsGroupList getOnmsGroupList()
                               throws org.exolab.castor.xml.MarshalException,
                                      org.exolab.castor.xml.ValidationException,
                                      IOException

Description copied from interface: GroupConfig

getOnmsGroupList

Specified by:

getOnmsGroupList in interface GroupConfig

Returns:

an OnmsGroupList

Throws:

org.exolab.castor.xml.MarshalException

org.exolab.castor.xml.ValidationException

IOException

getOnmsGroup

public OnmsGroup getOnmsGroup(String groupName)
                       throws org.exolab.castor.xml.MarshalException,
                              org.exolab.castor.xml.ValidationException,
                              IOException

Description copied from interface: GroupConfig

getOnmsGroup

Specified by:

getOnmsGroup in interface GroupConfig

Returns:

an OnmsGroup

Throws:

org.exolab.castor.xml.MarshalException

org.exolab.castor.xml.ValidationException

IOException

save

public void save(OnmsGroup group)
          throws Exception

Description copied from interface: GroupConfig

save

Specified by:

save in interface GroupConfig

Throws:

Exception

update

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

update

Throws:

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

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

IOException - if any.

hasGroup

public boolean hasGroup(String groupName)
                 throws IOException,
                        org.exolab.castor.xml.MarshalException,
                        org.exolab.castor.xml.ValidationException

Returns a boolean indicating if the group name appears in the xml file

Specified by:

hasGroup in interface GroupConfig

Parameters:

groupName - a String object.

Returns:

true if the group 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.

getGroupNames

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

getGroupNames

Specified by:

getGroupNames in interface GroupConfig

Returns:

a List object.

Throws:

IOException - if any.

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

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

getGroup

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

Get a group using its name

Specified by:

getGroup in interface GroupConfig

Parameters:

name - the name of the group to return

Returns:

Group, the group specified by name

Throws:

IOException - if any.

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

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

saveGroups

public void saveGroups()
                throws Exception

saveGroups

Specified by:

saveGroups in interface GroupConfig

Throws:

Exception - if any.

isGroupOnDuty

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

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

Specified by:

isGroupOnDuty in interface GroupConfig

Parameters:

group - the group whose duty schedule we want

time - the time to check for a duty schedule

Returns:

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

Throws:

IOException - if any.

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

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

groupNextOnDuty

public long groupNextOnDuty(String group,
                            Calendar time)
                     throws IOException,
                            org.exolab.castor.xml.MarshalException,
                            org.exolab.castor.xml.ValidationException

Determines when a group is next on duty. If a group has no duty schedules listed in the configuration file, that group is assumed to always be on duty.

Specified by:

groupNextOnDuty in interface GroupConfig

Parameters:

group - the group whose duty schedule we want

time - the time to check for a duty schedule

Returns:

long, the time in milliseconds until the group is next on duty

Throws:

IOException - if any.

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

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

saveXml

protected abstract void saveXml(String data)
                         throws IOException

saveXml

Parameters:

data - a String object.

Throws:

IOException - if any.

saveGroup

public void saveGroup(String name,
                      Group details)
               throws Exception

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

Specified by:

saveGroup in interface GroupConfig

Parameters:

name - a String object.

details - a Group object.

Throws:

Exception - if any.

saveRole

public void saveRole(Role role)
              throws Exception

saveRole

Specified by:

saveRole in interface GroupConfig

Parameters:

role - a Role object.

Throws:

Exception - if any.

deleteUser

public void deleteUser(String name)
                throws Exception

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

Specified by:

deleteUser in interface GroupConfig

Parameters:

name - a String object.

Throws:

Exception - if any.

deleteGroup

public void deleteGroup(String name)
                 throws Exception

Removes the group from the list of groups. Then overwrites to the "groups.xml"

Specified by:

deleteGroup in interface GroupConfig

Parameters:

name - a String object.

Throws:

Exception - if any.

deleteRole

public void deleteRole(String name)
                throws Exception

deleteRole

Specified by:

deleteRole in interface GroupConfig

Parameters:

name - a String object.

Throws:

Exception - if any.

renameGroup

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

Renames the group from the list of groups. Then overwrites to the "groups.xml"

Specified by:

renameGroup in interface GroupConfig

Parameters:

oldName - a String object.

newName - a String object.

Throws:

Exception - if any.

renameUser

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

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

Specified by:

renameUser in interface GroupConfig

Parameters:

oldName - a String object.

newName - a String object.

Throws:

Exception - if any.

getRoleNames

public String[] getRoleNames()

getRoleNames

Specified by:

getRoleNames in interface GroupConfig

Returns:

an array of String objects.

getRoles

public Collection<Role> getRoles()

getRoles

Specified by:

getRoles in interface GroupConfig

Returns:

a Collection object.

getRole

public Role getRole(String roleName)

getRole

Specified by:

getRole in interface GroupConfig

Parameters:

roleName - a String object.

Returns:

a Role object.

userHasRole

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

userHasRole

Specified by:

userHasRole in interface GroupConfig

Parameters:

userId - a String object.

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.

getSchedulesForRoleAt

public List<Schedule> getSchedulesForRoleAt(String roleId,
                                            Date time)
                                     throws org.exolab.castor.xml.MarshalException,
                                            org.exolab.castor.xml.ValidationException,
                                            IOException

getSchedulesForRoleAt

Specified by:

getSchedulesForRoleAt in interface GroupConfig

Parameters:

roleId - a String object.

time - a Date object.

Returns:

a List object.

Throws:

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

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

IOException - if any.

getUserSchedulesForRole

public List<Schedule> getUserSchedulesForRole(String userId,
                                              String roleId)
                                       throws org.exolab.castor.xml.MarshalException,
                                              org.exolab.castor.xml.ValidationException,
                                              IOException

getUserSchedulesForRole

Specified by:

getUserSchedulesForRole in interface GroupConfig

Parameters:

userId - a String object.

roleId - a String object.

Returns:

a List object.

Throws:

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

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

IOException - if any.

isUserScheduledForRole

public boolean isUserScheduledForRole(String userId,
                                      String roleId,
                                      Date time)
                               throws org.exolab.castor.xml.MarshalException,
                                      org.exolab.castor.xml.ValidationException,
                                      IOException

isUserScheduledForRole

Specified by:

isUserScheduledForRole in interface GroupConfig

Parameters:

userId - a String object.

roleId - a String object.

time - a Date object.

Returns:

a boolean.

Throws:

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

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

IOException - if any.

getRoleScheduleEntries

public OwnedIntervalSequence getRoleScheduleEntries(String roleid,
                                                    Date start,
                                                    Date end)
                                             throws org.exolab.castor.xml.MarshalException,
                                                    org.exolab.castor.xml.ValidationException,
                                                    IOException

getRoleScheduleEntries

Specified by:

getRoleScheduleEntries in interface GroupConfig

Parameters:

roleid - a String object.

start - a Date object.

end - a Date object.

Returns:

a OwnedIntervalSequence object.

Throws:

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

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

IOException - if any.

findGroupsForUser

public List<Group> findGroupsForUser(String user)

findGroupsForUser

Specified by:

findGroupsForUser in interface GroupConfig

Parameters:

user - a String object.

Returns:

a List object.