Componenti chiave dell'SDK dell'adapter LOB WCF

Articolo
10/14/2023

Lo sviluppo di una scheda tramite WCF LOB Adapter SDK richiede l'uso di molti dei componenti di base seguenti:

Componenti di connessione per stabilire e mantenere una connessione al sistema line-of-business.
I componenti del gestore definiscono e implementano le procedure usate per lavorare con messaggi in ingresso e in uscita e operazioni di metadati.
I componenti dei metadati definiscono e modificano i metadati usati per comunicare con il sistema line-of-business.
I componenti personalizzati forniscono supporto per transazioni, messaggistica affidabile e sicurezza.
I componenti di base unisce tutti i componenti e garantiscono un'integrazione semplice in WCF.

Questi componenti sono l'obiettivo di questo argomento.

Componenti di connessione

I componenti di connessione includono interfacce e classi che consentono di definire e controllare la durata delle connessioni, nonché gestire attributi di query e attributi utente (Uniform Resource Identifiers). I componenti di connessione includono le interfacce e le classi descritte nella tabella seguente.

Componente connessione	Necessaria?	Descrizione
`Microsoft.ServiceModel.Channels.Common.ConnectionUri`	Obbligatoria	Classe di base per fornire un'esperienza di compilazione URI personalizzata per gli utenti che utilizzeranno la scheda.
`Microsoft.ServiceModel.Channels.Common.IConnection`	Necessario	Interfaccia che definisce il comportamento per una connessione. Gli sviluppatori devono implementare questa interfaccia per definire una connessione al sistema di destinazione.
`Microsoft.ServiceModel.Channels.Common.IConnectionFactory`	Necessario	Classe di base per una factory di connessione. Gli sviluppatori subclasseranno quando si definisce la factory di connessione per il sistema di destinazione.
`Microsoft.ServiceModel.Channels.Common.ConnectionPoolSettings`	Facoltativo	Contiene le impostazioni che controllano il comportamento del pool di connessioni. Gli sviluppatori possono voler ottimizzare questi valori in base al comportamento del sistema di destinazione.
`Microsoft.ServiceModel.Channels.Common.ConnectionManagerSettings`	Facoltativo	Contiene impostazioni statiche che controllano il comportamento del pool di connessioni. Gli sviluppatori possono voler ottimizzare questi valori per il sistema di destinazione.

La creazione guidata dello sviluppo dell'adapter LOB WCF creerà implementazioni di Microsoft.ServiceModel.Channels.Common.IConnection``Microsoft.ServiceModel.Channels.Common.ConnectionUri e Microsoft.ServiceModel.Channels.Common.IConnectionFactory indipendentemente dalle opzioni della procedura guidata scelta. Queste implementazioni contengono codice per le opzioni di supporto scelte nella procedura guidata (incluse le proprietà di connessione nell'URI di connessione), ma lo sviluppatore della scheda dovrà fornire implementazioni per Open, Close e altri metodi di Microsoft.ServiceModel.Channels.Common.IConnection e Microsoft.ServiceModel.Channels.Common.ConnectionUri.

Componenti del gestore

I componenti del gestore forniscono supporto per diversi modelli di scambio di messaggi, tra cui operazioni in ingresso, in uscita, asincrone in ingresso, in uscita asincrone e di ricerca dei metadati, esplorazione e risoluzione. I componenti del gestore includono le interfacce e le classi descritte nella tabella seguente.

Componente gestore	Necessaria?	Descrizione
`Microsoft.ServiceModel.Channels.Common.IAsyncInboundHandler`	Facoltativo	Usato per ricevere messaggi in modo asincrono dal sistema di destinazione. Il supporto asincrono è facoltativo.
`Microsoft.ServiceModel.Channels.Common.IAsyncOutboundHandler`	Facoltativo	Usato per inviare messaggi in modo asincrono dal sistema di destinazione. Il supporto asincrono è facoltativo.
`Microsoft.ServiceModel.Channels.Common.IInboundHandler`	Facoltativo	Usato per ricevere messaggi dal sistema di destinazione. Gli sviluppatori devono implementare questo gestore se l'adapter deve ascoltare i messaggi dal sistema di destinazione.
`Microsoft.ServiceModel.Channels.Common.IOutboundHandler`	Facoltativo	Fornisce il supporto per l'invio di messaggi al sistema di destinazione. Anche se facoltativo, è necessario per il modello di messaggio di risposta alla richiesta. La maggior parte delle tecnologie di comunicazione fondamentali si basa su questo modello, tra cui HTTP, RPC e molti altri.
`Microsoft.ServiceModel.Channels.Common.IMetadataBrowseHandler`	Facoltativo	Questo gestore viene implementato quando l'adapter supporta l'esplorazione dei metadati. Anche se facoltativo, gli sviluppatori implementeranno spesso questo gestore per fornire un elenco di operazioni disponibili nel sistema di destinazione.
`Microsoft.ServiceModel.Channels.Common.IMetadataResolverHandler`	Facoltativo	Questo gestore deve essere implementato quando l'adapter recupera e restituisce metadati dal sistema di destinazione che rappresenta la logica e i tipi di dati specifici del sistema. I metadati possono essere recuperati dal sistema di destinazione effettivo oppure possono essere creati per rappresentare le funzionalità del sistema di destinazione. Ad esempio, un adattatore FTP potrebbe creare operazioni GET e PUT. Anche se non richiesto, gli sviluppatori implementeranno in genere questo gestore per fornire informazioni su un'operazione specifica.
`Microsoft.ServiceModel.Channels.Common.IMetadataSearchHandler`	Facoltativo	Questo gestore viene implementato quando l'adapter supporta la ricerca dei metadati.

