Partilhar via

Classes básicas de dispositivo POS para .NET (documentação do SDK do POS para .NET v1.14)

Cada dispositivo de hardware no POS para .NET é representado por uma interface abstrata, como CashDrawer classe, e uma classe Basic , como CashDrawerBasic. As classes básicas derivam da interface subjacente e contêm suporte funcional básico para o dispositivo. O POS para .NET fornece suporte genérico para abrir, reivindicar e habilitar o dispositivo, estatísticas do dispositivo e para gerenciar a entrega de eventos para o aplicativo. Além disso, cada classe Basic contém um conjunto de métodos herdados e protegidos que podem ser implementados pelo Service Object. Este tópico fornece informações resumidas sobre classes Basic que podem ser usadas por Service Objects que derivam da classe Basic do dispositivo, em vez de aproveitar a classe Base de dispositivo mais totalmente implementada.

Construtor

Cada classe Basic inclui um construtor que cria uma instância da classe e inicializa estatísticas para a versão UPOS, a categoria de dispositivo e a data de instalação.

Propriedades e métodos comuns

Cada classe Basic fornece propriedades substituídas PosCommon e definições de método. Para cada uma dessas propriedades e métodos, a classe Basic manipula a validação de estado, ou seja, a verificação de que o aplicativo abriu, reivindicou ou habilitou o dispositivo, e, em seguida, chama a implementação do PDV para .NET dessa propriedade ou método. Para obter mais informações sobre a classe PosCommon , consulte PosCommon.

O Service Object pode usar a classe CommonProperties para atualizar as propriedades PosCommon que são designadas somente leitura para o aplicativo ou para atualizar essas propriedades sem se preocupar com a validação de estado.

Métodos de eliminação

Cada classe Basic inclui dois métodos Dispose implementados para uso pelo Service Object. Para obter informações sobre como eles funcionam, consulte a documentação do .NET Framework para a classe IDisposable .

Abertura, reivindicação e ativação de dispositivos

Cada classe Basic fornece a funcionalidade principal para abrir, reivindicar e habilitar dispositivos. Normalmente, porém, os objetos de serviço desejam substituir esses métodos para adicionar seu próprio processamento personalizado.

Métodos e eventos protegidos para desenvolvedores de objetos de serviço

Cada classe Basic contém um grupo de métodos e eventos para o desenvolvedor Service Object.

As seguintes propriedades protegidas são definidas da seguinte forma:

  • CommonProperties propriedade, que retorna uma instância de CommonProperties com get e set valores para todas as propriedades PosCommon . O objeto de serviço pode usar CommonProperties para atualizar propriedades sem se preocupar com a validação de estado ou se a propriedade é designada somente leitura para o aplicativo.
  • Propriedade ExternallyClaimed , que Service Objects pode recuperar para determinar se outra instância do dispositivo foi reivindicada (nesse caso, a propriedade é definida como true).
  • Propriedade ErrorCount . Quando o Service Object consulta o valor de ErrorCount, a classe basic verifica a fila de eventos e contabiliza o número de eventos ErrorEvent encontrados e, em seguida, retorna essa contagem como o valor de ErrorCount.
  • DataCount propriedade. O PDV para .NET verifica se o dispositivo foi aberto e, em seguida, retorna o número de eventos DataEvent atualmente enfileirados para o dispositivo.

São definidos os seguintes métodos protegidos:

  • StateChangedEvent e delegado StateChangedEventHandler (classe EventArgs ). O objeto de serviço pode implementá-los para receber notificação quando a propriedade State do dispositivo for alterada.
  • Métodos protegidos por PreFireEvent para cada tipo de evento suportado pelo dispositivo. Cada classe básica fornece uma implementação padrão e genérica de PreFireEvent que retorna imediatamente. Se o Objeto de Serviço precisar atualizar seu estado interno antes de um evento ser enviado para o aplicativo, o Objeto de Serviço poderá substituir a implementação padrão de PreFireEvent e fornecer sua própria implementação para o tipo de evento em questão.
  • Métodos protegidos por QueueEvent para cada tipo de evento suportado pelo dispositivo. O Service Object chama QueueEvent para adicionar um evento à fila de eventos. A classe Basic verifica se o dispositivo está habilitado e, em seguida, adiciona o evento à fila de eventos a ser entregue ao aplicativo. Imediatamente antes da entrega, a classe Basic chama o PreFireEvent apropriado para dar ao Service Object uma oportunidade de atualizar seu estado interno. Quando PreFireEvent retorna, a classe Basic entrega o evento ao aplicativo.
  • Métodos protegidos QueueEventAndWait . O objeto de serviço chama QueueEventAndWait para adicionar um evento ErrorEvent ou um evento DirectIOEvent à fila de eventos, a partir da qual o objeto de serviço espera uma resposta do aplicativo. A classe Basic verifica se o dispositivo está habilitado e, em seguida, adiciona o evento à fila de eventos, para ser entregue ao aplicativo quando as condições estiverem corretas. Imediatamente antes da entrega, a classe Basic chama PreFireEvent para dar ao Service Object uma oportunidade de atualizar seu estado interno. Quando PreFireEvent retorna, a classe Basic entrega o evento ao aplicativo.
  • O método VerifyState , que usa dois valores booleanos, mustBeClaim e mustBeEnabled. O objeto de serviço pode chamar a implementação POS para .NET desse método para executar a validação de estado necessária para o dispositivo, antes de uma chamada de método ou propriedade.
  • Método CreateStatistic . O objeto de serviço deve usar esses métodos para criar estatísticas personalizadas (ou seja, específicas do fabricante). O POS para .NET lida com a criação e o gerenciamento de todas as estatísticas definidas pela UPOS.
  • Os métodos SetStatisticValue e IncrementStatistic permitem que o Service Object atualize uma estatística especificada mesmo que ela não seja definida como resettable (ou seja, esses métodos ignoram as regras impostas pelos métodos PosCommonResetStatistic(String) and UpdateStatistic(String, Object) ).
  • SetStatisticHandlers(String, GetStatistic, SetStatistic) , que permite que os Service Objects forneçam funções externas de retorno de chamada para a recuperação e configuração de estatísticas baseadas em hardware. Se uma propriedade get não estiver definida, a classe Basic assumirá que a estatística é baseada em software e seu valor é mantido no arquivo XML de estatísticas. Se as propriedades get e set forem definidas, a classe Basic chamará essas funções sempre que a estatística precisar ser atualizada ou redefinida. Cabe ao objeto de serviço fornecer código para atualizar a estatística no hardware.
  • Método ClearInput . O POS para .NET limpa as filas de eventos para o dispositivo e, em seguida, chama a implementação do objeto de serviço de ClearInputImpl.
  • Método ClearInputImpl . O objeto de serviço deve implementar esse método para limpar quaisquer buffers de hardware para o dispositivo.

Consulte Também

Outros Recursos

  • Last updated on