GroupBusiness.java

/*
 * $Id: GroupBusiness.java,v 1.64 2008/08/12 13:52:59 valdas Exp $
 * Created on Nov 16, 2004
 *
 * Copyright (C) 2004 Idega Software hf. All Rights Reserved.
 *
 * This software is the proprietary information of Idega hf.
 * Use is subject to license terms.
 */
package com.idega.user.business;

import java.rmi.RemoteException;
import java.util.Collection;
import java.util.Collections;
import java.util.List;
import java.util.Map;

import javax.ejb.CreateException;
import javax.ejb.EJBException;
import javax.ejb.FinderException;
import javax.ejb.RemoveException;

import com.idega.business.IBOService;
import com.idega.core.accesscontrol.data.ICRole;
import com.idega.core.builder.data.ICDomain;
import com.idega.core.contact.data.Email;
import com.idega.core.contact.data.EmailHome;
import com.idega.core.contact.data.Phone;
import com.idega.core.contact.data.PhoneHome;
import com.idega.core.file.data.ICFile;
import com.idega.core.file.data.ICFileHome;
import com.idega.core.location.business.AddressBusiness;
import com.idega.core.location.data.Address;
import com.idega.core.location.data.AddressHome;
import com.idega.data.IDOCompositePrimaryKeyException;
import com.idega.data.IDOEntity;
import com.idega.data.IDOLookupException;
import com.idega.data.IDORelationshipException;
import com.idega.idegaweb.IWUserContext;
import com.idega.presentation.IWContext;
import com.idega.user.bean.AddressData;
import com.idega.user.bean.GroupDataBean;
import com.idega.user.data.Group;
import com.idega.user.data.GroupDomainRelationType;
import com.idega.user.data.GroupHome;
import com.idega.user.data.GroupRelationHome;
import com.idega.user.data.GroupType;
import com.idega.user.data.GroupTypeHome;
import com.idega.user.data.User;
import com.idega.user.data.UserGroupRepresentativeHome;
import com.idega.user.data.UserHome;
import com.idega.util.datastructures.NestedSetsContainer;


/**
 *
 *  Last modified: $Date: 2008/08/12 13:52:59 $ by $Author: valdas $
 *
 * @author <a href="mailto:eiki@idega.com">eiki</a>
 * @version $Revision: 1.64 $
 */
