iap-java-sample

Английский | Китайский

Содержание

• Введение
• Установка
• Требования к окружению
• Настройка
• Пример кода
• Лицензия

Введение

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

AtDemo: Пример кода для AccessToken. Каждый метод может работать независимо. OrderService: Пример кода для OrderService. Каждый метод может работать независимо. SubscriptionService: Пример кода для SubscriptionService. Каждый метод может работать независимо. Notification: Пример кода для уведомлений. Каждый метод может работать независимо.

Установка

Перед использованием примера кода на Java проверьте, установлен ли Java-окружение. Распакуйте пакет с примерами кода на Java.

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

Требования к окружению

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

Настройка

Чтобы использовать функции, предоставленные в примерах, вам потребуется установить соответствующие параметры в файлах AtDemo.java, OrderService.java, SubscriptionService.java и AppServer.java в пакете.Далее приведены описания параметров в файле AtDemo.java. clientId: ID клиента, полученный из информации о приложении. 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()

   Вы можете использовать этот метод для получения уровня приложения Access Token. Код расположен в файле: src/main/java/com/example/demo/AtDemo.java

2. OrderService: verifyToken() Вы можете использовать этот метод для проверки токена покупки после выполнения платежа с помощью сервера платежей Huawei для подтверждения правильности результата платежа. URL: {rootUrl}/applications/purchases/tokens/verify. Адрес rootUrl различается на разных сайтах; всегда выбирайте адрес службы заказов ближайшего сайта для доступа. Код расположен в файле: src/main/java/com/example/demo/OrderService.java3. OrderService: cancelledListPurchase()

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

4. SubscriptionService: getSubscription()

Вы можете использовать этот метод для проверки приобретенного подписочного продукта, чтобы получить срок действия и статус. URL: {rootUrl}/sub/applications/{apiVersion}/purchases/get. Адрес rootUrl различается на разных сайтах; всегда выбирайте адрес службы подписок ближайшего сайта для доступа. Код расположен в файле: src/main/java/com/example/demo/SubscriptionService.java

5. SubscriptionService: stopSubscription()

Вы можете использовать этот метод для отмены уже активированной подписки; подписка остается действительной до истечения срока действия, а последующие продления будут прекращены. URL: {rootUrl}/sub/applications/{apiVersion}/purchases/stop. Адрес rootUrl различается на разных сайтах; всегда выбирайте адрес службы подписок ближайшего сайта для доступа. Код расположен в файле: src/main/java/com/example/demo/SubscriptionService.java6. SubscriptionService: delaySubscription() Можно вызвать этот метод для продления подписки продукта для клиента до указанного времени в будущем. После успешного выполнения срок действия подписки клиента будет истекать в более позднее время. URL: {rootUrl}/sub/applications/{apiVersion}/purchases/delay. Адрес rootUrl различается на разных сайтах, всегда следует выбирать адрес сервиса подписок ближайшего сайта для доступа. Код расположен в: src/main/java/com/example/demo/SubscriptionService.java

7. SubscriptionService: возвратСуммыПодписки() Метод возвращает сумму подписки продукта для клиента. Вы можете вызвать этот метод для возврата последней суммы продления подписки продукта, но сам продукт остается действительным в течение срока действия, а последующие продления будут выполняться нормально. URL: {rootUrl}/sub/applications/{apiVersion}/purchases/returnFee. Адрес rootUrl различается на разных сайтах, вы всегда должны выбирать адрес службы подписок ближайшего сайта для доступа. Код расположен в: src/main/java/com/example/demo/SubscriptionService.java

8. SubscriptionService: отмена_подписки()

   Вы можете вызвать этот метод для отмены подписки, что эквивалентно выполнению метода возврат_суммы_подписки(), и немедленному завершению услуги подписки и последующих продлений. URL: {rootUrl}/sub/applications/{apiVersion}/purchases/withdrawal. Адрес rootUrl различается на разных сайтах, вы всегда должны выбирать адрес службы подписок ближайшего сайта для доступа. Код расположен в: src/main/java/com/example/demo/SubscriptionService.java

9. AppServer: обработка_уведомлений()

   Вы можете вызвать этот метод для обработки уведомлений событий подписки. Информационный параметр получен из уведомления события подписки. Код расположен в: src/main/java/com/example/demo/notification/AppServer.java

10. OrderService: подтверждение_продажи() Вы можете вызвать этот метод для подтверждения покупки после отправки товара. URL: {rootUrl}/applications/{apiVersion}/purchases/confirm. Адрес rootUrl различается на разных сайтах; вы всегда должны выбирать адрес службы заказов ближайшего сайта для доступа. Код расположен в: OrderService.java## Лицензия Пример IAP Java лицензирован под Apache License, Version 2.0.