1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
<?php
/**
* Copyright © Magento, Inc. All rights reserved.
* See COPYING.txt for license details.
*/
namespace Magento\Framework\Exception;
use Magento\Framework\Phrase;
/**
* Exception to be thrown when there is an issue with the Input to a function call.
*
* @api
* @since 100.0.2
*/
class InputException extends AbstractAggregateException
{
/**
* @deprecated
*/
const DEFAULT_MESSAGE = 'One or more input exceptions have occurred.';
/**
* @deprecated
*/
const INVALID_FIELD_RANGE = 'The %fieldName value of "%value" must be between %minValue and %maxValue';
/**
* @deprecated
*/
const INVALID_FIELD_MIN_VALUE = 'The %fieldName value of "%value" must be greater than or equal to %minValue.';
/**
* @deprecated
*/
const INVALID_FIELD_MAX_VALUE = 'The %fieldName value of "%value" must be less than or equal to %maxValue.';
/**
* @deprecated
*/
const INVALID_FIELD_VALUE = 'Invalid value of "%value" provided for the %fieldName field.';
/**
* @deprecated
*/
const REQUIRED_FIELD = '"%fieldName" is required. Enter and try again.';
/**
* Initialize the input exception.
*
* @param \Magento\Framework\Phrase $phrase
* @param \Exception $cause
* @param int $code
*/
public function __construct(Phrase $phrase = null, \Exception $cause = null, $code = 0)
{
if ($phrase === null) {
$phrase = new Phrase('One or more input exceptions have occurred.');
}
parent::__construct($phrase, $cause, $code);
}
/**
* Creates an InputException for when a specific field was provided with an invalid value.
*
* @param string $fieldName Name of the field which had an invalid value provided.
* @param string $fieldValue The invalid value that was provided for the field.
* @param \Exception $cause Cause of the InputException
* @return \Magento\Framework\Exception\InputException
*/
public static function invalidFieldValue($fieldName, $fieldValue, \Exception $cause = null)
{
return new self(
new Phrase(
'Invalid value of "%value" provided for the %fieldName field.',
['fieldName' => $fieldName, 'value' => $fieldValue]
),
$cause
);
}
/**
* Creates an InputException for a missing required field.
*
* @param string $fieldName Name of the missing required field.
* @return \Magento\Framework\Exception\InputException
*/
public static function requiredField($fieldName)
{
return new self(
new Phrase('"%fieldName" is required. Enter and try again.', ['fieldName' => $fieldName])
);
}
}