Class EPPRegistryHandler

  • All Implemented Interfaces:
    EPPEventHandler
    Direct Known Subclasses:
    RegistryHandler

    public abstract class EPPRegistryHandler
    extends java.lang.Object
    implements EPPEventHandler
    The EPPRegistryHandler class provides an interface for handling EPP Registry Commands in a Server implementation. EPPEvents are handled by the handleEvent(EPPEvent, Object) method and routed to the appropriate abstract member function. Subclasses should override the abstract methods to define the desired behavior of a particular command when it is received. A subclassed instance of EPPRegistryHandler should be registered with the EPPDispatcher so that EPPEvent related to the Registry Mapping will be handled there.
    See Also:
    EPPEventHandler, EPPEvent
    • Constructor Detail

      • EPPRegistryHandler

        public EPPRegistryHandler()
        Construct an instance of EPPRegistryHandler. Whenever an EPPRegistryHandler instance is created load the corresponding EPPRegistryMapFactory EPPFactory.
    • Method Detail

      • handleEvent

        public EPPEventResponse handleEvent​(EPPEvent aEvent,
                                            java.lang.Object aData)
                                     throws EPPEventException
        This method receives an EPPEvent and routes it to the appropriate abstract method.
        Specified by:
        handleEvent in interface EPPEventHandler
        Parameters:
        aEvent - An EPPEvent that contains the EPPCommand
        aData - Any data that a Server needs to send to this EPPRegistryHandler instance
        Returns:
        DOCUMENT ME!
        Throws:
        EPPEventException - Thrown if an unrecognized EPPEvent is received
      • doRegistryInfo

        protected abstract EPPEventResponse doRegistryInfo​(EPPEvent aEvent,
                                                           java.lang.Object aData)
        Invoked when a Registry Info command is received. Subclasses should define the behavior when a Registry Info command is received.
        Parameters:
        aEvent - The EPPEvent that is being handled
        aData - Any data that a Server needs to send to this EPPRegistryHandler
        Returns:
        EPPEventResponse The response that should be sent back to the client.
      • doRegistryCheck

        protected abstract EPPEventResponse doRegistryCheck​(EPPEvent aEvent,
                                                            java.lang.Object aData)
        Invoked when a Registry Check command is received. Subclasses should define the behavior when a Registry Check command is received.
        Parameters:
        aEvent - The EPPEvent that is being handled
        aData - Any data that a Server needs to send to this EPPRegistryHandler
        Returns:
        EPPEventResponse The response that should be sent back to the client.
      • doRegistryCreate

        protected abstract EPPEventResponse doRegistryCreate​(EPPEvent aEvent,
                                                             java.lang.Object aData)
        Invoked when a Registry Create command is received. Subclasses should define the behavior when a Registry Create command is received.
        Parameters:
        aEvent - The EPPEvent that is being handled
        aData - Any data that a Server needs to send to this EPPRegistryHandler
        Returns:
        EPPEventResponse The response that should be sent back to the client.
      • doRegistryUpdate

        protected abstract EPPEventResponse doRegistryUpdate​(EPPEvent aEvent,
                                                             java.lang.Object aData)
        Invoked when a Registry Update command is received. Subclasses should define the behavior when a Registry Update command is received.
        Parameters:
        aEvent - The EPPEvent that is being handled
        aData - Any data that a Server needs to send to this EPPRegistryHandler
        Returns:
        EPPEventResponse The response that should be sent back to the client.
      • doRegistryDelete

        protected abstract EPPEventResponse doRegistryDelete​(EPPEvent aEvent,
                                                             java.lang.Object aData)
        Invoked when a Registry Delete command is received. Subclasses should define the behavior when a Registry Delete command is received.
        Parameters:
        aEvent - The EPPEvent that is being handled
        aData - Any data that a Server needs to send to this EPPRegistryHandler
        Returns:
        EPPEventResponse The response that should be sent back to the client.
      • getNamespace

        public java.lang.String getNamespace()
        Description copied from interface: EPPEventHandler
        The Namespace that a handler is associated with.
        Specified by:
        getNamespace in interface EPPEventHandler
        Returns:
        String The Namespace that the handler is associated with.
      • preHandleEvent

        protected void preHandleEvent​(EPPEvent aEvent,
                                      java.lang.Object aData)
                               throws EPPHandleEventException
        Handles any common behavior that all registry commands need to execute before they execute their command specific behavior. The default implementation does nothing.
        Parameters:
        aEvent - The EPPEvent that is being handled
        aData - Any data that a Server needs to send to this EPPRegistryHandler
        Throws:
        EPPHandleEventException - Thrown if an error condition occurs. It must contain an EPPEventResponse
      • postHandleEvent

        protected void postHandleEvent​(EPPEvent aEvent,
                                       java.lang.Object aData)
                                throws EPPHandleEventException
        Handles any common behavior that all registry commands need to execute after they execute their command specific behavior. The default implementation does nothing
        Parameters:
        aEvent - The EPPEvent that is being handled
        aData - Any data that a Server needs to send to this EPPRegistryHandler
        Throws:
        EPPHandleEventException - Thrown if an error condition occurs. It must contain an EPPEventResponse