blumia/dde-application-manager
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: finish dbus service: job/jobManager

Browse Source 
Log:
This commit is contained in:
heyuming
2023-07-18 15:55:29 +08:00
committed by Comix
parent 3a278bec79
commit d288752fb3
9 changed files with 72 additions and 41 deletions
Download Patch File Download Diff File Expand all files Collapse all files

11
api/dbus/org.desktopspec.JobManager1.Job.xml
View File

@ -7,7 +7,7 @@
value="Value of `Status` is one of
`started`, `running`, `finished`,
`suspending`, `suspend`,
`canceled` and `failed`."
`canceled`."
/>
</property>
@ -22,13 +22,13 @@
will be emitted."
/>
</method>
<method name="Pause">
<method name="Suspend">
<annotation
name="org.freedesktop.DBus.Description"
value="Success call to this method will
change the Status of this Job to `pausing`.
change the Status of this Job to `suspending`.
Then after some time this method call return,
Status will change to `paused`."
Status will change to `suspend`."
/>
</method>
@ -36,8 +36,7 @@
<annotation
name="org.freedesktop.DBus.Description"
value="Success call to this method will
change the Status of this Job to `resuming`.
Resuming Jobs will be queued along with pending Jobs.
Resumes the asynchronous computation.
Then after some time this method call return,
Status will change to `working`."
/>

9
api/dbus/org.desktopspec.JobManager1.xml
View File

@ -26,17 +26,16 @@
<signal name="JobRemoved">
<arg type="o" name="job" />
<arg type="s" name="status" />
<arg type="s" name="message" />
<arg type="v" name="result" />
<arg type="av" name="result" />
<annotation
name="org.freedesktop.DBus.Description"
value="This signal report the job remove event.
`status` is the `status` porperty of that Job
when it got removed.
`message` is the human readable message
for caller to report to user or just simple logging.
`result` is the result this job produce if it success.
`result` is the result which produce by this job,
and user needs to traverse the list to determine
if the values are valid or not.
Method that return an object of Job
should always have document
about the type and meaning of the `result`."