io.getlime.push.client

Class PushServerClient

java.lang.Object

io.getlime.push.client.PushServerClient

public class PushServerClient
extends Object

Simple class for interacting with the push server RESTful API.

Author:

Petr Dvorak, petr@lime-company.eu, Martin Tupy, martin.tupy.work@gmail.com

Constructor Summary

Constructors

Constructor and Description
PushServerClient() Default constructor.
PushServerClient(String serviceBaseUrl) Constructor with a push server base URL.

Method Summary

Modifier and Type	Method and Description
boolean	addUsersToCampaign(Long campaignId, List<String> users) Add a list of users to a specific campaign
io.getlime.core.rest.model.base.response.ObjectResponse<CreateCampaignResponse>	createCampaign(Long appId, PushMessageBody message) Create a campaign.
boolean	createDevice(Long appId, String token, MobilePlatform platform) Register anonymous device to the push server.
boolean	createDevice(Long appId, String token, MobilePlatform platform, String activationId) Register device associated with activation ID to the push server.
boolean	deleteCampaign(Long campaignId) Delete a campaign specified with campaignId.
boolean	deleteDevice(Long appId, String token) Remove device from the push server
boolean	deleteUsersFromCampaign(Long campaignId, List<String> users) Delete a list of users from specific campaign.
io.getlime.core.rest.model.base.response.ObjectResponse<CampaignResponse>	getCampaign(Long campaignId) Get a campaign specified with campaignID.
io.getlime.core.rest.model.base.response.ObjectResponse<ListOfCampaignsResponse>	getListOfCampaigns(boolean all) Get list of campaigns, dependent on all param
PagedResponse<ListOfUsersFromCampaignResponse>	getListOfUsersFromCampaign(Long campaignId, int page, int size) Get a list of users in paged format from specific campaign
io.getlime.core.rest.model.base.response.ObjectResponse<ServiceStatusResponse>	getServiceStatus() Returns service information
boolean	sendCampaign(Long campaignId) Send a specific campaign to users carrying this campaignID in PushCampaignUser model, but only once per device identified by token.
io.getlime.core.rest.model.base.response.ObjectResponse<PushMessageSendResult>	sendPushMessage(Long appId, PushMessage pushMessage) Send a single push message to application with given ID.
io.getlime.core.rest.model.base.response.ObjectResponse<PushMessageSendResult>	sendPushMessageBatch(Long appId, List<PushMessage> batch) Send a push message batch to application with given ID.
boolean	sendTestCampaign(Long campaignId, String userId) Send a campaign on test user for trying its correctness.
void	setServiceBaseUrl(String serviceBaseUrl) Set the service base URL.
boolean	updateDeviceStatus(String activationId) Update activation status for given device registration.

Methods inherited from class java.lang.Object

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

Constructor Detail

PushServerClient

public PushServerClient()

Default constructor.

PushServerClient

public PushServerClient(String serviceBaseUrl)

Constructor with a push server base URL.

Parameters:

serviceBaseUrl - URL pointing to the running push server instance, for example "http://localhost:8080/powerauth-push-server".

Method Detail

setServiceBaseUrl

public void setServiceBaseUrl(String serviceBaseUrl)

Set the service base URL.

Parameters:

serviceBaseUrl - Base URL.

getServiceStatus

public io.getlime.core.rest.model.base.response.ObjectResponse<ServiceStatusResponse> getServiceStatus()
                                                                                                throws PushServerClientException

Returns service information

Returns:

True if service is running.

Throws:

PushServerClientException - In case of network, response / JSON processing, or other IO error.

createDevice

public boolean createDevice(Long appId,
                            String token,
                            MobilePlatform platform)
                     throws PushServerClientException

Register anonymous device to the push server.

Parameters:

appId - PowerAuth 2.0 application app ID.

token - Token received from the push service provider (APNs, FCM).

platform - Mobile platform (iOS, Android).

Returns:

True if device registration was successful, false otherwise.

Throws:

PushServerClientException - In case of network, response / JSON processing, or other IO error.

createDevice

public boolean createDevice(Long appId,
                            String token,
                            MobilePlatform platform,
                            String activationId)
                     throws PushServerClientException

Register device associated with activation ID to the push server.

Parameters:

appId - PowerAuth 2.0 application app ID.

token - Token received from the push service provider (APNs, FCM).

platform - Mobile platform (iOS, Android).

activationId - PowerAuth 2.0 activation ID.

Returns:

True if device registration was successful, false otherwise.

Throws:

PushServerClientException - In case of network, response / JSON processing, or other IO error.

deleteDevice

public boolean deleteDevice(Long appId,
                            String token)
                     throws PushServerClientException

Remove device from the push server

Parameters:

appId - PowerAuth 2.0 application app ID.

token - Token received from the push service provider.

Returns:

True if device removal was successful, false otherwise.

Throws:

PushServerClientException - In case of network, response / JSON processing, or other IO error.

updateDeviceStatus

public boolean updateDeviceStatus(String activationId)
                           throws PushServerClientException

