Passer au contenu principal
Cette rubrique s’applique à FRE for Linux .
Cette méthode de chargement vous permet de charger ABBYY FineReader Engine en tant que serveur hors processus dans un processus distinct. Lorsque cette méthode est utilisée, tous les objets ABBYY FineReader Engine sont entièrement thread-safe. Chaque instance de FineReader Engine s’exécute dans son propre processus, simultanément avec les autres instances. Cela vous permet de créer un pool de processeurs et d’exploiter pleinement la puissance CPU disponible. C’est pourquoi cette méthode est particulièrement adaptée aux applications serveur. Pour charger Engine dans un processus distinct en tant que serveur hors processus, utilisez les fichiers fournis dans la distribution :
  • Le fichier OutprocEngineLoader.h déclare les méthodes d’initialisation et de déinitialisation de l’objet Engine (pour C++, utilisez les fonctions InitializeEngine et ExplicitlyUnload déclarées dans ce fichier d’en-tête).
  • Le fichier FREgnineOutproc.h est inclus dans OutprocEngineLoader.h. Il s’agit d’un équivalent du fichier FREngine.h pour les solutions multithread, qui prend en charge les mêmes méthodes et interfaces, à l’exception des méthodes de comptage de références et des méthodes avec des paramètres SAFEARRAY.
  • Les méthodes déclarées dans FREngineOutproc.h ne gèrent pas les cycles de références. C’est pourquoi une implémentation spécifique de SafePtr est fournie dans le fichier OutprocSafePtr.h, que vous trouverez dans les exemples de code décrivant le chargement en tant que serveur hors processus. Vous pouvez inclure ce fichier d’en-tête ou créer le vôtre.
  • Chaque chargement de l’objet Engine dans un processus distinct nécessite un port TCP. Le fichier de configuration OutprocConfig.ini contient la plage des ports disponibles pour la communication interprocessus.
  • Si votre application est en C++, liez également la bibliothèque libOutprocClientLib.so dans votre projet.
  • Si vous utilisez le wrapper Java, utilisez com.abbyy.Outproc.FREngine.jar au lieu de com.abbyy.FREngine.jar. Ces fichiers sont inclus dans le package de distribution d’ABBYY FineReader Engine.
Consultez les exemples de code Hello (Outproc) et Multithreading, qui montrent comment charger Engine en tant que serveur hors processus et fournissent une solution réutilisable pour les applications multithread en C++ et Java. L’objet Engine chargé en tant que serveur hors processus présente certaines particularités concernant l’utilisation des objets et des méthodes d’ABBYY FineReader Engine :
  • Vous devez spécifier le mode séquentiel de traitement des documents en définissant la propriété MultiProcessingMode de l’objet MultiProcessingParams sur MPM_Sequential.
  • Vous devez transmettre NULL pour les paramètres dérivés de IUnknown. Ces paramètres sont généralement utilisés dans les méthodes d’exportation. Pour transmettre les paramètres d’exportation autrement, créez un profil utilisateur avec les paramètres souhaités.
  • L’objet Engine chargé en tant que serveur hors processus ne prend pas en charge l’utilisation de :
    • callbacks et méthodes avec des paramètres dérivés de callbacks
    • interfaces et méthodes d’ouverture d’images depuis la mémoire
Vous pouvez également accélérer le parcours de la structure du document avec le schéma décrit dans Working with Layout and Blocks.