hu.gov.nav.ebt.client.sdk.logic

Interface ClientBackend

All Known Implementing Classes:

ClientBackendImplDb

public interface ClientBackend

Szakmai rendszer értesítése a letöltött üzenet feldolgozásáról

Egy-egy példánya egy adott felhasználó csatornáinak tárhelyéről letöltött üzenetek értesítéseit küldi.

Amennyiben az SDK EbtTransfer.processDownloaded folyamata ugyanazt az üzenetet többször dolgozza el, akkor a szakmai rendszer értesítése is többször fog megtörténni. Példa:

• Ügyfél rossz titkosító tanúsítványt ad meg, ami miatt a letöltött üzenetek feldolgozása nem sikerül, és nem tudja az üzenetet kititkosítani. Az üzenetek mind MessageException hibára futnak, feldolgozott állapotba kerülnek, és a szakmai rendszer processMessageFault metóduson keresztül értesül a hibáról.
• Ügyfél kijavítja a titkosító tanúsítvány beállítást, és SDK EbtTransfer.processDownloaded folyamat érintett, már feldolgozott üzeneteit manuálisan újra feldolgozható állapotba teszi. Ekkor a feldolgozás újra lefut, és az eredménytől függően újra értesíti a szakmai rendszert a feldolgozásról ugyanazzal az üzenet azonosítóval.

Figyelem! A BusinessDataContainer típusú paraméterekben levő DataSource típusú adattagok fájlrendszeren tárolt ideiglenes fájlokra hivatkoznak. A DataSource típus getInputStream() és DataSource típus getOutputStream() metódusával elkért stream példányokat a használat után be kell zárni az IOUtils.closeQuietly() metódussal (célszerűen egy try-finally blokkban), mert különben az SDK nem tudja törölni az ideiglenes fájlokat.

Tranzakció: Mandatory mindegyik metódusra.

Method Summary

Modifier and Type	Method and Description
void	clientBackendTest() Kapcsolati teszt.
void	processBusinessMessage(BusinessDataContainer businessDataContainer) A KKK2-től letöltött szakmai üzenet feldolgozásának jelzése.
void	processMessageFault(BusinessDataContainer businessDataContainer, String messageIDRaw, MessageException messageException) A KKK2-től letöltött és sikertelenül feldolgozott üzenet jelzése.
void	processNAVReceipt(BusinessDataContainer businessDataContainer, SdkConstants.NAV_RECEIPT_TYPE navReceiptType) A KKK2-től letöltött KKK2 nyugtaüzenet (NAVReceipt) feldolgozásának jelzése.
void	processVPAppReceipt(BusinessDataContainer businessDataContainer) A KKK2-től letöltött szakmai nyugtaüzenet (VPAppReceipt) feldolgozásának jelzése.
void	processVPCommunicationTest(BusinessDataContainer businessDataContainer) A KKK2-től letöltött KKK2 kommunikációs tesztüzenet (VPCommunicationTest) feldolgozásának jelzése.
void	processVPFault(BusinessDataContainer businessDataContainer) A KKK2-től letöltött KKK2 hibaüzenet (VPFault) feldolgozásának jelzése.

Method Detail

processVPFault

void processVPFault(BusinessDataContainer businessDataContainer)

A KKK2-től letöltött KKK2 hibaüzenet (VPFault) feldolgozásának jelzése.

A KKK2-től letöltött KKK2 hibaüzenet előzményénének azonosítója a RelatesTo mezőben található.

Teendő az ügyfél oldalon:

• Az előzmény üzenetnél a sikertelen küldés állapotának bejegyzése a szakmai rendszerben.
• Riasztás.

Parameters:

businessDataContainer - Szakmai üzenet konténere

processVPAppReceipt

void processVPAppReceipt(BusinessDataContainer businessDataContainer)

A KKK2-től letöltött szakmai nyugtaüzenet (VPAppReceipt) feldolgozásának jelzése.

Teendő az ügyfél oldalon:

• Naplózás.

Parameters:

businessDataContainer - Szakmai üzenet konténere

processVPCommunicationTest

void processVPCommunicationTest(BusinessDataContainer businessDataContainer)

A KKK2-től letöltött KKK2 kommunikációs tesztüzenet (VPCommunicationTest) feldolgozásának jelzése.

Teendő az ügyfél oldalon:

• Naplózás.

Parameters:

businessDataContainer - Szakmai üzenet konténere

processNAVReceipt

void processNAVReceipt(BusinessDataContainer businessDataContainer,
                       SdkConstants.NAV_RECEIPT_TYPE navReceiptType)

A KKK2-től letöltött KKK2 nyugtaüzenet (NAVReceipt) feldolgozásának jelzése.

Teendő az ügyfél oldalon:

• Az előzmény feltöltött üzenetnél a megfelelő nyugta típus (tértivevény, feladóvevény) megérkezésének bejegyzése a szakmai rendszerben. A feltöltés után a feladóvevényről jön értesítés, majd ha a szakmai rendszerig eljutott az üzenet, akkor tértivevényt küld a szakmai rendszer. Csak akkor sikeres a kézbesítés, ha a tértivevény is megérkezett válaszul a feltöltött üzenetre, ÉS nem érkezett KKK2 hibaüzenet (VPFault) válasz.
• Naplózás.

Parameters:

businessDataContainer - Szakmai üzenet konténere

navReceiptType - Nyugta típusa (tértivevény, feladóvevény)

processBusinessMessage

void processBusinessMessage(BusinessDataContainer businessDataContainer)

A KKK2-től letöltött szakmai üzenet feldolgozásának jelzése.

Teendő az ügyfél oldalon:

• Szakmai üzenet elmentése az ügyfél szakmai rendszerébe.

Parameters:

businessDataContainer - Szakmai üzenet konténere

processMessageFault

void processMessageFault(BusinessDataContainer businessDataContainer,
                         String messageIDRaw,
                         MessageException messageException)

A KKK2-től letöltött és sikertelenül feldolgozott üzenet jelzése.

Ha KKK2-től letöltött sikertelenül feldolgozott üzenetnek volt előzménye, akkor annak azonosítója a RelatesTo mezőben található.

Teendő az ügyfél oldalon:

• Riasztás.

Parameters:

businessDataContainer - Szakmai üzenet konténere (opcionális)

messageIDRaw - Üzenet azonosító

messageException - Üzenet feldolgozása során keletkezett hiba

clientBackendTest

void clientBackendTest()

Kapcsolati teszt.

A teszt ellenőrzi, hogy az adatbázishoz való kapcsolódás sikerül-e.

Throws:

ClientInternalException - Egyéb hiba esetén