Edit on Github

CadenzaFlow Connector Reference

CadenzaFlow Connect provides a simple API for connecting HTTP services and other things. It aims at two usage scenarios: usage in a generic system such as the CadenzaFlow process engine and standalone usage via API.

Connectors

CadenzaFlow Connect provides a HTTP and a SOAP HTTP connector. If you want to add an own connector to Connect please have a look at the extending Connect section. This section also describes the usage of a ConnectorConfigurator to configure the connector instances.

During the request invocation of a connector an interceptor chain is passed. The user can add own interceptors to this chain. The interceptor is called for every request of this connector.

connector.addRequestInterceptor(interceptor).createRequest();

Maven Coordinates

Connect can be used in any Java-based application by adding the following maven dependency to your pom.xml file:

CadenzaFlow BOM

If you use other CadenzaFlow projects please import the CadenzaFlow BOM to ensure correct versions for every CadenzaFlow project.

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>org.cadenzaflow.connect</groupId>
      <artifactId>cadenzaflow-connect-bom</artifactId>
      <scope>import</scope>
      <type>pom</type>
      <version>${version.cadenzaflow}</version>
    </dependency>
  </dependencies>
</dependencyManagement>

<dependencies>
  <dependency>
    <groupId>org.cadenzaflow.connect</groupId>
    <artifactId>cadenzaflow-connect-core</artifactId>
  </dependency>

  <dependency>
    <groupId>org.cadenzaflow.connect</groupId>
    <artifactId>cadenzaflow-connect-connectors-all</artifactId>
  </dependency>
</dependencies>

CadenzaFlow Connect is published to maven central.

Process engine plugin

If you are using Connect in the CadenzaFlow process engine, you also need the cadenzaflow-engine-plugin-connect dependency. For more information, refer to the Connectors guide.

Logging

CadenzaFlow Connect uses cadenzaflow-commons-logging which itself uses SLF4J as a logging backend. To enable logging a SLF4J implementation has to be part of your classpath. For example slf4j-simple, log4j12 or logback-classic.

To also enable logging for the Apache HTTP client you can use a SLF4J bridge like jcl-over-slf4j as the Apache HTTP Client doesn’t support SLF4J.