Sdílet prostřednictvím

POS pro základní třídy zařízení .NET (POS pro .NET v1.14 SDK)

Každé hardwarové zařízení v POS pro .NET je reprezentováno abstraktním rozhraním, například CashDrawer třídou, a základní třídou, například CashDrawerBasic. Základní třídy jsou odvozeny od základního rozhraní a obsahují základní funkční podporu zařízení. POS pro .NET poskytuje obecnou podporu pro otevírání, deklarace identity a povolování zařízení, statistik zařízení a pro správu doručování událostí do aplikace. Kromě toho každá třída Basic obsahuje sadu zděděných a chráněných metod, které lze implementovat Service Object. Toto téma obsahuje souhrnné informace o základních třídách, které mohou být používány objekty služby odvozené ze základní třídy zařízení, místo aby využívaly plně implementované základní třídy zařízení.

Konstruktor

Každá třída Basic obsahuje konstruktor, který vytvoří instanci třídy a inicializuje statistiky pro verzi UPOS, kategorii zařízení a datum instalace.

Běžné vlastnosti a metody

Každá třída Basic poskytuje přepsánou PosCommon vlastnost a definice metody. Pro každou z těchto vlastností a metod třída Basic zpracovává ověření stavu – tj. ověření, že aplikace otevřela, nárokovala nebo povolila zařízení – a potom volá POS pro implementaci této vlastnosti nebo metody .NET. Další informace o PosCommon třídy, viz PosCommon.

Service Object může použít CommonProperties třídy k aktualizaci PosCommon vlastnosti určené jen pro čtení pro aplikaci, nebo aktualizovat tyto vlastnosti bez obav o ověření stavu.

Dispose – metody

Každá třída Basic obsahuje dvě implementované metody Dispose pro použití objektem služby. Informace o tom, jak tyto funkce fungují, naleznete v dokumentaci rozhraní .NET Framework pro třídu IDisposable .

Otevírání, deklarace identity a povolení zařízení

Každá třída Basic poskytuje základní funkce pro otevírání, deklarace identity a povolování zařízení. Objekty služby ale obvykle chtějí tyto metody přepsat a přidat vlastní zpracování.

Chráněné metody a události pro vývojáře objektů služby

Každá třída Basic obsahuje skupinu metod a událostí pro vývojáře objektu služby.

Následující chráněné vlastnosti jsou definovány takto:

  • CommonProperties vlastnost, která vrací instanci CommonProperties s get a set hodnoty pro všechny PosCommon vlastnosti. Objekt služby může použít CommonProperties k aktualizaci vlastností, aniž by se museli starat o ověření stavu nebo zda je vlastnost určena jen pro čtení pro aplikaci.
  • ExterněClaimed vlastnost, které Service Objects může načíst určit, zda byla požadována jiná instance zařízení (v takovém případě je vlastnost nastavena na true).
  • ErrorCount – vlastnost. Když se objekt služby dotazuje na hodnotu ErrorCount, základní třída zkontroluje frontu událostí a načítá počet nalezených událostí ErrorEvent a pak vrátí tuto výšku jako hodnotu ErrorCount.
  • Vlastnost DataCount PoS pro .NET ověří, že zařízení bylo otevřeno, a poté vrátí počet událostí DataEvent , které jsou pro zařízení aktuálně zařazené do fronty.

Jsou definovány následující chráněné metody:

  • StateChangedEvent a delegát StateChangedEventHandler (Třída EventArgs ). Objekt služby může tyto objekty implementovat, aby dostávaly oznámení, když se vlastnost Stav zařízení změnila.
  • Chráněné metody PreFireEvent pro každý typ události podporované zařízením. Každá základní třída poskytuje výchozí obecnou implementaci PreFireEvent , která se vrátí okamžitě. Pokud objekt služby potřebuje aktualizovat svůj vnitřní stav před odesláním události do aplikace, může objekt služby přepsat výchozí implementaci PreFireEvent a poskytnout vlastní implementaci pro daný typ události.
  • Chráněné metody QueueEvent pro každý typ události podporované zařízením. Objekt služby volá QueueEvent pro přidání události do fronty událostí. Třída Basic ověří, že je zařízení povolené, a pak přidá událost do fronty událostí, která se do aplikace doručí. Bezprostředně před doručením třída Basic volá odpovídající PreFireEvent , aby objekt služby příležitost aktualizovat svůj vnitřní stav. Když PreFireEvent vrátí, třída Basic doručí událost do aplikace.
  • FrontAEventAndWait chráněné metody. Objekt služby volá QueueEventAndWait přidat událost ErrorEvent nebo DirectIOEvent událost do fronty událostí, ze které objekt služby očekává odpověď z aplikace. Třída Basic ověřuje, zda je zařízení povolené, a potom přidá událost do fronty událostí, která se má doručovat do aplikace, pokud jsou podmínky správné. Bezprostředně před doručením volá třída Basic PreFireEvent, aby objekt služby příležitost aktualizovat svůj vnitřní stav. Když PreFireEvent vrátí, třída Basic doručí událost do aplikace.
  • Metoda VerifyState , která přebírá dvě logické hodnoty, mustBeClaimed a mustBeEnabled. Objekt služby může volat POS pro implementaci .NET této metody k provedení nezbytného ověření stavu pro zařízení před voláním metody nebo vlastnosti.
  • CreateStatistic – metoda Objekt služby by měl tyto metody použít k vytvoření vlastní statistiky (tj. specifické pro výrobce). POS pro .NET zpracovává vytváření a správu všech statistik definovaných systémem UPOS.
  • Metody SetStatisticValue a IncrementStatistic umožňují objektu služby aktualizovat zadanou statistiku, i když není definována jako resetovatelná (to znamená, že tyto metody obcházejí pravidla vynucená metodami PosCommonResetStatistic(String) a UpdateStatistic(String, Object) metodami).
  • SetStatisticHandlers(String, GetStatistic, SetStatistic) metoda, která umožňuje objektům služby poskytovat externí funkce zpětného volání pro načítání a nastavení hardwarových statistik. Pokud není definována vlastnost get, třída Basic předpokládá, že statistika je softwarově založená a její hodnota je zachována v souboru XML statistiky. Pokud jsou definovány vlastnosti get i set, třída Basic volá tyto funkce vždy, když je potřeba statistiku aktualizovat nebo resetovat. Je na objektu služby, který poskytuje kód pro aktualizaci statistiky v hardwaru.
  • ClearInput – metoda. POS pro .NET vymaže fronty událostí pro zařízení a pak zavolá implementaci objektu služby ClearInputImpl.
  • ClearInputImpl – metoda. Objekt služby by měl implementovat tuto metodu pro vymazání všech hardwarových vyrovnávacích pamětí zařízení.

Viz také

Další prostředky

  • Last updated on