Package ru.bitel.bgbilling.modules.mobimoney.common.service

# Interface MobiService

public interface MobiService

- ## Method Summary

  Modifier and Type
  Method
  Description
  `int`
  `checkContract(String contract)`
  Метод проверяет наличие указанного договора в БД.
  `boolean`
  `checkPayment(int contractId, String mobiPaymentId)`
  Метод проверяет наличие у указанного договора платежа в указанный момент времени.
  `void`
  `checkStatus(Transaction transaction)`
  Метод, принудительно проверяющий статус указанной транзакции.
  `void`
  `deleteServiceCode(List<Integer> ids)`
  Удаление кодов операторов
  `List<MobiServiceCode>`
  `getServiceCodeList()`
  Список сервисных кодов операторов
  `Transaction`
  `getTransaction(String mobiPaymentId)`
  Получение одной единственной транзакции.
  `SearchResult<Transaction>`
  `searchTransactions(int contractId, String contractTitle, String status, PeriodWithTime period, String[] sort, Page page)`
  Универсальный метод получения списка транзакций.
  `int`
  `updateServiceCode(MobiServiceCode mobiServiceCode)`
  Добавление/изменение кода оператора
  `void`
  `updateTransaction(Transaction transaction)`
  Метод, добавляющий/обновляющий транзакцию.

- ## Method Details

  - ### searchTransactions

    SearchResult<Transaction> searchTransactions(int contractId, String contractTitle, String status, PeriodWithTime period, String[] sort, Page page) throws Exception
    Универсальный метод получения списка транзакций. Используется как в клиентской части, так и в web.
    Parameters:
      `contractId` - код договора
      `contractTitle` - название договора. если нет необходимости использовать, то подставлять null
      `status` - статус транзакции
      `period` - период за которые показывать транзакции
      `sort` -
      `page` -
    Returns:

  - ### getTransaction

    Transaction getTransaction(String mobiPaymentId) throws Exception
    Получение одной единственной транзакции. Используется на серверной стороне, когда приходят запросы на обновление статуса и/или даты платежа.
    Parameters:
      `transactionId` - код транзакции на стороне сервера
    Returns:
      транзакция

  - ### updateTransaction

    void updateTransaction(Transaction transaction) throws Exception
    Метод, добавляющий/обновляющий транзакцию. В случае, если у транзакции отсутствует идентификатор, то происходит добавление новой транзакции в БД, иначе в БД происходит обновление полей транзакции.
    Parameters:
      `transaction` - добавляемая/обновляемая транзакция

  - ### checkStatus

    void checkStatus(Transaction transaction) throws Exception
    Метод, принудительно проверяющий статус указанной транзакции. Происходит обращение к сервису и в случае, если статус изменился, то меняется статус в БД.
    Parameters:
      `transaction` -

  - ### checkContract

    int checkContract(String contract) throws Exception
    Метод проверяет наличие указанного договора в БД. Используется в методе PaymentContract веб-сервиса `MobiMoneyWSImpl`.
    Parameters:
      `contract` -

  - ### checkPayment

    boolean checkPayment(int contractId, String mobiPaymentId) throws Exception
    Метод проверяет наличие у указанного договора платежа в указанный момент времени. Используется в методе PaymentContract веб-сервиса `MobiMoneyWSImpl`
    Parameters:
      `contractId` - код договора
      `mobiPaymentId` - код транзакции
    Returns:
      если транзакция уже есть в БД, то возвращается она, иначе пустая транзакция

  - ### getServiceCodeList

    List<MobiServiceCode> getServiceCodeList() throws Exception
    Список сервисных кодов операторов

  - ### updateServiceCode

    int updateServiceCode(MobiServiceCode mobiServiceCode) throws Exception
    Добавление/изменение кода оператора
    Parameters:
      `mobiServiceCode` -

  - ### deleteServiceCode

    void deleteServiceCode(List<Integer> ids) throws Exception
    Удаление кодов операторов
    Parameters:
      `ids` - код(ы) удаляемых записей