public class ActivationService extends Object
User: Kirill, Date: 01.10.13 11:21
.Modifier and Type | Field and Description |
---|---|
private static String |
ACTIVATION_ACCESS_URL |
private Credentials |
credentials |
private Transport |
transport |
private URL |
url |
Constructor and Description |
---|
ActivationService(URL url,
Credentials credentials,
Transport transport)
Constructs the service.
|
Modifier and Type | Method and Description |
---|---|
boolean |
cashRegisterNameExists(CashRegisterNameExistsInfo cashRegisterNameExistsInfo)
Checks that cash register name is unique for particular seller.
|
String |
generateProductionNumber(InstallationOrderInfo installationOrderInfo)
If current application does not (yet) have a ProductionNumber, it uses this method to get a new one.
|
ActivationCodeInfo |
getActivationCode(Credentials credentials)
This method requires credentials and returns
ActivationCodeInfo for provided credentials. |
String |
orderActivation(ActivationOrderInfo activationOrderInfo)
If current application does not have Activation, or Activation expires soon, the app uses this method to request (order)
a new one.
|
private static final String ACTIVATION_ACCESS_URL
private URL url
private Credentials credentials
private Transport transport
public ActivationService(URL url, Credentials credentials, Transport transport)
url
- of the servercredentials
- to work with the servertransport
- to know the method to reach the serverpublic String generateProductionNumber(InstallationOrderInfo installationOrderInfo)
installationOrderInfo
- information about current installationInstallationOrderInfo.applicationPackage
fieldpublic String orderActivation(ActivationOrderInfo activationOrderInfo)
activationOrderInfo
- information about Activation neededReferenceNotFoundJsonException
- if device, installation or control unit are not foundCashRegisterNameIsNotUniqueJsonException
- if cash register name is not unique within a sellerInconsistentDataJsonException
- if sent data in inconsistent (e.g. when production number
doesn't belong to given device ID)ValidationJsonException
- if corporateId is not ok or other required fields are wrong or
provided data is incorrect (see message inside for more info)ReferenceNotFoundJsonException
- if there is no application specified in
* @throws com.srv4pos.server.api.exceptions.ReferenceNotFoundJsonException if there is no application specified in
ActivationOrderInfo#getInstallationOrderInfo()
InstallationOrderInfo.applicationPackage
field
ActivationOrderInfo#getInstallationOrderInfo()
InstallationOrderInfo.applicationPackage
fieldpublic boolean cashRegisterNameExists(CashRegisterNameExistsInfo cashRegisterNameExistsInfo)
cashRegisterNameExistsInfo
- see javadoc of members of this type for more infopublic ActivationCodeInfo getActivationCode(Credentials credentials)
ActivationCodeInfo
for provided credentials.
It must be authenticated by credentials initialized by Credentials#(String, String, String, String)
credentials
- to authenticate to pass activationSecurityToken as Credentials#(String, String, String, String)
ActivationDescriptorInfo
, it's signature and it's version (to correctly check digital signature)WrongUsernameOrPasswordJsonException
- if there is no possibility to authenticate. It might
happen because activation still has status ISSUED, but must be ACTIVE
or WORKING. User should get "Please contact sales@srv4pos.com if
this error appears longer than 24h".ActivationStillIssuedJsonException
- when activation is still in Issued stateCopyright © 2015. All rights reserved.