public interface GroupBusiness extends IBOService {

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getUserHome
	 */
	public UserHome getUserHome() throws java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getUserGroupRepresentativeHome
	 */
	public UserGroupRepresentativeHome getUserGroupRepresentativeHome() throws java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getGroupHome
	 */
	public GroupHome getGroupHome() throws java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getPermissionGroupHome
	 */
	public GroupHome getPermissionGroupHome() throws java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getAllGroups
	 */
	public Collection<Group> getAllGroups() throws java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getAllNonPermissionOrGeneralGroups
	 */
	public Collection<Group> getAllNonPermissionOrGeneralGroups() throws java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getGroups
	 */
	public Collection<Group> getGroups(String[] groupTypes, boolean returnSpecifiedGroupTypes) throws Exception,
			java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getParentGroups
	 */
	public Collection<Group> getParentGroups(int uGroupId) throws EJBException, FinderException, java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getParentGroups
	 */
	public Collection<Group> getParentGroups(Group group) throws java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getParentGroups
	 */
	public Collection<Group> getParentGroups(Group group, Map<String, Collection<Integer>> cachedParents, Map<String, Group> cachedGroups) throws java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getNonParentGroups
	 */
	public Collection<Group> getNonParentGroups(int uGroupId) throws java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getNonParentGroupsNonPermissionNonGeneral
	 */
	public Collection<Group> getNonParentGroupsNonPermissionNonGeneral(int uGroupId) throws java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getParentGroupsInDirect
	 */
	public Collection<Group> getParentGroupsInDirect(int uGroupId) throws java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getParentGroupsRecursive
	 */
	public Collection<Group> getParentGroupsRecursive(int uGroupId) throws EJBException, java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getParentGroupsRecursive
	 */
	public Collection<Group> getParentGroupsRecursive(Group aGroup) throws EJBException, java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getParentGroupsRecursive
	 */
	public Collection<Group> getParentGroupsRecursive(Group aGroup, Map<String, Collection<Integer>> cachedParents, Map<String, Group> cachedGroups) throws EJBException,
			java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getUserRepresentativeGroupTypeStringArray
	 */
	public String[] getUserRepresentativeGroupTypeStringArray() throws java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getParentGroupsRecursive
	 */
	public Collection<Group> getParentGroupsRecursive(Group aGroup, String[] groupTypes, boolean returnSpecifiedGroupTypes)
			throws EJBException, java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getUsers
	 */
	public Collection<User> getUsers(int groupId) throws EJBException, FinderException, java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getUsersDirectlyRelated
	 */
	public Collection<User> getUsersDirectlyRelated(int groupId) throws EJBException, FinderException,
			java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getUsersNotDirectlyRelated
	 */
	public Collection<User> getUsersNotDirectlyRelated(int groupId) throws EJBException, FinderException,
			java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getChildGroupsRecursive
	 */
	public Collection<Group> getChildGroupsRecursive(int groupId) throws EJBException, FinderException,
			java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getChildGroupsRecursive
	 */
	public Collection<Group> getChildGroupsRecursive(Group aGroup) throws EJBException, java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getChildGroupsRecursive
	 */
	public Collection<Group> getChildGroupsRecursive(Group aGroup, String[] groupTypes, boolean returnSpecifiedGroupTypes)
			throws EJBException, java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getUsers
	 */
	public Collection<User> getUsers(Group group) throws FinderException, java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getUsersRecursive
	 */
	public Collection<User> getUsersRecursive(Group group) throws FinderException, java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getUsersRecursive
	 */
	public Collection<User> getUsersRecursive(int groupId) throws FinderException, java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getChildGroups
	 */
	public Collection<Group> getChildGroups(int groupId) throws EJBException, FinderException, java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getChildGroupsResultFiltered
	 */
	public Collection<Group> getChildGroupsResultFiltered(Group parentGroup, String groupName, Collection<String> groupTypes, boolean onlyReturnTypesInCollection) throws java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getChildGroupsRecursiveResultFiltered
	 */
	public Collection<Group> getChildGroupsRecursiveResultFiltered(int groupId, Collection<String> groupTypesAsString,
			boolean onlyReturnTypesInCollection) throws java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getChildGroupsRecursiveResultFiltered
	 */
	public Collection<Group> getChildGroupsRecursiveResultFiltered(Group group, Collection<String> groupTypesAsString,
			boolean onlyReturnTypesInCollection) throws java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getChildGroupsRecursiveResultFiltered
	 */
	public Collection <Group>getChildGroupsRecursiveResultFiltered(Group group, Collection<String> groupTypesAsString,
			boolean onlyReturnTypesInCollection, boolean includeAliases) throws java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getChildGroupsRecursiveResultFiltered
	 */
	public Collection<Group> getChildGroupsRecursiveResultFiltered(Group group, Collection<String> groupTypesAsString,
			boolean onlyReturnTypesInCollection, boolean includeAliases, boolean excludeGroupsWithoutMembers) throws java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getUsersFromGroupRecursive
	 */
	public Collection<User> getUsersFromGroupRecursive(Group group) throws java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getUsersFromGroupRecursive
	 */
	public Collection<User> getUsersFromGroupRecursive(Group group, Collection<String> groupTypesAsString,
			boolean onlyReturnTypesInCollection) throws java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getChildGroups
	 */
	public Collection<Group> getChildGroups(Group aGroup) throws java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getChildGroups
	 */
	public Collection<Group> getChildGroups(Group aGroup, Collection<String> groupTypes, boolean returnSpecifiedGroupTypes)
			throws java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getChildGroups
	 */
	public Collection<Group> getChildGroups(Group aGroup, String[] groupTypes, boolean returnSpecifiedGroupTypes)
			throws java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getUsersDirectlyRelated
	 */
	public Collection<Group> getUsersDirectlyRelated(Group group) throws EJBException, RemoteException, FinderException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getChildGroupsInDirect
	 */
	public Collection<Group> getChildGroupsInDirect(int groupId) throws EJBException, FinderException,
			java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getChildGroupsInDirect
	 */
	public Collection<Group> getChildGroupsInDirect(Group group) throws EJBException, java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getUsersNotDirectlyRelated
	 */
	public Collection<User> getUsersNotDirectlyRelated(Group group) throws EJBException, RemoteException, FinderException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getGroups
	 */
	public Collection<Group> getGroups(String[] groupIDs) throws FinderException, RemoteException;
	public Collection<Group> getGroups(Collection<String> groupIDs) throws FinderException, RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getUsersForUserRepresentativeGroups
	 */
	public Collection<User> getUsersForUserRepresentativeGroups(Collection<Group> groups) throws FinderException, RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#updateUsersInGroup
	 */
	public void updateUsersInGroup(int groupId, String[] usrGroupIdsInGroup, User currentUser) throws RemoteException,
			FinderException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getGroupByGroupID
	 */
	public Group getGroupByGroupID(int id) throws FinderException, RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getGroupsByGroupName
	 */
	public Collection<Group> getGroupsByGroupName(String name) throws RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getGroupsByGroupNameAndTypes
	 */
	public Collection<Group> getGroupsByGroupNameAndGroupTypes(String name, Collection<?> groupTypes, boolean onlyReturnTypesInCollection) throws RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getGroupsByGroupTypeAndFirstPartOfName
	 */
	public Collection<Group> getGroupsByGroupTypeAndFirstPartOfName(String groupType, String groupNameStartsWith)
			throws RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getGroupsByAbbreviation
	 */
	public Collection<Group> getGroupsByAbbreviation(String abbreviation) throws RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getUserByID
	 */
	public User getUserByID(int id) throws FinderException, RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#addUser
	 */
	public void addUser(int groupId, User user) throws EJBException, RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getGroupHome
	 */
	public GroupHome getGroupHome(String groupType) throws java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getGroupRelationHome
	 */
	public GroupRelationHome getGroupRelationHome() throws java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getGroupByUniqueId
	 */
	public Group getGroupByUniqueId(String uniqueID) throws FinderException, java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#createGroup
	 */
	public Group createGroup(String name) throws CreateException, RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#createGroup
	 */
	public Group createGroup(String name, String description) throws CreateException, RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#createGroup
	 */
	public Group createGroup(String name, String description, String type) throws CreateException, RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#createGroup
	 */
	public Group createGroup(String name, String description, String type, boolean createUnderDomainRoot)
			throws CreateException, RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#createGroupUnder
	 */
	public Group createGroupUnder(String name, String description, String type, Group parentGroup)
			throws CreateException, RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#createGroupUnder
	 */
	public Group createGroupUnder(String name, String description, Group parentGroup) throws CreateException,
			RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#createGroup
	 */
	public Group createGroup(String name, String description, String type, int homePageID) throws CreateException,
			RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#createGroup
	 */
	public Group createGroup(String name, String description, String type, int homePageID, int aliasID)
			throws CreateException, RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#createGroupUnder
	 */
	public Group createGroupUnder(String name, String description, String type, int homePageID, int aliasID,
			Group parentGroup) throws CreateException, RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getICFileHome
	 */
	public ICFileHome getICFileHome() throws java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#createGroupHomeFolder
	 */
	public ICFile createGroupHomeFolder(Group group) throws CreateException, java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getAllAllowedGroupTypesForChildren
	 */
	public Collection<GroupType> getAllAllowedGroupTypesForChildren(int groupId, IWUserContext iwuc)
			throws java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getAllAllowedGroupTypesForChildren
	 */
	public Collection<GroupType> getAllAllowedGroupTypesForChildren(Group group, IWUserContext iwuc)
			throws java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#addGroupTypeChildren
	 */
	public void addGroupTypeChildren(List<GroupType> list, GroupType groupType) throws java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getGroupType
	 */
	public String getGroupType(Class<? extends IDOEntity> groupClass) throws RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getGroupTypeFromString
	 */
	public GroupType getGroupTypeFromString(String type) throws RemoteException, FinderException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getUserGroupPluginsForGroupType
	 */
	public Collection<UserGroupPlugInBusiness> getUserGroupPluginsForGroupType(String groupType) throws RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getUserGroupPluginsForGroup
	 */
	public Collection<UserGroupPlugInBusiness> getUserGroupPluginsForGroup(Group group) throws RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getUserGroupPluginsForUser
	 */
	public Collection<UserGroupPlugInBusiness> getUserGroupPluginsForUser(User user) throws RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getUserGroupPlugins
	 */
	public Collection<UserGroupPlugInBusiness> getUserGroupPlugins() throws RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getGroupTypeHome
	 */
	public GroupTypeHome getGroupTypeHome() throws RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#addGroupUnderDomainRoot
	 */
	public void addGroupUnderDomainRoot(ICDomain domain, Group group) throws CreateException, RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#addGroupUnderDomain
	 */
	public void addGroupUnderDomain(ICDomain domain, Group group, GroupDomainRelationType type) throws CreateException,
			RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#updateGroupMainAddressOrCreateIfDoesNotExist
	 */
	public Address updateGroupMainAddressOrCreateIfDoesNotExist(Integer groupId, String streetNameAndNumber,
			Integer postalCodeId, String countryName, String city, String province, String poBox)
			throws CreateException, RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getAddressBusiness
	 */
	public AddressBusiness getAddressBusiness() throws RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getGroupMainAddress
	 */
	public Address getGroupMainAddress(Group group) throws RemoteException, IDOLookupException,
			IDOCompositePrimaryKeyException, IDORelationshipException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getAddressHome
	 */
	public AddressHome getAddressHome() throws java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getGroupPhones
	 */
	public Phone[] getGroupPhones(Group group) throws RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getGroupEmail
	 */
	public Email getGroupEmail(Group group) throws java.rmi.RemoteException;

