@@ -40,7 +40,7 @@ |
||
40 | 40 | |
41 | 41 | /** |
42 | 42 | * @param CommandInterface|CreateRegistrationCommand $command |
43 | - * @return mixed |
|
43 | + * @return \EE_Registration |
|
44 | 44 | * @throws OutOfRangeException |
45 | 45 | * @throws UnexpectedEntityException |
46 | 46 | * @throws EE_Error |
@@ -21,42 +21,42 @@ |
||
21 | 21 | class CreateRegistrationCommandHandler extends CommandHandler |
22 | 22 | { |
23 | 23 | |
24 | - /** |
|
25 | - * @var CreateRegistrationService $registration_service |
|
26 | - */ |
|
27 | - private $registration_service; |
|
28 | - |
|
29 | - |
|
30 | - /** |
|
31 | - * Command constructor |
|
32 | - * |
|
33 | - * @param CreateRegistrationService $registration_service |
|
34 | - */ |
|
35 | - public function __construct(CreateRegistrationService $registration_service) |
|
36 | - { |
|
37 | - $this->registration_service = $registration_service; |
|
38 | - } |
|
39 | - |
|
40 | - |
|
41 | - /** |
|
42 | - * @param CommandInterface|CreateRegistrationCommand $command |
|
43 | - * @return mixed |
|
44 | - * @throws OutOfRangeException |
|
45 | - * @throws UnexpectedEntityException |
|
46 | - * @throws EE_Error |
|
47 | - * @throws InvalidEntityException |
|
48 | - */ |
|
49 | - public function handle(CommandInterface $command) |
|
50 | - { |
|
51 | - // now create a new registration for the ticket |
|
52 | - return $this->registration_service->create( |
|
53 | - $command->ticket()->get_related_event(), |
|
54 | - $command->transaction(), |
|
55 | - $command->ticket(), |
|
56 | - $command->ticketLineItem(), |
|
57 | - $command->regCount(), |
|
58 | - $command->regGroupSize(), |
|
59 | - $command->regStatus() |
|
60 | - ); |
|
61 | - } |
|
24 | + /** |
|
25 | + * @var CreateRegistrationService $registration_service |
|
26 | + */ |
|
27 | + private $registration_service; |
|
28 | + |
|
29 | + |
|
30 | + /** |
|
31 | + * Command constructor |
|
32 | + * |
|
33 | + * @param CreateRegistrationService $registration_service |
|
34 | + */ |
|
35 | + public function __construct(CreateRegistrationService $registration_service) |
|
36 | + { |
|
37 | + $this->registration_service = $registration_service; |
|
38 | + } |
|
39 | + |
|
40 | + |
|
41 | + /** |
|
42 | + * @param CommandInterface|CreateRegistrationCommand $command |
|
43 | + * @return mixed |
|
44 | + * @throws OutOfRangeException |
|
45 | + * @throws UnexpectedEntityException |
|
46 | + * @throws EE_Error |
|
47 | + * @throws InvalidEntityException |
|
48 | + */ |
|
49 | + public function handle(CommandInterface $command) |
|
50 | + { |
|
51 | + // now create a new registration for the ticket |
|
52 | + return $this->registration_service->create( |
|
53 | + $command->ticket()->get_related_event(), |
|
54 | + $command->transaction(), |
|
55 | + $command->ticket(), |
|
56 | + $command->ticketLineItem(), |
|
57 | + $command->regCount(), |
|
58 | + $command->regGroupSize(), |
|
59 | + $command->regStatus() |
|
60 | + ); |
|
61 | + } |
|
62 | 62 | } |
@@ -28,7 +28,7 @@ |
||
28 | 28 | |
29 | 29 | /** |
30 | 30 | * @param CommandInterface|CreateTransactionCommand $command |
31 | - * @return mixed |
|
31 | + * @return EE_Transaction |
|
32 | 32 | * @throws EE_Error |
33 | 33 | * @throws InvalidEntityException |
34 | 34 | * @throws InvalidDataTypeException |
@@ -26,43 +26,43 @@ |
||
26 | 26 | class CreateTransactionCommandHandler extends CommandHandler |
27 | 27 | { |
28 | 28 | |
29 | - /** |
|
30 | - * @param CommandInterface|CreateTransactionCommand $command |
|
31 | - * @return mixed |
|
32 | - * @throws EE_Error |
|
33 | - * @throws InvalidEntityException |
|
34 | - * @throws InvalidDataTypeException |
|
35 | - * @throws InvalidInterfaceException |
|
36 | - * @throws InvalidArgumentException |
|
37 | - * @throws ReflectionException |
|
38 | - * @throws RuntimeException |
|
39 | - */ |
|
40 | - public function handle(CommandInterface $command) |
|
41 | - { |
|
42 | - $transaction_details = $command->transactionDetails(); |
|
43 | - $cart_total = null; |
|
44 | - if ($command->checkout() instanceof EE_Checkout) { |
|
45 | - // ensure cart totals have been calculated |
|
46 | - $command->checkout()->cart->get_grand_total()->recalculate_total_including_taxes(); |
|
47 | - // grab the cart grand total |
|
48 | - $cart_total = $command->checkout()->cart->get_cart_grand_total(); |
|
49 | - $transaction_details['TXN_reg_steps'] = $command->checkout()->initialize_txn_reg_steps_array(); |
|
50 | - $transaction_details['TXN_total'] = $cart_total > 0 ? $cart_total : 0; |
|
51 | - } |
|
52 | - // create new TXN and save it so it has an ID |
|
53 | - $transaction = EE_Transaction::new_instance($transaction_details); |
|
54 | - if (! $transaction instanceof EE_Transaction) { |
|
55 | - throw new InvalidEntityException(get_class($transaction), 'EE_Transaction'); |
|
56 | - } |
|
57 | - $transaction->save(); |
|
58 | - // ensure grand total line item created |
|
59 | - $cart_total = $cart_total instanceof EE_Line_Item |
|
60 | - ? $cart_total |
|
61 | - : EEH_Line_Item::create_total_line_item($transaction); |
|
62 | - if (! $cart_total instanceof EE_Line_Item) { |
|
63 | - throw new InvalidEntityException(get_class($cart_total), 'EE_Line_Item'); |
|
64 | - } |
|
65 | - $cart_total->save_this_and_descendants_to_txn($transaction->ID()); |
|
66 | - return $transaction; |
|
67 | - } |
|
29 | + /** |
|
30 | + * @param CommandInterface|CreateTransactionCommand $command |
|
31 | + * @return mixed |
|
32 | + * @throws EE_Error |
|
33 | + * @throws InvalidEntityException |
|
34 | + * @throws InvalidDataTypeException |
|
35 | + * @throws InvalidInterfaceException |
|
36 | + * @throws InvalidArgumentException |
|
37 | + * @throws ReflectionException |
|
38 | + * @throws RuntimeException |
|
39 | + */ |
|
40 | + public function handle(CommandInterface $command) |
|
41 | + { |
|
42 | + $transaction_details = $command->transactionDetails(); |
|
43 | + $cart_total = null; |
|
44 | + if ($command->checkout() instanceof EE_Checkout) { |
|
45 | + // ensure cart totals have been calculated |
|
46 | + $command->checkout()->cart->get_grand_total()->recalculate_total_including_taxes(); |
|
47 | + // grab the cart grand total |
|
48 | + $cart_total = $command->checkout()->cart->get_cart_grand_total(); |
|
49 | + $transaction_details['TXN_reg_steps'] = $command->checkout()->initialize_txn_reg_steps_array(); |
|
50 | + $transaction_details['TXN_total'] = $cart_total > 0 ? $cart_total : 0; |
|
51 | + } |
|
52 | + // create new TXN and save it so it has an ID |
|
53 | + $transaction = EE_Transaction::new_instance($transaction_details); |
|
54 | + if (! $transaction instanceof EE_Transaction) { |
|
55 | + throw new InvalidEntityException(get_class($transaction), 'EE_Transaction'); |
|
56 | + } |
|
57 | + $transaction->save(); |
|
58 | + // ensure grand total line item created |
|
59 | + $cart_total = $cart_total instanceof EE_Line_Item |
|
60 | + ? $cart_total |
|
61 | + : EEH_Line_Item::create_total_line_item($transaction); |
|
62 | + if (! $cart_total instanceof EE_Line_Item) { |
|
63 | + throw new InvalidEntityException(get_class($cart_total), 'EE_Line_Item'); |
|
64 | + } |
|
65 | + $cart_total->save_this_and_descendants_to_txn($transaction->ID()); |
|
66 | + return $transaction; |
|
67 | + } |
|
68 | 68 | } |
@@ -51,7 +51,7 @@ discard block |
||
51 | 51 | } |
52 | 52 | // create new TXN and save it so it has an ID |
53 | 53 | $transaction = EE_Transaction::new_instance($transaction_details); |
54 | - if (! $transaction instanceof EE_Transaction) { |
|
54 | + if ( ! $transaction instanceof EE_Transaction) { |
|
55 | 55 | throw new InvalidEntityException(get_class($transaction), 'EE_Transaction'); |
56 | 56 | } |
57 | 57 | $transaction->save(); |
@@ -59,7 +59,7 @@ discard block |
||
59 | 59 | $cart_total = $cart_total instanceof EE_Line_Item |
60 | 60 | ? $cart_total |
61 | 61 | : EEH_Line_Item::create_total_line_item($transaction); |
62 | - if (! $cart_total instanceof EE_Line_Item) { |
|
62 | + if ( ! $cart_total instanceof EE_Line_Item) { |
|
63 | 63 | throw new InvalidEntityException(get_class($cart_total), 'EE_Line_Item'); |
64 | 64 | } |
65 | 65 | $cart_total->save_this_and_descendants_to_txn($transaction->ID()); |
@@ -16,33 +16,33 @@ |
||
16 | 16 | class InvalidEntityException extends InvalidArgumentException |
17 | 17 | { |
18 | 18 | |
19 | - /** |
|
20 | - * InvalidEntityException constructor. |
|
21 | - * |
|
22 | - * @param mixed $actual the actual object (or thing) we got |
|
23 | - * @param string $expected classname of the entity we wanted |
|
24 | - * @param string $message |
|
25 | - * @param int $code |
|
26 | - * @param Exception $previous |
|
27 | - */ |
|
28 | - public function __construct($actual, $expected, $message = '', $code = 0, Exception $previous = null) |
|
29 | - { |
|
30 | - if (empty($message)) { |
|
31 | - ob_start(); |
|
32 | - var_dump($actual); |
|
33 | - $object = ob_get_clean(); |
|
34 | - $message = sprintf( |
|
35 | - __( |
|
36 | - 'The supplied entity is an instance of "%1$s", but an instance of "%2$s" was expected. Object: %3$s', |
|
37 | - 'event_espresso' |
|
38 | - ), |
|
39 | - is_object($actual) |
|
40 | - ? get_class($actual) |
|
41 | - : gettype($actual), |
|
42 | - $expected, |
|
43 | - $object |
|
44 | - ); |
|
45 | - } |
|
46 | - parent::__construct($message, $code, $previous); |
|
47 | - } |
|
19 | + /** |
|
20 | + * InvalidEntityException constructor. |
|
21 | + * |
|
22 | + * @param mixed $actual the actual object (or thing) we got |
|
23 | + * @param string $expected classname of the entity we wanted |
|
24 | + * @param string $message |
|
25 | + * @param int $code |
|
26 | + * @param Exception $previous |
|
27 | + */ |
|
28 | + public function __construct($actual, $expected, $message = '', $code = 0, Exception $previous = null) |
|
29 | + { |
|
30 | + if (empty($message)) { |
|
31 | + ob_start(); |
|
32 | + var_dump($actual); |
|
33 | + $object = ob_get_clean(); |
|
34 | + $message = sprintf( |
|
35 | + __( |
|
36 | + 'The supplied entity is an instance of "%1$s", but an instance of "%2$s" was expected. Object: %3$s', |
|
37 | + 'event_espresso' |
|
38 | + ), |
|
39 | + is_object($actual) |
|
40 | + ? get_class($actual) |
|
41 | + : gettype($actual), |
|
42 | + $expected, |
|
43 | + $object |
|
44 | + ); |
|
45 | + } |
|
46 | + parent::__construct($message, $code, $previous); |
|
47 | + } |
|
48 | 48 | } |
@@ -14,26 +14,26 @@ |
||
14 | 14 | */ |
15 | 15 | abstract class CommandHandler implements CommandHandlerInterface |
16 | 16 | { |
17 | - /** |
|
18 | - * Verifies the Command class matches the Handler class |
|
19 | - * by simply removing "Handler" from the Command class and then comparing. |
|
20 | - * IF the Command Handler has been changed via CommandHandlerManager::addCommandHandler, |
|
21 | - * or via the filter in CommandHandlerManager::getCommandHandler(), |
|
22 | - * then this method MUST be overridden in the new Command Handler class. |
|
23 | - * PLZ NOTE: that it also needs to return itself ($this) |
|
24 | - * because the CommandBus utilizes method chaining. |
|
25 | - * |
|
26 | - * @param CommandInterface $command |
|
27 | - * @return CommandHandler |
|
28 | - * @throws InvalidEntityException |
|
29 | - * @since $VID:$ |
|
30 | - */ |
|
31 | - public function verify(CommandInterface $command) |
|
32 | - { |
|
33 | - $expected = str_replace('CommandHandler', 'Command', get_class($this)); |
|
34 | - if (! $command instanceof $expected) { |
|
35 | - throw new InvalidEntityException($command, $expected); |
|
36 | - } |
|
37 | - return $this; |
|
38 | - } |
|
17 | + /** |
|
18 | + * Verifies the Command class matches the Handler class |
|
19 | + * by simply removing "Handler" from the Command class and then comparing. |
|
20 | + * IF the Command Handler has been changed via CommandHandlerManager::addCommandHandler, |
|
21 | + * or via the filter in CommandHandlerManager::getCommandHandler(), |
|
22 | + * then this method MUST be overridden in the new Command Handler class. |
|
23 | + * PLZ NOTE: that it also needs to return itself ($this) |
|
24 | + * because the CommandBus utilizes method chaining. |
|
25 | + * |
|
26 | + * @param CommandInterface $command |
|
27 | + * @return CommandHandler |
|
28 | + * @throws InvalidEntityException |
|
29 | + * @since $VID:$ |
|
30 | + */ |
|
31 | + public function verify(CommandInterface $command) |
|
32 | + { |
|
33 | + $expected = str_replace('CommandHandler', 'Command', get_class($this)); |
|
34 | + if (! $command instanceof $expected) { |
|
35 | + throw new InvalidEntityException($command, $expected); |
|
36 | + } |
|
37 | + return $this; |
|
38 | + } |
|
39 | 39 | } |
@@ -31,7 +31,7 @@ |
||
31 | 31 | public function verify(CommandInterface $command) |
32 | 32 | { |
33 | 33 | $expected = str_replace('CommandHandler', 'Command', get_class($this)); |
34 | - if (! $command instanceof $expected) { |
|
34 | + if ( ! $command instanceof $expected) { |
|
35 | 35 | throw new InvalidEntityException($command, $expected); |
36 | 36 | } |
37 | 37 | return $this; |
@@ -8,24 +8,24 @@ |
||
8 | 8 | */ |
9 | 9 | interface CommandHandlerInterface |
10 | 10 | { |
11 | - /** |
|
12 | - * verifies that the supplied command is the correct class for the handler. |
|
13 | - * |
|
14 | - * !!! IMPORTANT !!! |
|
15 | - * Must return $this (ie: the handler itself) |
|
16 | - * as the CommandBus utilizes method chaining |
|
17 | - * |
|
18 | - * @param CommandInterface $command |
|
19 | - * @return CommandHandlerInterface |
|
20 | - * @since $VID:$ |
|
21 | - */ |
|
22 | - public function verify(CommandInterface $command); |
|
11 | + /** |
|
12 | + * verifies that the supplied command is the correct class for the handler. |
|
13 | + * |
|
14 | + * !!! IMPORTANT !!! |
|
15 | + * Must return $this (ie: the handler itself) |
|
16 | + * as the CommandBus utilizes method chaining |
|
17 | + * |
|
18 | + * @param CommandInterface $command |
|
19 | + * @return CommandHandlerInterface |
|
20 | + * @since $VID:$ |
|
21 | + */ |
|
22 | + public function verify(CommandInterface $command); |
|
23 | 23 | |
24 | - /** |
|
25 | - * Performs the command handler's logic. |
|
26 | - * |
|
27 | - * @param CommandInterface $command |
|
28 | - * @return mixed |
|
29 | - */ |
|
30 | - public function handle(CommandInterface $command); |
|
24 | + /** |
|
25 | + * Performs the command handler's logic. |
|
26 | + * |
|
27 | + * @param CommandInterface $command |
|
28 | + * @return mixed |
|
29 | + */ |
|
30 | + public function handle(CommandInterface $command); |
|
31 | 31 | } |
@@ -10,26 +10,26 @@ |
||
10 | 10 | interface CommandHandlerManagerInterface |
11 | 11 | { |
12 | 12 | |
13 | - /** |
|
14 | - * !!! IMPORTANT !!! |
|
15 | - * If overriding the default CommandHandler for a Command, |
|
16 | - * be sure to also override CommandHandler::verify(), |
|
17 | - * or else an Exception will be thrown when the CommandBus |
|
18 | - * attempts to verify that the incoming Command matches the Handler |
|
19 | - * |
|
20 | - * @param CommandHandlerInterface $command_handler |
|
21 | - * @param string $fqcn_for_command Fully Qualified ClassName for Command |
|
22 | - * @return void |
|
23 | - * @throws InvalidCommandHandlerException |
|
24 | - */ |
|
25 | - public function addCommandHandler(CommandHandlerInterface $command_handler, $fqcn_for_command = ''); |
|
13 | + /** |
|
14 | + * !!! IMPORTANT !!! |
|
15 | + * If overriding the default CommandHandler for a Command, |
|
16 | + * be sure to also override CommandHandler::verify(), |
|
17 | + * or else an Exception will be thrown when the CommandBus |
|
18 | + * attempts to verify that the incoming Command matches the Handler |
|
19 | + * |
|
20 | + * @param CommandHandlerInterface $command_handler |
|
21 | + * @param string $fqcn_for_command Fully Qualified ClassName for Command |
|
22 | + * @return void |
|
23 | + * @throws InvalidCommandHandlerException |
|
24 | + */ |
|
25 | + public function addCommandHandler(CommandHandlerInterface $command_handler, $fqcn_for_command = ''); |
|
26 | 26 | |
27 | 27 | |
28 | 28 | |
29 | - /** |
|
30 | - * @param CommandInterface $command |
|
31 | - * @param CommandBusInterface $command_bus |
|
32 | - * @return mixed |
|
33 | - */ |
|
34 | - public function getCommandHandler(CommandInterface $command, CommandBusInterface $command_bus = null); |
|
29 | + /** |
|
30 | + * @param CommandInterface $command |
|
31 | + * @param CommandBusInterface $command_bus |
|
32 | + * @return mixed |
|
33 | + */ |
|
34 | + public function getCommandHandler(CommandInterface $command, CommandBusInterface $command_bus = null); |
|
35 | 35 | } |
@@ -18,83 +18,83 @@ discard block |
||
18 | 18 | class CommandHandlerManager implements CommandHandlerManagerInterface |
19 | 19 | { |
20 | 20 | |
21 | - /** |
|
22 | - * @var CommandHandlerInterface[] $command_handlers |
|
23 | - */ |
|
24 | - protected $command_handlers; |
|
21 | + /** |
|
22 | + * @var CommandHandlerInterface[] $command_handlers |
|
23 | + */ |
|
24 | + protected $command_handlers; |
|
25 | 25 | |
26 | - /** |
|
27 | - * @type LoaderInterface $loader |
|
28 | - */ |
|
29 | - private $loader; |
|
26 | + /** |
|
27 | + * @type LoaderInterface $loader |
|
28 | + */ |
|
29 | + private $loader; |
|
30 | 30 | |
31 | 31 | |
32 | - /** |
|
33 | - * CommandHandlerManager constructor |
|
34 | - * |
|
35 | - * @param LoaderInterface $loader |
|
36 | - */ |
|
37 | - public function __construct(LoaderInterface $loader) |
|
38 | - { |
|
39 | - $this->loader = $loader; |
|
40 | - } |
|
32 | + /** |
|
33 | + * CommandHandlerManager constructor |
|
34 | + * |
|
35 | + * @param LoaderInterface $loader |
|
36 | + */ |
|
37 | + public function __construct(LoaderInterface $loader) |
|
38 | + { |
|
39 | + $this->loader = $loader; |
|
40 | + } |
|
41 | 41 | |
42 | 42 | |
43 | - /** |
|
44 | - * By default, Commands and CommandHandlers would normally |
|
45 | - * reside in the same folder under the same namespace, |
|
46 | - * and the names of the two classes would only differ in that |
|
47 | - * one ends in "Command" and the other ends in "CommandHandler". |
|
48 | - * However, if you wanted to utilize a CommandHandler from somewhere else, |
|
49 | - * then this method allows you to add that CommandHandler and specify the FQCN |
|
50 | - * (Fully Qualified ClassName) for the Command class that it should be used for. |
|
51 | - * For example: |
|
52 | - * by default the "Vendor\some\namespace\DoSomethingCommand" |
|
53 | - * would resolve to using "Vendor\some\namespace\DoSomethingCommandHandler" |
|
54 | - * but if you wanted to instead process that commend using: |
|
55 | - * "Vendor\a\totally\different\namespace\for\DoSomethingCommandHandler" |
|
56 | - * then the following code: |
|
57 | - * $CommandHandlerManager = $this->loader->getShared( 'CommandHandlerManagerInterface' ); |
|
58 | - * $CommandHandlerManager->addCommandHandler( |
|
59 | - * new Vendor\a\totally\different\namespace\for\DoSomethingCommandHandler(), |
|
60 | - * 'Vendor\some\namespace\DoSomethingCommand' |
|
61 | - * ); |
|
62 | - * would result in the alternate CommandHandler being used to process that Command |
|
63 | - * |
|
64 | - * !!! IMPORTANT !!! |
|
65 | - * If overriding the default CommandHandler for a Command, |
|
66 | - * be sure to also override CommandHandler::verify(), |
|
67 | - * or else an Exception will be thrown when the CommandBus |
|
68 | - * attempts to verify that the incoming Command matches the Handler |
|
69 | - * |
|
70 | - * @param CommandHandlerInterface $command_handler |
|
71 | - * @param string $fqcn_for_command Fully Qualified ClassName for Command |
|
72 | - * @return void |
|
73 | - * @throws InvalidCommandHandlerException |
|
74 | - */ |
|
75 | - public function addCommandHandler(CommandHandlerInterface $command_handler, $fqcn_for_command = '') |
|
76 | - { |
|
77 | - $command = ! empty($fqcn_for_command) |
|
78 | - ? $fqcn_for_command |
|
79 | - : str_replace('CommandHandler', 'Command', get_class($command_handler)); |
|
80 | - if (empty($command)) { |
|
81 | - throw new InvalidCommandHandlerException($command); |
|
82 | - } |
|
83 | - $this->command_handlers[ $command ] = $command_handler; |
|
84 | - } |
|
43 | + /** |
|
44 | + * By default, Commands and CommandHandlers would normally |
|
45 | + * reside in the same folder under the same namespace, |
|
46 | + * and the names of the two classes would only differ in that |
|
47 | + * one ends in "Command" and the other ends in "CommandHandler". |
|
48 | + * However, if you wanted to utilize a CommandHandler from somewhere else, |
|
49 | + * then this method allows you to add that CommandHandler and specify the FQCN |
|
50 | + * (Fully Qualified ClassName) for the Command class that it should be used for. |
|
51 | + * For example: |
|
52 | + * by default the "Vendor\some\namespace\DoSomethingCommand" |
|
53 | + * would resolve to using "Vendor\some\namespace\DoSomethingCommandHandler" |
|
54 | + * but if you wanted to instead process that commend using: |
|
55 | + * "Vendor\a\totally\different\namespace\for\DoSomethingCommandHandler" |
|
56 | + * then the following code: |
|
57 | + * $CommandHandlerManager = $this->loader->getShared( 'CommandHandlerManagerInterface' ); |
|
58 | + * $CommandHandlerManager->addCommandHandler( |
|
59 | + * new Vendor\a\totally\different\namespace\for\DoSomethingCommandHandler(), |
|
60 | + * 'Vendor\some\namespace\DoSomethingCommand' |
|
61 | + * ); |
|
62 | + * would result in the alternate CommandHandler being used to process that Command |
|
63 | + * |
|
64 | + * !!! IMPORTANT !!! |
|
65 | + * If overriding the default CommandHandler for a Command, |
|
66 | + * be sure to also override CommandHandler::verify(), |
|
67 | + * or else an Exception will be thrown when the CommandBus |
|
68 | + * attempts to verify that the incoming Command matches the Handler |
|
69 | + * |
|
70 | + * @param CommandHandlerInterface $command_handler |
|
71 | + * @param string $fqcn_for_command Fully Qualified ClassName for Command |
|
72 | + * @return void |
|
73 | + * @throws InvalidCommandHandlerException |
|
74 | + */ |
|
75 | + public function addCommandHandler(CommandHandlerInterface $command_handler, $fqcn_for_command = '') |
|
76 | + { |
|
77 | + $command = ! empty($fqcn_for_command) |
|
78 | + ? $fqcn_for_command |
|
79 | + : str_replace('CommandHandler', 'Command', get_class($command_handler)); |
|
80 | + if (empty($command)) { |
|
81 | + throw new InvalidCommandHandlerException($command); |
|
82 | + } |
|
83 | + $this->command_handlers[ $command ] = $command_handler; |
|
84 | + } |
|
85 | 85 | |
86 | 86 | |
87 | - /** |
|
88 | - * @param CommandInterface $command |
|
89 | - * @param CommandBusInterface $command_bus |
|
90 | - * @return mixed |
|
91 | - * @throws DomainException |
|
92 | - * @throws CommandHandlerNotFoundException |
|
93 | - */ |
|
94 | - public function getCommandHandler(CommandInterface $command, CommandBusInterface $command_bus = null) |
|
95 | - { |
|
96 | - $command_name = get_class($command); |
|
97 | - /* |
|
87 | + /** |
|
88 | + * @param CommandInterface $command |
|
89 | + * @param CommandBusInterface $command_bus |
|
90 | + * @return mixed |
|
91 | + * @throws DomainException |
|
92 | + * @throws CommandHandlerNotFoundException |
|
93 | + */ |
|
94 | + public function getCommandHandler(CommandInterface $command, CommandBusInterface $command_bus = null) |
|
95 | + { |
|
96 | + $command_name = get_class($command); |
|
97 | + /* |
|
98 | 98 | * Filters the Fully Qualified Class Name for the Command Handler |
99 | 99 | * that will be used to handle the incoming Command |
100 | 100 | * |
@@ -107,34 +107,34 @@ discard block |
||
107 | 107 | * @param string "CommandHandler::class" Fully Qualified Class Name for the Command Handler |
108 | 108 | * @param CommandInterface $command the actual Command instance |
109 | 109 | */ |
110 | - $command_handler = apply_filters( |
|
111 | - 'FHEE__EventEspresso_core_services_commands_CommandHandlerManager__getCommandHandler__command_handler', |
|
112 | - str_replace('Command', 'CommandHandler', $command_name), |
|
113 | - $command |
|
114 | - ); |
|
115 | - $handler = null; |
|
116 | - // has a command handler already been set for this class ? |
|
117 | - // if not, can we find one via the FQCN ? |
|
118 | - if (isset($this->command_handlers[ $command_name ])) { |
|
119 | - $handler = $this->command_handlers[ $command_name ]; |
|
120 | - } elseif (class_exists($command_handler)) { |
|
121 | - $handler = $this->loader->getShared($command_handler); |
|
122 | - } |
|
123 | - // if Handler requires an instance of the CommandBus, but that has not yet been set |
|
124 | - if ($handler instanceof CompositeCommandHandler && ! $handler->commandBus() instanceof CommandBusInterface) { |
|
125 | - if (! $command_bus instanceof CommandBusInterface) { |
|
126 | - throw new DomainException( |
|
127 | - esc_html__( |
|
128 | - 'CompositeCommandHandler classes require an instance of the CommandBus.', |
|
129 | - 'event_espresso' |
|
130 | - ) |
|
131 | - ); |
|
132 | - } |
|
133 | - $handler->setCommandBus($command_bus); |
|
134 | - } |
|
135 | - if ($handler instanceof CommandHandlerInterface) { |
|
136 | - return $handler; |
|
137 | - } |
|
138 | - throw new CommandHandlerNotFoundException($command_handler); |
|
139 | - } |
|
110 | + $command_handler = apply_filters( |
|
111 | + 'FHEE__EventEspresso_core_services_commands_CommandHandlerManager__getCommandHandler__command_handler', |
|
112 | + str_replace('Command', 'CommandHandler', $command_name), |
|
113 | + $command |
|
114 | + ); |
|
115 | + $handler = null; |
|
116 | + // has a command handler already been set for this class ? |
|
117 | + // if not, can we find one via the FQCN ? |
|
118 | + if (isset($this->command_handlers[ $command_name ])) { |
|
119 | + $handler = $this->command_handlers[ $command_name ]; |
|
120 | + } elseif (class_exists($command_handler)) { |
|
121 | + $handler = $this->loader->getShared($command_handler); |
|
122 | + } |
|
123 | + // if Handler requires an instance of the CommandBus, but that has not yet been set |
|
124 | + if ($handler instanceof CompositeCommandHandler && ! $handler->commandBus() instanceof CommandBusInterface) { |
|
125 | + if (! $command_bus instanceof CommandBusInterface) { |
|
126 | + throw new DomainException( |
|
127 | + esc_html__( |
|
128 | + 'CompositeCommandHandler classes require an instance of the CommandBus.', |
|
129 | + 'event_espresso' |
|
130 | + ) |
|
131 | + ); |
|
132 | + } |
|
133 | + $handler->setCommandBus($command_bus); |
|
134 | + } |
|
135 | + if ($handler instanceof CommandHandlerInterface) { |
|
136 | + return $handler; |
|
137 | + } |
|
138 | + throw new CommandHandlerNotFoundException($command_handler); |
|
139 | + } |
|
140 | 140 | } |
@@ -23,36 +23,36 @@ |
||
23 | 23 | { |
24 | 24 | |
25 | 25 | |
26 | - /** |
|
27 | - * @var CancelTicketLineItemService $cancel_ticket_line_item_service |
|
28 | - */ |
|
29 | - private $cancel_ticket_line_item_service; |
|
30 | - |
|
31 | - |
|
32 | - /** |
|
33 | - * Command constructor |
|
34 | - * |
|
35 | - * @param CancelTicketLineItemService $cancel_ticket_line_item_service |
|
36 | - */ |
|
37 | - public function __construct(CancelTicketLineItemService $cancel_ticket_line_item_service) |
|
38 | - { |
|
39 | - $this->cancel_ticket_line_item_service = $cancel_ticket_line_item_service; |
|
40 | - } |
|
41 | - |
|
42 | - |
|
43 | - /** |
|
44 | - * @param CommandInterface|CancelTicketLineItemCommand $command |
|
45 | - * @return mixed |
|
46 | - * @throws InvalidEntityException |
|
47 | - * @throws RuntimeException |
|
48 | - */ |
|
49 | - public function handle(CommandInterface $command) |
|
50 | - { |
|
51 | - return $this->cancel_ticket_line_item_service->cancel( |
|
52 | - $command->transaction(), |
|
53 | - $command->ticket(), |
|
54 | - $command->quantity(), |
|
55 | - $command->ticketLineItem() |
|
56 | - ); |
|
57 | - } |
|
26 | + /** |
|
27 | + * @var CancelTicketLineItemService $cancel_ticket_line_item_service |
|
28 | + */ |
|
29 | + private $cancel_ticket_line_item_service; |
|
30 | + |
|
31 | + |
|
32 | + /** |
|
33 | + * Command constructor |
|
34 | + * |
|
35 | + * @param CancelTicketLineItemService $cancel_ticket_line_item_service |
|
36 | + */ |
|
37 | + public function __construct(CancelTicketLineItemService $cancel_ticket_line_item_service) |
|
38 | + { |
|
39 | + $this->cancel_ticket_line_item_service = $cancel_ticket_line_item_service; |
|
40 | + } |
|
41 | + |
|
42 | + |
|
43 | + /** |
|
44 | + * @param CommandInterface|CancelTicketLineItemCommand $command |
|
45 | + * @return mixed |
|
46 | + * @throws InvalidEntityException |
|
47 | + * @throws RuntimeException |
|
48 | + */ |
|
49 | + public function handle(CommandInterface $command) |
|
50 | + { |
|
51 | + return $this->cancel_ticket_line_item_service->cancel( |
|
52 | + $command->transaction(), |
|
53 | + $command->ticket(), |
|
54 | + $command->quantity(), |
|
55 | + $command->ticketLineItem() |
|
56 | + ); |
|
57 | + } |
|
58 | 58 | } |
@@ -22,37 +22,37 @@ |
||
22 | 22 | { |
23 | 23 | |
24 | 24 | |
25 | - /** |
|
26 | - * @var CreateTicketLineItemService $factory |
|
27 | - */ |
|
28 | - private $factory; |
|
29 | - |
|
30 | - |
|
31 | - /** |
|
32 | - * Command constructor |
|
33 | - * |
|
34 | - * @param CreateTicketLineItemService $factory |
|
35 | - */ |
|
36 | - public function __construct(CreateTicketLineItemService $factory) |
|
37 | - { |
|
38 | - $this->factory = $factory; |
|
39 | - } |
|
40 | - |
|
41 | - |
|
42 | - /** |
|
43 | - * @param CommandInterface|CreateTicketLineItemCommand $command |
|
44 | - * @return EE_Line_Item |
|
45 | - * @throws InvalidEntityException |
|
46 | - * @throws UnexpectedEntityException |
|
47 | - * @throws EE_Error |
|
48 | - */ |
|
49 | - public function handle(CommandInterface $command) |
|
50 | - { |
|
51 | - // create new line item for ticket |
|
52 | - return $this->factory->create( |
|
53 | - $command->transaction(), |
|
54 | - $command->ticket(), |
|
55 | - $command->quantity() |
|
56 | - ); |
|
57 | - } |
|
25 | + /** |
|
26 | + * @var CreateTicketLineItemService $factory |
|
27 | + */ |
|
28 | + private $factory; |
|
29 | + |
|
30 | + |
|
31 | + /** |
|
32 | + * Command constructor |
|
33 | + * |
|
34 | + * @param CreateTicketLineItemService $factory |
|
35 | + */ |
|
36 | + public function __construct(CreateTicketLineItemService $factory) |
|
37 | + { |
|
38 | + $this->factory = $factory; |
|
39 | + } |
|
40 | + |
|
41 | + |
|
42 | + /** |
|
43 | + * @param CommandInterface|CreateTicketLineItemCommand $command |
|
44 | + * @return EE_Line_Item |
|
45 | + * @throws InvalidEntityException |
|
46 | + * @throws UnexpectedEntityException |
|
47 | + * @throws EE_Error |
|
48 | + */ |
|
49 | + public function handle(CommandInterface $command) |
|
50 | + { |
|
51 | + // create new line item for ticket |
|
52 | + return $this->factory->create( |
|
53 | + $command->transaction(), |
|
54 | + $command->ticket(), |
|
55 | + $command->quantity() |
|
56 | + ); |
|
57 | + } |
|
58 | 58 | } |