abs.ixi.client

Class UserManager

java.lang.Object

abs.ixi.client.core.AbstractPacketForwarder

abs.ixi.client.UserManager

All Implemented Interfaces:

PacketCollector, PacketForwarder

public class UserManager
extends AbstractPacketForwarder
implements PacketCollector

UserManager is the top level entity which has all the convinience method required to add, retrieve and update user related data. Most of the times, UserManager processes IQ packets. Primary responsibility includes user login, user signup, user logout, roster management and Chatroom/Group related APIs.

UserManager allows both asynchronous and synchronous invocation of exposed APIs. Additionally, developer can supply a Callback instance to be invoked once the request to server is complete.

Constructor Summary

Constructors

Constructor and Description
UserManager(XMPPStreamManager streamManager, ResponseCorrelator correlator)

Method Summary

Modifier and Type	Method and Description
boolean	addChatRoomAdmin(JID roomJID, JID userJID) Request to add chat room admin.
boolean	addChatRoomMember(JID roomJID, JID userJID) Request to add chat room member.
boolean	addChatRoomOwner(JID roomJID, JID userJID) Request to add chat room owner.
boolean	addRosterMember(JID jid, String name) Request to add a memeber to the user Roster.
boolean	changePassword(String newPassword) Use it change user login password and refer XEP-0077.
boolean	changeUserAvatar(File file) User it to change user avatar.
boolean	changeUserAvatar(File file, String imageType) User it to change user avatar.
boolean	changeUserAvatar(URL url) User it to change user avatar.
boolean	changeUserAvatar(URL url, String imageType) User it to change user avatar.
void	collect(Packet packet) This collector takes the given packet.
boolean	createInstantRoom(String roomName) It create instant Room with default configurations.
boolean	createPrivateRoom(String roomName) Create public room with given room name.
boolean	createPublicRoom(String roomName) Create public room with given room name.
boolean	createReservedRoom(String roomName, Map<ChatRoom.RoomConfigParam,String> configs) Request to create group with some configurations rather than default configuration (private group)
boolean	destroyChatRoom(JID roomJID, String reason) Destroy chat room.
boolean	discardDeviceToken(String regId, PushNotificationService service, DeviceType deviceType, String deviceId) On log out Client app developer have to un register device token.
Set<ChatRoom.RoomConfigParam>	getChatRoomConfigParams(JID roomJID) Request to get list of room configurations which can be updated.
boolean	getFullRoster(Callback<Roster,Exception> callback) Retrieve full user roster from server.
IQ	getRoster(int version) Retrieve user Roster from server.
UserProfileData	getUserProfileData() It return logged in user's data.
UserProfileData	getUserProfileData(JID userJID) It return given user's data.
Set<String>	getUserRegistrationAttributes() Returns all required attributes to register new user.
Set<String>	getUserSearchAttributes() It Returns all server supported attributes for searching a user.
boolean	registerNewUser(String userName, String email, String password) Uses it for In-Band User Registration and refer XEP-0077.
void	registerNewUser(String userName, String email, String password, Callback<String,String> callback) Register a new user
boolean	removeChatRoomMember(JID roomJID, JID userJID) Request to Remove member from chat room.
boolean	removeRosterMember(JID jid) Remove Roster member from logged-in user Roster.
IQ	removeRosterMember(JID jid, String name, Callback<IQ,Exception> callback) Remove a roster member from logged-in user roster.
boolean	removeUserAvatar() Use it to remove user avatar.
List<UserSearchData.Item>	searchUser(String firstName, String lastName, String nickName, String email) This method returns list of matched users.
List<UserSearchData.Item>	searchUserWithEmail(String email) This method returns list of matched users.
List<UserSearchData.Item>	searchUserWithFirstName(String firstName) This method returns list of matched users.
List<UserSearchData.Item>	searchUserWithLastName(String lastName) This method returns list of matched users.
List<UserSearchData.Item>	searchUserWithNickName(String nickName) This method returns list of matched users.
void	sendAddChatRoomMemberRequest(JID roomJID, JID userJID) Request to add chat room member.
boolean	sendAddRosterMemberRequest(JID jid, String name) Send request to add a memeber to the user Roster.
boolean	sendChangeUserNicknameRequest(JID roomJID, String nickName) Request to change user nick name in given chat room
boolean	sendGetChatRoomInfoRequest(JID roomJID) Request to get info of chat room.
boolean	sendGetChatRoomMembersRequest(JID roomJID) Send request to retrieve memebers list of a chatroom.
boolean	sendGetChatRoomsRequest() Send a request to retreive list of availave chat rooms on server.
void	sendGetChatRoomsRequest(Callback<List<ChatRoom>,Exception> callback) Send a request to retrieve list of available chat rooms on server.
boolean	sendGetFullRosterRequest() Retrieve full user roster from server.
boolean	sendGetRosterRequest(int version) Send a request to server to retrieve a particular version of user Roster.
boolean	sendJoinChatRoomRequest(JID roomJID, String nickName) Request to join a ChatRoom.
boolean	sendLeaveChatRoomRequest(JID roomJID) Request to leave a ChatRoom
boolean	sendRemoveRosterMemberRequest(JID jid, String name) Send request to remove Roster member from logged-in user Roster.
boolean	sendUpdateRosterMemberNameRequest(JID jid, String name) Send request to server to update Roster member name.
boolean	unRegisterUser() Use it deactivate logged in user account and refer XEP-0077.
boolean	updateChatRoomMember(JID roomJID, JID userJID, String nickName, ChatRoom.Affiliation affiliation, ChatRoom.Role role) Request to update chat room member.
boolean	updateDeviceToken(String token, PushNotificationService service, DeviceType deviceType, String deviceId) Update device push notification registration id on server.
boolean	updateRoomSubject(JID roomJID, String subject) Send a request to change Chat room subject.
boolean	updateRosterMemberName(JID jid, String name) Request to server to update Roster member name.
IQ	updateRosterMemberName(JID jid, String name, Callback<IQ,Exception> callback) Update name of a roster member.
boolean	updateUserProfileData(String firstName, String middleName, String lastName, String nickName, String email, String phone, String gender, String birthDay, String addressHome, String addressStreet, String addressLocality, String addressCity, String addressState, String addressCountry, String addressPCode, String about) Use it to update user profile data.
boolean	updateUserProfileData(UserProfileData userProfileData) return true if user data is updated successfully.

