SDK da Proteção de Informações da Microsoft - observadores do SDK de política
O SDK de política contém uma classe de observador. Os membros observadores são virtuais e devem ser substituídos para manipular retornos de chamada nas operações assíncronas.
Quando uma operação assíncrona é concluída, a função de membro OnXxx()
correspondente ao resultado é chamada. Os exemplos são OnLoadSuccess()
, OnLoadFailure()
e OnAddEngineSuccess()
para mip::Profile::Observer
.
Os exemplos abaixo demonstram o padrão promessa/futuro, que também é usado pelos exemplos do SDK e pode ser estendido para implementar o comportamento de retorno de chamada desejado.
Implementação do observador de perfil
No exemplo a seguir, criamos uma classe, ProfileObserver
, que é derivada de mip::Profile::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 abaixo são implementados apenas parcialmente e não incluem substituições para os observadores relacionados a mip::ProfileEngine
.
profile_observer.h
No cabeçalho, definimos ProfileObserver
, derivando de mip::Profile::Observer
e, em seguida, substituímos cada uma das funções de membro.
class ProfileObserver final : public mip::Profile::Observer {
public:
ProfileObserver() { }
void OnLoadSuccess(const std::shared_ptr<mip::Profile>& profile, const std::shared_ptr<void>& context) override;
void OnLoadFailure(const std::exception_ptr& error, const std::shared_ptr<void>& context) override;
//TODO: Implement remaining members
};
profile_observer.cpp
Na implementação propriamente dita, definimos uma ação a ser tomada para cada função de membro observador.
Cada membro aceita dois parâmetros. O primeiro é um ponteiro compartilhado para a classe manipulada pela função. ProfileObserver::OnLoadSuccess
esperaria receber um arquivo mip::Profile
. ProfileObserver::OnAddEngineSuccess
esperaria mip::ProfileEngine
.
O segundo é um ponteiro compartilhado para o contexto. Em nossa implementação, o contexto é uma referência a um std::promise
, transmitido como shared_ptr<void>
. A primeira linha da função converte isso em std::promise
e, em seguida, armazena em um objeto chamado promise
.
Finalmente, o futuro é preparado pela configuração de promise->set_value()
e a transmissão do objeto mip::Profile
.
#include "profile_observer.h"
#include <future>
//Called when Profile is successfully loaded
void ProfileObserver::OnLoadSuccess(const std::shared_ptr<mip::Profile>& profile, const std::shared_ptr<void>& context) {
//cast context to promise
auto promise = std::static_pointer_cast<std::promise<std::shared_ptr<mip::Profile>>>(context);
//set promise value to profile
promise->set_value(profile);
}
//Called when Profile 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::Profile>>>(context);
promise->set_exception(error);
}
//TODO: Implement remaining observer members
Ao executar uma operação assíncrona, a implementação do observador é transmitida ao construtor de configurações ou à própria função assíncrona.
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de