Udostępnij przez

Podstawowe klasy punktów zakupu dla urządzeń platformy .NET (poS dla zestawu SDK platformy .NET w wersji 1.14)

Każde urządzenie sprzętowe w usłudze POS dla platformy .NET jest reprezentowane zarówno przez abstrakcyjny interfejs, jak klasa, jak i klasę Podstawową, taką jak CashDrawer CashDrawerBasic. Klasy podstawowe pochodzą z podstawowego interfejsu i zawierają podstawową obsługę funkcjonalną dla urządzenia. Usługa POS dla platformy .NET zapewnia ogólną obsługę otwierania, oświadczeń i włączania urządzenia, statystyk urządzeń oraz zarządzania dostarczaniem zdarzeń do aplikacji. Ponadto każda klasa Podstawowa zawiera zestaw odziedziczonych i chronionych metod, które mogą być implementowane przez obiekt usługi. Ten temat zawiera podsumowanie informacji o klasach Podstawowych, które mogą być używane przez obiekty usługi pochodzące z klasy Podstawowa urządzenia, zamiast korzystać z bardziej w pełni zaimplementowanej klasy bazowej urządzenia.

Konstruktor

Każda klasa Podstawowa zawiera konstruktor, który tworzy wystąpienie klasy i inicjuje statystyki dotyczące wersji systemu UPOS, kategorii urządzenia i daty instalacji.

Typowe właściwości i metody

Każda klasa Podstawowa udostępnia zastąpione PosCommon właściwości i definicje metod. Dla każdej z tych właściwości i metod klasa Podstawowa obsługuje walidację stanu — czyli weryfikację, czy aplikacja otworzyła, twierdziła lub włączyła urządzenie — a następnie wywołuje poS dla implementacji tej właściwości lub metody platformy .NET. Aby uzyskać więcej informacji na temat klasy PosCommon , zobacz PosCommon.

Obiekt usługi może użyć klasy CommonProperties , aby zaktualizować właściwości PosCommon wyznaczone tylko do odczytu dla aplikacji lub zaktualizować te właściwości bez martwienia się o walidację stanu.

Metody Dispose

Każda klasa Podstawowa zawiera dwie zaimplementowane metody Dispose do użycia przez obiekt usługi. Aby uzyskać informacje na temat sposobu działania tych elementów, zobacz dokumentację programu .NET Framework dla klasy IDisposable .

Otwieranie, oświadczenia i włączanie urządzeń

Każda klasa Podstawowa zapewnia podstawowe funkcje otwierania, oświadczeń i włączania urządzeń. Zazwyczaj jednak obiekty usługi chcą zastąpić te metody, aby dodać własne niestandardowe przetwarzanie.

Chronione metody i zdarzenia dla deweloperów obiektów usługi

Każda klasa Podstawowa zawiera grupę metod i zdarzeń dla dewelopera obiektu usługi.

Następujące chronione właściwości są definiowane w następujący sposób:

  • Właściwość CommonProperties , która zwraca wystąpienie właściwości CommonProperties z właściwościami get i ustawia wartości dla wszystkich właściwości PosCommon . Obiekt usługi może używać właściwości CommonProperties do aktualizowania właściwości bez martwienia się o walidację stanu lub czy właściwość jest wyznaczona tylko do odczytu dla aplikacji.
  • Właściwość ExternallyClaimed , którą obiekty usługi mogą pobrać, aby określić, czy zostało zgłoszone inne wystąpienie urządzenia (w tym przypadku właściwość jest ustawiona na wartość true).
  • Właściwość ErrorCount . Gdy obiekt usługi wykonuje zapytanie o wartość ErrorCount, klasa podstawowa sprawdza kolejkę zdarzeń i określa liczbę znalezionych zdarzeń ErrorEvent , a następnie zwraca ten wynik jako wartość ErrorCount.
  • Właściwość DataCount . Usługa POS dla platformy .NET sprawdza, czy urządzenie zostało otwarte, a następnie zwraca liczbę zdarzeń DataEvent aktualnie w kolejce dla urządzenia.