Methods inherited from class abs.ixi.client.core.AbstractPacketForwarder

addPacketCollector, addPacketCollector, forwardDefault, forwardPacket, removePacketCollector, removePacketCollector

Methods inherited from class java.lang.Object

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

Constructor Detail

UserManager

public UserManager(XMPPStreamManager streamManager,
                   ResponseCorrelator correlator)

Method Detail

sendGetFullRosterRequest

public boolean sendGetFullRosterRequest()

Retrieve full user roster from server. The method sends a request to server for user Roster and returns. Upon receiving the the Roster, Event.EventType.ROSTER_RECEIVE is pushed on to EventBus. Application can write an EventHandler for the event type and handle the received Roster.

Returns:

true if the request was sent to server; otherwise false

getFullRoster

public boolean getFullRoster(Callback<Roster,Exception> callback)

Retrieve full user roster from server. The method sends a request to server for user Roster and returns. Upon receiving the the Roster, Event.EventType.ROSTER_RECEIVE is pushed on to EventBus. Application can write an EventHandler for the event type and handle the received Roster.

Parameters:

callback - callback instance

Returns:

true if the request was sent to server; otherwise false

sendGetRosterRequest

public boolean sendGetRosterRequest(int version)

Send a request to server to retrieve a particular version of user Roster. The method simply sends the request and returns. Later when response arrives, Event.EventType.ROSTER_RECEIVE event is pushed on to EventBus. Applications can create and subscribe an EventHandler for this event type.

Parameters:

version - Roster version to be retrieved

Returns:

true if the request was sent successfully; otherwise false

getRoster

public IQ getRoster(int version)
             throws TimeoutException

Retrieve user Roster from server. The method blocks until server retruns the response. If server fails to respond in ReplyTimeout time, a TimeoutException will be generated.

Parameters:

version - Roster version; 0 indicates full Roster

Returns:

IQ packet with Roster response

Throws:

TimeoutException - if server does not reply in configured time.

sendAddRosterMemberRequest

public boolean sendAddRosterMemberRequest(JID jid,
                                          String name)

Send request to add a memeber to the user Roster.

Parameters:

jid - JID of the user who will be added to Roster

name - name of user who will be added to Roster

Returns:

true if the request was sent successfully otherwise false

updateRosterMemberName

