REST Listener

Table of Contents

    REST Listener

    A REST listener consumes a HTTP-REST request and offers its content as a ConnectMessage.

    This listener is a request/response consumer, which means that a response must be returned. In addition this consumer can handle REST URL type requests.

    This can happen through a host:port/context-path/ combination. For every combination, a separate server context is started. 
    Listeners with the same host:port/context combination will use the same server context. The HTTP server will be generated and configured automatically.

    When a Message reply component is configured at the end of the flow, the result from the service is sent back to the HTTP invoker.

    Also, thrown exceptions will be sent back to the HTTP invoker, in stead of being caught by the connect exception handling mechanism.

    In the table below, you will find an explanation about these properties. All attributes with a ‘*’ are mandatory.




    By default, we fill this out with the technical ‘tag’, followed by a serial number. Changing the name is optional.


    Set this value to true, if you want this consumer to be enabled.

    Consumer Autostart

    Consumer will be started at startup of the interface


    Hostname used to create the endpoint


    Port number. The default is the Jetty port.

    Context Path

    Path on which to open webservice endpoint. A custom Context Path should always start with a forward slash (/). So for instance: "/CustomPath".


    Specify which HTTP Methods are allowed (GET/POST/HEAD/OPTIONS/PUT/PATCH/DELETE/TRACE). You may also use a comma separated list.

    Input can be done by clicking in the lower part of the box. A drop down menu will appear and you can select, or type your selection:


    Name of the MessagePart in a ConnectMessage where the content of the file is being stored.

    Response Timeout

    Time in milliseconds to wait before time-out.

    Mapped Request Headers

    A comma separated list of headers to be mapped from HTTP request to the ConnectMessage

    Mapped Response Headers

    A comma separated list of headers to be mapped from the ConnectMessage to the HTTP response

    Expected Content Type

    Specify which content-type may be expected to be correcly mapped to a useable format. This will override default content-type mapping.

    Enable SSL

    Enables SSL Connector. When set to true, the keystore value and alias value should be set. Otherwise the defaults will be used.

    Authentication Realm

    Provide a Authentication file from Resources to specify configured Authentication for selected Scheme. See chapter on Providing Authentication for HTTP/WS Listeners. For more information, follow this link.

    Authentication Scheme

    Select desired Authentication Schema (NONE, BASIC, JDBC, LDAP). See chapter on Providing Authentication for HTTP/WS Listeners. For more information, follow this link.

    REST Pattern

    Provide used REST Pattern for this request. IE /contextPath/[customerId]/{}/[email]/{}  Every Pattern must start with the Context Path.

    Defined variables must be enclosed witin [] and followed by /{} to specify a variable value will be used in the url.

    Every parameter will be stored as a ConnectMessage Property on the ConnectMessage.

    REST Parameters As XML

    Setting this to true will add a separate messagepart with id 'restXml' containing all the REST parameters and values in XML format.


    Description of the specific consumer. This is for documentation purposes.


    Enable SSL

    When you enable SSL, you need to add some extra information. This will look like this:



    Certificate Alias in Keystore

    Set the certificate alias for the selected certificate. Should exist in defined keystore.

    Key Password

    Password for the certificate key.

    Keystore Location

    The location of the keystore. Should be a path to the keystore JKS file.

    Keystore Password

    Password of the keystore.


    Copyright © 2019 ConnectPlaza.   For pricing, account management and more go to https://www.connectplaza.com

    About Connectplaza

    Si components version:   

    Lorem ipsum delore set

    Lorem ipsum delore set

    Window size is not optimal. Please enlarge for optimal experience

    No connection

    No response from the server. This window will automaticly disappear by an valid connection