Archivio di istanze
Le informazioni contenute in questo argomento sono valide per Windows Workflow Foundation 4.
Un archivio di istanze è un contenitore logico di istanze, ovvero lo spazio in cui vengono archiviati i dati e i metadati dell'istanza. Un archivio di istanze non implica l'archiviazione fisica dedicata e può contenere informazioni durevoli in un database di SQL Server o informazioni sullo stato non durevoli in una memoria. In .NET Framework versione 4 è disponibile l'archivio di istanze del flusso di lavoro SQL, vale a dire un'implementazione concreta di un archivio di istanze che consente ai flussi di lavoro di rendere persistenti i dati e i metadati dell'istanza in un database di SQL Server 2005 o di SQL Server 2008.
L'API di persistenza è l'interfaccia tra un host e un archivio di istanze che consente all'host di inviare richieste di comando (ad esempio LoadWorkflowCommand e SaveWorkflowCommand) all'archivio di istanze. L'implementazione concreta di questa API viene definita provider di persistenza. Il provider di persistenza riceve richieste da un host e modifica l'archivio di istanze.
Gli host e gli archivi di istanze sono modulari in modo che un host possa essere utilizzato con molti archivi di istanze e un archivio di istanze possa essere utilizzato con molti host. Un archivio di istanze viene ottimizzato in genere per i modelli di utilizzo di un particolare host, anche se l'archivio di istanze e l'host possono evolvere in cicli di vita indipendenti. Ad esempio quando si progettano gli oggetti WorkflowServiceHost e SqlWorkflowInstanceStore viene posta la massima attenzione affinché funzionino bene insieme. È possibile creare un proprio archivio di istanze per rendere persistenti i dati e i metadati di istanze di servizio flusso di lavoro e utilizzare tale archivio di istanze con l'oggetto WorkflowServiceHost. È possibile creare ad esempio un oggetto OracleWorkflowInstanceStore che consenta ai flussi di lavoro di rendere persistenti le informazioni in un database Oracle anziché salvarle in un database di SQL Server.
In genere gli host possono essere estesi con funzionalità aggiuntiva che modifica gli oggetti persistenti. Ad esempio un sistema di persistenza delle istanze può disporre di un host del flusso di lavoro, un'estensione che supporta l'operazione "Suspend" e un archivio di istanze SQL. L'host del flusso di lavoro potrebbe inviare un comando standard quale Salva o Carica per salvare o caricare un flusso di lavoro da un archivio di istanze o per salvare un flusso di lavoro in un archivio di istanze. L'estensione di sospensione potrebbe aggiungere ulteriore semantica ai comandi per il salvataggio e il caricamento di istanze del flusso di lavoro in modo che un'istanza del flusso di lavoro sospesa non possa essere caricata. Il provider di persistenza per l'archivio di istanze SQL riconosce i comandi per il salvataggio e il caricamento di istanze del flusso di lavoro e li implementa chiamando stored procedure appropriate che modificano le tabelle degli oggetti persistenti in un database di SQL Server.
Un host funge da proprietario di istanza all'interno di un archivio di istanze e può operare come più proprietari di istanza con più archivi di istanze contemporaneamente. L'host fornisce i GUID per chiavi di istanza associate alle istanze. Una chiave di istanza è un alias non univoco che identifica un'istanza. Il sistema di persistenza crea, aggiorna ed elimina le informazioni del proprietario di istanza quando esegue i comandi richiesti dagli host.
Nell'elenco seguente sono indicati i passaggi importanti relativi all'interazione dell'host con l'archivio di istanze:
Ottenere un oggetto InstanceStore da un provider di persistenza.
Ottenere l'handle per un'istanza chiamando il metodo CreateInstanceHandle sull'oggetto InstanceStore.
Richiamare i comandi sull'handle di istanza chiamando il metodo Execute sull'oggetto InstanceStore.
Esaminare l'oggetto InstanceView restituito da InstanceStore.Execute per determinare i risultati dei comandi.