La Creazione guidata sviluppo adapter creerà implementazioni di Microsoft.ServiceModel.Channels.Common.IAsyncOutboundHandler, Microsoft.ServiceModel.Channels.Common.IOutboundHandlerMicrosoft.ServiceModel.Channels.Common.IInboundHandler e i gestori di metadati in base alle scelte effettuate dallo sviluppatore. Viene fornito il codice di supporto; tuttavia, lo sviluppatore dell'adapter dovrà fornire codice per avviare e arrestare il listener in ingresso e altro codice contrassegnato dai commenti TODO.

Componenti dei metadati

I componenti dei metadati forniscono supporto per la gestione delle richieste di metadati e per la descrizione di tipi e operazioni nell'applicazione di destinazione. I componenti del gestore controllano la modalità di gestione delle richieste di metadati. I componenti dei metadati descrivono i tipi di dati e le operazioni esposte dal sistema di destinazione.

I componenti dei metadati sono progettati per contenere due tipi di informazioni sui metadati: metadati dei tipi e metadati dell'operazione.

I metadati dei tipi di tipo descrivono i tipi di dati disponibili nel sistema di destinazione e includono il nome del tipo, le proprietà della matrice, se è una matrice e se è un tipo di schema XSD semplice o un tipo complesso.
I metadati dell'operazione descrivono le operazioni disponibili nel sistema di destinazione. Le proprietà includono un tipo restituito, un elenco di parametri e il nome dell'operazione.

Il supporto dei metadati all'interno di una scheda è facoltativo, ma consigliato. Uno dei vantaggi dell'uso di WCF LOB Adapter SDK per creare un adattatore rispetto all'implementazione di funzionalità come servizio WCF è la possibilità di esporre e associare a un set di operazioni dinamico.

Nota

Se è necessario esporre un set limitato di metodi statici, è consigliabile usare WCF.

I componenti disponibili per la gestione, la descrizione e l'uso dei metadati sono descritti nella tabella seguente.

