1	<?php
2
3	/**
4	* This program is free software; you can redistribute it and/or
5	* modify it under the terms of the GNU General Public License
6	* as published by the Free Software Foundation; under version 2
7	* of the License (non-upgradable).
8	*
9	* This program is distributed in the hope that it will be useful,
10	* but WITHOUT ANY WARRANTY; without even the implied warranty of
11	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12	* GNU General Public License for more details.
13	*
14	* You should have received a copy of the GNU General Public License
15	* along with this program; if not, write to the Free Software
16	* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
17	*
18	* Copyright (c) 2017 (original work) Open Assessment Technologies SA;
19	*
20	*/
21
22	namespace oat\ltiDeliveryProvider\model\execution;
23
24	use oat\taoDelivery\model\execution\Delete\DeliveryExecutionDelete;
25	use oat\taoDelivery\model\execution\DeliveryExecution;
26	use oat\taoDelivery\models\classes\execution\event\DeliveryExecutionState;
27
28	/**
29	* Interface LtiDeliveryExecutionService
30	*
31	* Service is used to make lti specific delivery executions actions
32	*
33	* @package oat\ltiDeliveryProvider\model\execution
34	*/
35	interface LtiDeliveryExecutionService extends DeliveryExecutionDelete
36	{
37	public const SERVICE_ID = 'ltiDeliveryProvider/LtiDeliveryExecution';
38
39	/**
40	* Get delivery executions linked to user and $link resource
41	*
42	* @param \core_kernel_classes_Resource $delivery
43	* @param \core_kernel_classes_Resource $link
44	* @param string $userId
45	* @return DeliveryExecution[]
46	*/
47	public function getLinkedDeliveryExecutions(
48	\core_kernel_classes_Resource $delivery,
49	\core_kernel_classes_Resource $link,
50	$userId
51	);
52
53	/**
54	* Get delivery active execution by delivery for current user
55	* @param \core_kernel_classes_Resource $delivery
56	* @return mixed
57	*/
58	public function getActiveDeliveryExecution(\core_kernel_classes_Resource $delivery);
59
60	/**
61	* Listener of changing delivery execution state event
62	* @param DeliveryExecutionState $event
63	* @return mixed
64	*/
65	public function executionStateChanged(DeliveryExecutionState $event);
66
67	/**
68	* create a LTIDeliveryExecutionLink from parameters
69	* @param string $userUri
70	* @param string $link
71	* @param string $deliveryExecutionUri
72	* @return LTIDeliveryExecutionLink
73	*/
74	public function createDeliveryExecutionLink($userUri, $link, $deliveryExecutionUri);
75	}