Serverseitige JavaScript-API

JavaScript-Adapter können die JavaScript-API von IBM MobileFirst Platform Server verwenden, um serverbezogene Operationen wie die folgenden auszuführen: andere Adapter aufrufen, Adapteraktivitäten protokollieren, Werte von Konfigurationseigenschaften abrufen, Aktivitäten an IBM MobileFirst Analytics melden und die Identität des Anforderungsausstellers abrufen.

MFP.Server und MFP.Logger

Die serverseitige JavaScript-API wird in zwei Klassen bereitgestellt:

MFP.Server für Serveroperationen
MFP.Logger für Protokollierung

Beispiele für die Verwendung der API finden Sie in den folgenden Abschnitten.

Sicherheit

Die Funktion MFP.Server.getTokenIntrospectionData ermöglicht den Zugriff auf den Sicherheitskontext des Clients und auf die Clientregistrierungsdaten. Im folgenden Beispiel wird die Funktion verwendet, um den Anzeigenamen des authentifizierten Benutzers abzurufen:

AuthenticatedUser user = securityContext.getAuthenticatedUser();
    return "Hello " + user.getDisplayName();
}

Adapterprozeduren aufrufen

MFP.Server.invokeProcedure vereinfacht die Ausführung von Anforderungen an andere Adapter desselben Servers.

Das folgende Beispiel zeigt, wie ein JavaScript-Adapter mit der Funktion aufgerufen wird:

function callAnotherProcedure() {
    var invocationData = {
        adapter : “JsAdapter”, procedure :     
        “getStories”
    };
return MFP.Server.invokeProcedure();}

Weitere Informationen finden Sie unter Adapter konfigurieren.

Konfigurationseigenschaften

Mithilfe der Funktion MFP.Server.getPropertyValue kann der Adapter eine Eigenschaft aus der Adapterkonfiguration lesen.

Angenommen, es gibt eine benutzerdefinierte Eigenschaft databaseName. Zum Abrufen des Wertes dieser Eigenschaft könnten Sie den folgenden Code schreiben:

var dbName = MFP.Server.getPropertyValue(‘databaseName’);

Weitere Informationen finden Sie unter Adapter konfigurieren.

Analyse

Die Funktion MFP.Server.logActivity meldet Informationen an IBM MobileFirst Analytics.

Zum Senden der Zeichenfolge Getting account balance könnten Sie beispielsweise Folgendes schreiben:

function getBalance(user) {
    MFP.Server.logActivity(‘Getting account balance);  
    // Operation ausführen
}

Protokollierung

Die JavaScript-API stellt über die Klasse MFP.Logger Protokollierungsfunktionen bereit. Es gibt vier Funktionen, die vier Standardprotokollierungsstufen entsprechen.