kolibribeans
Class QueryContainer

java.lang.Object
  |
  +--kolibribeans.QueryContainer

public class QueryContainer

extends java.lang.Object

Title: Description: Copyright: Copyright (c) 2001 Company:

Field Summary

static int	PRIORITY_HIGH
static int	PRIORITY_LOW
static int	PRIORITY_NORMAL
static int	VISIBILITY_CONFIDENTIAL
static int	VISIBILITY_PRIVATE
static int	VISIBILITY_PUBLIC
static int	VISIBILITY_RESERVABLE_TIME

Constructor Summary

QueryContainer()

QueryContainer(java.util.Calendar date, java.lang.String http_referer)

Method Summary

static RS2	checkPrivateGroupParticipation(int personID) Helps to check whether a user belongs to a so called private group.
static RS2	checkRequestedGroup(int personID) Helps to check whether person has right to view requested group data.
static boolean	checkRequestedGroup(int personID, int groupID) Helps to check whether person has right to view requested group data.
static RS2	checkSpaceExistence() Deprecated. Why this did not return code and spaceid of wanted space?
static java.lang.String[]	checkSpaceExistence(java.lang.String code) Deprecated. Why this did not return code and spaceid of wanted space?
static boolean	checkTeacher(java.lang.String eventID, int personID)
static void	deleteEvent(java.lang.String eventID) Deletes an event from DB, i.e. sets event.deleted=false.
RS2	getAllGroupMembersEvents(Group group, int languageID) Gets all events of group.
RS2	getAllGroupMembersEvents(Group group, User user) Gets all events of group.
static RS2	getBookableEvents(int personid, java.util.Calendar begindate) Returns persons both booked and unbooked events.
java.util.Calendar	getDate() Getter method for particular month used in restriction.
static RS2	getEventData(int personID, java.lang.String oeventID) Retrieves person's general event data.
static RS2	getEventFieldsIntoForm(java.lang.String eventID, int languageID) Retrieves event-related data that is to be publish on a form.
static java.lang.String	getEventGroupName(java.lang.String groupID)
static RS2	getEventsForMonth(java.util.Calendar cal, int personID) Gets begintimes for a person's events from a months period.
static RS2	getEventsTimes(java.lang.String eventID) Retrieves begin and end times for a certain event.
static RS2	getGroup(int groupID) Gets colums representing given group.
static java.util.ArrayList	getGroupMembersInArrayList(int groupID) Returns groups members in ArrayList.
static java.lang.String	getGroupName(java.lang.String eventID) Retrieves the name of the event group for requested event.
static java.util.ArrayList	getGroupsAllParentGroups(int groupID) Returns recursively groupIDs of all parentGroups of given group.
static RS2	getGroupsMembers(Group group, User user) Gets all members of single group and its subgroups.
static RS2	getGroupsMembers(int[] groupID, User user) Gets all persons that are members of multiple groups.
static RS2	getGroupsMembers(int[] groupID, User user, java.lang.String[] nonMembers)
static RS2	getGroupsMembers(int groupID, User user) Gets members of single group.
static RS2	getGroupsSubGroups(int groupID) Returns Groups subgroups.
static RS2	getGroupsSubGroups(int groupID, Group notAllowed) Returns Groups subgroups.
static RS2	getGroupsSubGroups(int groupID, int[] notAllowedSubGroups) Returns Groups subgroups.
static java.util.ArrayList	getGroupsSubGroupsInArrayList(int groupID) returns groups subgroups of group in ArrayList.
static RS2	getNotesForEvent(java.lang.String eventID) Retrieves all notes for specified event.
static RS2	getPersonsAllowedGroups(User user) Return groups to wich user has rights,
static RS2	getPriorityValues(int languageID) Retrieves all possible priority values.
java.lang.String	getReferer() Getter method for http_referer attribute.
static RS2	getRepeatedEvents(java.lang.String eventID) Retrieves all the instances of a single repeating event.
boolean	getRestrictQuery() Getter method for RestrictedQuery option.
boolean	getShowUnbooked() Get method for showUnbooked attribute.
RS2	getSpacesEvents(int spaceID, int languageID, int priority, java.lang.String info) Gets all events of space.
static java.util.ArrayList	getSubGroupMembers(int groupID) Returns subgroup members of group in ArrayList.
static RS2	getSubGroupsForGroups(java.lang.String nameToSearch) Returns subgroups.
static RS2	getUserForGroup(int userID, User user) Gets persons to be added to group.
RS2	getUsersEvents(int personID, int languageID) Returns events of single person.
RS2	getUsersEvents(int personID, int languageID, int priority)
RS2	getUsersEvents(int personID, int languageID, int priority, java.lang.String info) Returns events of single person with given priority.
RS2	getUsersEvents(User user) Returns events of single person.
RS2	getUsersEvents(User user, java.lang.String info)
static RS2	getUsersForGroup(java.lang.String nameToSearch, User user) Returns persons to be added to group.
static RS2	getUsersForGroup(java.lang.String nameToSearch, User user, int department, int course) Returns persons to be added to group.
static RS2	getVisibilityValues(int languageID) Retrieves all possible visibility values.
static void	insertEvent(int nextEID, java.lang.String groupID, java.lang.String startTimeStamp, java.lang.String endTimeStamp, java.lang.String sVisibility, java.lang.String sPriority, java.lang.String sDescription, java.lang.String sComment) Inserts an event into DB.
static void	insertEvent(int nextEID, java.lang.String groupID, java.lang.String startTimeStamp, java.lang.String endTimeStamp, java.lang.String sVisibility, java.lang.String sPriority, java.lang.String sDescription, java.lang.String sComment, int inheritedFrom)
static void	insertEventSpace(int nextEID, int nextSID) Inserts an EventSpace-relation into DB.
static void	insertIntoPrivateGroup(int nextEGID, java.lang.String names, int nextGPID, int personID) Inserts a user into a so called private group.
static void	insertNote(int nextID, java.lang.String eventID, int personID, java.lang.String sTitle, java.lang.String sMsg) Inserts a note into DB.
static void	insertSpace(int nextSID, java.lang.String sLocation) Inserts a new space into DB.
static boolean	isAllowedToModify(java.lang.String personid, java.lang.String eventid) The method tells if teh user has right to modify event's details.
static boolean	isValidGroupName(java.lang.String name, int groupID) Checks if given string is valid name for group.
static java.lang.String	numberOfArrayListToString(java.util.ArrayList list) Cobines Stringvalues in arraylist to one string that can be used in "IN-clause" of query.
void	setDate(java.util.Calendar date) Setter method for particular month used in restriction.
void	setReferer(java.lang.String referer) Setter method for http_referer attribute.
void	setRestrictQuery(boolean restrictQuery) Setter method for RestrictedQuery option.
void	setShowUnbooked(boolean show) Set method for showUnbooked attribute.
static void	updateEvent(java.lang.String startTimeStamp, java.lang.String endTimeStamp, java.lang.String sVisibility, java.lang.String sPriority, java.lang.String sDescription, java.lang.String eventID, java.lang.String sComment) Updates an event.
static void	updateEventSpace(java.lang.String eventID, int nextSID) Updates table called EventSpace.
static void	updateHoursAndRest(java.lang.String startHour, java.lang.String endHour, java.lang.String visibilityid, java.lang.String priorityid, java.lang.String description, java.lang.String comment, java.lang.String events) starthour and endhour represented as timestamp and catenated to existing time stamp.

