Interface AdapterComponentMBean

    • Field Summary

      Fields 
      Modifier and Type Field Description
      static java.lang.String ADAPTER_PREFIX
      The standard prefix indicating the parent adapter which is ",adapter="
      static java.lang.String CHANNEL_PREFIX
      The standard prefix indicating the parent channel which is ",channel="
      static java.lang.String EQUALS  
      static java.lang.String ID_PREFIX
      The standard prefix indicating the id of this component, which is @{value}
      static java.lang.String JMX_ADAPTER_TYPE
      The standard JMX Prefix specifying domain and type which resolves to "com.adaptris:type=Adapter"
      static java.lang.String JMX_CHANNEL_TYPE
      The standard JMX Prefix for channels which resolves to "com.adaptris:type=Channel"
      static java.lang.String JMX_CONSUMER_MONITOR_TYPE
      The standard JMX Prefix for a given consumer monitor exposed via JMX which resolves to "com.adaptris:type=ConsumerMonitor"
      static java.lang.String JMX_DOMAIN_NAME
      The standard Domain name for components.
      static java.lang.String JMX_FAILED_MESSAGE_RETRIER_TYPE
      The standard JMX Prefix for a FailedMessageRetrier that is exposed via JMX which resolves to "com.adaptris:type=FailedMessageRetrier"
      static java.lang.String JMX_FS_MONITOR_TYPE
      The standard JMX Prefix for a given Filesystem monitor exposed via JMX which resolves to "com.adaptris:type=FsMonitor"
      static java.lang.String JMX_INFLIGHT_TYPE
      The standard JMX Prefix for a given MessageInFlight Interceptor exposed via JMX which resolves to "com.adaptris:type=InFlight"
      static java.lang.String JMX_LOG_HANDLER_TYPE
      Deprecated.
      static java.lang.String JMX_METRICS_TYPE
      The standard JMX Prefix for a given MessageMetricsStatistics exposed via JMX which resolves to "com.adaptris:type=Metrics"
      static java.lang.String JMX_MSG_ERR_DIGESTER_TYPE
      The standard JMX Prefix for a given Message Error Digest exposed via JMX which resolves to "com.adaptris:type=MessageErrorDigest"
      static java.lang.String JMX_NOTIFIER_TYPE
      The standard JMX Prefix for an Interceptor which emits Notification which resolves to "com.adaptris:type=Notifications"
      static java.lang.String JMX_RETRY_MONITOR_TYPE
      The standard JMX Prefix for a given RetryMessageErrorHandler monitor exposed via JMX which resolves to "com.adaptris:type=RetryMessageHandlerMonitor"
      static java.lang.String JMX_WORKFLOW_TYPE
      The standard JMX Prefix specifying domain and type which resolves to "com.adaptris:type=Workflow"
      static java.lang.String KEY_ADAPTER
      ObjectName Key representing the adapter unique-id
      static java.lang.String KEY_CHANNEL
      ObjectName Key representing parent channel unique-id
      static java.lang.String KEY_ID
      ObjectName Key representing the unique-id of a component
      static java.lang.String KEY_WORKFLOW
      ObjectName Key representing the parent workflow unique-id
      static java.lang.String NOTIF_MSG_CLOSED
      The standard message for a component being closed '"Component Closed" '.
      static java.lang.String NOTIF_MSG_CONFIG_UPDATED
      Standard Message for a configuration update.
      static java.lang.String NOTIF_MSG_INITIALISED
      The standard message for a component being initialised '"Component Initialised" '.
      static java.lang.String NOTIF_MSG_RESTARTED
      The standard message for a component being restarted '"Component Restarted" '.
      static java.lang.String NOTIF_MSG_STARTED
      The standard message for a component being started '"Component Started" '.
      static java.lang.String NOTIF_MSG_STOPPED
      The standard message for a component being stopped '"Component Stopped" '.
      static java.lang.String NOTIF_TYPE_ADAPTER_CONFIG
      Notification type for adapter config update notifications '"adaptris.jmx.adapter.config" '
      static java.lang.String NOTIF_TYPE_ADAPTER_LIFECYCLE
      The notification type for adapter lifecycle notifications '"adaptris.jmx.adapter.lifecycle" '.
      static java.lang.String NOTIF_TYPE_CHANNEL_CONFIG
      Notification type for channel config update notifications '"adaptris.jmx.channel.config" '
      static java.lang.String NOTIF_TYPE_CHANNEL_LIFECYCLE
      The notification type for channel lifecycle notifications '"adaptris.jmx.channel.lifecycle" '.
      static java.lang.String NOTIF_TYPE_WORKFLOW_CONFIG
      Notification type for workflow config update notifications '"adaptris.jmx.workflow.config" '
      static java.lang.String NOTIF_TYPE_WORKFLOW_LIFECYCLE
      The notification type for workflow lifecycle notifications '"adaptris.jmx.workflow.lifecycle" '.
      static java.lang.String PROPERTY_SEPARATOR  
      static java.lang.String WORKFLOW_PREFIX
      The standard prefix indicating the parent workflow which is ",workflow="
    • Field Detail

      • KEY_ID

        static final java.lang.String KEY_ID
        ObjectName Key representing the unique-id of a component
        See Also:
        Constant Field Values
      • KEY_ADAPTER

        static final java.lang.String KEY_ADAPTER
        ObjectName Key representing the adapter unique-id
        See Also:
        Constant Field Values
      • KEY_CHANNEL

        static final java.lang.String KEY_CHANNEL
        ObjectName Key representing parent channel unique-id
        See Also:
        Constant Field Values
      • KEY_WORKFLOW

        static final java.lang.String KEY_WORKFLOW
        ObjectName Key representing the parent workflow unique-id
        See Also:
        Constant Field Values
      • ID_PREFIX

        static final java.lang.String ID_PREFIX
        The standard prefix indicating the id of this component, which is @{value}
        See Also:
        Constant Field Values
      • ADAPTER_PREFIX

        static final java.lang.String ADAPTER_PREFIX
        The standard prefix indicating the parent adapter which is ",adapter="
        See Also:
        Constant Field Values
      • CHANNEL_PREFIX

        static final java.lang.String CHANNEL_PREFIX
        The standard prefix indicating the parent channel which is ",channel="
        See Also:
        Constant Field Values
      • WORKFLOW_PREFIX

        static final java.lang.String WORKFLOW_PREFIX
        The standard prefix indicating the parent workflow which is ",workflow="
        See Also:
        Constant Field Values
      • JMX_DOMAIN_NAME

        static final java.lang.String JMX_DOMAIN_NAME
        The standard Domain name for components.
        See Also:
        Constant Field Values
      • JMX_ADAPTER_TYPE

        static final java.lang.String JMX_ADAPTER_TYPE
        The standard JMX Prefix specifying domain and type which resolves to "com.adaptris:type=Adapter"
        See Also:
        Constant Field Values
      • JMX_WORKFLOW_TYPE

        static final java.lang.String JMX_WORKFLOW_TYPE
        The standard JMX Prefix specifying domain and type which resolves to "com.adaptris:type=Workflow"
        See Also:
        Constant Field Values
      • JMX_CHANNEL_TYPE

        static final java.lang.String JMX_CHANNEL_TYPE
        The standard JMX Prefix for channels which resolves to "com.adaptris:type=Channel"
        See Also:
        Constant Field Values
      • JMX_MSG_ERR_DIGESTER_TYPE

        static final java.lang.String JMX_MSG_ERR_DIGESTER_TYPE
        The standard JMX Prefix for a given Message Error Digest exposed via JMX which resolves to "com.adaptris:type=MessageErrorDigest"
        See Also:
        Constant Field Values
      • JMX_LOG_HANDLER_TYPE

        @Deprecated
        @Removal(version="5.0")
        static final java.lang.String JMX_LOG_HANDLER_TYPE
        Deprecated.
        See Also:
        Constant Field Values
      • JMX_FAILED_MESSAGE_RETRIER_TYPE

        static final java.lang.String JMX_FAILED_MESSAGE_RETRIER_TYPE
        The standard JMX Prefix for a FailedMessageRetrier that is exposed via JMX which resolves to "com.adaptris:type=FailedMessageRetrier"
        See Also:
        Constant Field Values
      • JMX_METRICS_TYPE

        static final java.lang.String JMX_METRICS_TYPE
        The standard JMX Prefix for a given MessageMetricsStatistics exposed via JMX which resolves to "com.adaptris:type=Metrics"
        See Also:
        Constant Field Values
      • JMX_INFLIGHT_TYPE

        static final java.lang.String JMX_INFLIGHT_TYPE
        The standard JMX Prefix for a given MessageInFlight Interceptor exposed via JMX which resolves to "com.adaptris:type=InFlight"
        See Also:
        Constant Field Values
      • JMX_FS_MONITOR_TYPE

        static final java.lang.String JMX_FS_MONITOR_TYPE
        The standard JMX Prefix for a given Filesystem monitor exposed via JMX which resolves to "com.adaptris:type=FsMonitor"
        See Also:
        Constant Field Values
      • JMX_CONSUMER_MONITOR_TYPE

        static final java.lang.String JMX_CONSUMER_MONITOR_TYPE
        The standard JMX Prefix for a given consumer monitor exposed via JMX which resolves to "com.adaptris:type=ConsumerMonitor"
        See Also:
        Constant Field Values
      • JMX_RETRY_MONITOR_TYPE

        static final java.lang.String JMX_RETRY_MONITOR_TYPE
        The standard JMX Prefix for a given RetryMessageErrorHandler monitor exposed via JMX which resolves to "com.adaptris:type=RetryMessageHandlerMonitor"
        See Also:
        Constant Field Values
      • JMX_NOTIFIER_TYPE

        static final java.lang.String JMX_NOTIFIER_TYPE
        The standard JMX Prefix for an Interceptor which emits Notification which resolves to "com.adaptris:type=Notifications"
        See Also:
        Constant Field Values
      • NOTIF_TYPE_ADAPTER_LIFECYCLE

        static final java.lang.String NOTIF_TYPE_ADAPTER_LIFECYCLE
        The notification type for adapter lifecycle notifications '"adaptris.jmx.adapter.lifecycle" '.
        See Also:
        Constant Field Values
      • NOTIF_TYPE_CHANNEL_LIFECYCLE

        static final java.lang.String NOTIF_TYPE_CHANNEL_LIFECYCLE
        The notification type for channel lifecycle notifications '"adaptris.jmx.channel.lifecycle" '.
        See Also:
        Constant Field Values
      • NOTIF_TYPE_WORKFLOW_LIFECYCLE

        static final java.lang.String NOTIF_TYPE_WORKFLOW_LIFECYCLE
        The notification type for workflow lifecycle notifications '"adaptris.jmx.workflow.lifecycle" '.
        See Also:
        Constant Field Values
      • NOTIF_TYPE_WORKFLOW_CONFIG

        static final java.lang.String NOTIF_TYPE_WORKFLOW_CONFIG
        Notification type for workflow config update notifications '"adaptris.jmx.workflow.config" '
        See Also:
        Constant Field Values
      • NOTIF_TYPE_CHANNEL_CONFIG

        static final java.lang.String NOTIF_TYPE_CHANNEL_CONFIG
        Notification type for channel config update notifications '"adaptris.jmx.channel.config" '
        See Also:
        Constant Field Values
      • NOTIF_TYPE_ADAPTER_CONFIG

        static final java.lang.String NOTIF_TYPE_ADAPTER_CONFIG
        Notification type for adapter config update notifications '"adaptris.jmx.adapter.config" '
        See Also:
        Constant Field Values
      • NOTIF_MSG_CONFIG_UPDATED

        static final java.lang.String NOTIF_MSG_CONFIG_UPDATED
        Standard Message for a configuration update.
        See Also:
        Constant Field Values
      • NOTIF_MSG_INITIALISED

        static final java.lang.String NOTIF_MSG_INITIALISED
        The standard message for a component being initialised '"Component Initialised" '.
        See Also:
        Constant Field Values
      • NOTIF_MSG_STARTED

        static final java.lang.String NOTIF_MSG_STARTED
        The standard message for a component being started '"Component Started" '.
        See Also:
        Constant Field Values
      • NOTIF_MSG_STOPPED

        static final java.lang.String NOTIF_MSG_STOPPED
        The standard message for a component being stopped '"Component Stopped" '.
        See Also:
        Constant Field Values
      • NOTIF_MSG_CLOSED

        static final java.lang.String NOTIF_MSG_CLOSED
        The standard message for a component being closed '"Component Closed" '.
        See Also:
        Constant Field Values
      • NOTIF_MSG_RESTARTED

        static final java.lang.String NOTIF_MSG_RESTARTED
        The standard message for a component being restarted '"Component Restarted" '.
        See Also:
        Constant Field Values
    • Method Detail

      • requestInit

        void requestInit​(long timeoutMs)
                  throws CoreException,
                         java.util.concurrent.TimeoutException
        Initialise this component.

        A timeout is required as Connections within the adapter may be configured to retry forever (if a broker is not available for instance) which would cause this method to never return.

        Parameters:
        timeoutMs - the max timeout to wait for in milliseconds
        Throws:
        CoreException - wrapping any underlying adapter exception
        java.util.concurrent.TimeoutException - if the timeout was exceeded.
      • requestStart

        void requestStart​(long timeoutMs)
                   throws CoreException,
                          java.util.concurrent.TimeoutException
        Start this component.

        A timeout is required as Connections within the adapter may be configured to retry forever (if a broker is not available for instance) which would cause this method to never return.

        Parameters:
        timeoutMs - the max timeout to wait for in milliseconds
        Throws:
        CoreException - wrapping any underlying adapter exception
        java.util.concurrent.TimeoutException - if the timeout was exceeded.
      • requestStop

        void requestStop​(long timeout)
                  throws CoreException,
                         java.util.concurrent.TimeoutException
        Stop this component.

        A timeout is required as Connections within the adapter may be configured to retry forever (if a broker is not available for instance) which would cause this method to never return.

        Parameters:
        timeout - the max timeout to wait for in milliseconds
        Throws:
        CoreException - wrapping any underlying adapter exception
        java.util.concurrent.TimeoutException - if the timeout was exceeded.
      • requestClose

        void requestClose​(long timeoutMs)
                   throws CoreException,
                          java.util.concurrent.TimeoutException
        Close this component.

        A timeout is required as Connections within the adapter may be configured to retry forever (if a broker is not available for instance) which would cause this method to never return.

        Parameters:
        timeoutMs - the max timeout to wait for in milliseconds
        Throws:
        CoreException - wrapping any underlying adapter exception
        java.util.concurrent.TimeoutException - if the timeout was exceeded.
      • requestRestart

        void requestRestart​(long timeoutMs)
                     throws CoreException,
                            java.util.concurrent.TimeoutException
        Restart this component.

        This just invokes requestClose(long) and requestStart(long) in sequence with the timeoutMs parameter. Bear in mind that a TimeoutException may not occur until 2 * timeoutMs depending on how long the component takes to close and start.

        Parameters:
        timeoutMs - the max timeout to pass into requestClose(long) and requestStart(long) in ms. This means that a TimeoutException might not occur until 2 * timeoutMs.
        Throws:
        CoreException - wrapping any underlying adapter exception
        java.util.concurrent.TimeoutException - if the timeout was exceeded.
      • requestStartTime

        long requestStartTime()
        Returns timestamp of the last start time for this component
        Returns:
        the last start time, or 0 if the component has never been started.
      • requestStopTime

        long requestStopTime()
        Returns timestamp of the last stop time for this component
        Returns:
        the last stop time; generally speaking this will be the time when the component was "created" if an explicit stop has never been requested.
      • getComponentState

        ComponentState getComponentState()
        Get the state of this managed runtime component.
        Returns:
        the component state
      • getUniqueId

        java.lang.String getUniqueId()
        Get the name of this runtime component.
        Returns:
        the name of this component which is generally semantically equivalent to the corresponding Workflow.getUniqueId() or Channel.getUniqueId()
      • getWrappedComponentClassname

        java.lang.String getWrappedComponentClassname()
        Get the class name that is wrapped by this MBean.
        Returns:
        the class name (e.g. com.adaptris.core.StandardWorkflow)