Zdefiniowano następujące metody chronione:

  • StateChangedEvent i delegate StateChangedEventHandler (klasa EventArgs ). Obiekt usługi może zaimplementować te elementy, aby otrzymywać powiadomienia, gdy właściwość State urządzenia uległa zmianie.
  • Metody chronione preFireEvent dla każdego typu zdarzenia obsługiwanego przez urządzenie. Każda klasa podstawowa udostępnia domyślną, ogólną implementację prefireEvent , która zwraca natychmiast. Jeśli obiekt usługi musi zaktualizować swój stan wewnętrzny przed wysłaniem zdarzenia do aplikacji, obiekt usługi może zastąpić domyślną implementację prefireEvent i zapewnić własną implementację dla danego typu zdarzenia.
  • QueueEvent chronione metody dla każdego typu zdarzenia obsługiwanego przez urządzenie. Obiekt usługi wywołuje metodę QueueEvent , aby dodać zdarzenie do kolejki zdarzeń. Klasa Podstawowa sprawdza, czy urządzenie jest włączone, a następnie dodaje zdarzenie do kolejki zdarzeń, która ma zostać dostarczona do aplikacji. Bezpośrednio przed dostarczeniem klasa Podstawowa wywołuje odpowiedni prefireEvent, aby dać obiektowi usługi możliwość zaktualizowania stanu wewnętrznego. Gdy funkcja PreFireEvent zwraca, klasa Basic dostarcza zdarzenie do aplikacji.
  • QueueEventAndWait , metody chronione. Obiekt usługi wywołuje metodę QueueEventAndWait, aby dodać zdarzenie ErrorEvent lub zdarzenie DirectIOEvent do kolejki zdarzeń, z której obiekt usługi oczekuje odpowiedzi z aplikacji. Klasa Podstawowa sprawdza, czy urządzenie jest włączone, a następnie dodaje zdarzenie do kolejki zdarzeń, które ma zostać dostarczone do aplikacji, gdy warunki są poprawne. Bezpośrednio przed dostarczeniem klasa Podstawowa wywołuje metodę PreFireEvent, aby dać obiektowi usługi możliwość zaktualizowania stanu wewnętrznego. Gdy funkcja PreFireEvent zwraca, klasa Basic dostarcza zdarzenie do aplikacji.
  • VerifyState metoda, która przyjmuje dwie wartości logiczne, musiBeClaimed i mustBeEnabled. Obiekt usługi może wywołać usługę POS dla implementacji platformy .NET tej metody w celu przeprowadzenia weryfikacji stanu niezbędnego dla urządzenia przed wywołaniem metody lub właściwości.
  • CreateStatistic , metoda. Obiekt usługi powinien używać tych metod do tworzenia niestandardowych (czyli specyficznych dla producenta) statystyk. Usługa POS dla platformy .NET obsługuje tworzenie i zarządzanie wszystkimi statystykami zdefiniowanymi przez upOS.
  • Metody SetStatisticValue i IncrementStatistic umożliwiają obiektowi usługi aktualizowanie określonej statystyki, nawet jeśli nie jest zdefiniowana jako resettable (czyli te metody pomijają reguły wymuszane przez posCommonResetStatistic(String) i UpdateStatistic(String, Object) metody).
  • SetStatisticHandlers(String, GetStatistic, SetStatistic) metoda, która umożliwia obiektom usługi udostępnianie funkcji wywołania zwrotnego zewnętrznego na potrzeby pobierania i ustawiania statystyk opartych na sprzęcie. Jeśli właściwość get nie jest zdefiniowana, klasa Podstawowa zakłada, że statystyka jest oparta na oprogramowaniu, a jej wartość jest przechowywana w pliku XML statystyk. Jeśli zdefiniowano zarówno właściwości get, jak i set, klasa Podstawowa wywołuje te funkcje za każdym razem, gdy statystyka musi zostać zaktualizowana lub zresetowana. Do obiektu usługi należy podanie kodu w celu zaktualizowania statystyki na sprzęcie.
  • ClearInput , metoda. Usługa POS dla platformy .NET czyści kolejki zdarzeń dla urządzenia, a następnie wywołuje implementację obiektu usługi ClearInputImpl.
  • ClearInputImpl , metoda. Obiekt usługi powinien zaimplementować tę metodę, aby wyczyścić wszystkie bufory sprzętowe dla urządzenia.

Zobacz też

Inne zasoby

  • Last updated on