urtware / doc / activitydiagrams / service / urtServiceAcquireRequest.uml @ 2d315870
History | View | Annotate | Download (1.93 KB)
1 | 7491c395 | Thomas Schöpping | /' |
---|---|---|---|
2 | µRtWare is a lightweight publish/subscribe middleware for real-time |
||
3 | applications. It was developed as part of the software habitat for the |
||
4 | Autonomous Mini Robot [1] (AMiRo) but can be used for other purposes as well. |
||
5 | |||
6 | Copyright (C) 2018..2020 Thomas Schöpping et al. |
||
7 | |||
8 | This program is free software: you can redistribute it and/or modify |
||
9 | it under the terms of the GNU General Public License as published by |
||
10 | the Free Software Foundation, either version 3 of the License, or |
||
11 | (at your option) any later version. |
||
12 | |||
13 | This program is distributed in the hope that it will be useful, |
||
14 | but WITHOUT ANY WARRANTY; without even the implied warranty of |
||
15 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
||
16 | GNU General Public License for more details. |
||
17 | |||
18 | You should have received a copy of the GNU General Public License |
||
19 | along with this program. If not, see <http://www.gnu.org/licenses/>. |
||
20 | '/ |
||
21 | |||
22 | /'### INTRO ##################################################################'/ |
||
23 | |||
24 | @startuml |
||
25 | |||
26 | 2d315870 | Thomas Schöpping | title **µRtWare**\nurtServiceAcquireRequest()\n |
27 | 7491c395 | Thomas Schöpping | |
28 | ee83a495 | Thomas Schöpping | /'### PARAMETERS & RETURN ####################################################'/ |
29 | 7491c395 | Thomas Schöpping | |
30 | note |
||
31 | ee83a495 | Thomas Schöpping | -- **service** : urt_service_t* -- |
32 | 2d315870 | Thomas Schöpping | The service that shall acquire the request. |
33 | Must not be ""NULL"". |
||
34 | -- **request** : urt_baserequest_t* -- |
||
35 | The request to be acquired. |
||
36 | 7491c395 | Thomas Schöpping | Must not be ""NULL"". |
37 | ee83a495 | Thomas Schöpping | ==== |
38 | -- **return** : urt_status_t -- |
||
39 | 2d315870 | Thomas Schöpping | Returns ""URT_STATUS_OK"" in case of success. |
40 | Returns ""URT_STATUS_REQUEST_BADOWNER"" if the service has lost ownership of the request. |
||
41 | ee83a495 | Thomas Schöpping | endnote |
42 | 7491c395 | Thomas Schöpping | |
43 | /'### PROCEDURE ##############################################################'/ |
||
44 | |||
45 | ee83a495 | Thomas Schöpping | start |
46 | 2d315870 | Thomas Schöpping | :lock request; |
47 | 7491c395 | Thomas Schöpping | note |
48 | 2d315870 | Thomas Schöpping | Execution is blocked until mutex is locked. |
49 | ee83a495 | Thomas Schöpping | endnote |
50 | 2d315870 | Thomas Schöpping | if (This service is owner of the request?) then (yes) |
51 | stop |
||
52 | note |
||
53 | Returns ""URT_STATUS_OK"". |
||
54 | endnote |
||
55 | else (no) |
||
56 | :unlock request; |
||
57 | stop |
||
58 | note |
||
59 | Returns ""URT_STATUS_REQUEST_BADOWNER"". |
||
60 | endnote |
||
61 | endif |
||
62 | 7491c395 | Thomas Schöpping | |
63 | /'### OUTRO ##################################################################'/ |
||
64 | |||
65 | @enduml |