Methods inherited from class java.lang.Object

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

Field Detail

VISIBILITY_PUBLIC

public static int VISIBILITY_PUBLIC

VISIBILITY_PRIVATE

public static int VISIBILITY_PRIVATE

VISIBILITY_CONFIDENTIAL

public static int VISIBILITY_CONFIDENTIAL

VISIBILITY_RESERVABLE_TIME

public static int VISIBILITY_RESERVABLE_TIME

PRIORITY_LOW

public static int PRIORITY_LOW

PRIORITY_NORMAL

public static int PRIORITY_NORMAL

PRIORITY_HIGH

public static int PRIORITY_HIGH

Constructor Detail

QueryContainer

public QueryContainer()

QueryContainer

public QueryContainer(java.util.Calendar date,
                      java.lang.String http_referer)

Method Detail

setRestrictQuery

public void setRestrictQuery(boolean restrictQuery)

Setter method for RestrictedQuery option.

getRestrictQuery

public boolean getRestrictQuery()

Getter method for RestrictedQuery option.

Returns:

restrictQuery.

setDate

public void setDate(java.util.Calendar date)

Setter method for particular month used in restriction.

Parameters:

date - date in month to be used.

getDate

public java.util.Calendar getDate()

Getter method for particular month used in restriction.

Returns:

date date in month to be used.

setReferer

public void setReferer(java.lang.String referer)

Setter method for http_referer attribute.

getReferer

public java.lang.String getReferer()

Getter method for http_referer attribute.

Returns:

http_referer.

setShowUnbooked

public void setShowUnbooked(boolean show)

Set method for showUnbooked attribute.

getShowUnbooked

public boolean getShowUnbooked()

Get method for showUnbooked attribute.

Returns:

showUnbooked.

getAllGroupMembersEvents

public RS2 getAllGroupMembersEvents(Group group,
                                    int languageID)
                             throws java.lang.Exception

Gets all events of group. This includes all group events and all. groupmembers personal events.

Parameters:

group - Group whose events are wanted.

languageID - Language to use in translations.

Returns:

RS2 containg events of group.

java.lang.Exception

getAllGroupMembersEvents

public RS2 getAllGroupMembersEvents(Group group,
                                    User user)
                             throws java.lang.Exception

Gets all events of group. This includes all group events and all groupmembers personal events.

Parameters:

group - Group whose events are wanted.

user - User whose language is used in translations.

Returns:

RS2 containg events of group.

java.lang.Exception

getUsersEvents

public RS2 getUsersEvents(int personID,
                          int languageID)
                   throws java.lang.Exception

Returns events of single person.

Parameters:

languageID - language to use in translations.

Returns:

RS2 containing events.

java.lang.Exception

getUsersEvents

public RS2 getUsersEvents(int personID,
                          int languageID,
                          int priority,
                          java.lang.String info)
                   throws java.lang.Exception

Returns events of single person with given priority.

Parameters:

languageID - language to use in translations.

priority - Get events with given priority.

Returns:

RS2 containing events.

java.lang.Exception

getUsersEvents

public RS2 getUsersEvents(int personID,
                          int languageID,
                          int priority)
                   throws java.lang.Exception

java.lang.Exception

getUsersEvents

public RS2 getUsersEvents(User user)
                   throws java.lang.Exception

Returns events of single person.

Parameters:

user - Person whose events are wanted.

Returns:

RS2 containing events.

java.lang.Exception

getUsersEvents

public RS2 getUsersEvents(User user,
                          java.lang.String info)
                   throws java.lang.Exception

java.lang.Exception

getUsersForGroup

public static RS2 getUsersForGroup(java.lang.String nameToSearch,
                                   User user)
                            throws java.lang.Exception

Returns persons to be added to group. Searches person by lastname, firstname and names and returns all founded persons in RS2.

Parameters:

nameToSearch - Name to be used is search.

user - User whose language is used in translations.

Returns:

RS2 containing found persons.

java.lang.Exception

getUsersForGroup

public static RS2 getUsersForGroup(java.lang.String nameToSearch,
                                   User user,
                                   int department,
                                   int course)
                            throws java.lang.Exception

Returns persons to be added to group. Searches person by lastname, firstname and names and returns all founded persons in RS2.

Parameters:

nameToSearch - Name to be used is search.

user - User whose language is used in translations.

department - DepartmentID of searched users. (Persons home organisation must be this)

course - CourseID of searched person. (Person must be on this course)

Returns:

RS2 containing found persons.

java.lang.Exception

getPersonsAllowedGroups

public static RS2 getPersonsAllowedGroups(User user)
                                   throws java.lang.Exception

Return groups to wich user has rights,

Parameters:

user - User whose groups are searched.

Returns:

RS2 containing groups

java.lang.Exception

getSubGroupsForGroups

public static RS2 getSubGroupsForGroups(java.lang.String nameToSearch)
                                 throws java.lang.Exception

Returns subgroups.

Parameters:

nameToSearch - Name to search group.

Returns:

RS2 containing preferred groups.

java.lang.Exception

getGroupsSubGroups

public static RS2 getGroupsSubGroups(int groupID)
                              throws java.lang.Exception

Returns Groups subgroups.

Parameters:

groupID - ID of group.

Returns:

RS2 of query.

Throws:

Exception.

java.lang.Exception

getGroupsSubGroups