	public Email getGroupMainEmail(Group group) throws NoEmailFoundException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#updateGroupMail
	 */
	public Email updateGroupMail(Group group, String email) throws CreateException, RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getEmailHome
	 */
	public EmailHome getEmailHome() throws java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#updateGroupPhone
	 */
	public Phone updateGroupPhone(Group group, int phoneTypeId, String phoneNumber) throws EJBException,
			java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getGroupPhone
	 */
	public Phone getGroupPhone(Group group, int phoneTypeId) throws RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getPhoneHome
	 */
	public PhoneHome getPhoneHome() throws java.rmi.RemoteException;

	/**
	 * @throws RemoveException
	 * @see com.idega.user.business.GroupBusinessBean#isGroupRemovable
	 */
	public boolean isGroupRemovable(Group group,Group parentGroup) throws java.rmi.RemoteException, RemoveException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getNameOfGroupWithParentName
	 */
	public String getNameOfGroupWithParentName(Group group, Collection<Group> parentGroups) throws java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getNameOfGroupWithParentName
	 */
	public String getNameOfGroupWithParentName(Group group) throws java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getNameOfGroupWithParentName
	 */
	public String getNameOfGroupWithParentName(Group group, Map<String, Collection<Integer>> cachedParents, Map<String, Group> cachedGroups)
			throws java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#createVisibleGroupType
	 */
	public GroupType createVisibleGroupType(String groupType) throws RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#createGroupTypeOrUpdate
	 */
	public GroupType createGroupTypeOrUpdate(String groupType, boolean visible) throws RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#applyPermitPermissionToGroupsParentGroupOwnersPrimaryGroups
	 */
	public void applyPermitPermissionToGroupsParentGroupOwnersPrimaryGroups(Group group)
			throws RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#applyUserAsGroupsOwner
	 */
	public void applyUserAsGroupsOwner(Group group, User user) throws java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#applyCurrentUserAsOwnerOfGroup
	 */
	public void applyCurrentUserAsOwnerOfGroup(IWUserContext iwc, Group group) throws java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#applyAllGroupPermissionsForGroupToCurrentUsersPrimaryGroup
	 */
	public void applyAllGroupPermissionsForGroupToCurrentUsersPrimaryGroup(IWUserContext iwuc, Group group)
			throws java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#applyAllGroupPermissionsForGroupToUsersPrimaryGroup
	 */
	public void applyAllGroupPermissionsForGroupToUsersPrimaryGroup(Group group, User user)
			throws java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#applyAllGroupPermissionsForGroupToGroup
	 */
	public void applyAllGroupPermissionsForGroupToGroup(Group groupToSetPermissionTo,
			Group groupToGetPermissions) throws java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#applyPermissionControllingFromGroupToGroup
	 */
	public void applyPermissionControllingFromGroupToGroup(Group groupToGetInheritanceFrom,
			Group groupToInheritPermissions) throws java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#applyOwnerAndAllGroupPermissionsToNewlyCreatedGroupForUserAndHisPrimaryGroup
	 */
	public void applyOwnerAndAllGroupPermissionsToNewlyCreatedGroupForUserAndHisPrimaryGroup(Group newlyCreatedGroup, User user) throws RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#applyInheritedPermissionsToGroup
	 */
	public void applyInheritedPermissionsToGroup(Group newlyCreatedGroup) throws RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getOwnerUsersForGroup
	 */
	public Collection<User> getOwnerUsersForGroup(Group group) throws RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getGroupsByMetaDataKeyAndValue
	 */
	public Collection<Group> getGroupsByMetaDataKeyAndValue(String key, String value) throws java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getLastGroupTreeSnapShot
	 */
	public NestedSetsContainer getLastGroupTreeSnapShot() throws EJBException, java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#refreshGroupTreeSnapShotInANewThread
	 */
	public void refreshGroupTreeSnapShotInANewThread() throws java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#refreshGroupTreeSnapShot
	 */
	public void refreshGroupTreeSnapShot() throws EJBException, java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#userGroupTreeImageProcedureTopNodeSearch
	 */
	public boolean userGroupTreeImageProcedureTopNodeSearch() throws java.rmi.RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#callAllUserGroupPluginAfterGroupCreateOrUpdateMethod
	 */
	public void callAllUserGroupPluginAfterGroupCreateOrUpdateMethod(Group group);

