Implementieren einer Schnittstelle

Die Implementierung von Schnittstellen basiert auf dem Konzept der objektorientierten Programmierung. Über gemeinsame Schnittstellen können Sie verschiedene aber gleichartige Funktionsbausteine auch gleichartig verwenden.

Ein Funktionsbaustein, der eine Schnittstelle implementiert, muss alle Methoden und Eigenschaften enthalten, die in dieser Schnittstelle definiert sind (Schnittstellen-Methoden und Schnittstellen-Eigenschaften). Das bedeutet: Name, Eingänge und Ausgang der jeweiligen Methode oder Eigenschaft müssen exakt gleich sein.

Wenn Sie einen neuen Funktionsbausteins anlegen, der eine Schnittstelle implementiert, fügt CODESYS automatisch alle Methoden und Eigenschaften dieser Schnittstelle unterhalb des neuen Funktionsbausteins im Baum ein.

Wichtig

Wenn Sie danach weitere Methoden der Schnittstelle hinzufügen, fügt CODESYS diese Methoden nicht automatisch auch in den betreffenden Funktionsbausteinen hinzu. Für die Aktualisierung müssen Sie explizit den Befehl Schnittstellen implementieren auswählen.

Bei abgeleiteten Funktionsbausteinen müssen Sie darauf achten, dass Methoden oder Eigenschaften, die durch „Vererbung“ einer Schnittstelle übernommen wurden, die gewünschte Implementierung erhalten oder gelöscht werden, falls die in der Basis vorliegende Implementierung verwendet werden soll. Sie erhalten entsprechende Übersetzungsfehlermeldungen oder Warnungen, provoziert durch automatisch eingefügte Pragmaattribute. Sehen Sie bitte die Hilfeseite zum Befehl Schnittstellen implementieren.

Wichtig

Einer Variablen vom Typ einer Schnittstelle müssen Sie die Schnittstelle eines Funktionsbausteins zuweisen, bevor eine Methode über die Variable aufgerufen werden kann.
Eine Variable vom Typ einer Schnittstelle ist immer eine Referenz der zugewiesenen Funktionsbausteininstanz.

Eine Variable vom Typ einer Schnittstelle ist eine Referenz auf Instanzen von Funktionsbausteinen. Eine solche Variable kann auf jeden Funktionsbaustein verweisen, der die Schnittstelle implementiert. Wenn keine Zuweisung auf die Variable erfolgt ist, dann enthält die Variable im Onlinebetrieb den Wert 0.

Beispiel 30. Beispiele

Die Schnittstelle I1 enthält die Methode GetName.

METHOD GetName : STRING

Die Funktionsbausteine A und B implementieren jeweils die Schnittstelle I1:

FUNCTION_BLOCK A IMPLEMENTS I1
FUNCTION_BLOCK B IMPLEMENTS I1

Beide Funktionsbausteine müssen deswegen eine Methode mit dem Namen GetName und dem Rückgabetyp STRING enthalten. Ansonsten meldet der Compiler einen Fehler.

Eine Funktion enthält die Deklaration einer Variablen vom Typ der Schnittstelle I1.

FUNCTION DeliverName : STRING
VAR_INPUT
    l_i : I1;
END_VAR

Funktionsbausteine, die die Schnittstelle I1 implementieren, können dieser Eingangsvariablen zugewiesen werden.

Beispiele für Funktionsaufrufe:

DeliverName(l_i := A_instance); // call with instance of type A
DeliverName(l_i := B_instance); // call with instance of type B

Aufruf der Schnittstellen-Methode:

In diesem Falle hängt es vom tatsächlichen Typ von l_i ab, ob die Applikation A.GetName oder B.GetName aufruft.

DeliverName := l_i.GetName();