Merge branch '8784-dir-listings'
[arvados.git] / doc / sdk / java / example.html.textile.liquid
1 ---
2 layout: default
3 navsection: sdk
4 navmenu: Java
5 title: "Examples"
6 ...
7 {% comment %}
8 Copyright (C) The Arvados Authors. All rights reserved.
9
10 SPDX-License-Identifier: CC-BY-SA-3.0
11 {% endcomment %}
12
13 h2. Initialize SDK
14
15 <pre>
16 import org.arvados.sdk.Arvados;
17 </pre>
18
19 <pre>
20     String apiName = "arvados";
21     String apiVersion = "v1";
22
23     Arvados arv = new Arvados(apiName, apiVersion);
24 </pre>
25
26 h2. create
27
28 <pre>
29     Map<String, String> collection = new HashMap<String, String>();
30     collection.put("name", "create example");
31
32     Map<String, Object> params = new HashMap<String, Object>();
33     params.put("collection", collection);
34     Map response = arv.call("collections", "create", params);
35 </pre>
36
37 h2. delete
38
39 <pre>
40     Map<String, Object> params = new HashMap<String, Object>();
41     params.put("uuid", uuid);
42     Map response = arv.call("collections", "delete", params);
43 </pre>
44
45 h2. get
46
47 <pre>
48     params = new HashMap<String, Object>();
49     params.put("uuid", userUuid);
50     Map response = arv.call("users", "get", params);
51 </pre>
52
53 h2. list
54
55 <pre>
56     Map<String, Object> params = new HashMap<String, Object>();
57     Map response = arv.call("users", "list", params);
58
59     // get uuid of the first user from the response
60     List items = (List)response.get("items");
61
62     Map firstUser = (Map)items.get(0);
63     String userUuid = (String)firstUser.get("uuid");
64 </pre>
65
66 h2. update
67
68 <pre>
69     Map<String, String> collection = new HashMap<String, String>();
70     collection.put("name", "update example");
71
72     Map<String, Object> params = new HashMap<String, Object>();
73     params.put("uuid", uuid);
74     params.put("collection", collection);
75     Map response = arv.call("collections", "update", params);
76 </pre>
77
78 h2. Get current user
79
80 <pre>
81     Map<String, Object> params = new HashMap<String, Object>();
82     Map response = arv.call("users", "current", params);
83 </pre>