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 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.
ValidateConnection
La méthode ValidateConnection est appelée par le Gestionnaire de ressources sur une connexion inactive pour déterminer si elle est toujours valide. Elle est appelée lorsque la période spécifiée dans le fichier de configuration arrive à expiration. La méthode doit tester la connexion pour déterminer si elle est toujours valide, en utilisant tout mécanisme pris en charge par la ressource pour effectuer cette opération.

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.
        Connexion
        La méthode Connect est appelée pour se connecter à la ressource spécifiée par l'objet d'adaptateur. Les informations de contexte renvoyées par la connexion, telles que les descripteurs, les curseurs ou d'autres informations contextuelles, sont renvoyées en définissant les propriétés de l'objet de connexion.
        Déconnecter
        La méthode Disconnect permet de se déconnecter de la ressource référencée par l'objet de connexion. Le contexte de connexion est obtenu en récupérant les propriétés de l'objet de connexion qui ont été définies dans l'appel Connect.
        CompareConnection
        La méthode CompareConnection est appelée par le Gestionnaire de ressources pour déterminer si une connexion peut être réutilisée.
        ValidateConnection
        La méthode ValidateConnection est appelée par le Gestionnaire de ressources sur une connexion inactive pour déterminer si elle est toujours valide. Elle est appelée lorsque la période spécifiée dans le fichier de configuration arrive à expiration. La méthode doit tester la connexion pour déterminer si elle est toujours valide, en utilisant tout mécanisme pris en charge par la ressource pour effectuer cette opération.
        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éthode d'interface ValidateConnection

La méthode ValidateConnection est appelée par le Gestionnaire de ressources sur une connexion inactive pour déterminer si elle est toujours valide. Elle est appelée lorsque la période spécifiée dans le fichier de configuration arrive à expiration. La méthode doit tester la connexion pour déterminer si elle est toujours valide, en utilisant tout mécanisme pris en charge par la ressource pour effectuer cette opération.

MPIRC ValidateConnection (HMPIADAPT  
hAdapter,HCONNECTION  hConnection)

Entrées

hAdapter: Descripteur d'adaptateur
hConnection: Descripteur de connexion

Sorties

Aucun

Renvoie

MPIRC_SUCCESS: La connexion est correcte.
MPIRC_BAD_CONNECTION: La connexion n'est plus correcte.

Cette méthode est facultative. Si elle n'est pas fournie, la connexion est supposée être non valide lorsque le délai d'expiration est atteint. Ce délai d'expiration est actuellement défini dans le fichier de configuration dtx.ini.

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.