public IQ updateRosterMemberName(JID jid,
                                 String name,
                                 Callback<IQ,Exception> callback)

Update name of a roster member. The request is executed asynchronosly; supplied Callback will be invoked once response arrives. If Server fails to respond in stipulated reply time, Callback will be invoked with TimeoutException

Parameters:

jid - JID of the user who will be added to Roster

name - new name of the member

callback - Callback instance for invocation

Returns:

true if the request was sent to server successfully;otherwise false

sendUpdateRosterMemberNameRequest

public boolean sendUpdateRosterMemberNameRequest(JID jid,
                                                 String name)

Send request to server to update Roster member name. The method simply send an IQ packet to server with supplied correlation id as the packet id.

Parameters:

jid - JID of the member

name - new name of the member

Returns:

true if the request was sent to server successfully; otherwise false

removeRosterMember

public IQ removeRosterMember(JID jid,
                             String name,
                             Callback<IQ,Exception> callback)

Remove a roster member from logged-in user roster. The request is executed asynchronosly; supplied Callback will be invoked once response arrives. If Server fails to respond in stipulated reply time, Callback will be invoked with TimeoutException

Parameters:

jid - JID of the user who will be removed to Roster

name - new name of the member

callback - Callback instance for invocation

Returns:

true if the request was sent to server successfully;otherwise false

sendRemoveRosterMemberRequest

public boolean sendRemoveRosterMemberRequest(JID jid,
                                             String name)

Send request to remove Roster member from logged-in user Roster. The method simply send an IQ packet to server with supplied correlation id as the packet id.

Parameters:

jid - JID of the member

name - new name of the member

Returns:

true if the request was sent to server successfully; otherwise false

addRosterMember

public boolean addRosterMember(JID jid,
                               String name)

Request to add a memeber to the user Roster.

Parameters:

jid - JID of the user who will be added to Roster

name - name of the member if name is not specified that Roster member name will be default name of that user.

Returns:

true if the request was sent successfully otherwise false

removeRosterMember

public boolean removeRosterMember(JID jid)

Remove Roster member from logged-in user Roster. The method simply send an IQ packet to server with supplied correlation id as the packet id.

Parameters:

jid - JID of the member

Returns:

true if the request was sent to server successfully; otherwise false

updateRosterMemberName

public boolean updateRosterMemberName(JID jid,
                                      String name)

Request to server to update Roster member name. The method simply send an IQ packet to server with supplied correlation id as the packet id.

Parameters:

jid - JID of the member

name - new name of the member if name is not specified that Roster member name will be default name of that user.

Returns:

true if the request was sent to server successfully; otherwise false

sendGetChatRoomsRequest

public boolean sendGetChatRoomsRequest()

Send a request to retreive list of availave chat rooms on server.

Returns:

true if the request was sent to server successfully otherwise false

sendGetChatRoomsRequest

public void sendGetChatRoomsRequest(Callback<List<ChatRoom>,Exception> callback)

Send a request to retrieve list of available chat rooms on server.

Parameters:

callback - Callback instance for invocation

sendGetChatRoomMembersRequest

public boolean sendGetChatRoomMembersRequest(JID roomJID)

Send request to retrieve memebers list of a chatroom.

Parameters:

roomJID - room JID

Returns:

true if the request was sent to server successfully otherwise false

sendGetChatRoomInfoRequest

public boolean sendGetChatRoomInfoRequest(JID roomJID)

Request to get info of chat room.

Parameters:

roomJID - JID of the chatroom

Returns:

true if the request was sent to server successfully otherwise false

sendChangeUserNicknameRequest

public boolean sendChangeUserNicknameRequest(JID roomJID,
                                             String nickName)

Request to change user nick name in given chat room

Parameters:

roomJID - JID of the chatroom

nickName - nickName

Returns:

true if the request was sent to server successfully otherwise false

sendJoinChatRoomRequest

public boolean sendJoinChatRoomRequest(JID roomJID,
                                       String nickName)

Request to join a ChatRoom.

Parameters:

roomJID - JID of the chatroom

nickName - nickName

Returns:

true if the request was sent to server successfully otherwise false

sendLeaveChatRoomRequest

public boolean sendLeaveChatRoomRequest(JID roomJID)

Request to leave a ChatRoom

Parameters:

roomJID - JID of the room

Returns:

true if the request was sent to server successfully otherwise false

sendAddChatRoomMemberRequest

