com.atlassian.confluence.api.model.validation

Class SimpleMergeValidationResult

java.lang.Object

com.atlassian.confluence.api.model.validation.SimpleMergeValidationResult

All Implemented Interfaces:

MergeValidationResult, ValidationResult

public class SimpleMergeValidationResult
extends Object
implements MergeValidationResult

Since:

5.9

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SimpleMergeValidationResult.Builder

Constructor Summary

Constructors

Constructor and Description
SimpleMergeValidationResult(SimpleMergeValidationResult.Builder builder)

Method Summary

Modifier and Type	Method and Description
static SimpleMergeValidationResult.Builder	builder(ValidationResult result)
ServiceException	convertToServiceException(String errorMsg) Converts this validation result into a ServiceException without throwing.
Iterable<ValidationError>	getErrors() Returns an iterable of the errors (if any) stored in this result.
boolean	isAuthorized() Checks for authorization status.
boolean	isValid() Checks for validity.
ServiceException	throwIfInvalid() Deprecated. since 5.10 please use throwIfNotSuccessful()
ServiceException	throwIfInvalid(String msg) Deprecated. since 5.10 please use throwIfNotSuccessful(String)
void	throwIfNotSuccessful() Converts this validation result into a ServiceException and throws it.
void	throwIfNotSuccessful(String msg) Converts this validation result into a ServiceException and throws it.
void	throwIfNotValid(String msg) Deprecated. since 5.10 please use throwIfNotSuccessful(String)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.atlassian.confluence.api.model.validation.ValidationResult

isNotSuccessful, isSuccessful

Constructor Detail

SimpleMergeValidationResult

public SimpleMergeValidationResult(SimpleMergeValidationResult.Builder builder)

Method Detail

isAuthorized

public boolean isAuthorized()

Description copied from interface: ValidationResult

Checks for authorization status. Does NOT imply the validity check.

Specified by:

isAuthorized in interface ValidationResult

Returns:

true if the current user is permitted to perform the execution that the validation is for, false otherwise.

See Also:

ValidationResult.isValid(), ValidationResult.isSuccessful()

isValid

public boolean isValid()

Description copied from interface: ValidationResult

Checks for validity. Does NOT imply the authorization check.

By contract implementations MUST return false if there are errors in this ValidationResult. Default implementation is usually enough.

Specified by:

isValid in interface ValidationResult

Returns:

true if there are no errors in this result, false otherwise.

See Also:

ValidationResult.getErrors(), ValidationResult.isAuthorized(), ValidationResult.isSuccessful()

getErrors

public Iterable<ValidationError> getErrors()

Description copied from interface: ValidationResult

Returns an iterable of the errors (if any) stored in this result. By contract having any errors here MUST also result in ValidationResult.isValid() returning false.

Default implementation of ValidationResult.isValid() is safe for null values. Be cautious about returning null if not using the default implementation for ValidationResult.isValid().

Specified by:

getErrors in interface ValidationResult

Returns:

an iterable of the errors stored in this result.

See Also:

ValidationResult.isValid(), ValidationError

throwIfInvalid

@Deprecated
public ServiceException throwIfInvalid(String msg)
                                            throws ServiceException

Deprecated. since 5.10 please use throwIfNotSuccessful(String)

Description copied from interface: ValidationResult

Converts this validation result into a ServiceException and throws it. Checks for both: ValidationResult.isValid() and ValidationResult.isAuthorized().

Issues:

• Should always throw and never return anything, even though return type is declared.
• Method name suggests only validation check even though two checks are actually performed.

Deprecated for the reasons above.

This method is deprecated since 5.10, please use ValidationResult.throwIfNotSuccessful(String)

Specified by:

throwIfInvalid in interface ValidationResult

Returns:

the exception that will be thrown

Throws:

ServiceException

See Also:

ValidationResult.throwIfNotSuccessful(String)

throwIfNotValid

@Deprecated
public void throwIfNotValid(String msg)
                                 throws ServiceException

Deprecated. since 5.10 please use throwIfNotSuccessful(String)

Description copied from interface: ValidationResult

Converts this validation result into a ServiceException and throws it. Checks for both: ValidationResult.isValid() and ValidationResult.isAuthorized().

Issues:

• Method name suggests only validation check even though two checks are actually performed.

Deprecated for the reason above.

This method is deprecated since 5.10, please use ValidationResult.throwIfNotSuccessful(String)

Specified by:

throwIfNotValid in interface ValidationResult

Throws:

ServiceException

See Also:

ValidationResult.throwIfNotSuccessful(String)

throwIfInvalid

@Deprecated
public ServiceException throwIfInvalid()
                                            throws ServiceException

Deprecated. since 5.10 please use throwIfNotSuccessful()

Description copied from interface: ValidationResult

Converts this validation result into an Exception and throws it. Should always throw and never return anything, even though return type is declared. Deprecated for that reason.

First validation error will be used as message string

This method is deprecated since 5.10, please use ValidationResult.throwIfNotSuccessful()

Specified by:

throwIfInvalid in interface ValidationResult

Returns:

the exception that will be thrown

Throws:

ServiceException

See Also:

ValidationResult.throwIfNotSuccessful()

throwIfNotSuccessful

public void throwIfNotSuccessful(String msg)
                          throws ServiceException

Description copied from interface: ValidationResult

Converts this validation result into a ServiceException and throws it. By default provided string will be used as an exception message.

By contract implementations MUST throw proper subclass of ServiceException when ValidationResult.isNotSuccessful().

Specified by:

throwIfNotSuccessful in interface ValidationResult

Throws:

ServiceException

See Also:

ValidationResult.isNotSuccessful(), ValidationResult.convertToServiceException(String)

throwIfNotSuccessful

public void throwIfNotSuccessful()
                          throws ServiceException

Description copied from interface: ValidationResult

Converts this validation result into a ServiceException and throws it.

By default first validation error (if any) will be used as an exception message.

By contract implementations MUST throw proper subclass of ServiceException when ValidationResult.isNotSuccessful().

Specified by:

throwIfNotSuccessful in interface ValidationResult

Throws:

ServiceException

See Also:

ValidationResult.isNotSuccessful(), ValidationResult.convertToServiceException(String), ValidationResult.getErrors(), ValidationError

convertToServiceException

public ServiceException convertToServiceException(@Nullable
                                                  String errorMsg)

Description copied from interface: ValidationResult

Converts this validation result into a ServiceException without throwing. Implementations of this method should reasonably analyze the internals of this ValidationResult and return appropriate subclass of ServiceException which is most suitable for the case.

This method is used internally in the default implementations of ValidationResult.throwIfNotSuccessful() and ValidationResult.throwIfNotSuccessful(String)

Specified by:

convertToServiceException in interface ValidationResult

Parameters:

errorMsg - message to put in the Exception returned

Returns:

instance of appropriate ServiceException subclass.

See Also:

ValidationResult.throwIfNotSuccessful(), ValidationResult.throwIfNotSuccessful(String)

builder

public static SimpleMergeValidationResult.Builder builder(ValidationResult result)