public static RS2 getGroupsSubGroups(int groupID,
                                     int[] notAllowedSubGroups)
                              throws java.lang.Exception

Returns Groups subgroups.

Parameters:

groupID - ID of group.

notAllowedSubGroups - Array of values that are not allowed as subgroups.

Returns:

RS2 of query.

Throws:

java.lang.Exception - if something goes wrong.

getGroupsSubGroups

public static RS2 getGroupsSubGroups(int groupID,
                                     Group notAllowed)
                              throws java.lang.Exception

Returns Groups subgroups.

Parameters:

groupID - ID of group.

Returns:

RS2 of query.

Throws:

java.lang.Exception - if something goes wrong.

getGroupsMembers

public static RS2 getGroupsMembers(int[] groupID,
                                   User user)
                            throws java.lang.Exception

Gets all persons that are members of multiple groups.

Parameters:

groupID - Array of values that represent groupids.

user - User whose language is used in translations.

Returns:

RS2 containing members.

java.lang.Exception

getGroupsMembers

public static RS2 getGroupsMembers(int[] groupID,
                                   User user,
                                   java.lang.String[] nonMembers)
                            throws java.lang.Exception

java.lang.Exception

getGroupsMembers

public static RS2 getGroupsMembers(int groupID,
                                   User user)
                            throws java.lang.Exception

Gets members of single group.

Parameters:

groupID - value that represent groupID.

user - User whose language is used in translations.

Returns:

RS2 containing members.

java.lang.Exception

getGroupsMembers

public static RS2 getGroupsMembers(Group group,
                                   User user)
                            throws java.lang.Exception

Gets all members of single group and its subgroups.

Parameters:

group - Group which members are wanted.

user - User whose language is used in translations.

Returns:

RS2 containing members.

java.lang.Exception

getGroup

public static RS2 getGroup(int groupID)
                    throws java.lang.Exception

Gets colums representing given group.

Parameters:

groupID - ID of group

Returns:

RS2 of appropriate kind.

java.lang.Exception

isValidGroupName

public static boolean isValidGroupName(java.lang.String name,
                                       int groupID)
                                throws java.lang.Exception

Checks if given string is valid name for group.

Parameters:

name - String to check

Returns:

true if valid.

java.lang.Exception

getUserForGroup

public static RS2 getUserForGroup(int userID,
                                  User user)
                           throws java.lang.Exception

Gets persons to be added to group.

Parameters:

userID - ID of wanted user.

user - User whose language is used in translations.

Returns:

RS2 containing persons.

java.lang.Exception

getEventsForMonth

public static RS2 getEventsForMonth(java.util.Calendar cal,
                                    int personID)
                             throws java.lang.Exception

Gets begintimes for a person's events from a months period.

Parameters:

cal - month preferred to be queried.

personID - person's ID.

Returns:

RS2 containing events' begintimes.

java.lang.Exception

getEventData

public static RS2 getEventData(int personID,
                               java.lang.String oeventID)
                        throws java.lang.Exception

Retrieves person's general event data.

Parameters:

personID - person's ID.

Returns:

RS2 containing event data.

Throws:

java.lang.Exception - when something's gone wrong.

checkRequestedGroup

public static RS2 checkRequestedGroup(int personID)
                               throws java.lang.Exception

Helps to check whether person has right to view requested group data.

Parameters:

personID - person's ID.

Returns:

RS2 containing authorization info.

Throws:

java.lang.Exception - when something's gone wrong.

checkRequestedGroup

public static boolean checkRequestedGroup(int personID,
                                          int groupID)
                                   throws java.lang.Exception

Helps to check whether person has right to view requested group data.

Parameters:

personID - person's ID.

Returns:

RS2 containing authorization info.

Throws:

java.lang.Exception - when something's gone wrong.

getEventFieldsIntoForm

public static RS2 getEventFieldsIntoForm(java.lang.String eventID,
                                         int languageID)
                                  throws java.lang.Exception

Retrieves event-related data that is to be publish on a form.

Parameters:

eventID - event's ID.

languageID - preferred language.

java.lang.Exception

getVisibilityValues

public static RS2 getVisibilityValues(int languageID)
                               throws java.lang.Exception

Retrieves all possible visibility values.

Parameters:

languageID - preferred language.

Returns:

RS2 containing visibility values.

Throws:

