name: ConstraintViolationInterface class_comment: null dependencies: [] properties: [] methods: - name: getMessage visibility: public parameters: [] comment: '# * A violation of a constraint that happened during validation. # * # * For each constraint that fails during validation one or more violations are # * created. The violations store the violation message, the path to the failing # * element in the validation graph and the root element that was originally # * passed to the validator. For example, take the following graph: # * # * (Person)---(firstName: string) # * \ # * (address: Address)---(street: string) # * # * If the Person object is validated and validation fails for the # * "firstName" property, the generated violation has the Person # * instance as root and the property path "firstName". If validation fails # * for the "street" property of the related Address instance, the root # * element is still the person, but the property path is "address.street". # * # * @author Bernhard Schussek # */ # interface ConstraintViolationInterface # { # /** # * Returns the violation message.' - name: getMessageTemplate visibility: public parameters: [] comment: '# * Returns the raw violation message. # * # * The raw violation message contains placeholders for the parameters # * returned by {@link getParameters}. Typically you''ll pass the # * message template and parameters to a translation engine.' - name: getParameters visibility: public parameters: [] comment: '# * Returns the parameters to be inserted into the raw violation message. # * # * @return array a possibly empty list of parameters indexed by the names # * that appear in the message template # * # * @see getMessageTemplate()' - name: getPlural visibility: public parameters: [] comment: '# * Returns a number for pluralizing the violation message. # * # * For example, the message template could have different translation based # * on a parameter "choices": # * # * # * # * This method returns the value of the parameter for choosing the right # * pluralization form (in this case "choices").' - name: getRoot visibility: public parameters: [] comment: '# * Returns the root element of the validation. # * # * @return mixed The value that was passed originally to the validator when # * the validation was started. Because the validator traverses # * the object graph, the value at which the violation occurs # * is not necessarily the value that was originally validated.' - name: getPropertyPath visibility: public parameters: [] comment: '# * Returns the property path from the root element to the violation. # * # * @return string The property path indicates how the validator reached # * the invalid value from the root element. If the root # * element is a Person instance with a property # * "address" that contains an Address instance # * with an invalid property "street", the generated property # * path is "address.street". Property access is denoted by # * dots, while array access is denoted by square brackets, # * for example "addresses[1].street".' - name: getInvalidValue visibility: public parameters: [] comment: '# * Returns the value that caused the violation. # * # * @return mixed the invalid value that caused the validated constraint to # * fail' - name: getCode visibility: public parameters: [] comment: '# * Returns a machine-digestible error code for the violation.' - name: getConstraint visibility: public parameters: [] comment: '# * Returns the constraint whose validation caused the violation.' - name: getCause visibility: public parameters: [] comment: '# * Returns the cause of the violation.' - name: __toString visibility: public parameters: [] comment: '# * Converts the violation into a string for debugging purposes.' traits: [] interfaces: []