	/**
	 * @see com.idega.user.business.GroupBusinessBean#callAllUserGroupPluginAfterGroupCreateOrUpdateMethod
	 */
	public void callAllUserGroupPluginAfterGroupCreateOrUpdateMethod(Group group, Group parentGroup);

	/**
	 * @throws RemoteException
	 * @see com.idega.user.business.GroupBusinessBean#callAllUserGroupPluginBeforeGroupRemoveMethod
	 */
	public void callAllUserGroupPluginBeforeGroupRemoveMethod(Group group, Group parentGroup) throws RemoteException,RemoveException;

	public Group createGroup(String name,String description,String type,int homePageID,int aliasID,boolean createUnderDomainRoot,Group parentGroup)throws CreateException,RemoteException;

	public Group createGroup(String name,String description,String type,int homePageID,int homeFolderID,int aliasID,boolean createUnderDomainRoot,Group parentGroup)throws CreateException,RemoteException;

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getGroupsData
	 */
	public List<GroupDataBean> getGroupsData(List<String> uniqueIds);

	/**
	 * @see com.idega.user.business.GroupBusinessBean#getAddressParts
	 */
	public AddressData getAddressParts(Address address);

	public Collection<Group> getUserGroupsByPhrase(IWContext iwc, String phrase);

	/**
	 * Gets groups by criterias mentioned above and orders by them descending
	 * <br/>Criterias: 			<br/>
	 * <ul>
	 * 		<li>Groups amount in group.</li>
	 * 		<li>Users amount in group.</li>
	 * </ul>
	 * @param amount the maximum number of groups that will be returned if less than or equals 0 returns all maches.
	 * @param types group types that will be returned if empty groups of all types will be returned.
	 * @return
	 */
	public Collection<Group> getMostPopularGroups(Collection <String> types,int amount);

