Class DomainNameUtils


  • public class DomainNameUtils
    extends java.lang.Object
    Convert domain name Strings to normalised domain names as defined in the NUM Protocol Specification.
    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      static DomainNameUtils instance()
      Static accessor for the Singleton using lazy-init.
      java.lang.String normaliseDomainName​(java.lang.String domainName)
      Convert a domain name or URL into a normalised name by removing 'www.' and any trailing '.'.
      java.lang.String toIndependentRecordQuery​(java.lang.String domainName, java.lang.String moduleId)
      Convert a domain name to a query format suitable for use in an independent query.
      java.lang.String toManagedRecordQuery​(java.lang.String domainName, java.lang.String moduleId)
      Convert a domain name to a query format suitable for use in a managed record query.
      java.lang.String toPopulatorQuery​(java.lang.String domainName, java.lang.String moduleId)
      Convert a domain name to a query format suitable for use in a populator query.
      java.lang.String toPrePopulatedRecordQuery​(java.lang.String domainName, java.lang.String moduleId)
      Convert a domain name to a query format suitable for use in a pre-populated record query.
      • Methods inherited from class java.lang.Object

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

      • instance

        public static DomainNameUtils instance()
        Static accessor for the Singleton using lazy-init.
        Returns:
        DomainNameUtils
      • toIndependentRecordQuery

        public java.lang.String toIndependentRecordQuery​(java.lang.String domainName,
                                                         java.lang.String moduleId)
                                                  throws NumBadURLException,
                                                         NumInvalidParameterException
        Convert a domain name to a query format suitable for use in an independent query.
        Parameters:
        domainName - java.lang.String The domain name to be converted.
        moduleId - java.lang.String the module number/id as a String
        Returns:
        java.lang.String The converted domain name result.
        Throws:
        NumBadURLException - on error
        NumInvalidParameterException - on error
      • toManagedRecordQuery

        public java.lang.String toManagedRecordQuery​(java.lang.String domainName,
                                                     java.lang.String moduleId)
                                              throws NumInvalidParameterException,
                                                     NumBadURLException
        Convert a domain name to a query format suitable for use in a managed record query.
        Parameters:
        domainName - java.lang.String The domain name to be converted.
        moduleId - java.lang.String the module number/id as a String
        Returns:
        java.lang.String The converted URL result.
        Throws:
        NumInvalidParameterException - on error
        NumBadURLException - on error
      • toPrePopulatedRecordQuery

        public java.lang.String toPrePopulatedRecordQuery​(java.lang.String domainName,
                                                          java.lang.String moduleId)
                                                   throws NumBadURLException,
                                                          NumInvalidParameterException
        Convert a domain name to a query format suitable for use in a pre-populated record query.
        Parameters:
        domainName - java.lang.String The domain name to be converted.
        moduleId - java.lang.String the module number/id as a String
        Returns:
        java.lang.String The converted URL result.
        Throws:
        NumBadURLException - on error
        NumInvalidParameterException - on error
      • toPopulatorQuery

        public java.lang.String toPopulatorQuery​(java.lang.String domainName,
                                                 java.lang.String moduleId)
                                          throws NumBadURLException,
                                                 NumInvalidParameterException
        Convert a domain name to a query format suitable for use in a populator query.
        Parameters:
        domainName - java.lang.String The domain name to be converted.
        moduleId - java.lang.String the module number/id as a String
        Returns:
        java.lang.String The converted URL result.
        Throws:
        NumBadURLException - on error
        NumInvalidParameterException - on error
      • normaliseDomainName

        public java.lang.String normaliseDomainName​(java.lang.String domainName)
                                             throws NumInvalidParameterException,
                                                    NumBadURLException
        Convert a domain name or URL into a normalised name by removing 'www.' and any trailing '.'.
        Parameters:
        domainName - java.lang.String The Not Null domain name string or URL.
        Returns:
        A normalised java.lang.String domain name.
        Throws:
        NumInvalidParameterException - on error
        NumBadURLException - on error