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
Méthodes fournies par un adaptateur
Plusieurs méthodes doivent être fournies par un adaptateur.

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.
        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.

Méthodes fournies par un adaptateur

Plusieurs méthodes doivent être fournies par un adaptateur.

Les types de méthodes suivants doivent être fournis par un adaptateur. Certaines de ces méthodes sont obligatoires, tandis que d'autres sont facultatives.

Méthodes d’initialisation et d’arrêt de bibliothèque
Création et destruction d’instance d’adaptateur
Création et destruction d’instance de connexion
Interface source/cible
Interface de propriété
Interface de connexion
Interface de programme d'écoute

Pour savoir si la méthode d'adaptateur est obligatoire ou facultative, consultez le tableau suivant.
Méthode	Obligatoire (Oui/Non)
InitializeLibrary	N
DestroyLibrary	N
CreateAdapterInstance	O
DestroyAdapterInstance	O
CreateConnectionInstance	O
DestroyConnectionInstance	O
CombinedListen	N³
Connexion	O
Déconnecter	O
Get	N¹
Placer	N¹
OnNotify	N¹
BeginTransaction	N²
EndTransaction	N²
Ecoute	N³
ValidateProperties	O
CompareConnection	O
ValidateConnection	N
CompareWatches	N^3,4

¹ ² ³ ⁴

¹ Certains adaptateurs ne prennent pas en charge les interfaces source et cible, et ne peuvent donc fournir qu'une méthode Get ou Put.

² Cette méthode n'est pas obligatoire si la ressource n'est pas transactionnelle.

³ Cette méthode est obligatoire uniquement pour les adaptateurs qui prennent en charge l'interface Listen.

⁴ CompareWatches est obligatoire uniquement si CombinedListen est fourni par l'adaptateur. Si Listen est fourni, CompareWatches n’est pas nécessaire.

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.