public void sendAddChatRoomMemberRequest(JID roomJID,
                                         JID userJID)

Request to add chat room member. This request should be given by ChatRoom.Affiliation.ADMIN or ChatRoom.Affiliation.OWNER. otherwise request will failed

Parameters:

roomJID - JID of the chatroom

userJID - JID of the user

addChatRoomAdmin

public boolean addChatRoomAdmin(JID roomJID,
                                JID userJID)

Request to add chat room admin. This request should be given by ChatRoom.Affiliation.ADMIN or ChatRoom.Affiliation.OWNER otherwise request will failed

Parameters:

roomJID - JID of the chatroom

userJID - JID of the user

Returns:

true if member added successfully

addChatRoomOwner

public boolean addChatRoomOwner(JID roomJID,
                                JID userJID)

Request to add chat room owner. This request should be given by ChatRoom.Affiliation.ADMIN or ChatRoom.Affiliation.OWNER otherwise request will failed

Parameters:

roomJID - JID of the chatroom

userJID - user JID

Returns:

true if member added successfully

addChatRoomMember

public boolean addChatRoomMember(JID roomJID,
                                 JID userJID)

Request to add chat room member. This request should be given by ChatRoom.Affiliation.ADMIN or ChatRoom.Affiliation.OWNER otherwise request will failed

Parameters:

roomJID - chatroom JID

userJID - user JID

Returns:

true if member added successfully

removeChatRoomMember

public boolean removeChatRoomMember(JID roomJID,
                                    JID userJID)

Request to Remove member from chat room. This request should be given by ChatRoom.Affiliation.ADMIN or ChatRoom.Affiliation.OWNER. otherwise request will failed

Parameters:

roomJID - chatroom JID

userJID - user JID

Returns:

true if member added successfully

updateChatRoomMember

public boolean updateChatRoomMember(JID roomJID,
                                    JID userJID,
                                    String nickName,
                                    ChatRoom.Affiliation affiliation,
                                    ChatRoom.Role role)

Request to update chat room member. This request should be given by ChatRoom.Affiliation.ADMIN or ChatRoom.Affiliation.OWNER. otherwise request will failed

Parameters:

roomJID - chatroom JID

userJID - user JID

nickName - nickName

affiliation - affiliation

role - role

Returns:

true if member added successfully

createInstantRoom

public boolean createInstantRoom(String roomName)

It create instant Room with default configurations. In usual group chat scenarios groups behave like a private chat rooms. No one can enter in chat room itself. So Stringflow server group's default behaviour is private group. In private groups Admin or Owner can add other members. And Room creator will be made owner and moderator of the group.No one can enter these group by giving sendJoinChatRoomRequest(JID, String) request.

Parameters:

roomName - name of the chatroom

Returns:

true is room is successfully created, otherwise false

createReservedRoom

public boolean createReservedRoom(String roomName,
                                  Map<ChatRoom.RoomConfigParam,String> configs)

Request to create group with some configurations rather than default configuration (private group)

Parameters:

roomName - chatroom name

configs - configurations

Returns:

true if the chatroom was created successfully otherwise false

createPrivateRoom

public boolean createPrivateRoom(String roomName)

Create public room with given room name. No one can enter in this room using sendJoinChatRoomRequest(JID, String). Only room admin and owner can add or remove other members.

Parameters:

roomName - chatroom name

Returns:

true if the private room was created successfully otherwise false

createPublicRoom

public boolean createPublicRoom(String roomName)

Create public room with given room name. Any one can enter in this room using sendJoinChatRoomRequest(JID, String).

Parameters:

roomName - chatroom name

Returns:

true if the public room was created successfully otherwise false

getChatRoomConfigParams

public Set<ChatRoom.RoomConfigParam> getChatRoomConfigParams(JID roomJID)

Request to get list of room configurations which can be updated. This request should be given by chat room owner. Only Owner is allowed to modify group configuration. If Other request to get room configurations then Server sends a failure error IQ. And method returns null.

Parameters:

roomJID - chatroom JID

Returns:

Set of room configuration params

updateRoomSubject

public boolean updateRoomSubject(JID roomJID,
                                 String subject)

Send a request to change Chat room subject. The method simply sends request to server.

Parameters:

roomJID - chatroom JID

subject - subject

Returns:

true if the request was sent to server successfully otherwise false

destroyChatRoom

public boolean destroyChatRoom(JID roomJID,
                               String reason)

