iap-java-sample

Содержание

• Введение
• Установка
• Требования к среде
• Конфигурация
• Пример кода
• Лицензия

Введение

Пример кода на Java инкапсулирует API сервера HUAWEI IAP. Он предоставляет множество примеров программ для ознакомления или использования.

Далее описаны пакеты примера кода на Java:

1. AtDemo: пример кода AccessToken. Каждый метод может выполняться независимо.
2. OrderService: пример кода OrderService. Каждый метод может выполняться независимо.
3. SubscriptionService: пример кода SubscriptionService. Каждый метод может выполняться независимо.
4. notification: пример кода notification. Каждый метод может выполняться независимо.

Установка

Перед использованием примера кода Java проверьте, установлена ли среда Java. Распакуйте пакет примера кода Java. Скопируйте пакет примера кода Java в распакованной папке в каталог проекта поставщика по пути, указанному JAVAPATH. Обновите проект и убедитесь, что файл успешно скопирован в целевой каталог.

Требования к среде

Рекомендуется использовать JDK 1.8 или более позднюю версию.

Конфигурация

Чтобы использовать функции, представленные в примерах, необходимо установить соответствующие параметры в AtDemo.java, OrderService.java, SubscriptionService.java и AppServer.java в пакете.

Ниже описаны параметры в AtDemo.java:

• clientId: идентификатор клиента, полученный из информации о приложении.
• clientSecret: секретный ключ доступа приложения, полученный из информации о приложении.
• tokenUrl: URL-адрес службы Huawei OAuth 2.0 для получения токена. См. Аутентификация на основе OAuth 2.0.

Ниже описаны параметры в notification/AppServer.java:

• PUBLIC_KEY: открытый ключ RSA.

Сначала следует понять значение accountFlag. Если поле accountFlag в InappPurchaseData равно 1, учётная запись принадлежит оператору связи (TOBTOC_SITE_URL); в противном случае — компании Huawei (TOC_SITE_URL). Для OrderService и SubscriptionService необходимо выбрать соответствующий сайт.

• TOC_SITE_URL: TOC_SITE_URL имеет разные URL-адреса на разных сайтах, вы всегда должны выбирать адрес ближайшего сайта для доступа.
• TOBTOC_SITE_URL: сайт оператора связи.

Пример кода

Каждый метод в примере Java вызывает API сервера HUAWEI IAP. Ниже описаны методы в примере Java.

1. AtDemo: getAppAT()

Вы можете вызвать этот метод, чтобы получить токен доступа на уровне приложения. Расположение кода: src/main/java/com/example/demo/AtDemo.java.

2. OrderService: verifyToken()

Вы можете вызвать этот метод для проверки токена покупки в результате оплаты с платёжным сервером Huawei, чтобы подтвердить точность результата оплаты. URL: {rootUrl}/applications/purchases/tokens/verify. RootUrl имеет разные URL-адреса на разных сайтах, вы должны всегда выбирать адрес службы заказа ближайшего сайта для доступа. Расположение кода: src/main/java/com/example/demo/OrderService.java.

3. OrderService: cancelledListPurchase()

Вы можете вызвать этот метод для постраничного запроса всей информации о покупке, которая была отменена или имеет возврат средств. URL: {rootUrl}/applications/{apiVersion}/purchases/cancelledList. RootUrl имеет разные URL-адреса на разных сайтах, вы должны всегда выбирать адрес службы заказов ближайшего сайта для доступа. Расположение кода: src/main/java/com/example/demo/OrderService.java.

4. SubscriptionService: getSubscription()

Вы можете вызвать этот метод, чтобы проверить купленный продукт подписки, например, чтобы узнать срок действия и статус. URL: {rootUrl}/sub/applications/{apiVersion}/purchases/get. RootUrl имеет разные URL-адреса на разных сайтах, вы должны всегда выбирать ближайший сайт для доступа. Адрес службы подписки ближайшего сайта для доступа.

Код находится по адресу: src/main/java/com/example/demo/SubscriptionService.java

5. SubscriptionService: stopSubscription()

Этот метод можно вызвать, чтобы отменить уже оформленный продукт подписки. Подписка остаётся действительной в течение срока действия, а последующие продления будут прекращены.

URL-адрес: {rootUrl}/sub/applications/{apiVersion}/purchases/stop. У rootUrl разные URL-адреса на разных сайтах, всегда следует выбирать адрес службы подписки ближайшего доступного сайта.

Код находится по адресу: src/main/java/com/example/demo/SubscriptionService.java

6. SubscriptionService: delaySubscription()

Этим методом можно воспользоваться, чтобы продлить подписку клиента до указанного времени в будущем. После успешного выполнения срок действия подписки клиента истечёт в будущем.

URL-адрес: {rootUrl}/sub/applications/{apiVersion}/purchases/delay. У rootUrl разные URL-адреса на разных сайтах, всегда следует выбирать адрес службы подписки ближайшего доступного сайта.

Код находится по адресу: src/main/java/com/example/demo/SubscriptionService.java

7. SubscriptionService: returnFeeSubscription()

С помощью этого метода можно вернуть последнюю плату за продление подписки на продукт, но сам продукт остаётся действительным в течение срока его действия, и последующие продления будут выполняться в обычном режиме.

URL-адрес: {rootUrl}/sub/applications/{apiVersion}/purchases/returnFee. У rootUrl разные URL-адреса на разных сайтах, всегда следует выбирать адрес службы подписки ближайшего доступного сайта.

Код находится по адресу: src/main/java/com/example/demo/SubscriptionService.java

8. SubscriptionService: withdrawSubscription()

Можно вызвать этот метод, чтобы отменить подписку, что эквивалентно выполнению метода returnFeeSubscription, и немедленно завершить обслуживание подписки и последующее продление.

URL-адрес: {rootUrl}/sub/applications/{apiVersion}/purchases/withdrawal. У rootUrl разные URL-адреса на разных сайтах, всегда следует выбирать адрес службы подписки ближайшего доступного сайта.

Код находится по адресу: src/main/java/com/example/demo/SubscriptionService.java

9. AppServer: dealNotification()

Метод можно использовать для обработки уведомлений о событиях подписки.

Параметр information получен из уведомления о событии подписки.

Код находится по адресу: src/main/java/com/example/demo/notification/AppServer.java

10. OrderService: confirmPurchase()

Этот метод позволяет подтвердить покупку после отправки продукта.

URL-адрес: {rootUrl}/applications/{apiVersion}/purchases/confirm. У rootUrl разные URL-адреса на разных сайтах, всегда следует выбирать адрес службы заказа ближайшего доступного сайта.

Код находится по адресу: OrderService.java

Лицензия

IAP Java sample лицензирован под Apache License, Version 2.0.