Accueil
Contextes d'exécution
Descriptions des services d'exécution Link.
SDK
L'interface de programmation LNK inclut des méthodes et des objets spécifiques au langage qui fournissent des fonctionnalités communes à plusieurs environnements.
API C
L'API C permet aux applications d'appeler des mappes et de développer des adaptateurs à utiliser avec HCL Link.
Adaptateurs personnalisés
L’interface des adaptateurs personnalisés permet aux utilisateurs de développer des adaptateurs avec autant de fonctionnalités que celles fournies avec le produit.
Méthodes fournies par l'adaptateur
Interface source et cible
Les méthodes d’interface source et cible sont appelées pour obtenir des données d’une ressource, pour insérer des données dans une ressource et pour contrôler une transaction tout en développant des adaptateurs personnalisés.
BeginTransaction
La méthode BeginTransaction est appelée pour démarrer explicitement une transaction.

Contextes d'exécution
Descriptions des services d'exécution Link.
- API REST
  L'exécution REST fournit une API REST utilisée pour exécuter les mappes et les flux qui ont été déployés.
- Serveur de commande de flux
  Déployez un flux du Lien HCL vers le système de fichiers local à l'aide de la définition de serveur de flux d'exécution.
- Map Command Server
  Vous devez préparer les mappes pour l'exécution avant d'utiliser Map Command Server pour cette opération.
- SDK
  L'interface de programmation LNK inclut des méthodes et des objets spécifiques au langage qui fournissent des fonctionnalités communes à plusieurs environnements.
  - Présentation de l'interface de programmation Link
    L'interface de programmation Link est une approche orientée objet qui permet aux applications d'appeler des mappes HCL Link, ce qui supprime la dépendance aux lignes de commande.
  - API C
    L'API C permet aux applications d'appeler des mappes et de développer des adaptateurs à utiliser avec HCL Link.
    - Présentation des méthodes d'interface de l'API C
      Les propriétés d'objet de mappe, de carte et d'adaptateur définissent les propriétés qui peuvent être définies pour chaque objet. Utilisez les méthodes d’interface de l’API C pour obtenir ou définir les propriétés de l’objet d’adaptateur.
    - Méthodes d'objet
    - Chargement, exécution et contrôle des mappes
      Vous pouvez utiliser différentes méthodes pour charger, exécuter et contrôler des mappes lorsque vous utilisez des API avec HCL Link.
    - Adaptateurs personnalisés
      L’interface des adaptateurs personnalisés permet aux utilisateurs de développer des adaptateurs avec autant de fonctionnalités que celles fournies avec le produit.
      - Développement d'adaptateurs personnalisés
        L’interface des adaptateurs personnalisés permet aux utilisateurs de développer des adaptateurs avec autant de fonctionnalités que celles fournies avec le produit.
      - Enregistrement d'adaptateur et table virtuelle de bibliothèque
        La première étape requise pour développer un adaptateur consiste à ajouter l'adaptateur au fichier d'enregistrement .xml.
      - Initialisation de l'adaptateur
        InitializeLibrary fournit un point d'entrée par lequel les structures globales, les sections critiques ou les listes requises par l'adaptateur peuvent être initialisées.
      - Pointage vers les méthodes d'adaptateur
        Une fois l'adaptateur chargé, vous devez appeler la structure de la table virtuelle (vtable) pour obtenir des pointeurs vers les méthodes.
      - Fichier d'enregistrement d'adaptateur
        Le fichier d'enregistrement adapters.xml contient une balise unique pour chaque adaptateur, y compris un certain nombre d'attributs pour fournir des informations sur l'adaptateur.
      - Bibliothèque d'adaptateurs vtable
      - Méthodes fournies par l'adaptateur
        Méthodes fournies par un adaptateur
        Plusieurs méthodes doivent être fournies par un adaptateur.
        Méthodes d'adaptateur utilisées après la création d'instance
        Une fois que vous avez créé une instance des objets d'adaptateur et de connexion, la mappe peut utiliser ces objets pour obtenir des données, mettre des données ou surveiller des événements. La table virtuelle de l'adaptateur, MPI_ADAPTER_VTABLE, pointe vers un certain nombre de méthodes fournies par l'adaptateur.
        Présentation de l'instance d'adaptateur
        Lorsqu'une mappe s'exécute, un certain nombre d'objets sont créés (par exemple, une mappe et une carte). Chaque carte possède une instance d'adaptateur associée. L'instance d'adaptateur contient un certain nombre de propriétés qui déterminent le comportement de l'adaptateur. Le nombre et le type de ces propriétés sont définis via la méthode mpiObjectNewPropColl.
        Présentation de l'instance de connexion
        Les instances d'objets de connexion sont créées de la même manière que les instances d'adaptateur. Lorsqu'une nouvelle connexion est requise, une instance de connexion est créée.
        Interface de connexion
        Les méthodes d’interface de connexion sont appelées pour se connecter à une ressource et pour contrôler le regroupement de connexions.
        Méthodes d'initialisation et d'arrêt de bibliothèque
        Les méthodes d’adaptateur personnalisé InitializeLibrary et DestroyLibrary sont appelées pour effectuer des tâches d’initialisation ponctuelles et pour effectuer un nettoyage après ces tâches.
        Interface de programme d'écoute
        L'interface du programme d'écoute utilise les méthodes Listen, CombinedListen et CompareWatches pour surveiller les événements uniques ou multiples de la ressource.
        Appel de méthode
        Les exemples d'appels de méthode illustrent la séquence d'appels à un adaptateur.
        Interface source et cible
        Les méthodes d’interface source et cible sont appelées pour obtenir des données d’une ressource, pour insérer des données dans une ressource et pour contrôler une transaction tout en développant des adaptateurs personnalisés.
        Get
        La méthode Get est appelée pour obtenir des données d'une ressource afin de servir d'entrée dans une mappe.
        Placer
        La méthode Put est appelée pour envoyer des données à une ressource pour la sortie d'une mappe.
        OnNotify
        La méthode OnNotify est appelée pour signaler à un adaptateur la progression de la mappe par rapport à l'adaptateur.
        BeginTransaction
        La méthode BeginTransaction est appelée pour démarrer explicitement une transaction.
        EndTransaction
        La méthode EndTransaction est appelée à la fin de la transaction pour la terminer.
        Interface de propriété
        La méthode d’adaptateur personnalisé ValidateProperties est appelée pour valider les propriétés de l’adaptateur.
        Codes retour de l'API C
        Il existe trois types de codes retour pour l'API C : réussite, avertissement ou erreur.
      - Méthodes d'adaptateur supplémentaires
        Un certain nombre de méthodes supplémentaires qui font partie de la bibliothèque d'interface de programmation HCL Link sont particulièrement pertinentes pour les développeurs d'adaptateurs.
      - Transmission de données vers et depuis des mappes
        La transmission de données entre les adaptateurs et le moteur se fait à l'aide d'objets de flux. Du point de vue de l'adaptateur, il n'est pas nécessaire de créer ces objets de flux. Ils sont déjà créées lorsque la méthode Get ou Put est appelée.
      - Présentation des unités d'exécution, des connexions et des transactions
        Il est important de savoir comment les unités d'exécution, les connexions et les transactions interagissent.
  - API Python
    Utilisez l'API Python pour créer, éditer et exécuter des mappes et des schémas à partir d'un programme Python. Pour plus de détails, voir la documentation installée dans install_dir/python/api/hip/docs/html/index.html. Des exemples de l'API Python sont installés dans la documentation install_dir/python/api/examples. pour les exemples d'API Python disponibles dans install_dir/python/api/docs/html/examples.html.
  - API Java
    Les interfaces API Java vous permettent de créer, d'éditer et d'exécuter des mappes et des schémas et à partir d'un programme Java™.
  - Outils Java
    Le Java™ Outils du fournit des objets et des utilitaires JNI que vous pouvez utiliser pour obtenir des informations sur les instances de votre mappe.