java.lang.Exception - when something's gone wrong.

getPriorityValues

public static RS2 getPriorityValues(int languageID)
                             throws java.lang.Exception

Retrieves all possible priority values.

Parameters:

languageID - preferred language.

Returns:

RS2 containing priority values.

Throws:

java.lang.Exception - when something's gone wrong.

getNotesForEvent

public static RS2 getNotesForEvent(java.lang.String eventID)
                            throws java.lang.Exception

Retrieves all notes for specified event.

Returns:

RS2 containing all the notes.

Throws:

java.lang.Exception - when something's gone wrong.

insertNote

public static void insertNote(int nextID,
                              java.lang.String eventID,
                              int personID,
                              java.lang.String sTitle,
                              java.lang.String sMsg)
                       throws java.lang.Exception

Inserts a note into DB.

Throws:

java.lang.Exception - when something's gone wrong.

checkPrivateGroupParticipation

public static RS2 checkPrivateGroupParticipation(int personID)
                                          throws java.lang.Exception

Helps to check whether a user belongs to a so called private group.

Returns:

RS2.

Throws:

java.lang.Exception - when something's gone wrong.

insertIntoPrivateGroup

public static void insertIntoPrivateGroup(int nextEGID,
                                          java.lang.String names,
                                          int nextGPID,
                                          int personID)
                                   throws java.lang.Exception

Inserts a user into a so called private group.

Parameters:

nextEGID - next available primary key value.

names - user's names.

nextGPID - next available primary key value.

Throws:

java.lang.Exception - when something's gone wrong.

checkSpaceExistence

public static java.lang.String[] checkSpaceExistence(java.lang.String code)
                                              throws java.lang.Exception

Deprecated. Why this did not return code and spaceid of wanted space?

Helps to check whether requested space already exists.

Throws:

java.lang.Exception - when something's gone wrong.

See Also:

checkSpaceExistence(String)

checkSpaceExistence

public static RS2 checkSpaceExistence()
                               throws java.lang.Exception

Deprecated. Why this did not return code and spaceid of wanted space?

Helps to check whether requested space already exists.

Throws:

java.lang.Exception - when something's gone wrong.

See Also:

checkSpaceExistence(String)

updateEvent

public static void updateEvent(java.lang.String startTimeStamp,
                               java.lang.String endTimeStamp,
                               java.lang.String sVisibility,
                               java.lang.String sPriority,
                               java.lang.String sDescription,
                               java.lang.String eventID,
                               java.lang.String sComment)
                        throws java.lang.Exception

Updates an event.

Parameters:

eventID - primary key for the event being updated.

Throws:

java.lang.Exception - when something's gone wrong.

updateHoursAndRest

public static void updateHoursAndRest(java.lang.String startHour,
                                      java.lang.String endHour,
                                      java.lang.String visibilityid,
                                      java.lang.String priorityid,
                                      java.lang.String description,
                                      java.lang.String comment,
                                      java.lang.String events)
                               throws java.lang.Exception

starthour and endhour represented as timestamp and catenated to existing time stamp.

java.lang.Exception

insertSpace

public static void insertSpace(int nextSID,
                               java.lang.String sLocation)
                        throws java.lang.Exception

Inserts a new space into DB.

Parameters:

nextSID - next available primary key value.

sLocation - name of the space to be added.

Throws:

java.lang.Exception - when something's gone wrong.

updateEventSpace

public static void updateEventSpace(java.lang.String eventID,
                                    int nextSID)
                             throws java.lang.Exception

Updates table called EventSpace. One event can only have one event! Deletes now the previous (usually deleted)

Parameters:

eventID - foreign key value(s).

nextSID - foreign key value.

Throws:

java.lang.Exception - when something's gone wrong.

insertEvent

public static void insertEvent(int nextEID,
                               java.lang.String groupID,
                               java.lang.String startTimeStamp,
                               java.lang.String endTimeStamp,
                               java.lang.String sVisibility,
                               java.lang.String sPriority,
                               java.lang.String sDescription,
                               java.lang.String sComment)
                        throws java.lang.Exception

Inserts an event into DB.

Parameters:

nextEID - next available primary key value.

groupID - foreign key value.

Throws:

java.lang.Exception - when something's gone wrong.

insertEvent

