Vorhandene Adapter auf MobileFirst Server Version 8.0.0 umstellen

improve this page | report issue

Übersicht

Ab MobileFirst Server Version 8.0 sind Adapter Maven-Projekte. Hier erfahren Sie, wie ein Upgrade für in früheren Versionen von MobileFirst Server entwickelte Adapter durchgeführt wird.

Hier sind die Migrationsschritte beschrieben, die für Adapter ausgeführt werden müssen, die für MobileFirst Server ab Version 6.2 entwickelt wurden, damit diese auch in MobileFirst Server Version 8.0 funktionieren.
Sehen Sie sich zunächst die Änderungen an den Adapter-APIs an (siehe Nicht mehr verwendete Features und API-Elemente sowie Änderungen der serverseitigen API in Version 8.0).

Migration von Adaptern mit dem Unterstützungstool für Migration

Mit dem Unterstützungstool für Migration ist die Umstellung vorhandener Adapter einfacher. Weitere Informationen finden Sie hier.

Ältere Adapter unverändert in MobileFirst Server Version 8.0 verwenden

Ein vorhandener Adapter kann ohne Änderung in MobileFirst Server Version 8.0 implementiert werden, solange sie nicht die folgenden Bedingungen erfüllen:

Adaptertyp Bedingung
Java Verwendet die Schnittstelle PushAPI oder SecurityAPI
JavaScript
  • Wurde in IBM Worklight bis Version 6.2 erstellt
  • Verwendet einen anderen Verbindungstyp als HTTP oder SQL
  • Enthält Prozeduren mit securityTest-Anpassung
  • Enthält Prozeduren, die für die Verbindung zum Back-End die Benutzeridentität verwenden
  • Verwendet eine der folgenden APIs:
    • WL.Device.*
    • WL.Geo.\*
    • WL.Server.readSingleJMSMessage
    • WL.Server.readAllJMSMessages
    • WL.Server.writeJMSMessage
    • WL.Server.requestReplyJMSMessage
    • WL.Server.getActiveUser
    • WL.Server.setActiveUser
    • WL.Server.getCurrentUserIdentity
    • WL.Server.getCurrentDeviceIdentity
    • WL.Server.createEventSource
    • WL.Server.createDefaultNotification
    • WL.Server.getUserNotificationSubscription
    • WL.Server.notifyAllDevices
    • WL.Server.notifyDeviceToken
    • WL.Server.notifyDeviceSubscription
    • WL.Server.sendMessage
    • WL.Server.createEventHandler
    • WL.Server.setEventHandlers
    • WL.Server.setApplicationContext
    • WL.Server.fetchNWBusinessObject
    • WL.Server.createNWBusinessObject
    • WL.Server.deleteNWBusinessObject
    • WL.Server.updateNWBusinessObject
    • WL.Server.getBeaconsAndTriggers
    • WL.Server.signSoapMessage
    • WL.Server.createSQLStatement

Java-Adapter

auf Maven-Projekte in MobileFirst Server Version 8.0 umstellen

  1. Erstellen Sie ein Adapter-Maven-Projekt mit dem Archetyp adapter-maven-archetype-java. Wenn Sie den Parameter artifactId setzen, verwenden Sie den Adapternamen. Für den Parameter package müssen Sie dasselbe Paket wie beim vorhandenen Java-Adapter verwenden. Weitere Informationen finden Sie unter Java-Adapter erstellen.
  2. Überschreiben Sie die Adapterdeskriptordatei (adapter.xml) im Ordner src/main/adapter-resources des neuen Adapterprojekts, das Sie in Schritt 1 erstellt haben. Weitere Einzelheiten zum Deskriptor finden Sie unter Deskriptordatei für Java-Adapter.

  3. Entfernen Sie alle Dateien aus dem Ordner src/main/java Ihres neuen Adapterprojekts. Kopieren Sie dann alle Java-Dateien aus dem Ordner src/ Ihres alten Java-Adapterprojekts. Behalten Sie die Ordnerstruktur bei. Kopieren Sie alle Nicht-Jva-Dateien des alten Adapters aus dem Ordner src in den Ordner src/main/resources des neuen Adapters. Das Verzeichnis src/main/resources ist standardmäßig nicht vorhanden. Wenn der Adapter Nicht-Java-Dateien enthält, müssen Sie das Verzeichnis erstellen. Lesen Sie bezüglich der Änderungen an Java-Adpater-APIs die Informationen unter Änderungen an der serverseitigen API in Version 8.0.

    Die folgenden Diagramme veranschaulichen die Struktur von Adaptern bis Version 7.1 und von Maven-Adaptern ab Version 8.0.

    ├── adapters
 │   └── RSSAdapter
 │       ├── RSSAdapter.xml
 │       ├── lib
 │       └── src
 │           └── com
 │               └── sample
 │                   ├── RSSAdapterApplication.java
 │                   └── RSSAdapterResource.java

    Neue Struktur eines Java-Adapters:

    ├── pom.xml
 ├── src
 │   └── main
 │       ├── adapter-resources
 │       │   └── adapter.xml
 │       └── java
 │           └── com
 │               └── sample
 │                   ├── RSSAdapterApplication.java
 │                   └── RSSAdapterResource.java
  4. Fügen Sie mit einem der folgenden Schritte alle nicht im Maven-Repository enthaltenen JAR-Dateien hinzu:
    • Fügen Sie die JAR-Dateien zu einem lokalen Repository hinzu. Lesen Sie dazu die Beschreibung in der Veröffentlichung Guide to installing third-party party JARs. Fügen Sie die Dateien dann zum Element dependencies hinzu.
    • Fügen Sie die JAR-Dateien unter Verwendung des Elements systemPath zum Element “dependencies” hinzu. Weitere Informationen finden Sie unter Introduction to the Dependency Mechanism.

JavaScript-Adapter

auf Maven-Projekte in MobileFirst Server Version 8.0 umstellen

  1. Erstellen Sie ein Adapter-Maven-Projekt mit dem Archetyp adapter-maven-archetype-http oder adapter-maven-archetype-sql. Wenn Sie den Parameter artifactId setzen, verwenden Sie den Adapternamen. Weitere Informationen finden Sie unter JavaScript-Adapter erstellen.
  2. Überschreiben Sie die Adapterdeskriptordatei (adapter.xml) im Ordner src/main/adapter-resources des neuen Adapterprojekts, das Sie in Schritt 1 erstellt haben. Einzelheiten zum Deskriptor finden Sie unter Deskriptordatei für JavaScript-Adapter.
  3. Überschreiben Sie die JavaScript-Dateien im Ordner src/main/adapter-resources/js Ihres neuen Adapterprojekts.
▲
Inclusive terminology note: The Mobile First Platform team is making changes to support the IBM® initiative to replace racially biased and other discriminatory language in our code and content with more inclusive language. While IBM values the use of inclusive language, terms that are outside of IBM's direct influence are sometimes required for the sake of maintaining user understanding. As other industry leaders join IBM in embracing the use of inclusive language, IBM will continue to update the documentation to reflect those changes.
Last modified on May 13, 2020