Completed
Push — master ( 9df0a4...b657f4 )
by Welling
02:10
created

RequestsInterface::getUser()

Size

Total Lines 1

Duplication

Lines 0
Ratio 0 %

Importance

Changes 0
Metric Value
dl 0
loc 1
ccs 0
cts 0
cp 0
c 0
b 0
f 0
1
<?php
2
3
/**
4
 * Directus – <http://getdirectus.com>
5
 *
6
 * @link      The canonical repository – <https://github.com/directus/directus>
7
 * @copyright Copyright 2006-2016 RANGER Studio, LLC – <http://rangerstudio.com>
8
 * @license   GNU General Public License (v3) – <http://www.gnu.org/copyleft/gpl.html>
9
 */
10
11
namespace Directus\SDK;
12
13
use Directus\SDK\Response\Entry;
14
use Directus\SDK\Response\EntryCollection;
15
16
/**
17
 * Requests Interface
18
 *
19
 * @author Welling Guzmán <[email protected]>
20
 */
21
interface RequestsInterface
22
{
23
    /**
24
     * Gets list of all tables
25
     *
26
     * @param array $params
27
     *
28
     * @return EntryCollection
29
     */
30
    public function getTables(array $params = []);
31
32
    /**
33
     * Gets the details of the given table
34
     *
35
     * @param $tableName
36
     *
37
     * @return Entry
38
     */
39
    public function getTable($tableName);
40
41
    /**
42
     * Gets columns of a given table
43
     *
44
     * @param $tableName
45
     * @param $params
46
     *
47
     * @return EntryCollection
48
     */
49
    public function getColumns($tableName, array $params = []);
50
51
    /**
52
     * Gets the details of a given table's column
53
     *
54
     * @param $tableName
55
     * @param $columnName
56
     *
57
     * @return Entry
58
     */
59
    public function getColumn($tableName, $columnName);
60
61
    /**
62
     * Fetch Items from a given table
63
     *
64
     * @param string $tableName
65
     * @param array $options
66
     *
67
     * @return EntryCollection
68
     */
69
    public function getItems($tableName, array $options = []);
70
71
    /**
72
     * Get an entry in a given table by the given ID
73
     *
74
     * @param mixed $id
75
     * @param string $tableName
76
     * @param array $options
77
     *
78
     * @return Entry
79
     */
80
    public function getItem($tableName, $id, array $options = []);
81
82
    /**
83
     * Gets the list of users
84
     *
85
     * @param array $params
86
     *
87
     * @return EntryCollection
88
     */
89
    public function getUsers(array $params = []);
90
91
    /**
92
     * Gets a user by the given id
93
     *
94
     * @param $id
95
     * @param array $params
96
     *
97
     * @return Entry
98
     */
99
    public function getUser($id, array $params = []);
100
101
    /**
102
     * Gets a list of User groups
103
     *
104
     * @return EntryCollection
105
     */
106
    public function getGroups();
107
108
    /**
109
     * Gets the information of a given user group
110
     *
111
     * @param $groupID
112
     *
113
     * @return Entry
114
     */
115
    public function getGroup($groupID);
116
117
    /**
118
     * Get a given group privileges
119
     *
120
     * @param $groupID
121
     *
122
     * @return EntryCollection
123
     */
124
    public function getGroupPrivileges($groupID);
125
126
    /**
127
     * Gets a list fo files
128
     *
129
     * @param array $params - Parameters
130
     *
131
     * @return EntryCollection
132
     */
133
    public function getFiles(array $params = []);
134
135
    /**
136
     * Gets the information of a given file ID
137
     *
138
     * @param $fileID
139
     *
140
     * @return Entry
141
     */
142
    public function getFile($fileID);
143
144
    /**
145
     * Gets all settings
146
     *
147
     * @return object
148
     */
149
    public function getSettings();
150
151
    /**
152
     * Gets all settings in a given collection name
153
     *
154
     * @param $collectionName
155
     *
156
     * @return EntryCollection
157
     */
158
    public function getSettingsByCollection($collectionName);
159
160
    /**
161
     * Updates settings in the given collection
162
     *
163
     * @param $collection
164
     * @param $data
165
     *
166
     * @return Entry
167
     */
168
    public function updateSettings($collection, array $data);
169
170
    /**
171
     * Gets messages with the given ID
172
     *
173
     * @param $id
174
     *
175
     * @return Entry
176
     */
177
    public function getMessage($id);
178
179
    /**
180
     * Gets all messages from the given user ID
181
     *
182
     * @param $userId
183
     *
184
     * @return EntryCollection
185
     */
186
    public function getMessages($userId = null);
187
188
    /**
189
     * Create a new item in the given table name
190
     *
191
     * @param $tableName
192
     * @param array $data
193
     *
194
     * @return Entry
195
     */
196
    public function createItem($tableName, array $data);
197
198
    /**
199
     * Update the item of the given table and id
200
     *
201
     * @param $tableName
202
     * @param $id
203
     * @param array $data
204
     *
205
     * @return mixed
206
     */
207
    public function updateItem($tableName, $id, array $data);
208
209
    /**
210
     * Deletes the given item id(s)
211
     *
212
     * @param string $tableName
213
     * @param string|array|Entry|EntryCollection $ids
214
     * @param bool $hard
215
     *
216
     * @return int
217
     */
218
    public function deleteItem($tableName, $ids, $hard = false);
219
220
    /**
221
     * Creates a new user
222
     *
223
     * @param array $data
224
     *
225
     * @return Entry
226
     */
227
    public function createUser(array $data);
228
229
    /**
230
     * Updates the given user id
231
     *
232
     * @param $id
233
     * @param array $data
234
     *
235
     * @return mixed
236
     */
237
    public function updateUser($id, array $data);
238
239
    /**
240
     * Deletes the given user id(s)
241
     *
242
     * @param string|array|Entry|EntryCollection $ids
243
     * @param bool $hard
244
     *
245
     * @return int
246
     */
247
    public function deleteUser($ids, $hard = false);
248
249
    /**
250
     * Creates a new file
251
     *
252
     * @param File $file
253
     *
254
     * @return Entry
255
     */
256
    public function createFile(File $file);
257
258
    /**
259
     * Updates the given file id
260
     *
261
     * @param $id
262
     * @param array|File $data
263
     *
264
     * @return mixed
265
     */
266
    public function updateFile($id, $data);
267
268
    /**
269
     * Deletes the given file id(s)
270
     *
271
     * @param string|array|Entry|EntryCollection $ids
272
     * @param bool $hard
273
     *
274
     * @return int
275
     */
276
    public function deleteFile($ids, $hard = false);
277
278
    /**
279
     * Creates a new Bookmark
280
     *
281
     * @param $data
282
     *
283
     * @return Entry
284
     */
285
    public function createBookmark($data);
286
287
    /**
288
     * Gets a Bookmark with the given id
289
     *
290
     * @param int $id
291
     *
292
     * @return Entry
293
     */
294
    public function getBookmark($id);
295
296
    /**
297
     * Gets a Bookmarks
298
     *
299
     * @param int $userId
0 ignored issues
show
Documentation introduced by
Should the type for parameter $userId not be integer|null?

This check looks for @param annotations where the type inferred by our type inference engine differs from the declared type.

It makes a suggestion as to what type it considers more descriptive.

Most often this is a case of a parameter that can be null in addition to its declared types.

Loading history...
300
     *
301
     * @return Entry
302
     */
303
    public function getBookmarks($userId = null);
304
305
    /**
306
     * Creates a new Table preferences
307
     *
308
     * @param $data
309
     *
310
     * @return Entry
311
     */
312
    public function createPreferences($data);
313
314
    /**
315
     * Creates a new Column
316
     *
317
     * @param $data
318
     *
319
     * @return Entry
320
     */
321
    public function createColumn($data);
322
323
    /**
324
     * Creates a new group
325
     *
326
     * @param $data
327
     *
328
     * @return Entry
329
     */
330
    public function createGroup(array $data);
331
332
    /**
333
     * Creates new message
334
     *
335
     * @param array $data
336
     *
337
     * @return Entry
338
     */
339
    public function createMessage(array $data);
340
341
    /**
342
     * Sends a new message
343
     *
344
     * Alias of createMessage
345
     *
346
     * @param array $data
347
     *
348
     * @return Entry
349
     */
350
    public function sendMessage(array $data);
351
352
    /**
353
     * Creates a new privileges/permissions
354
     *
355
     * @param array $data
356
     *
357
     * @return Entry
358
     */
359
    public function createPrivileges(array $data);
360
361
    /**
362
     * Creates
363
     *
364
     * @param $name
365
     * @param array $data
366
     *
367
     * @return Entry
368
     */
369
    public function createTable($name, array $data = []);
370
371
    /**
372
     * Creates/Updates column ui options
373
     *
374
     * @param array $data
375
     *
376
     * @return Entry
377
     */
378
    public function createColumnUIOptions(array $data);
379
380
    /**
381
     * Gets preferences
382
     *
383
     * @param $table
384
     * @param $user
385
     *
386
     * @return Entry
387
     */
388
    public function getPreferences($table, $user);
389
390
    /**
391
     * Deletes a bookmark
392
     *
393
     * @param $id
394
     * @param bool $hard
395
     *
396
     * @return Entry
397
     */
398
    public function deleteBookmark($id, $hard = false);
399
400
    /**
401
     * Deletes a column
402
     *
403
     * @param $name
404
     * @param $table
405
     *
406
     * @return Entry
407
     */
408
    public function deleteColumn($name, $table);
409
410
    /**
411
     * Deletes a group
412
     *
413
     * @param $id
414
     * @param bool $hard
415
     *
416
     * @return Entry
417
     */
418
    public function deleteGroup($id, $hard = false);
419
420
    /**
421
     * Deletes a table
422
     *
423
     * @param $name
424
     *
425
     * @return Entry
426
     */
427
    public function deleteTable($name);
428
429
    /**
430
     * Gets activity records
431
     *
432
     * @param array $params
433
     *
434
     * @return Entry
435
     */
436
    public function getActivity(array $params = []);
437
438
    /**
439
     * Gets a random alphanumeric string
440
     *
441
     * @param array $options
442
     *
443
     * @return Entry
444
     */
445
    public function getRandom(array $options = []);
446
447
    /**
448
     * Gets a hashed value from the given string
449
     *
450
     * @param string $string
451
     * @param array $options
452
     *
453
     * @return Entry
454
     */
455
    public function getHash($string, array $options = []);
456
}
457