Class ServicesUtil


  • public class ServicesUtil
    extends java.lang.Object
    Utilities for handling e.g. exceptions in DAO classes in a common way, parameters etc.
    • Constructor Summary

      Constructors 
      Constructor Description
      ServicesUtil()  
    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method Description
      static void validateIfAnyResult​(java.util.Collection resultToCheck, java.lang.String unknownIdException)
      Checks if collection contains any objects.
      static void validateIfSingleResult​(java.util.Collection<? extends java.lang.Object> resultToCheck, java.lang.Class clazz, java.lang.String qualifier, java.lang.Object qualifierValue)
      Checks if collection contains only a single object and generates proper exception messages out of passed type and qualifier.
      static void validateIfSingleResult​(java.util.Collection<? extends java.lang.Object> resultToCheck, java.lang.String unknownIdException, java.lang.String ambiguousIdException)
      Checks if collection contains only a single object.
      static void validateParameterNotNull​(java.lang.Object parameter, java.lang.String nullMessage)
      Validates if parameter passed to method is not null
      static void validateParameterNotNullStandardMessage​(java.lang.String parameter, java.lang.Object parameterValue)
      Validates if parameter value passed to method is not null.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Constructor Detail

      • ServicesUtil

        public ServicesUtil()
    • Method Detail

      • validateIfSingleResult

        public static void validateIfSingleResult​(java.util.Collection<? extends java.lang.Object> resultToCheck,
                                                  java.lang.String unknownIdException,
                                                  java.lang.String ambiguousIdException)
        Checks if collection contains only a single object.
        Parameters:
        resultToCheck - collection to check
        unknownIdException - message for exception thrown if collection is empty or is null
        ambiguousIdException - message for exception thrown if collection has more than one object
        Throws:
        UnknownIdentifierException - if collection is empty or is null
        AmbiguousIdentifierException - if collection has more than one object
      • validateIfSingleResult

        public static void validateIfSingleResult​(java.util.Collection<? extends java.lang.Object> resultToCheck,
                                                  java.lang.Class clazz,
                                                  java.lang.String qualifier,
                                                  java.lang.Object qualifierValue)
        Checks if collection contains only a single object and generates proper exception messages out of passed type and qualifier.
        Parameters:
        resultToCheck - collection to check
        clazz - result must contain elements which are assignable from this clazz
        qualifier - unique qualifier used for search
        qualifierValue - for qualifier
        Throws:
        UnknownIdentifierException - if collection is empty or is null
        AmbiguousIdentifierException - if collection has more than one object
        java.lang.IllegalStateException - if element in collection is NOT of the given type
      • validateIfAnyResult

        public static void validateIfAnyResult​(java.util.Collection resultToCheck,
                                               java.lang.String unknownIdException)
        Checks if collection contains any objects.
        Parameters:
        resultToCheck - collection to check
        unknownIdException - message for exception thrown if collection is empty or is null
        Throws:
        UnknownIdentifierException - if collection is empty or is null
      • validateParameterNotNull

        public static void validateParameterNotNull​(java.lang.Object parameter,
                                                    java.lang.String nullMessage)
        Validates if parameter passed to method is not null
        Parameters:
        parameter - to check
        nullMessage - message for exception thrown if parameter is null
        Throws:
        java.lang.IllegalArgumentException - if parameter is null
      • validateParameterNotNullStandardMessage

        public static void validateParameterNotNullStandardMessage​(java.lang.String parameter,
                                                                   java.lang.Object parameterValue)
        Validates if parameter value passed to method is not null.
        Parameters:
        parameter - name of parameter used for exception message
        parameterValue - value to check for null
        Throws:
        java.lang.IllegalArgumentException - if parameter is null