Componente metadati	Descrizione
`Microsoft.ServiceModel.Channels.Common.ComplexQualifiedType`	Classe che rappresenta un tipo qualificato complesso per un adattatore. Ad esempio, se il sistema di destinazione è un database relazionale, una tabella, una riga o un tipo restituito di routine definito dall'utente potrebbero essere tutti tipi qualificati personalizzati.
`Microsoft.ServiceModel.Channels.Common.OperationMetadata`	Classe di base per rappresentare i metadati dell'operazione per il sistema di destinazione. Ad esempio, è possibile sottoclasse OperationMetadata per contenere informazioni sulle stored procedure in un adapter destinato a un database relazionale.
`Microsoft.ServiceModel.Channels.Common.OperationMetadataTraceRecord`	Fornisce un modo per acquisire i metadati dell'operazione in un file di traccia. La traccia raccoglie informazioni come ID univoco, l'ultima volta a cui è stato eseguito l'accesso, il timestamp, il nome visualizzato, il nome originale, i parametri e altri dettagli.
`Microsoft.ServiceModel.Channels.Common.ParameterizedOperationMetadata`	Fornisce un modo per definire gli attributi di un'operazione, ad esempio parametri e tipo restituito.
`Microsoft.ServiceModel.Channels.Common.OperationParameter`	Descrive un parametro usato per richiamare un'operazione nel sistema di destinazione. Le proprietà includono il nome, il nome originale, la direzione del parametro e un flag che indica se il parametro è vuoto o meno.
`Microsoft.ServiceModel.Channels.Common.OperationParameterDirection`	Tipo enumerato che descrive la direzione di un parametro per un'operazione. Un parametro può essere in ingresso (In), solo in uscita (Out) o bidirezionale (InOut).
`Microsoft.ServiceModel.Channels.Common.OperationResult`	Rappresenta un risultato dell'operazione. Può essere OperationResult.Empty per le operazioni che restituiscono void o null e un valore stringa, integer o altro valore a seconda dell'operazione.
`Microsoft.ServiceModel.Channels.Common.QualifiedType`	Progettato per essere la classe di base per le proprietà del tipo qualificato e viene usato per descrivere le proprietà dei metadati dei tipi per un sistema di destinazione.
`Microsoft.ServiceModel.Channels.Common.QualifiedTypeContainer`	Fornisce un contenitore per un set di tipi qualificati correlati.
`Microsoft.ServiceModel.Channels.Common.SimpleQualifiedType`	Descrive le proprietà dei metadati di tipo per un sistema di destinazione quando tale tipo esegue il mapping direttamente a un tipo di schema XSD W3C. Per un elenco di tipi consentiti, vedere Enumerazione XmlTypeCode.
`Microsoft.ServiceModel.Channels.Common.TypeMember`	Fornisce un modo per definire un membro dati semplice o complesso nei metadati del tipo strutturato.
`Microsoft.ServiceModel.Channels.Common.TypeMetadata`	Classe di base per rappresentare i metadati dei tipi per il sistema di destinazione.
`Microsoft.ServiceModel.Channels.Common.StructuredTypeMetadata`	Fornisce un modo per definire una struttura di dati che contiene membri di tipo complessi e/o semplici.
`Microsoft.ServiceModel.Channels.Common.TypeMetadataCollection`	Fornisce un contenitore per un set di metadati di tipo correlati.
`Microsoft.ServiceModel.Channels.Common.TypeMetadataTraceRecord`	Fornisce un modo per acquisire i metadati dei tipi in un file di traccia. La traccia raccoglie informazioni quali ID univoco, ora dell'ultimo accesso, timestamp e altri dettagli.

Componenti personalizzati

I componenti personalizzati forniscono supporto per transazioni, sicurezza, messaggistica affidabile e altre funzionalità che dipendono dal sistema di destinazione. Gli sviluppatori di adattatori che usano WCF LOB Adapter SDK dovranno comprendere le funzionalità del sistema di destinazione e determinare la misura in cui si vuole supportarli.

Componenti principali

I componenti di base forniscono un set di classi di base e interfacce che consentono di collegare l'adattatore a WCF. I componenti di base sono descritti nella tabella seguente.

Componente principale	Necessaria?	Descrizione
`Microsoft.ServiceModel.Channels.Common.Adapter`	Obbligatoria	Classe di base di un adattatore scritto con WCF LOB Adapter SDK. È responsabile dell'interazione con l'architettura del canale WCF
`Microsoft.ServiceModel.Channels.Common.AdapterBinding`	Necessario	Classe che contiene impostazioni che controllano varie impostazioni per l'adattatore, tra cui il pool di connessioni (), la cache (`Microsoft.ServiceModel.Channels.Common.ConnectionPoolSettingsMicrosoft.ServiceModel.Channels.Common.CacheSettings`), i metadati (`Microsoft.ServiceModel.Channels.Common.MetadataSettings`) e la messaggistica (`Microsoft.ServiceModel.Channels.Common.MessagingSettings`).

Le schede personalizzate vengono esposte tramite associazioni WCF. Per altre informazioni, vedere la documentazione di WCF all'indirizzo https://go.microsoft.com/fwlink/?LinkId=100308.

La Creazione guidata adapter crea implementazioni di Microsoft.ServiceModel.Channels.Common.Adapter, Microsoft.ServiceModel.Channels.Common.AdapterBinding, System.ServiceModel.Configuration.StandardBindingElemente System.ServiceModel.Configuration.StandardBindingCollectionElement per esporre l'associazione dell'adapter al sistema di configurazione WCF. La Creazione guidata adapter genererà anche un'implementazione di per consentire Microsoft.ServiceModel.Channels.Common.Adapter l'uso all'interno di System.ServiceModel.Configuration.BindingElementExtensionElement un'associazione personalizzata WCF da un computer o da un file di configurazione dell'applicazione.

Per altre informazioni su StandardBindingElement, StandardBindingCollectionElement e BindingElementExtensionElement, vedere la documentazione di WCF.

Per altre informazioni sulla configurazione di un adattatore scritto con WCF LOB Adapter SDK, vedere Distribuire un adattatore tramite WCF LOB Adapter SDK.

Vedere anche

Informazioni sul sistema LOB con WCF LOB Adapter SDK

Condividi tramite