/service-proxy

API gateway for REST and SOAP written in Java.

Primary LanguageJava

Membrane Service Proxy

GitHub release Hex.pm

Check the Repository at GitHub for the latest source code. Read the CHANGELOG for recent changes.

What is Membrane?

Membrane Service Proxy is an open source, reverse HTTP proxy framework written in Java, licensed under ASF 2.0, that can be used as

  • a Service Virtualization layer,
  • an API Gateway,
  • a synchronous ESB for HTTP based Integration,
  • a Security Proxy.

To get started, follow the SOAP and REST tutorials or have a look at the examples or the FAQ.

Get Started

Download the binary.

Unpack.

Start service-proxy.sh or service-proxy.bat.

Have a look at the main configuration file conf/proxies.xml. Changes to this file are instantly deployed.

Run the samples in the examples directory or go to the website for more documentation.

Samples

Hosting virtual REST services is easy:

<serviceProxy port="80">
    <path>/restnames/</path>
    <target host="www.thomas-bayer.com" />
</serviceProxy>

SOAP proxies configure themselves by analysing WSDL:

<soapProxy wsdl="http://thomas-bayer.com/axis2/services/BLZService?wsdl">
</soapProxy>

Add features like logging or XML Schema validation against a WSDL document:

<soapProxy wsdl="http://thomas-bayer.com/axis2/services/BLZService?wsdl">
	<validator />
	<log />
</soapProxy>