...
Pretože D2000 nepozná binárny dátový typ, RPC procedúry nie sú na presun binárnych dát vhodné. Na tento účel slúžia Simple Byte Array (SBA) metódy napísané v D2000 Jave. Bližší popis SBA je v dokumentácii k D2000.Na stiahnutie binárnych dát z D2000 na klienta slúži GET príkaz na adrese:
https://<doména<doména.sk>sk>/<názov aplikácie>/api/rest/v0/d2/sba/<meno eventu>/<meno SBA RPC metódy>?fileName=file.dat[¶meterX=hodnotaX¶meterY=hodnotaY&...]
Parametre dotazu (časť za otáznikom) sú automaticky preposlané do SBA metódy tak, ako boli zadané do adresy. Jediný preddefinovaný parameter je fileName, ktorý hovorí, ako sa bude sťahovaný súbor volať (kvoli downloadovaniu z prehliadača). Ak sa tento parameter nenastaví, tak názov downloadovaného súboru bude implicitne "file.dat". Ostatné parametre závisia od konkrétnej implementácie SBA metódy.
Nasledujúci príklad ilustruje volanie a implementaciu SBA RPC metódy pre stahovanie konkrétneho súboru z lokálneho súborového systému. Pozor uvedený príklad nie je vôbec vhodný pre reálne použítie a je uvedený iba pre ilustráciu použitia volania SBA RPC. Volanie SBA RPC metódy downloadFileSystemFile v evente E.SmartWeb_Demo je nasledovn=e.
GET
| Blok kódu | ||
|---|---|---|
| ||
package app.runnables;
import app.wrappers.E$SmartWeb_Demo__$WRAPPER$__;
import java.io.IOException;
import java.io.UnsupportedEncodingException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.util.Arrays;
import java.util.HashMap;
import java.util.List;
public class E$SmartWeb_Demo extends E$SmartWeb_Demo__$WRAPPER$__ {
public byte[] reportContract_PDF(byte[] urlParamsBytes) throws IOException {
final HashMap<String, String> parameters = getParametersFromUrlQueryString(urlParamsBytes);
final long contractId = Long.parseLong(parameters.get("id"));
System.out.println("DEBUG: Downloading contract with id " + contractId);
// TODO replace with real code to download PDF report for contract
Path path = Paths.get("D:/D2000/Contract" + contractId + ".pdf");
return Files.readAllBytes(path);
}
/**
* Utility metóda, vráti naparsované URL parametre zo vstupného poľa byte[]
**/
private HashMap<String, String> getParametersFromUrlQueryString(byte[] urlQueryStringBytes) throws UnsupportedEncodingException {
final String urlParamsString = new String(urlQueryStringBytes, "UTF-8");
final List<String> paramPartsList = Arrays.asList(urlParamsString.split("&"));
final HashMap<String, String> parameters = new HashMap<String, String>();
for (String paramPartsString : paramPartsList) {
final String[] paramParts = paramPartsString.split("=");
final String paramName = paramParts[0];
final String paramValue = paramParts.length > 1 ? paramParts[1] : null;
parameters.put(paramName, paramValue);
}
return parameters;
}
};
|