	/**
	 * Gets groups and returns them ordered by modification date descendant
	 * @param amount the maximum number of groups that will be returned if less than or equals 0 returns all maches.
	 * @param types group types that will be returned if empty groups of all types will be returned.
	 * @return
	 */
	public Collection<Group> getGroups(Collection <String> types,int amount);

	/**Searches by:
	 * 		name,
	 * 		description
	 * @param request the request by which result will be searched
	 * @param amount the maximum number of groups that will be returned if less than or equals 0 returns all maches.
	 * @param types group types that will be returned if empty groups of all types will be returned.
	 * @return
	 */
	public Collection<Group> getGroupsBySearchRequest(String request, Collection <String> types,int amount);

	/**
	 *
	 * @param groupId is {@link Group#getPrimaryKey()}. Group will be
	 * selected by it, if not <code>null</code>;
	 * @param name is {@link Group#getName()}, not <code>null</code> if
	 * group id not provided;
	 * @param description is {@link Group#getDescription()},
	 * skipped if <code>null</code>;
	 * @param city is {@link Address#getCity()} of {@link Group}, skipped
	 * if <code>null</code>;
	 * @param roles is {@link Collection} of {@link ICRole}s to add for
	 * {@link Group}. Skipped if <code>null</code>;
	 * @return updated {@link Group}s or one {@link Group}s in {@link List}
	 * if new created or {@link Collections#emptyList()} on failure;
	 * @author <a href="mailto:martynas@idega.is">Martynas Stakė</a>
	 */
	public List<Group> update(
			String groupId,
			String name,
			String description,
			String city,
			Collection<String> roles);
}