Package org.zeromq

Class ZSocket

java.lang.Object
org.zeromq.ZSocket
All Implemented Interfaces:
AutoCloseable

public class ZSocket extends Object implements AutoCloseable
ZeroMQ sockets present an abstraction of an asynchronous message queue, with the exact queuing semantics depending on the socket type in use. Where conventional sockets transfer streams of bytes or discrete datagrams, ZeroMQ sockets transfer discrete messages.

ZeroMQ sockets being asynchronous means that the timings of the physical connection setup and tear down, reconnect and effective delivery are transparent to the user and organized by ZeroMQ itself. Further, messages may be queued in the event that a peer is unavailable to receive them.

  • Field Details

  • Constructor Details

    • ZSocket

      public ZSocket(int socketType)
      Create a ZeroMQ socket
      Parameters:
      socketType - ZeroMQ socket type
    • ZSocket

      public ZSocket(SocketType socketType)
      Create a ZeroMQ socket
      Parameters:
      socketType - ZeroMQ Socket type
  • Method Details

    • getSocketType

      public SocketType getSocketType()
      Retrieve the socket type for the current 'socket'. The socket type is specified at socket creation time and cannot be modified afterwards.
      Returns:
      the socket's type.
    • getType

      public int getType()
      Retrieve the socket type for the current 'socket'. The socket type is specified at socket creation time and cannot be modified afterwards.
      Returns:
      the socket's type.
      See Also:
    • bind

      public boolean bind(String endpoint)
      Creates an endpoint for accepting connections and binds to it.

      The endpoint argument is a string consisting of two parts as follows: transport ://address. The transport part specifies the underlying transport protocol to use. The meaning of the address part is specific to the underlying transport protocol selected.

      Parameters:
      endpoint - the endpoint to bind to
      Returns:
      returns true if bind to the endpoint was successful
    • unbind

      public boolean unbind(String endpoint)
      Stop accepting connections on a socket.

      Shall unbind from the endpoint specified by the endpoint argument.

      Parameters:
      endpoint - the endpoint to unbind from
      Returns:
      returns true if unbind to the endpoint was successful
    • connect

      public boolean connect(String endpoint)
      Connects the socket to an endpoint and then accepts incoming connections on that endpoint.

      The endpoint is a string consisting of a transport :// followed by an address. The transport specifies the underlying protocol to use. The address specifies the transport-specific address to connect to.

      Parameters:
      endpoint - the endpoint to connect to
      Returns:
      returns true if connecting to the endpoint was successful
    • disconnect

      public boolean disconnect(String endpoint)
      Disconnecting a socket from an endpoint.
      Parameters:
      endpoint - the endpoint to disconnect from
      Returns:
      returns true if disconnecting to endpoint was successful
    • hasReceiveMore

      public final boolean hasReceiveMore()
      Returns a boolean value indicating if the multipart message currently being read from the Socket and has more message parts to follow. If there are no message parts to follow or if the message currently being read is not a multipart message a value of false shall be returned. Otherwise, a value of true shall be returned.
      Returns:
      true if there are more messages to receive.
    • subscribe

      public void subscribe(byte[] topic)
    • subscribe

      public void subscribe(String topic)
    • unsubscribe

      public void unsubscribe(byte[] topic)
    • unsubscribe

      public void unsubscribe(String topic)
    • send

      public int send(byte[] b)
    • send

      public int send(byte[] b, int flags)
    • sendFrame

      public boolean sendFrame(ZFrame frame, int flags)
      Send a frame
      Parameters:
      frame -
      flags -
      Returns:
      return true if successful
    • sendMessage

      public boolean sendMessage(ZMsg message)
    • sendStringUtf8

      public int sendStringUtf8(String str)
    • sendStringUtf8

      public int sendStringUtf8(String str, int flags)
    • receive

      public byte[] receive()
    • receive

      public byte[] receive(int flags)
    • receiveStringUtf8

      public String receiveStringUtf8()
    • receiveStringUtf8

      public String receiveStringUtf8(int flags)
    • mayRaise

      private void mayRaise()
    • setOption

      private void setOption(int option, Object value)
    • getOption

      private Object getOption(int option)
    • close

      public void close()
      Specified by:
      close in interface AutoCloseable