Destroy chat room. Only Group owner can destroy a chat room

Parameters:

roomJID - chatroom JID

reason - reason string

Returns:

true if the chatroom was destroyed successfully otherwise false

updateDeviceToken

public boolean updateDeviceToken(String token,
                                 PushNotificationService service,
                                 DeviceType deviceType,
                                 String deviceId)

Update device push notification registration id on server. In order to receive push notification from any external Push Notification Service such as GCM/FCM/APNS/WPNS, device must register with any of these services. Upon successful registration, device receives registration id which is used by Server to route push notifications to device. Messaging on mobile devices can not work without server making use of external push notification service; In order to send a push notification from server, server must know the registration id of the device.

Parameters:

token - Registration Id of the device

service - External Push Notification Service Name

deviceType - DeviceType

deviceId - unique id of the device

Returns:

true if the request was sent to server successfully otherwise false

discardDeviceToken

public boolean discardDeviceToken(String regId,
                                  PushNotificationService service,
                                  DeviceType deviceType,
                                  String deviceId)

On log out Client app developer have to un register device token.

Parameters:

regId - Registration Id of the device

service - External Push Notification Service Name

deviceType - DeviceType

deviceId - unique deviceId

Returns:

true if the opeartion was successful otherwise false

getUserRegistrationAttributes

public Set<String> getUserRegistrationAttributes()
                                          throws NetworkException

Returns all required attributes to register new user. if null is return their might be some problem while processing request. Please refer In-Band Registration(XEP-0077)

Returns:

Set of registration attributes

Throws:

NetworkException - if encounters any network related issues

registerNewUser

public void registerNewUser(String userName,
                            String email,
                            String password,
                            Callback<String,String> callback)
                     throws NetworkException

Register a new user

Parameters:

userName - userName

email - email of the user

password - password of the user

callback - Callback instance

Throws:

NetworkException - if network related error occurred

registerNewUser

public boolean registerNewUser(String userName,
                               String email,
                               String password)
                        throws NetworkException

Uses it for In-Band User Registration and refer XEP-0077.

Parameters:

userName - user name

email - email of the user

password - password of the user

Returns:

true if user is registered successfully.

Throws:

NetworkException - if network related error occurred

changePassword

public boolean changePassword(String newPassword)

Use it change user login password and refer XEP-0077.

Parameters:

newPassword - new password of the user

Returns:

true if password is changed successfully

unRegisterUser

public boolean unRegisterUser()

Use it deactivate logged in user account and refer XEP-0077.

Returns:

true if the operation was successful otherwise false

getUserProfileData

public UserProfileData getUserProfileData()

It return logged in user's data. It refers XEP-0054(vcard-temp) to access user profile related data.

Returns:

UserProfileData instance

getUserProfileData

public UserProfileData getUserProfileData(JID userJID)

It return given user's data. It refers XEP-0054(vcard-temp) to access user profile related data.

Parameters:

userJID - JID of the user

Returns:

UserProfileData instance

updateUserProfileData

public boolean updateUserProfileData(String firstName,
                                     String middleName,
                                     String lastName,
                                     String nickName,
                                     String email,
                                     String phone,
                                     String gender,
                                     String birthDay,
                                     String addressHome,
                                     String addressStreet,
                                     String addressLocality,
                                     String addressCity,
                                     String addressState,
                                     String addressCountry,
                                     String addressPCode,
                                     String about)

Use it to update user profile data. If do not want to update any attribute then pass null on that attribute place.

We do not validate data. It's client responsibility to pass all details in correct way or format.

Parameters:

firstName - firstName of the user

middleName - middleName of the user

lastName - last name of the user

nickName - nickName if any

email - email of the user

phone - phone no of the user

gender - gender of the suer

birthDay - birthDate(dd-mm-yyyy)

addressHome - home address

addressStreet - Street address

addressLocality - locality

addressCity - City name

addressState - state

addressCountry - country

addressPCode - Postal code

about - brief about the user

Returns:

true if the operation was successful otherwise false

updateUserProfileData

public boolean updateUserProfileData(UserProfileData userProfileData)

return true if user data is updated successfully. Please refer V-Card XEP-0054.

Parameters:

userProfileData - UserProfileData

Returns:

true if the operation was successful otherwise false

changeUserAvatar

public boolean changeUserAvatar(File file)

User it to change user avatar.

