API per Straus7 - Application Programming Interface

Introduzione

 

A partire dalla release 2.2 di Straus7, e' reso disponibile un nuovo potente strumento di lavoro, le Straus7 API (Application Programming Interface). Questo prodotto software consente agli utenti di interfacciare con Straus7 proprie applicazioni esterne.

 

La dicitura “Application Programming Interface” assume, in questo contesto, il seguente significato:

 

 

 

 

Ogni programma scritto con un linguaggio di programmazione supportato in ambiente Windows può utilizzare le API di Straus7 a condizione che, in primo luogo, esso possa caricare dinamicamente file DLL di Windows e, in secondo luogo, che rispetti le relative convenzioni di chiamata. Ciò è possibile con linguaggi tipo C, C++, Pascal, Delphi, Visual Basic, FORTRAN, etc. La scelta del linguaggio di programmazione dipende unicamente dalle preferenze del programmatore, piuttosto che da ragioni di compatibilità o prestazione. Le API stesse sono scritte utilizzando il linguaggio di programmazione Delphi.

 

Funzionalità base

 

Le API consentono agli utenti di incorporare Straus7 all’interno delle proprie applicazioni.

Piu' precisamente esse possono essere utilizzate per :

  1. Creare direttamente nuovi modelli Straus7 (i file binari con estensione ST7, che contengono i tipici dati di ingresso di Straus7).
  2. Modificare file ST7 esistenti.
  3. Lanciare i solutori di Straus7.
  4. Estrarre e rielaborare i risultati di un calcolo svolto.

 

In realta', operazioni di questo tipo possono essere eseguite anche tramite l’utilizzo diretto della Straus7 GUI. E' inoltre possibile scambiare dati tra Straus7 ed altre applicazioni con funzioni di importazione\esportazione in formato testo, con funzioni di copia\incolla ecc.

Le modalita' di cui sopra possono pero' rivelarsi lunghe e onerose.

Le API, invece, forniscono una modalita' totalmente trasparente di interagire con Straus7 e con esse risulta facile automatizzare anche operazioni ripetitive. Una nota importante riguarda il fatto che, anche se il formato dei file binari dovesse cambiare a seguito di aggiornamenti del software, tali cambiamenti verranno integralmente gestiti dalle API; ciò lascia immutata la struttura dei programmi esterni già sviluppati.

 

Utilizzatori finali

 

Le API di Straus7 sono state sviluppate pensando a varie categorie di utenti, in particolare :

 

 

Il Toolkit delle API di Straus7.

 

Il Toolkit delle API è composto dai seguenti componenti:

 

  1. La libreria dinamica di collegamento (DLL) St7API.DLL. Tale file costituisce l’interfaccia tra i vari programmi e Straus7.
  2. I file header. Questi file permettono ad un compilatore esterno di comunicare con St7API.DLL. I file header contengono la definizione di tutte le costanti utilizzate insieme alle convenzioni di chiamata delle funzioni per ogni linguaggio supportato. E' previsto un set di files header per ogni linguaggio (ad es. Delphi, C, C++, FORTRAN, ecc.). Si noti che in alcuni casi il formato del file di header è dipendente dal produttore del linguaggio di compilazione – ad es. il file header per Microsoft Visual C++ sarà differente da quello per Borland C++.
  3. Una applicazione di esempio. Per illustrare l’utilizzo delle API, e' fornito il codice sorgente di una semplice applicazione, per i vari linguaggi supportati.
  4. La documentazione delle API di Straus7. In questo manuale (fornito come file PDF) sono definite tutte le funzioni disponibili, convenzioni di chiamata con spiegazione dei messaggi di errore. Ad ogni funzione e' associato un semplice esempio applicativo, scritto utilizzando vari tipi di linguaggio di programmazione.



Per inviare un messaggio: hsh@iperv.it