Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance. Project price only 1 $
You can buy this project and download/modify it how often you want.
package org.zeromq;
import java.io.IOException;
import java.io.PrintWriter;
import java.io.StringWriter;
import java.util.Arrays;
import org.zeromq.ZMQ.Socket;
/**
* ZFrame
*
* The ZFrame class provides methods to send and receive single message frames across 0MQ sockets. A 'frame' corresponds
* to one underlying zmq_msg_t in the libzmq code. When you read a frame from a socket, the more() method indicates if
* the frame is part of an unfinished multipart message. The send() method normally destroys the frame, but with the
* ZFRAME_REUSE flag, you can send the same frame many times. Frames are binary, and this class has no special support
* for text data.
*
* Based on zframe.c in czmq
*
* @author rsmith (at) rsbatechnology (dot) co (dot) uk
*
*
*/
public class ZFrame {
public static final int MORE = ZMQ.SNDMORE;
public static final int REUSE = 128; // no effect at java
public static final int DONTWAIT = ZMQ.DONTWAIT;
private boolean more;
private byte[] data;
/**
* Class Constructor Creates an empty frame. (Useful when reading frames from a 0MQ Socket)
*/
protected ZFrame() {
// Empty constructor
}
/**
* Class Constructor Copies message data into ZFrame object
*
* @param data Data to copy into ZFrame object
*/
public ZFrame(byte[] data) {
if (data != null) {
this.data = (byte[]) data.clone();
}
}
/**
* Class Constructor Copies String into frame data
*
* @param data
*/
public ZFrame(String data) {
if (data != null) {
this.data = data.getBytes();
}
}
/**
* Destructor.
*/
public void destroy() {
if (hasData())
data = null;
}
/**
* @return the data
*/
public byte[] getData() {
return data;
}
/**
* @return More flag, true if last read had MORE message parts to come
*/
public boolean hasMore() {
return more;
}
/**
* Returns byte size of frame, if set, else 0
*
* @return Number of bytes in frame data, else 0
*/
public int size() {
if (hasData())
return data.length;
else
return 0;
}
/**
* Convenience method to ascertain if this frame contains some message data
*
* @return True if frame contains data
*/
public boolean hasData() {
return data != null;
}
/**
* Method to call org.zeromq.Socket send() method.
*
* @param socket 0MQ socket to send on
* @param flags Valid send() method flags, defined in org.zeromq.ZMQ class
* @return True if success, else False
*/
public boolean send(Socket socket, int flags) {
if (socket == null) {
throw new IllegalArgumentException("socket parameter must be set");
}
if (!hasData()) {
throw new IllegalAccessError("Cannot send frame without data");
}
// Note the jzmq Socket.cpp JNI class does a memcpy of the byte data before calling
// the 0MQ send function, so don't have to clone the message data again here.
return socket.send(data, flags);
}
/**
* Sends frame to socket if it contains any data. Frame contents are kept after the send.
*
* @param socket 0MQ socket to send frame
* @param flags Valid send() method flags, defined in org.zeromq.ZMQ class
* @return True if success, else False
*/
public boolean sendAndKeep(Socket socket, int flags) {
return send(socket, flags);
}
/**
* Sends frame to socket if it contains any data. Frame contents are kept after the send. Uses default behaviour of
* Socket.send() method, with no flags set
*
* @param socket 0MQ socket to send frame
* @return True if success, else False
*/
public boolean sendAndKeep(Socket socket) {
return sendAndKeep(socket, 0);
}
/**
* Sends frame to socket if it contains data. Use this method to send a frame and destroy the data after.
*
* @param socket 0MQ socket to send frame
* @param flags Valid send() method flags, defined in org.zeromq.ZMQ class
* @return True if success, else False
*/
public boolean sendAndDestroy(Socket socket, int flags) {
boolean ret = send(socket, flags);
if (ret)
destroy();
return ret;
}
/**
* Sends frame to socket if it contains data. Use this method to send an isolated frame and destroy the data after.
* Uses default behaviour of Socket.send() method, with no flags set
*
* @param socket 0MQ socket to send frame
* @return True if success, else False
*/
public boolean sendAndDestroy(Socket socket) {
return sendAndDestroy(socket, 0);
}
/**
* Creates a new frame that duplicates an existing frame
*
* @return Duplicate of frame; message contents copied into new byte array
*/
public ZFrame duplicate() {
return new ZFrame(this.data.clone());
}
/**
* Returns true if both frames have byte - for byte identical data
*
* @param other The other ZFrame to compare
* @return True if both ZFrames have same byte-identical data, else false
*/
public boolean hasSameData(ZFrame other) {
if (other == null)
return false;
if (size() == other.size()) {
if (hasData() && other.hasData()) {
for (int i = 0; i < size(); i++) {
if (this.data[i] != other.data[i])
return false;
}
return true;
}
}
return false;
}
/**
* Sets new contents for frame
*
* @param data New byte array contents for frame
*/
public void reset(byte[] data) {
this.data = data;
}
/**
* Sets new contents for frame
*
* @param data String contents for frame
*/
public void reset(String data) {
reset(data.getBytes());
}
/**
* Returns frame data as a printable hex string
*
* @return
*/
public String strhex() {
String hexChar = "0123456789ABCDEF";
StringBuilder b = new StringBuilder();
for (int nbr = 0; nbr < data.length; nbr++) {
int b1 = data[nbr] >>> 4 & 0xf;
int b2 = data[nbr] & 0xf;
b.append(hexChar.charAt(b1));
b.append(hexChar.charAt(b2));
}
return b.toString();
}
/**
* String equals. Uses String compareTo for the comparison (lexigraphical)
*
* @param str String to compare with frame data
* @return True if frame body data matches given string
*/
public boolean streq(String str) {
if (!hasData())
return false;
return new String(this.data).compareTo(str) == 0;
}
@Override
public boolean equals(Object o) {
if (this == o)
return true;
if (o == null || getClass() != o.getClass())
return false;
ZFrame zFrame = (ZFrame) o;
if (!Arrays.equals(data, zFrame.data))
return false;
return true;
}
@Override
public int hashCode() {
return data != null ? Arrays.hashCode(data) : 0;
}
/**
* Returns a human - readable representation of frame's data
*
* @return A text string or hex-encoded string if data contains any non-printable ASCII characters
*/
public String toString() {
if (!hasData())
return null;
// Dump message as text or hex-encoded string
boolean isText = true;
for (int i = 0; i < data.length; i++) {
if (data[i] < 32 || data[i] > 127)
isText = false;
}
if (isText)
return new String(data);
else
return strhex();
}
/**
* Internal method to call recv on the socket. Does not trap any ZMQExceptions but expects caling routine to handle
* them.
*
* @param socket 0MQ socket to read from
* @return Byte array
*/
private byte[] recv(Socket socket, int flags) {
if (socket == null)
throw new IllegalArgumentException("socket parameter must not be null");
data = socket.recv(flags);
more = socket.hasReceiveMore();
return data;
}
/**
* Receives single frame from socket, returns the received frame object, or null if the recv was interrupted. Does a
* blocking recv, if you want to not block then use recvFrame(socket, ZMQ.DONTWAIT);
*
* @param socket Socket to read from
* @return received frame, else null
*/
public static ZFrame recvFrame(Socket socket) {
ZFrame f = new ZFrame();
f.recv(socket, 0);
return f;
}
/**
* Receive a new frame off the socket, Returns newly-allocated frame, or null if there was no input waiting, or if
* the read was interrupted.
*
* @param socket Socket to read from
* @param flags Pass flags to 0MQ socket.recv call
* @return received frame, else null
*/
public static ZFrame recvFrame(Socket socket, int flags) {
ZFrame f = new ZFrame();
f.recv(socket, flags);
return f;
}
public void print(String prefix) {
StringWriter sw = new StringWriter();
PrintWriter pw = new PrintWriter(sw);
if (prefix != null)
pw.printf("%s", prefix);
byte[] data = getData();
int size = size();
boolean is_bin = false;
int char_nbr;
for (char_nbr = 0; char_nbr < size; char_nbr++)
if (data[char_nbr] < 9 || data[char_nbr] > 127)
is_bin = true;
pw.printf("[%03d] ", size);
int max_size = is_bin ? 35 : 70;
String elipsis = "";
if (size > max_size) {
size = max_size;
elipsis = "...";
}
for (char_nbr = 0; char_nbr < size; char_nbr++) {
if (is_bin)
pw.printf("%02X", data[char_nbr]);
else
pw.printf("%c", data[char_nbr]);
}
pw.printf("%s\n", elipsis);
pw.flush();
pw.close();
try {
sw.close();
} catch (IOException e) {
}
System.out.print(sw.toString());
}
}
