Von Version < 1.15 >
bearbeitet von awa
am 12.03.2020, 12:00
Auf Version < 1.12 >
bearbeitet von awa
am 12.03.2020, 11:46
< >
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -18,22 +18,15 @@
18 18  
19 19  == Plugin-Konfiguration ==
20 20  
21 -Am Plugin selber kann konfiguriert werden, ob das Deploy-Servlet durch ein Passwort geschützt werden soll. Dazu gibt es die eine Plugin-Eigenschaft //token//, diese hat das folgende Format
21 +== HTTP-Request-Aufbau ==
22 22  
23 -> hash_method:hashed_value
24 -
25 -Folgende Hash-Methoden stehen zur Verfügung:
26 -
27 -; plain
28 -: asd
29 -
30 -== Deploy-Servlet ==
31 -
32 32  Im Folgenden wird der Aufbau des HTTP-Requests beschrieben, um ein Plugin zu installieren, zu aktualisieren oder zu löschen.
33 33  
34 34  Es muss immer ein HTTP-Post-Request verwendet werden und [[sich an folgende URL richten>>doc:Formcycle.PluginDevelopment.Types.IPluginServletAction]] (Namen des FORMCYCLE-Servers entsprechend anpassen):
35 35  
36 -> POST http://localhost:8080/formcycle/plugin?name=deploy-plugin&client-id=154 HTTP/1.1
27 +{{code language="none"}}
28 +POST http://localhost:8080/formcycle/plugin?name=deploy-plugin&client-id=154 HTTP/1.1
29 +{{/code}}
37 37  
38 38  Die //client-id// muss nicht angegeben werden, wenn das Plugin als System-Plugin installiert ist.
39 39  
... ... @@ -89,8 +89,8 @@
89 89  
90 90  (((
91 91  {{code language="bash"}}
92 -# Installiert oder aktualisiert das Plugin mit dem Implementation-Title com.example:plugin
93 93   curl -X POST \
86 + # These options are required
94 94   -F deploy-action=save \
95 95   -F token=admin \
96 96   -F plugin-ident=manifest \
... ... @@ -105,8 +105,8 @@
105 105  
106 106  (((
107 107  {{code language="bash"}}
108 -# Löscht das Plugin mit dem Implementation-Title com.example:plugin
109 109   curl -X POST \
102 + # These options are required
110 110   -F deploy-action=delete \
111 111   -F token=admin \
112 112   -F plugin-ident=manifest \
... ... @@ -116,12 +116,12 @@
116 116  )))
117 117  
118 118  ; activate
119 -: Aktiviert das angegebene Plugin. Es darf hierbei keine JAR-Datei übertragen werden. Existiert das angegebene Plugin nicht, wird ein Fehler zurückgegeben. Ist das Plugin bereits aktiviert, wird nicht getan und ein Erfolg zurückgegeben. Beispiel:
112 +: Aktiviert das angegebene Plugin. Es darf hierbei keine JAR-Datei übertragen werden. Existiert das angegebene Plugin nicht, wird ein Fehler zurückgegeben. Beispiel:
120 120  
121 121  (((
122 122  {{code language="bash"}}
123 -# Aktiviert das Plugin mit dem Implementation-Title com.example:plugin
124 124   curl -X POST \
117 + # These options are required
125 125   -F deploy-action=activate \
126 126   -F token=admin \
127 127   -F plugin-ident=manifest \
... ... @@ -131,12 +131,12 @@
131 131  )))
132 132  
133 133  ; deactivate
134 -: Deaktiviert das angegebene Plugin. Es darf hierbei keine JAR-Datei übertragen werden. Existiert das angegebene Plugin nicht, wird ein Fehler zurückgegeben. Ist das Plugin bereits deaktiviert, wird nicht getan und ein Erfolg zurückgegeben. Beispiel:
127 +: Deaktiviert das angegebene Plugin. Es darf hierbei keine JAR-Datei übertragen werden. Existiert das angegebene Plugin nicht, wird ein Fehler zurückgegeben. Beispiel:
135 135  
136 136  (((
137 137  {{code language="bash"}}
138 -# Deaktiviert oder aktualisiert das Plugin mit dem Implementation-Title com.example:plugin
139 139   curl -X POST \
132 + # These options are required
140 140   -F deploy-action=deactivate \
141 141   -F token=admin \
142 142   -F plugin-ident=manifest \
... ... @@ -147,6 +147,7 @@
147 147  
148 148  ; update-properties
149 149  : Aktualisiert die Eigenschaften des angegebenen Plugins. Es darf hierbei keine JAR-Datei übertragen werden. Entweder die Eigenschaft //clear-properties// oder //property// sollte gesetzt sein. Existiert das angegebene Plugin nicht, wird ein Fehler zurückgegeben. Beispiel:
143 +
150 150  (((
151 151  {{code language="bash"}}
152 152  # Löscht alle vorhandenen Plugin-Eigenschaften und setzt dann die Eigenschaft "foo" auf den Wert "bar"
... ... @@ -266,53 +266,4 @@
266 266  }
267 267  {{/code}}
268 268  
269 -Beispiel für die Antwort beim Aktualisieren eines Plugins:
270 -
271 -{{code language="json"}}
272 -{
273 - "success": true,
274 - "requestParameters": {
275 - "plugin-ident": ["manifest"],
276 - "name": ["deploy-plugin"],
277 - "client-id": ["1"],
278 - "deploy-action": ["save"],
279 - "plugin-identifier": ["Implementation-Title=com.example:plugin"],
280 - "token": ["admin"]
281 - },
282 - "details": {
283 - "name": "my-plugin.jar",
284 - "active": true,
285 - "id": 203,
286 - "message": "Plugin saved successfully.",
287 - "uuid": "2fe3e1ba-cb32-434e-9f59-4422f8dabcad"
288 - },
289 - "message": "Plugin saved successfully.",
290 - "statusCode": 200
291 -}
292 -{{/code}}
293 -
294 -Beispiel für die Antwort beim Löschen, falls das angegebene Plugin nicht gefunden wurde:
295 -
296 -{{code language="json"}}
297 -{
298 - "success": false,
299 - "requestParameters": {
300 - "plugin-ident": ["manifest"],
301 - "name": ["deploy-plugin"],
302 - "client-id": ["1"],
303 - "deploy-action": ["delete"],
304 - "plugin-identifier": ["Implementation-Title=com.example:plugin"],
305 - "token": ["admin"]
306 - },
307 - "details": {
308 - "exceptionType": "java.lang.IllegalArgumentException",
309 - "exceptionMessage": "Deploy action 'delete' requires an existing pluign, but none was found."
310 - },
311 - "message": "class java.lang.IllegalArgumentException: Deploy action 'delete' requires an existing pluign, but none was found.",
312 - "statusCode": 404
313 -}
314 -{{/code}}
315 -
316 -
317 317  == Beispiel für Maven ==
318 -
Copyright 2000-2025