Update activation status for given device registration.

Parameters:

activationId - Identifier of activation

Returns:

True if updating went successful, false otherwise.

Throws:

PushServerClientException - In case of network, response / JSON processing, or other IO error.

sendPushMessage

public io.getlime.core.rest.model.base.response.ObjectResponse<PushMessageSendResult> sendPushMessage(Long appId,
                                                                                                      PushMessage pushMessage)
                                                                                               throws PushServerClientException

Send a single push message to application with given ID.

Parameters:

appId - PowerAuth 2.0 application app ID.

pushMessage - Push message to be sent.

Returns:

SendMessageResponse in case everything went OK, ErrorResponse in case of an error.

Throws:

PushServerClientException - In case of network, response / JSON processing, or other IO error.

sendPushMessageBatch

public io.getlime.core.rest.model.base.response.ObjectResponse<PushMessageSendResult> sendPushMessageBatch(Long appId,
                                                                                                           List<PushMessage> batch)
                                                                                                    throws PushServerClientException

Send a push message batch to application with given ID.

Parameters:

appId - PowerAuth 2.0 application app ID.

batch - Push message batch to be sent.

Returns:

SendMessageResponse in case everything went OK, ErrorResponse in case of an error.

Throws:

PushServerClientException - In case of network, response / JSON processing, or other IO error.

createCampaign

public io.getlime.core.rest.model.base.response.ObjectResponse<CreateCampaignResponse> createCampaign(Long appId,
                                                                                                      PushMessageBody message)
                                                                                               throws PushServerClientException

Create a campaign.

Parameters:

appId - Application ID.

message - Message which attributes are defined in PushMessageBody.

Returns:

ID of new created campaign.

Throws:

PushServerClientException - In case of network, response / JSON processing, or other IO error.

deleteCampaign

public boolean deleteCampaign(Long campaignId)
                       throws PushServerClientException

Delete a campaign specified with campaignId.

Parameters:

campaignId - Campaign ID.

Returns:

True if campaign is removed, false otherwise.

Throws:

PushServerClientException - In case of network, response / JSON processing, or other IO error.

getListOfCampaigns

public io.getlime.core.rest.model.base.response.ObjectResponse<ListOfCampaignsResponse> getListOfCampaigns(boolean all)
                                                                                                    throws PushServerClientException

Get list of campaigns, dependent on all param

Parameters:

all - true to get whole list, false to get campaigns that are only sent

Returns:

List of campaigns.

Throws:

PushServerClientException - In case of network, response / JSON processing, or other IO error.

getCampaign

public io.getlime.core.rest.model.base.response.ObjectResponse<CampaignResponse> getCampaign(Long campaignId)
                                                                                      throws PushServerClientException

Get a campaign specified with campaignID.

Parameters:

campaignId - ID of campaign to get.

Returns:

Details of campaign, defined in CampaignResponse

Throws:

PushServerClientException - In case of network, response / JSON processing, or other IO error.

addUsersToCampaign

public boolean addUsersToCampaign(Long campaignId,
                                  List<String> users)
                           throws PushServerClientException

Add a list of users to a specific campaign

Parameters:

campaignId - Identifier of campaign.

users - List of users to add.

Returns:

True if adding was successful, false otherwise.

Throws:

PushServerClientException - In case of network, response / JSON processing, or other IO error.

getListOfUsersFromCampaign

public PagedResponse<ListOfUsersFromCampaignResponse> getListOfUsersFromCampaign(Long campaignId,
                                                                                 int page,
                                                                                 int size)
                                                                          throws PushServerClientException

Get a list of users in paged format from specific campaign

Parameters:

campaignId - Identifier of campaign.

page - Page number.

size - Size of elements per page.

Returns:

Page of users specified with params.

Throws:

PushServerClientException - In case of network, response / JSON processing, or other IO error.

deleteUsersFromCampaign

public boolean deleteUsersFromCampaign(Long campaignId,
                                       List<String> users)
                                throws PushServerClientException

Delete a list of users from specific campaign.

Parameters:

campaignId - Identifier of campaign.

users - List of users' Identifiers to delete.

Returns:

True if deletion was successful, false otherwise.

Throws:

PushServerClientException - In case of network, response / JSON processing, or other IO error.

sendTestCampaign

public boolean sendTestCampaign(Long campaignId,
                                String userId)
                         throws PushServerClientException

Send a campaign on test user for trying its correctness.

Parameters:

campaignId - Identifier of campaign.

userId - Identifier of test user.

Returns:

True if sent, else otherwise.

Throws:

PushServerClientException - In case of network, response / JSON processing, or other IO error.

sendCampaign

public boolean sendCampaign(Long campaignId)
                     throws PushServerClientException

Send a specific campaign to users carrying this campaignID in PushCampaignUser model, but only once per device identified by token.

Parameters:

campaignId - Identifier of campaign.

Returns:

True if sent, else otherwise.

Throws:

PushServerClientException - In case of network, response / JSON processing, or other IO error.