...
Pri posielaní binárnych dát nie je možné poslať špecifické URL parametre priamo do SBA RPC metódy. Hodnota vstupného parametra SBA RPC metódy bude v tomto prípade binárny obsah posielaný v tele POST requestu. Klient ale nie je žiadnym spôsobom obmedzený typom obsahu, ktorý posiela cez HTTP POST request. Jediná požiadavkou je, aby binárny obsah vedela rozkódovať príslušná implementácia SBA RPC metódy, analogicky ako v predchádzajúcom prípade keď sme ilustrovali rozkódovanie URL parametrov špeciálnou utility metódou getParametersFromUrlQueryString(). Ak klient potrebuje posielať s binárnym obsahom aj dodatočné vstupné parametre (napr. identifikujúce tento obsah), je zakódovanie a rozkódovanie takéhoto obsahu v SBA RPC plne v jeho kompetencii.
...
Nasledujúca kapitola obsahuje odporúčaný spôsob takéhoto kódovania.
...
Odporúčaný spôsob kódovania
...
vstupných parametrov spolu s binárnym obsahom
V prípade že so samotným binárnym obsahom potrebujeme v rámci volania SBA RPC metódy posielať aj ďalšie vstupné parametre, odporúčame kódovať parametre ako aj priložený obsah do zip streamu
...
. Výhodou takéhoto riešenia je univerzálnosť a jednoduchosť použitia vo väčšine programovacích jazykov (ZIP kompresia býva väčšinou dobre podporená buď v štandardnej knižnici daného jazyka alebo v nejakej inej
...
voľne dostupnej verzii knižnice).
...
Uvádzame príklad kompresie viacerých parametrov do jedného ZIP byte streamu v Jave na strane klienta:
| Blok kódu | ||
|---|---|---|
| ||
/**
* Proposal method how to serialize multiple key-value pairs to byte array
*/
@SuppressWarnings("unused")
private byte[] writeParameters(Map<String, byte[]> params) throws IOException {
try (ByteArrayOutputStream baos = new ByteArrayOutputStream()) {
try (ZipOutputStream zos = new ZipOutputStream(baos)) {
for (Map.Entry<String, byte[]> entry : params.entrySet()) {
final ZipEntry zipEntry = new ZipEntry(entry.getKey());
zipEntry.setSize(entry.getValue().length);
zos.putNextEntry(zipEntry);
zos.write(entry.getValue());
zos.closeEntry();
}
}
return baos.toByteArray();
}
} |
Príklad rozkódovania ZIP byte streamu na strane SBA RPC potom bude:
| Blok kódu | ||
|---|---|---|
| ||
/**
* Proposal method how to deserialize multiple key-value pairs from byte array
*/
@SuppressWarnings("unused")
private Map<String, byte[]> loadParameters(byte[] inputBytes) throws IOException {
final Map<String, byte[]> dataParts = new HashMap<String, byte[]>();
try (ByteArrayInputStream byteArrayInputStream = new ByteArrayInputStream(inputBytes)) {
try (ZipInputStream zipInputStream = new ZipInputStream(new ByteArrayInputStream(inputBytes))) {
ZipEntry zipEntry = zipInputStream.getNextEntry();
byte[] buffer = new byte[4096];
while (zipEntry != null) {
final ByteArrayOutputStream outputStream = new ByteArrayOutputStream();
int len;
while ((len = zipInputStream.read(buffer)) > 0) {
outputStream.write(buffer, 0, len);
}
final byte[] data = outputStream.toByteArray();
dataParts.put(zipEntry.getName(), data);
zipEntry = zipInputStream.getNextEntry();
}
}
}
return dataParts;
} |
Automatické kódovanie vstupných parametrov spolu s binárnym obsahom
Ako alternatíva k predchádzajúcej možnosti kódovania vstupných parametrov spolu s obsahom na strane klienta je volanie SBA RPC metódy cez HTTP POST s inou hodnotou HTTP hlavičky: Content-Type: multipart/form-data. V tomto prípade sa v telo POST volania kóduje podľa definovaného štandardu na posielanie uploadovanie obsahu formulárov aj binárnymi súbormi z prehliadača. Smart Web podporuje aj tento formát na volanie SBA RPC metód. Vstupný parameter pri volani SBA RPC metódy bude v tomto prípade obsahovať obsah jhodnôt ednotlivých polí formulára zazipovaný spôsobom ako bol popísaný v predchádzajúcej kapitole. T.j. na rozkódovanie parametrov je možné využiť už uvedenú Java metódu loadParameters.