Web API

Das RapidClipse Framework bietet mehrere Methoden an, um Web-API Funktionen des Endgeräts zu benutzen z.B. einen Text in das Clipboard des Benutzers zu kopieren und einzufügen.

Zuerst muss die Maven dependency in der pom.xml hinzugefügt werden:

<dependency>
	<groupId>com.rapidclipse</groupId>
	<artifactId>rap-server-webapi</artifactId>
	<version>10.02.00-RAP-GA</version>
</dependency>

Die API ist in mehrere Teilen aufgebaut:

https://rapidclipse.atlassian.net/wiki/spaces/RCXDOCDE/pages/916717602 - Kopieren und Einfügen von Texten in und von dem System-Clipboard.
https://rapidclipse.atlassian.net/wiki/spaces/RCXDOCDE/pages/916750370 - Allgemeine Funktionen wie vibrieren oder teilen von Links an andere installierte Apps.
https://rapidclipse.atlassian.net/wiki/spaces/RCXDOCDE/pages/916881437 - Lesen der Geographischen Koordinaten des Gerätes.
- Lesen der Menge des verfügbaren Speichers.
- Lesen von Informationen über die momentane Netzwerkverbindung.
- Local Notifications, welche im Notification-Management des Gerätes angezeigt wird.
- Testen, wann das Gerät wieder über eine Online-Verbindung verfügt.
- Dialog, mit welchen Informationen für Zahlung mit z.B. Kreditkarte gesammelt werden kann.
- Testen ob der Benutzer bestimmte Web-API-Featuers erlaubt hat, oder nicht.
- Allgemeine Funktionen zu Bildschirmorientierung und Fullscreen.
- Lesen von Touch-Informationen.
- GUI-Element für abspielen von Multimedia als auch von den Kameras des Gerätes.

Viele der Methoden erwarten Callbacks als Parameter, da der Javascript-Code erst ausgeführt werden kann, wenn die Informationen an den Browser gesendet wurden und dieser dann die Rückgabewerte wieder an den Server zurück geschickt hat.

Wichtige Information:

Viele der Features funktionieren nur in einen Secure-Context (https-Verbindung zu dem Server). Diese können aber z.B. mit Google Chrome trozdem im lokalen Netzwerk wie folgt getestet werden:
- Um Features auf localhost zu testen kann bei Chrome unter chrome://flags unter Insecure origins treated as secure http://localhost:8080 eingetragen werden
- Um Features auszuprobieren, welche nur auf dem Handy funktionieren, kann im Handy auch unter Insecure origins treated as secure die lokale IP-Addresse des PCs eingetragen werden z.B. http://192.168.0.123:8080
Viele dieser Features müssen erst vom Benutzer erlaubt werden. Wenn eines dieser Features ausgeführt wird, bekommt der Benutzer ein kleines Dialog-Fenster, wo dieser dieses Feature erlauben oder blockieren kann.
Für ein paar Features wie z.B. Local Notifications muss die Anwendung als PWA gekennzeichnet werden! Dafür einfach über die Haupt-View @PWA schreiben
Nicht alle der Features werden zurzeit von allen Browsern unterstützt, um Browser-Compatibiltity Informationen zu erhalten können Webseiten wie MDN benutzt werden.