The image SHOULD use less than eight kilobytes (8k) of data; And it's height and width SHOULD be between thirty-two (32) and ninety-six (96) pixels; the recommended size is sixty-four (64) pixels high and sixty-four (64) pixels wide.

We Only verify total size of file which should be less than eight kilobytes (8k). and other verifications like height, width, pixels client have to do.

Please refer XEP-0153: vCard-Based Avatars.

Parameters:

file - avtar file

Returns:

true if user avtar is changes successfully.

changeUserAvatar

public boolean changeUserAvatar(URL url)

User it to change user avatar.

The image SHOULD use less than eight kilobytes (8k) of data; And it's height and width SHOULD be between thirty-two (32) and ninety-six (96) pixels; the recommended size is sixty-four (64) pixels high and sixty-four (64) pixels wide.

We Only verify total size of file which should be less than eight kilobytes (8k). and other verifications like height, width, pixels client have to do.

Please refer XEP-0153: vCard-Based Avatars.

Parameters:

url - url of the user avtar image

Returns:

true if user avtar is changes successfully.

changeUserAvatar

public boolean changeUserAvatar(URL url,
                                String imageType)

User it to change user avatar.

The image SHOULD use less than eight kilobytes (8k) of data; And it's height and width SHOULD be between thirty-two (32) and ninety-six (96) pixels; the recommended size is sixty-four (64) pixels high and sixty-four (64) pixels wide.

We Only verify total size of file which should be less than eight kilobytes (8k). and other verifications like height, width, pixels client have to do.

Please refer XEP-0153: vCard-Based Avatars.

Parameters:

url - Avtar image url

imageType - ContyentType of the image

Returns:

true if user avtar is changes successfully.

changeUserAvatar

public boolean changeUserAvatar(File file,
                                String imageType)

User it to change user avatar.

The image SHOULD use less than eight kilobytes (8k) of data; And it's height and width SHOULD be between thirty-two (32) and ninety-six (96) pixels; the recommended size is sixty-four (64) pixels high and sixty-four (64) pixels wide.

We Only verify total size of file which should be less than eight kilobytes (8k). and other verifications like height, width, pixels client have to do.

Please refer XEP-0153: vCard-Based Avatars.

Parameters:

file - Avtar file

imageType - content type of the file

Returns:

true if user avtar is changes successfully.

removeUserAvatar

public boolean removeUserAvatar()

Use it to remove user avatar. Please refer XEP-0153: vCard-Based Avatars.

Returns:

true if avtar was removed successfully

getUserSearchAttributes

public Set<String> getUserSearchAttributes()

It Returns all server supported attributes for searching a user.

Please refer XEP-0055.

Returns:

user search attributes

searchUser

public List<UserSearchData.Item> searchUser(String firstName,
                                            String lastName,
                                            String nickName,
                                            String email)

This method returns list of matched users. return null if no user match found with searching details.

Please refer XEP-0055.

Parameters:

firstName - firstName of the user

lastName - lastName of the user

nickName - nickName of the user

email - email of the user

Returns:

list of matched users. return null if no user match found with searching details.

searchUserWithFirstName

public List<UserSearchData.Item> searchUserWithFirstName(String firstName)

This method returns list of matched users. return null if no user match found with searching details.

Please refer XEP-0055.

Parameters:

firstName - firstName of the user

Returns:

List of users matching the search criteria

searchUserWithLastName

public List<UserSearchData.Item> searchUserWithLastName(String lastName)

This method returns list of matched users. return null if no user match found with searching details.

Please refer XEP-0055.

Parameters:

lastName - lastName

Returns:

List of users matching the search criteria

searchUserWithNickName

public List<UserSearchData.Item> searchUserWithNickName(String nickName)

This method returns list of matched users. return null if no user match found with searching details.

Please refer XEP-0055.

Parameters:

nickName - nickName

Returns:

List of users matching the search criteria

searchUserWithEmail

public List<UserSearchData.Item> searchUserWithEmail(String email)

This method returns list of matched users. return null if no user match found with searching details.

Please refer XEP-0055.

Parameters:

email - email of the user

Returns:

List of users matching the search criteria

collect

public void collect(Packet packet)

Description copied from interface: PacketCollector

This collector takes the given packet. The collector may employ further filtering and may decide to ignore/drop this packet.

Specified by:

collect in interface PacketCollector

Parameters:

packet - packet instance to be collected