jeromq

jeromq copied to clipboard

#JeroMQ

Pure Java implementation of libzmq (http://zeromq.org).

Features

• Based on libzmq 3.2.5.
• ZMTP/2.0 (http://rfc.zeromq.org/spec:15).
• tcp:// protocol and inproc:// is compatible with zeromq.
• ipc:// protocol works only between jeromq (uses tcp://127.0.0.1:port internally).
• Not too bad performance compared to zeromq.
• 4.5M messages (100B) per sec.
• Performance.
• Exactly same developer experience with zeromq and jzmq.

Not supported Features

• ipc:// protocol with zeromq. Java doesn't support UNIX domain socket.
• pgm:// protocol. Cannot find a pgm Java implementation.

Extended Features

• Build your own StreamEngine's Decoder/Encoder:
• TestProxyTcp
• Proxy

Contribution Process

This project uses the C4 process for all code changes. "Everyone, without distinction or discrimination, SHALL have an equal right to become a Contributor under the terms of this contract."

Usage

Add it to your Maven project's pom.xml:

    <dependency>
      <groupId>org.zeromq</groupId>
      <artifactId>jeromq</artifactId>
      <version>0.3.5</version>
    </dependency>

    <!-- for the latest SNAPSHOT -->
    <dependency>
      <groupId>org.zeromq</groupId>
      <artifactId>jeromq</artifactId>
      <version>0.3.6-SNAPSHOT</version>
    </dependency>

    <!-- If you can't find the latest snapshot -->
    <repositories>
      <repository>
        <id>sonatype-nexus-snapshots</id>
        <url>https://oss.sonatype.org/content/repositories/snapshots</url>
        <releases>
          <enabled>false</enabled>
        </releases>
        <snapshots>
          <enabled>true</enabled>
        </snapshots>
       </repository>
    </repositories>

Using ANT

To generate an ant build file from pom.xml, issue the following command:

mvn ant:ant

Also please refer the Wiki.

Copying

Free use of this software is granted under the terms of the GNU Lesser General Public License (LGPL). For details see the files COPYING and COPYING.LESSER included with the JeroMQ distribution.