Compartilhar via

SDK da Proteção de Informações da Microsoft – Observadores do SDK de Arquivos

O SDK de Arquivo contém duas classes de observador. Os membros observadores são virtuais e podem ser substituídos para manipular retornos de chamada de eventos.

Quando uma operação assíncrona é concluída, a OnXxx() função membro correspondente ao resultado é chamada. Exemplos são OnLoadSuccess(), OnLoadFailure()e OnAddEngineSuccess() para mip::FileProfile::Observer.

Esses exemplos demonstram o padrão promise/future, que também é adotado pelos samples do SDK e pode ser estendido para implementar o comportamento de callback desejado.

Implementação do observador de perfil de arquivo

No exemplo a seguir, criamos uma classe derivada ProfileObserver de mip::FileProfile::Observer. As funções de membro foram substituídas para usar o padrão futuro/promessa usado em todos os exemplos.

Observação: os exemplos são implementados parcialmente e não incluem substituições para os mip::FileEngine observadores relacionados.

profile_observer.h

No cabeçalho, definimos ProfileObserver, derivando de mip::FileProfile::Observer e, em seguida, substituímos cada uma das funções de membro.

class ProfileObserver final : public mip::FileProfile::Observer {
public:
ProfileObserver() { }
  void OnLoadSuccess(const std::shared_ptr<mip::FileProfile>& profile, const std::shared_ptr<void>& context) override;
  void OnLoadFailure(const std::exception_ptr& error, const std::shared_ptr<void>& context) override;
  //TODO: Implement mip::FileEngine related observers.
};

profile_observer.cpp

Na própria implementação, definimos uma ação a ser tomada para cada função de membro do observador.

Cada membro aceita dois parâmetros. O primeiro é um ponteiro compartilhado para a classe que estamos manipulando na função. ProfileObserver::OnLoadSuccess esperaria receber um arquivo mip::FileProfile. ProfileObserver::OnAddEngineSuccess esperaria mip::FileEngine.

O segundo é um ponteiro compartilhado para o contexto. Em nossa implementação, o contexto é uma referência a um std::promise, transmitido por referência como std::shared_ptr<void>. A primeira linha da função converte isso em std::promise, que é então armazenado em um objeto chamado promise.

Finalmente, o futuro é preparado pela configuração de promise->set_value() e a transmissão do objeto mip::FileProfile.

#include "profile_observer.h"
#include <future>

//Called when FileProfile is successfully loaded
void ProfileObserver::OnLoadSuccess(const std::shared_ptr<mip::FileProfile>& profile, const std::shared_ptr<void>& context) {
  //cast context to promise
  auto promise = 
  std::static_pointer_cast<std::promise<std::shared_ptr<mip::FileProfile>>>(context);
  //set promise value to profile
  promise->set_value(profile);
}

//Called when FileProfile fails to load
void ProfileObserver::OnLoadFailure(const std::exception_ptr& error, const std::shared_ptr<void>& context) {
  auto promise = std::static_pointer_cast<std::promise<std::shared_ptr<mip::FileProfile>>>(context);
  promise->set_exception(error);
}

//TODO: Implement mip::FileEngine related observers.

Quando instanciamos qualquer classe SDK ou usamos uma função que executa operações assíncronas, passamos a implementação do observador para o construtor de configurações ou a própria função assíncrona. Ao instanciar o mip::FileProfile::Settings objeto, o construtor assume mip::FileProfile::Observer como um dos parâmetros. Este exemplo mostra nosso elemento personalizado ProfileObserver, usado em um construtor mip::FileProfile::Settings.

Implementação do FileHandler Observer

Similar ao observador de perfil, a mip::FileHandler implementa uma classe mip::FileHandler::Observers para tratar notificações de eventos assíncronos durante operações de arquivo. A implementação é semelhante àquela detalhada acima. FileHandlerObserver é parcialmente definido abaixo.

file_handler_observer.h

#include "mip/file/file_handler.h"

class FileHandlerObserver final : public mip::FileHandler::Observer {
public:
  void OnCreateFileHandlerSuccess(
      const std::shared_ptr<mip::FileHandler>& fileHandler,
      const std::shared_ptr<void>& context) override;

  void OnCreateFileHandlerFailure(
      const std::exception_ptr& error,
      const std::shared_ptr<void>& context) override;

  //TODO: override remaining member functions inherited from mip::FileHandler::Observer
};

file_handler_observer.cpp

A amostra de código é apenas das duas primeiras funções, mas as funções restantes usam um padrão semelhante a estas e também para ProfileObserver.

#include "file_handler_observer.h"

void FileHandlerObserver::OnCreateFileHandlerSuccess(const std::shared_ptr<mip::FileHandler>& fileHandler, const std::shared_ptr<void>& context) {
    auto promise = std::static_pointer_cast<std::promise<std::shared_ptr<mip::FileHandler>>>(context);
    promise->set_value(fileHandler);
}

void FileHandlerObserver::OnCreateFileHandlerFailure(const std::exception_ptr& error, const std::shared_ptr<void>& context) {
    auto promise = std::static_pointer_cast<std::promise<std::shared_ptr<mip::FileHandler>>>(context);
    promise->set_exception(error);
}

//TODO: override remaining member functions inherited from mip::FileHandler::Observer
  • Last updated on