HTTP Transport Feature

Overview

Uses the HTTP protocol to transport messages.

Defining this Feature as a Dependency

This feature is typically defined as a dependency by binding extensions only, i.e. you wouldn't define it as a dependency within your component deployments. If you're developing a binding that uses the http transport, paste the following element into the dependencies section of your deployment's POM, making sure to populate the version tag with the desired version (check repository for the latest available version). Note that if the feature is optional, i.e. if it's not absolutely required by your extension, set optional to 'true'.

<dependency>
  <groupId>org.bluestemsoftware.open.eoa.ext.feature.ws.transport.http</groupId>
  <artifactId>ws-transport-http</artifactId>
  <version>VERSION</version>
  <scope>runtime</scope>
  <type>eoa-feature</type>
  <optional>false</optional>
</dependency>

Enabling this Feature Provider

If no provider is specified when feature is enabled and more than one implementation exists, an arbitrary implementation is selected by the alakai server. Enabling this specific provider requires the following entry within your server.xml file:

<feature type="org.bluestemsoftware.specification.eoa.ext.feature.ws.transport.http.HTTPTransportFeature">
  <provider impl="org.bluestemsoftware.open.eoa.ext.feature.ws.transport.http.HTTPTransportFeatureImpl"/>
</feature>

Features Required by this Provider

The following features must be explicitly enabled to use this provider:

<feature type="org.bluestemsoftware.specification.eoa.ext.feature.auth.cstore.CredentialStoreFeature"/>
<feature type="org.bluestemsoftware.specification.eoa.ext.feature.http.client.HTTPClientFeature" />
<feature type="org.bluestemsoftware.specification.eoa.ext.feature.http.server.HTTPServerFeature"/>

Optional Features Used by this Provider

This feature will employ the following optional features if they are enabled:

  None

Configuration Schema 

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" targetNamespace="http://bluestemsoftware.org/open/eoa/ext/feature/ws/transport/http/config/1.0" xmlns:tns="http://bluestemsoftware.org/open/eoa/ext/feature/ws/transport/http/config/1.0" elementFormDefault="qualified">
  <xs:element name="config">
    <xs:complexType>
      <xs:sequence>
        <xs:element name="credentialStore" type="xs:NCName" />
      </xs:sequence>
    </xs:complexType>
  </xs:element>
</xs:schema>

Default Configuration

The following configuration is implied when no configuration is specified within 'provider' element: 

<config xmlns="http://bluestemsoftware.org/open/eoa/ext/feature/ws/transport/http/config/1.0">
  <credentialStore>default</credentialStore>
</config>

Sample Configurations

The default configuration uses the default credential store ID "default". To change this ID to, e.g. "mystore", requires the following configuration:

<config xmlns="http://bluestemsoftware.org/open/eoa/ext/feature/ws/transport/http/config/1.0">
  <credentialStore>mystore</credentialStore>
</config>