Vue d'ensemble de la méthode BeginTransaction

La méthode BeginTransaction est appelée pour démarrer explicitement une transaction.

Cette méthode est facultative car certaines ressources sont non transactionnelles, et pour d'autres, une transaction est démarrée implicitement lorsque la connexion est établie.

MPIRC BeginTransaction (HMPIADAPT  
hAdapter, HMPICONNECT  hConnection)

Entrées

hAdapter: Descripteur d'adaptateur
hConnection: Descripteur de connexion

Sorties

Aucun

Renvoie

Statut de réussite

Cette méthode est toujours appelée à la suite d'un appel Connect et avant tout appel Get ou Put. Si l'adaptateur fonctionne dans le mode dans lequel les unités d'exécution de connexion de mappe et le programme d'écoute sont combinés, BeginTransaction est appelé avant Listen.

Rate this topic

5 stars 4 stars 3 stars 2 stars 1 star

Comment on this topic.

By clicking this box, you acknowledge that you are NOT a U.S. Federal Government employee or agency, nor are you submitting information with respect to or on behalf of one. HCL provides software and services to U.S. Federal Government customers through its partners immixGroup, Inc. Contact this team at https://hcltechsw.com/resources/us-government-contact. Do not include any personal data in this Comment box. Note: To report a problem or question about the product software, do not use this form. Instead, go to the HCL Software Support site.