public static void insertEvent(int nextEID,
                               java.lang.String groupID,
                               java.lang.String startTimeStamp,
                               java.lang.String endTimeStamp,
                               java.lang.String sVisibility,
                               java.lang.String sPriority,
                               java.lang.String sDescription,
                               java.lang.String sComment,
                               int inheritedFrom)
                        throws java.lang.Exception

java.lang.Exception

insertEventSpace

public static void insertEventSpace(int nextEID,
                                    int nextSID)
                             throws java.lang.Exception

Inserts an EventSpace-relation into DB.

Parameters:

nextEID - foreign key value.

nextSID - foreign key value.

Throws:

java.lang.Exception - when something's gone wrong.

deleteEvent

public static void deleteEvent(java.lang.String eventID)
                        throws java.lang.Exception

Deletes an event from DB, i.e. sets event.deleted=false.

Parameters:

eventID - primary key value.

Throws:

java.lang.Exception - when something's gone wrong.

getRepeatedEvents

public static RS2 getRepeatedEvents(java.lang.String eventID)
                             throws java.lang.Exception

Retrieves all the instances of a single repeating event.

Parameters:

eventID - primary key value.

Returns:

RS2 containing instances of requested event when found.

Throws:

java.lang.Exception - when something's gone wrong.

getEventsTimes

public static RS2 getEventsTimes(java.lang.String eventID)
                          throws java.lang.Exception

Retrieves begin and end times for a certain event.

Returns:

RS2 containing begin and end times.

java.lang.Exception

getGroupName

public static java.lang.String getGroupName(java.lang.String eventID)
                                     throws java.lang.Exception

Retrieves the name of the event group for requested event.

Returns:

result name of the group.

java.lang.Exception

getGroupsAllParentGroups

public static java.util.ArrayList getGroupsAllParentGroups(int groupID)
                                                    throws java.lang.Exception

Returns recursively groupIDs of all parentGroups of given group.

Parameters:

groupID - ID of given group

Returns:

ArrayList containening parentgroups.

Throws:

java.lang.Exception - thrown on error.

getGroupsSubGroupsInArrayList

public static java.util.ArrayList getGroupsSubGroupsInArrayList(int groupID)
                                                         throws java.lang.Exception

returns groups subgroups of group in ArrayList.

Parameters:

groupID - Id of group.

java.lang.Exception

numberOfArrayListToString

public static java.lang.String numberOfArrayListToString(java.util.ArrayList list)

Cobines Stringvalues in arraylist to one string that can be used in "IN-clause" of query.

Parameters:

list - ArrayList to be changed.

Returns:

Values in string;

getSubGroupMembers

public static java.util.ArrayList getSubGroupMembers(int groupID)
                                              throws java.lang.Exception

Returns subgroup members of group in ArrayList.

Parameters:

groupID - Group whose members are wanted.

Returns:

ArrayList containing members

java.lang.Exception

getGroupMembersInArrayList

public static java.util.ArrayList getGroupMembersInArrayList(int groupID)
                                                      throws java.lang.Exception

Returns groups members in ArrayList.

Parameters:

groupID - Group whose members are wanted.

Returns:

ArrayList containing members

java.lang.Exception

getEventGroupName

public static java.lang.String getEventGroupName(java.lang.String groupID)
                                          throws java.lang.Exception

java.lang.Exception

checkTeacher

public static boolean checkTeacher(java.lang.String eventID,
                                   int personID)
                            throws java.lang.Exception

java.lang.Exception

getBookableEvents

public static RS2 getBookableEvents(int personid,
                                    java.util.Calendar begindate)
                             throws java.lang.Exception

Returns persons both booked and unbooked events.

Parameters:

personid - The person whose events we want

Returns:

RS2 containing found events.

java.lang.Exception

isAllowedToModify

public static boolean isAllowedToModify(java.lang.String personid,
                                        java.lang.String eventid)

The method tells if teh user has right to modify event's details. Returns true if modification is ok, else returns false. With empty eventid or personid string returns true.

getSpacesEvents

public RS2 getSpacesEvents(int spaceID,
                           int languageID,
                           int priority,
                           java.lang.String info)
                    throws java.lang.Exception

Gets all events of space. This includes all events.

Parameters:

spaceID - Space which events are wanted.

languageID - Language to use in translations.

Returns:

RS2 containg events of group.

java.lang.Exception