The client:

package com.coralblocks.coralfix.sample;

import static com.coralblocks.coralfix.FixTags.*;

import com.coralblocks.coralfix.FixConstants.FixVersions;
import com.coralblocks.coralfix.FixConstants.MsgTypes;
import com.coralblocks.coralfix.FixGroup;
import com.coralblocks.coralfix.FixMessage;
import com.coralblocks.coralfix.FixTag;
import com.coralblocks.coralfix.FixTags;
import com.coralblocks.coralfix.client.FixApplicationClient;
import com.coralblocks.coralreactor.client.Client;
import com.coralblocks.coralreactor.nio.NioReactor;
import com.coralblocks.coralreactor.util.Configuration;
import com.coralblocks.coralreactor.util.MapConfiguration;

public class SimpleFixApplicationClient extends FixApplicationClient {
	
	// Add any extra / non-standard fix tag from your spec, so you can work with the name instead of the id
	private static FixTag MySpecialTag = FixTags.addTag("MySpecialTag", 3434);
	
	public SimpleFixApplicationClient(NioReactor nio, String localhost, int port, Configuration config) {
	    super(nio, localhost, port, config);
    }
	
	@Override
	protected void handleOpened() {
		// client was opened and will now try to connect to its destination
		
		// do anything you want to do here...
	}
	
	@Override
	protected void handleClosed() {
		// client was closed, its connection was terminated and it will now sit idle
		
		// do anything you want to do here...
	}
	
	@Override
	protected void handleConnectionEstablished() {
		// socket connection was established but no login handshake was done yet
		
		// do anything you want to do here...
	}
	
	@Override
	protected void handleConnectionOpened() {
		// the FIX session handshake through LOGON messages was performed...
		// the client is now ready to start sending/receiving messages
		
		// do anything you want to do here...
	}
	
	@Override
	protected void handleConnectionReady() {
		// any sequence reset or re-send request have been processed at the session level...
		// the client is now ready to start sending/receiving any business application messages
		
		// do anything you want to do here...
		
		sendNewOrderSingle();
	}
	
	private void sendNewOrderSingle() {
		
		FixMessage outFixMsg = getOutFixMessage(MsgTypes.NewOrderSingle);
		
		// Add the tags you want to outFixMsg
		// NOTE: there is no need to add any session-level tags like MsgSeqNum, SenderCompID, etc.
		outFixMsg.add(Price, 50.34);
		outFixMsg.addTimestamp(TransactTime, System.currentTimeMillis());
		outFixMsg.add(ClOrdID, "A123");
		outFixMsg.add(MySpecialTag, 'Y');
		
		// Add a repeating group
		FixGroup partyIds = outFixMsg.createGroup(NoPartyIDs);
		partyIds.nextElement().add(PartyID, "BLAH").add(PartyIDSource, 'D').add(PartyRole, 54);
		partyIds.nextElement().add(PartyID, "TRD").add(PartyIDSource, 'D').add(PartyRole, 36);
		partyIds.nextElement().add(PartyID, "FOO").add(PartyIDSource, 'D').add(PartyRole, 7);
		
		// Send out the message to the client
		send(outFixMsg);
	}
	
	@Override
	protected void handleConnectionTerminated() {
		// the socket connection was broken/terminated
		
		// do anything you want to do here...
	}
	
	@Override
	protected void prepareLogon(FixMessage outFixMsg) {
		super.prepareLogon(outFixMsg);
		
		// add/remove any tag here... probably not necessary because the base
		// class is already adding all the required tags
	}
	
	@Override
	protected void handleFixApplicationMessage(FixMessage fixMsg, boolean possDupe) {
		
		// do what you have to do with this FIX application message
	}		
	
	public static void main(String[] args) {
		
		String senderComp = args.length > 0 ? args[0] : "testClient";
		
		NioReactor nio = NioReactor.create();
		
		MapConfiguration config = new MapConfiguration();
		
		// REQUIRED
		config.add("fixVersion", FixVersions.VERSION_44);
		
		// the senderComp of the fix client
		// REQUIRED
		config.add("senderComp", senderComp);
		
		// NOT required:
		// config.add("targetComp", "testAcct"); // the TargetCompID tag
		// config.add("senderSub", "xxx"); // the SenderSubID tag
		// config.add("targetSub", "yyy"); // the TargetSubID tag
		// config.add("senderLoc", "aaa"); // the SenderLocationID tag
		// config.add("heartbeat", "20"); // the HeartBtInt tag (defaults to 10 seconds)
		// config.add("encryption", "1"); // the EncryptMethod tag (defaults to 0)
		// config.add("username", "myusername"); // sends the Username tag with the Logon message
		// config.add("password", "mypass"); // the RawData tag (the RawDataLength tag will also be included)
		
		// print all messages received and sent to STDOUT for debugging purposes
		// (default is false)
		config.add("debugMessages", true);
		// config.add("debugHeartbeats", true); // show heartbeats as well (default is true)
		
		// send a ResetSeqNumFlag=Y on Logon to force a sequence reset on both sides (inbound and outbound)
		// (default is false)
		config.add("forceSeqReset", true);
		
		// turn on asynchronous audit logging
		// (default is false)
		config.add("auditLog", false);
		// config.add("auditLogDir", "/mylogdir/"); // set the folder where to save the audit log file (default is "auditLog")
		
		// turn on asynchronous fix logging (human readable fix messages)
		// (default is false)
		config.add("fixLog", false);
		// config.add("fixLogDir", "/mylogdir"); // set the folder where to save the fix log file (default is "fixLog")
		// config.add("fixLogHeartbeats", true); // log heartbeats to the fix log (default is false)
		
		// persist sequences asynchronously to a file, so you don't lose them across restarts
		// (default is false)
		config.add("persistSequences", false);
		// config.add("persistDir", "mySeqFolder"); // the folder where to store the sequence files (default is current dir)
		// config.add("persistFilename, "mySeqFilename"); // the filename of the sequence file (default is the client name)
		
		// persists outbound fix messages asynchronously for message resends / gap fills
		// (default is false)
		config.add("supportPersistence", false);
		
		// open the admin server to accept telnet connections to monitor and control this fix client
		// (default is false)
		config.add("adminServer", false);
		
		// change the port for the admin server
		// (default is 45441)
		config.add("adminServerPort", 45441);
		
		// change to put the outbound FIX store in another thread
		// (default is true)
		config.add("fixStoreAsync", false);
		
		// set heartbeat interval in seconds
		// (default is 10)
		config.add("heartbeat", 5);
		
		/*
		// More optional config parameters
		// IMPORTANT: The default values should be what you want most of the time!
		
		config.add("includeLastMsgSeqNumProcessedTag", false); // include this header tag on every fix message? (default is true)
		
		config.add("maxLogonAttempts", 10); // if Logon fail for whatever reason, retry (default is 5)
		
		config.add("secondsToReopenAfterClose", 60 * 10); // if can't logon, then client will be closed and re-open after N seconds (default is 300)
		
		config.add("sendLogoutOnClose", false); // on a client close, a logout message will be sent (default is false)
		
		config.add("sendLogonOnConnected", true); // when socket is estabilished send logon automatically (default is true)
		
		config.add("persistSequencesImmediately", false); // force the mmap file to commit the the sequences to disk immediately (default is false)
		
		config.add("sequence", 1); // the initial inbound sequence (default is 1 or whatever is persisted if persistence is on)
		
		config.add("outboundSeq", 1); // the initial outbound sequence (default is 1 or wahtever is persisted if persitence is on)
		
		config.add("acceptInboundSeqFromServer", false); // accept whatever sequence you get from server as your inbound sequence (default is false)
		
		config.add("disconnectOnGap", false); // disconnect on gap instead of sending a sequence reset / message retransmission (default is false)
		
		config.add("reconnectOnStartTimerEvent", true); // when using a start timer, reconnect if connected (default is true)
		
		config.add("resetSequencesOnStartTimerEvent", true); // when using a start timer, reset the sequences (default is true)
		 */
		
		/*
		// More optional config parameters related to the max size of FIX messages:
		
		config.add("fixMaxTags", 64); // max number of tags, not including tags from repeating groups (defaults to 64)
		config.add("fixMaxGroups", 8); // max number of different repeating groups a message can have (defaults to 8)
		config.add("fixMaxValueLength", 256); // max length of a tag value in characters (defaults to 256)
		config.add("fixMaxGroupElements", 64); // max number of repeating group elements (defaults to 64)
		config.add("fixMaxValuesPerGroupElement", 64); // max number of repeating group tags/values per group element (defaults to 64)
		 */
		
		Client client = new SimpleFixApplicationClient(nio, "localhost", 45451, config);
		client.open();
		
		nio.start();
	}
}

The server:

package com.coralblocks.coralfix.sample;

import static com.coralblocks.coralfix.FixTags.*;

import java.util.Iterator;

import com.coralblocks.coralfix.FixConstants.FixVersions;
import com.coralblocks.coralfix.FixConstants.MsgTypes;
import com.coralblocks.coralfix.FixGroup;
import com.coralblocks.coralfix.FixGroupElement;
import com.coralblocks.coralfix.FixMessage;
import com.coralblocks.coralfix.FixTag;
import com.coralblocks.coralfix.FixTags;
import com.coralblocks.coralfix.server.FixApplicationServer;
import com.coralblocks.coralreactor.client.Client;
import com.coralblocks.coralreactor.nio.NioReactor;
import com.coralblocks.coralreactor.util.Configuration;
import com.coralblocks.coralreactor.util.MapConfiguration;

public class SimpleFixApplicationServer extends FixApplicationServer {
	
	// Add any extra / non-standard fix tag from your spec, so you can work with the name instead of the id
	private static FixTag MySpecialTag = FixTags.addTag("MySpecialTag", 3434);

	public SimpleFixApplicationServer(NioReactor nio, int port, Configuration config) {
		super(nio, port, config);
		
	    // Specify the repeating group you expect to parse, for each message type:
	    addGroupTemplate(MsgTypes.NewOrderSingle, NoPartyIDs, PartyID, PartyIDSource, PartyRole);
	    
	   /* Explanation about addGroupTemplate above:
        *
        * MsgTypes.NewOrderSingle is the message type containing the repeating group
        *    
        * NoPartyIDs is the main repeating group tag, meaning the repeating groups will
        * start after that tag. This tag contains the number (i.e. an integer) of repeating groups that follow.
        *
        * PartyID is the very first tag that every repeating group will have. That's important
        * to correctly denote the starting of a new repeating group and is enforced by the
        * FIX spec (i.e. you can't start a new repeating group with another tag)
        *
        * PartyIDSource, PartyRole, etc. are all the other tags (not included the very first
        * one above) that this repeating group can contain. They can be specified in any order
        * and can appear in the repeating group in any order. They are also all optional, in other words,
        * they do not need to appear in the FIX message BUT THEY DO HAVE TO BE SPECIFIED HERE, ALL OF THEM.
        */
    }
	
	@Override
	protected void handleOpened() {
		// sever was opened and will now accept connections from clients...
		
		// do anything you want to do here...
	}
	
	@Override
	protected void handleClosed() {
		// server was closed, all clients were disconnected and it will not accept any connection...
		
		// do anything you want to do here...
	}
	
	@Override
	protected void handleConnectionEstablished(Client client) {
		// socket connection was established for a client but no login handshake was done yet
		
		// do anything you want to do here...
	}
	
	@Override
	protected void handleConnectionOpened(Client client) {
		// the FIX session handshake through LOGON messages was performed for this client...
		// the client is now ready to start sending/receiving messages
		
		// do anything you want to do here...
	}
	
	@Override
	protected void handleConnectionReady(Client client) {
		// any sequence reset or re-send request have been processed at the session level...
		// the client is now ready to start sending/receiving any business application messages
		
		// do anything you want to do here...
	}
	
	@Override
	protected void handleConnectionTerminated(Client client) {
		// the socket connection was broken/terminated for this client
		
		// do anything you want to do here...
	}
	
	@Override
	protected void handleFixApplicationMessage(Client client, FixMessage fixMsg, boolean possDupe) {
		
		// do whatever you want to do with the application message received from this client...
		
		if (fixMsg.checkType(MsgTypes.NewOrderSingle)) {
			
			double price = fixMsg.getDouble(Price);
			System.out.println("Read price: " + price);
			
			CharSequence clOrdID = fixMsg.getCharSequence(ClOrdID);
			System.out.println("Read ClOrdID: " + clOrdID);
			
			char mySpecialTag = fixMsg.getChar(MySpecialTag);
			System.out.println("Read MySpecialTag: " + mySpecialTag);
			
			FixGroup fixGroup = fixMsg.getGroup(NoPartyIDs);
			System.out.println(fixGroup.getNumberOfElements());
		 
			// you can also print the whole fix group for debugging purposes:
			System.out.println(fixGroup);
		         
	        Iterator<FixGroupElement> iter = fixGroup.iterator();
		         
	        while(iter.hasNext()) {
	             
	            FixGroupElement elem = iter.next();
	            
	            CharSequence partyID = elem.getCharSequence(PartyID);
	            System.out.println(partyID);
	            
	            char partyIDSource = elem.getChar(PartyIDSource);
	            System.out.println(partyIDSource);
	            
	            int partyRole = elem.getInt(PartyRole);
	            System.out.println(partyRole);
	             
	            // you can also print the whole element for debugging purposes:
	            System.out.println(elem);
	        }
		}
	}
	
	public static void main(String[] args) {

		NioReactor nio = NioReactor.create();
		
		MapConfiguration config = new MapConfiguration();
		
		// REQUIRED
		config.add("fixVersion", FixVersions.VERSION_44);
		
		// print all messages received and sent to STDOUT for debugging purposes
		// (default is false)
		config.add("debugMessages", true);
		
		// accept as the client inbound sequence whatever sequence I receive in the first message coming from the client
		// (default is false)
		config.add("acceptInboundSeqFromClient", false);
		
		// turn on asynchronous audit logging
		// (default is false)
		config.add("auditLog", false);
		
		// turn on asynchronous fix logging (human readable fix messages)
		// (default is false)
		config.add("fixLog", false);
		
		// persist all sequences from all clients (senderCompIDs) to disk
		// (default is false)
		config.add("persistSequences", false);
		
		// support persistence of outbound fix messages for message resends / gap fills
		// (default is false)
		config.add("supportPersistence", false);
		
		// enable the telnet admin server
		// (default is false)
		config.add("adminServer", false);
		
		// change the port for the admin server
		// (default is 45442)
		config.add("adminServerPort", 45442);
		
		// change to put the outbound FIX store in another thread
		// (default is true)
		config.add("fixStoreAsync", false);
		
		FixApplicationServer server = new SimpleFixApplicationServer(nio, 45451, config);
		server.open();

		nio.start();
	}
}

Server log output:

$ ./bin/run.sh com.coralblocks.coralfix.sample.SimpleFixApplicationServer
java -DshutdownHooksDebug=true -server -Dapple.awt.UIElement=true -XX:+UseCompressedOops -XX:+OptimizeStringConcat -Xms2g -Xmx8g -XX:NewSize=512m -XX:MaxNewSize=1024m -cp target/coralfix-all.jar:lib/jna-3.5.1.jar -DlogColors=true -DlogLevel=Info -DnioReactorPerformanceBoost=OFF com.coralblocks.coralfix.sample.SimpleFixApplicationServer
20:43:49.352039-INFO SimpleFixApplicationServer-45451 Server opened! bindAddress=/0.0.0.0:45451 actualBindAddress=/0:0:0:0:0:0:0:0:45451 host=0.0.0.0 port=45451 readServerSocketBufferSize=6710884 serverSocketReuseBindPort=false
20:43:49.352559-INFO NioReactor Reactor started! type=OptimumNioReactor datagramChannelImpl=DatagramChannelImpl selectorImpl=KQueueSelectorImpl supportConcurrentCallbacks=true
20:44:04.047525-INFO SimpleFixApplicationServer-45451 Client connection established! client=SimpleFixApplicationServerClient-127.0.0.1:59061 writeBufferSize=16384 readBufferSize=16384 writeSocketBufferSize=6710884 readSocketBufferSize=6710884
20:44:04.054598-SYSOUT SimpleFixApplicationServer-45451 IN <= BeginString(8)=FIX.4.4 BodyLength(9)=72 MsgType(35)=Logon("A") MsgSeqNum(34)=1 SenderCompID(49)=testClient LastMsgSeqNumProcessed(369)=0 SendingTime(52)=20250620-23:44:04.053 EncryptMethod(98)=0 HeartBtInt(108)=5 ResetSeqNumFlag(141)=Y CheckSum(10)=126
20:44:04.054836-INFO SimpleFixApplicationServer-45451 Received Logon message from client! client=SimpleFixApplicationServerClient-127.0.0.1:59061 senderComp=testClient seq=1 logonReceived="8=FIX.4.4|9=72|35=A|34=1|49=testClient|369=0|52=20250620-23:44:04.053|98=0|108=5|141=Y|10=126|"
20:44:04.055120-EVENT SimpleFixApplicationServer-45451 Client is forcing a sequence reset with tag ResetSeqNumFlag! client=SimpleFixApplicationServerClient-127.0.0.1:59061 nextExpectedSeq=2 nextOutboundSeq=1 senderComp=testClient
20:44:04.055196-INFO SimpleFixApplicationServer-45451 Client connection opened! client=SimpleFixApplicationServerClient-127.0.0.1:59061
20:44:04.055880-SYSOUT SimpleFixApplicationServer-45451 OUT => BeginString(8)=FIX.4.4 BodyLength(9)=72 MsgType(35)=Logon("A") MsgSeqNum(34)=1 TargetCompID(56)=testClient LastMsgSeqNumProcessed(369)=1 SendingTime(52)=20250620-23:44:04.056 HeartBtInt(108)=5 EncryptMethod(98)=0 ResetSeqNumFlag(141)=Y CheckSum(10)=128
20:44:04.056089-INFO SimpleFixApplicationServer-45451 Client logged to fix session! client=SimpleFixApplicationServerClient-127.0.0.1:59061 senderComp=testClient heartbeat=5 isResetSeqNumFlag=false logonSent="8=FIX.4.4|9=72|35=A|34=1|56=testClient|369=1|52=20250620-23:44:04.056|108=5|98=0|141=Y|10=XXX|"
20:44:06.556871-INFO SimpleFixApplicationServer-45451 Connection is now ready! client=SimpleFixApplicationServerClient-127.0.0.1:59061 connectionReadyInterval=2500
20:44:06.568439-SYSOUT SimpleFixApplicationServer-45451 IN <= BeginString(8)=FIX.4.4 BodyLength(9)=173 MsgType(35)=NewOrderSingle("D") MsgSeqNum(34)=2 SenderCompID(49)=testClient LastMsgSeqNumProcessed(369)=1 SendingTime(52)=20250620-23:44:06.564 Price(44)=50.34 TransactTime(60)=20250620-23:44:06.561 ClOrdID(11)=A123 MySpecialTag(3434)=Y [NoPartyIDs(453)=3 | PartyID(448)=BLAH PartyIDSource(447)=D PartyRole(452)=54 | PartyID(448)=TRD PartyIDSource(447)=D PartyRole(452)=36 | PartyID(448)=FOO PartyIDSource(447)=D PartyRole(452)=7] CheckSum(10)=120
Read price: 50.34
Read ClOrdID: A123
Read MySpecialTag: Y
3
PartyID(448)=BLAH PartyIDSource(447)=D PartyRole(452)=54 | PartyID(448)=TRD PartyIDSource(447)=D PartyRole(452)=36 | PartyID(448)=FOO PartyIDSource(447)=D PartyRole(452)=7
BLAH
D
54
PartyID(448)=BLAH PartyIDSource(447)=D PartyRole(452)=54
TRD
D
36
PartyID(448)=TRD PartyIDSource(447)=D PartyRole(452)=36
FOO
D
7
PartyID(448)=FOO PartyIDSource(447)=D PartyRole(452)=7
20:44:09.057270-SYSOUT SimpleFixApplicationServer-45451 OUT => BeginString(8)=FIX.4.4 BodyLength(9)=55 MsgType(35)=Heartbeat("0") MsgSeqNum(34)=2 TargetCompID(56)=testClient LastMsgSeqNumProcessed(369)=2 SendingTime(52)=20250620-23:44:09.057 CheckSum(10)=096
20:44:11.559755-SYSOUT SimpleFixApplicationServer-45451 IN <= BeginString(8)=FIX.4.4 BodyLength(9)=55 MsgType(35)=Heartbeat("0") MsgSeqNum(34)=3 SenderCompID(49)=testClient LastMsgSeqNumProcessed(369)=2 SendingTime(52)=20250620-23:44:11.558 CheckSum(10)=098
20:44:14.059070-SYSOUT SimpleFixApplicationServer-45451 OUT => BeginString(8)=FIX.4.4 BodyLength(9)=55 MsgType(35)=Heartbeat("0") MsgSeqNum(34)=3 TargetCompID(56)=testClient LastMsgSeqNumProcessed(369)=3 SendingTime(52)=20250620-23:44:14.059 CheckSum(10)=096
20:44:16.561967-SYSOUT SimpleFixApplicationServer-45451 IN <= BeginString(8)=FIX.4.4 BodyLength(9)=55 MsgType(35)=Heartbeat("0") MsgSeqNum(34)=4 SenderCompID(49)=testClient LastMsgSeqNumProcessed(369)=3 SendingTime(52)=20250620-23:44:16.560 CheckSum(10)=098

Client log output:

$ ./bin/run.sh com.coralblocks.coralfix.sample.SimpleFixApplicationClient
java -DshutdownHooksDebug=true -server -Dapple.awt.UIElement=true -XX:+UseCompressedOops -XX:+OptimizeStringConcat -Xms2g -Xmx8g -XX:NewSize=512m -XX:MaxNewSize=1024m -cp target/coralfix-all.jar:lib/jna-3.5.1.jar -DlogColors=true -DlogLevel=Info -DnioReactorPerformanceBoost=OFF com.coralblocks.coralfix.sample.SimpleFixApplicationClient
20:44:04.043041-INFO SimpleFixApplicationClient-testClient-localhost:45451 Client opened! sequence=1 session=null shouldResetSeqOnOpen=false
20:44:04.045146-INFO SimpleFixApplicationClient-testClient-localhost:45451 Bound socket channel! bindAddress=null boundTo=0.0.0.0:59061 bindPortProvider=null writeBufferSize=16384 readBufferSize=16384 writeSocketBufferSize=6710884 readSocketBufferSize=6710884
20:44:04.046328-INFO NioReactor Reactor started! type=OptimumNioReactor datagramChannelImpl=DatagramChannelImpl selectorImpl=KQueueSelectorImpl supportConcurrentCallbacks=true
20:44:04.051103-INFO SimpleFixApplicationClient-testClient-localhost:45451 Connection established!
20:44:04.051186-EVENT SimpleFixApplicationClient-testClient-localhost:45451 Resetting outbound sequence to 1! oldOutboundSeq=1
20:44:04.051224-INFO SimpleFixApplicationClient-testClient-localhost:45451 Connected to server! Sending Logon message... senderCompID=testClient isResettingSequences=true outboundSeq=1 logonAttempts=1
20:44:04.053586-SYSOUT SimpleFixApplicationClient-testClient-localhost:45451 OUT => BeginString(8)=FIX.4.4 BodyLength(9)=72 MsgType(35)=Logon("A") MsgSeqNum(34)=1 SenderCompID(49)=testClient LastMsgSeqNumProcessed(369)=0 SendingTime(52)=20250620-23:44:04.053 EncryptMethod(98)=0 HeartBtInt(108)=5 ResetSeqNumFlag(141)=Y CheckSum(10)=126
20:44:04.053907-INFO SimpleFixApplicationClient-testClient-localhost:45451 Sent Logon message to server! logonSent="8=FIX.4.4|9=72|35=A|34=1|49=testClient|369=0|52=20250620-23:44:04.053|98=0|108=5|141=Y|10=XXX|"
20:44:04.056825-SYSOUT SimpleFixApplicationClient-testClient-localhost:45451 IN <= BeginString(8)=FIX.4.4 BodyLength(9)=72 MsgType(35)=Logon("A") MsgSeqNum(34)=1 TargetCompID(56)=testClient LastMsgSeqNumProcessed(369)=1 SendingTime(52)=20250620-23:44:04.056 HeartBtInt(108)=5 EncryptMethod(98)=0 ResetSeqNumFlag(141)=Y CheckSum(10)=128
20:44:04.056950-INFO SimpleFixApplicationClient-testClient-localhost:45451 Received Logon response from server! sequence=1 hearbeat=5 logonReceived="8=FIX.4.4|9=72|35=A|34=1|56=testClient|369=1|52=20250620-23:44:04.056|108=5|98=0|141=Y|10=128|"
20:44:04.057000-EVENT SimpleFixApplicationClient-testClient-localhost:45451 Server is forcing a sequence reset with tag ResetSeqNumFlag! newInboundSequence=2 newOutboundSeq=2
20:44:04.057036-INFO SimpleFixApplicationClient-testClient-localhost:45451 Connection opened!
20:44:06.557617-INFO SimpleFixApplicationClient-testClient-localhost:45451 Connection is now ready! connectionReadyInterval=2500
20:44:06.564415-SYSOUT SimpleFixApplicationClient-testClient-localhost:45451 OUT => BeginString(8)=FIX.4.4 BodyLength(9)=173 MsgType(35)=NewOrderSingle("D") MsgSeqNum(34)=2 SenderCompID(49)=testClient LastMsgSeqNumProcessed(369)=1 SendingTime(52)=20250620-23:44:06.564 Price(44)=50.34 TransactTime(60)=20250620-23:44:06.561 ClOrdID(11)=A123 MySpecialTag(3434)=Y [NoPartyIDs(453)=3 | PartyID(448)=BLAH PartyIDSource(447)=D PartyRole(452)=54 | PartyID(448)=TRD PartyIDSource(447)=D PartyRole(452)=36 | PartyID(448)=FOO PartyIDSource(447)=D PartyRole(452)=7] CheckSum(10)=120
20:44:09.058828-SYSOUT SimpleFixApplicationClient-testClient-localhost:45451 IN <= BeginString(8)=FIX.4.4 BodyLength(9)=55 MsgType(35)=Heartbeat("0") MsgSeqNum(34)=2 TargetCompID(56)=testClient LastMsgSeqNumProcessed(369)=2 SendingTime(52)=20250620-23:44:09.057 CheckSum(10)=096
20:44:11.558729-SYSOUT SimpleFixApplicationClient-testClient-localhost:45451 OUT => BeginString(8)=FIX.4.4 BodyLength(9)=55 MsgType(35)=Heartbeat("0") MsgSeqNum(34)=3 SenderCompID(49)=testClient LastMsgSeqNumProcessed(369)=2 SendingTime(52)=20250620-23:44:11.558 CheckSum(10)=098
20:44:14.060615-SYSOUT SimpleFixApplicationClient-testClient-localhost:45451 IN <= BeginString(8)=FIX.4.4 BodyLength(9)=55 MsgType(35)=Heartbeat("0") MsgSeqNum(34)=3 TargetCompID(56)=testClient LastMsgSeqNumProcessed(369)=3 SendingTime(52)=20250620-23:44:14.059 CheckSum(10)=096
20:44:16.560829-SYSOUT SimpleFixApplicationClient-testClient-localhost:45451 OUT => BeginString(8)=FIX.4.4 BodyLength(9)=55 MsgType(35)=Heartbeat("0") MsgSeqNum(34)=4 SenderCompID(49)=testClient LastMsgSeqNumProcessed(369)=3 SendingTime(52)=20250620-23:44:16.560 CheckSum(10)=098

You can implement your own UDP and TCP clients and servers through the classes AbstractUdpClient, AbstractTcpClient and AbstractTcpServer. See further below this article for an example of an UDP client implementation.

It also comes with some clients and servers you can use out of the box. They are: LineTcpClient/LineTcpServer (messages delimited by the newline character), BytePayloadTcpClient/BytePayloadTcpServer (payload protocol with a byte size) and ShortPayloadTcpClient/ShortPayloadTcpServer (payload protocol with a short size). Below an example of a client that extends LineTcpClient to receive messages delimited by the newline character and print them to the console.

package com.coralblocks.coralreactor.client.print;

import java.nio.ByteBuffer;

import com.coralblocks.coralbits.util.ByteBufferUtils;
import com.coralblocks.coralreactor.client.Client;
import com.coralblocks.coralreactor.client.line.LineTcpClient;
import com.coralblocks.coralreactor.nio.NioReactor;
import com.coralblocks.coralreactor.util.Configuration;
import com.coralblocks.coralreactor.util.MapConfiguration;

public class PrintLineClient extends LineTcpClient {

	public PrintLineClient(NioReactor nio, String host, int port, Configuration config) {
	    super(nio, host, port, config);
    }
	
	@Override
	protected void handleOpened() {
		// the client was open and will now start trying to connect to its destination...
		
		// do whatever you want here...
	}
	
	@Override
	protected void handleClosed() {
		// the client was closed and will now do nothing (won't connect to anywhere and just sit idle)
		
		// do whatever you want here...
	}
	
	@Override
	protected void handleConnectionEstablished() {
		// a network connection was established
		// for TCP this is a socket connection
		// for UDP that means a packet was received so a "connection" can be assumed
		
		// do whatever you want here...
	}
	
	@Override
	protected void handleConnectionOpened() {
		// any special protocol login, handshake, authentication, etc. was successfully done
		// client is now ready to start exchanging messages
		// by default a connection is opened as soon as it is established but some special clients require
		// some initial login, handshake, authentication, etc. before they can start sending/receiving messages
		
		// do whatever you want here...
		
		send("Hello there!");
	}
	
	@Override
	protected void handleConnectionTerminated() {
		// the connection was broken or terminated for any reason...
		// for TCP this is a socket termination or the disconnect() method was explicitly called on the client
		// for UDP this is a read timeout (lack of heartbeat and data for some time) or the disconnect() method was explicitly called
		// after the connection is terminated the client will automatically try to reconnect unless the close() method is called
		
		// do whatever you want here...
	}
	
	@Override
	protected void handleMessage(ByteBuffer msg) {
		
		// here is an application message received by this client...
		// it does NOT include the newline character
		
		ByteBufferUtils.println(msg);
	}
	
	public static void main(String[] args) {
		
		NioReactor nio = NioReactor.create();
		
		MapConfiguration config = new MapConfiguration();
		
		Client client = new PrintLineClient(nio, "localhost", 45151, config);
		client.open();
		
		nio.start();
	}
}

You can easily simulate a server with netcat:

The log output from the client is:

21:20:39.023705-INFO PrintClient-localhost:45151 Client opened! sequence=1 session=null
21:20:39.083586-INFO NioReactor Reactor started! type=OptimumNioReactor impl=KQueueSelectorImpl
21:20:39.085061-INFO PrintClient-localhost:45151 Connection established!
21:20:39.085096-INFO PrintClient-localhost:45151 Connection opened!
[hi]
[this is a test]
[how are you?]

The code for a server is very similar, the difference being that all methods have a client argument since the server can handle many clients simultaneously. To make it more interesting we add a timer on each client to send a message every N seconds.

package com.coralblocks.coralreactor.server.print;

import java.nio.ByteBuffer;

import com.coralblocks.coralbits.util.ByteBufferUtils;
import com.coralblocks.coralreactor.client.Client;
import com.coralblocks.coralreactor.nio.NioReactor;
import com.coralblocks.coralreactor.server.Server;
import com.coralblocks.coralreactor.server.line.LineTcpServer;
import com.coralblocks.coralreactor.util.Configuration;
import com.coralblocks.coralreactor.util.MapConfiguration;

public class PrintLineServer extends LineTcpServer {
	
	private final int interval;

	public PrintLineServer(NioReactor nio, int port, Configuration config) {
	    super(nio, port, config);
	    this.interval = config.getInt("interval", 1000); // 1 second by default
    }
	
	@Override
	protected void handleOpened() {
		// the server was open and will now start accepting connections (i.e. clients)
		
		// do whatever you want here...
	}
	
	@Override
	protected void handleClosed() {
		// the server was closed, all clients was closed and the server will not accept any more connections
		
		// do whatever you want here...
	}
	
	@Override
	protected void handleConnectionEstablished(Client client) {
		// a network connection was established with the given client
		
		// do whatever you want here...
	}
	
	@Override
	protected void handleConnectionOpened(Client client) {
		// any special protocol login, handshake, authentication, etc. was successfully done
		// client is now ready to start exchanging messages
		// by default a connection is opened as soon as it is established but special clients require
		// some initial login, handshake, authentication, etc. before they can start sending/receiving messages
		
		// do whatever you want here...
		
		client.setEventTimeout(interval);
	}
	
	@Override
	public void handleEventTimeout(Client client, long now, int timeout) {
		client.send("Hello");
		client.setEventTimeout(timeout); // timers trigger just once so re-register for another trigger
	}
	
	@Override
	protected void handleConnectionTerminated(Client client) {
		// the connection with the given client was closed
		
		// do whatever you want here...
	}
	
	@Override
	protected void handleMessage(Client client, ByteBuffer msg) {
		
		// here is an application message received by the given client...
		// it does NOT include the newline character
		
		if (ByteBufferUtils.equals(msg, "bye")) {
			client.close();
			return;
		}
		
		System.out.print("Message from ");
		System.out.print(client);
		System.out.print(" ");
		
		ByteBufferUtils.println(msg);
	}
	
	public static void main(String[] args) {
		
		NioReactor nio = NioReactor.create();
		
		MapConfiguration config = new MapConfiguration();
		config.add("interval", 2000); // 2 seconds
		
		Server server = new PrintLineServer(nio, 45151, config);
		server.open();
		
		nio.start();
	}
}

To connect to the server we can use the PrintLineClient we just wrote. For simplicity we just use netcat:

The log output from the server is:

21:50:51.014509-INFO PrintLineServer-45151 Server opened! host=0.0.0.0 port=45151
21:50:51.017752-INFO NioReactor Reactor started! type=OptimumNioReactor impl=KQueueSelectorImpl
21:51:13.404784-INFO TcpServerClient-127.0.0.1:54391 Client connection established!
21:51:13.404828-INFO TcpServerClient-127.0.0.1:54391 Client connection opened!
Message from TcpServerClient-127.0.0.1:54391 [Hi]
21:51:30.109062-INFO PrintLineServer-45151 Client disconnected: TcpServerClient-127.0.0.1:54391

You can also code your own clients and servers through the AbstractUdpClient, AbstractTcpClient and AbstractTcpServer. Below an example of an UDP client that receives and prints packets.

package com.coralblocks.coralreactor.client.print;

import static com.coralblocks.corallog.Log.*;

import java.net.InetSocketAddress;
import java.nio.ByteBuffer;

import com.coralblocks.coralreactor.client.AbstractUdpClient;
import com.coralblocks.coralreactor.client.Client;
import com.coralblocks.coralreactor.nio.NioReactor;
import com.coralblocks.coralreactor.util.Configuration;
import com.coralblocks.coralreactor.util.MapConfiguration;

public class PrintPacketClient extends AbstractUdpClient {

	public PrintPacketClient(NioReactor nio, String host, int port, Configuration config) {
	    super(nio, host, port, config);
    }
	
	@Override
	protected void handleOpened() {
		// optional (here for clarity)
	}
	
	@Override
	protected void handleClosed() {
		// optional (here for clarity)
	}
	
	@Override
	protected void handleConnectionEstablished() {
		// optional (here for clarity)
	}
	
	@Override
	protected void handleConnectionOpened() {
		// optional (here for clarity)
	}
	
	@Override
	protected void handleConnectionTerminated() {
		// optional (here for clarity)
	}
	
	@Override
	protected void handleMessage(InetSocketAddress from, ByteBuffer msg) {
		Info.log(name, "Got packet:", msg);
	}
	
	public static void main(String[] args) {
		
		NioReactor nio = NioReactor.create();
		
		MapConfiguration config = new MapConfiguration();
		
		Client client = new PrintPacketClient(nio, "0.0.0.0", 45151, config);
		client.open();
		
		nio.start();
	}	
}

To code an UDP client that only sends packets, we can extend SenderUdpClient as below:

package com.coralblocks.coralreactor.client.sender;

import static com.coralblocks.corallog.Log.*;

import com.coralblocks.coralreactor.client.Client;
import com.coralblocks.coralreactor.nio.NioReactor;
import com.coralblocks.coralreactor.util.Configuration;
import com.coralblocks.coralreactor.util.MapConfiguration;

public class SenderPacketClient extends SenderUdpClient {
	
	private final int interval;

	public SenderPacketClient(NioReactor nio, String host, int port, Configuration config) {
	    super(nio, host, port, config);
	    this.interval = config.getInt("interval", 1000); // 1 second by default
    }
	
	@Override
	protected void handleOpened() {
		// optional (here for clarity)
	}
	
	@Override
	protected void handleClosed() {
		// optional (here for clarity)
	}
	
	@Override
	protected void handleConnectionEstablished() {
		// optional (here for clarity)
	}
	
	@Override
	protected void handleConnectionOpened() {
		setEventTimeout(interval);
	}
	
	@Override
	protected void handleConnectionTerminated() {
		// optional (here for clarity)
	}
	
	@Override
	protected void handleEventTimeout(long now, int timeout) {
		Info.log(name, "Sending packet...");
		send("Hello there!");
		if (isConnectionOpen()) { // just in case there was an error sending the UDP packet and the client was closed
			setEventTimeout(timeout); // re-register so it happens again (timers trigger only once)
		}
	}
	
	public static void main(String[] args) {
		
		NioReactor nio = NioReactor.create();
		
		MapConfiguration config = new MapConfiguration();
		
		config.add("sendAddress", "localhost");
		config.add("sendPort", 45151);
		
		String bindAddress = "0.0.0.0";
		int bindPort = 0; // choose any free port to bind (ephemeral port)
		
		Client client = new SenderPacketClient(nio, bindAddress, bindPort, config);
		client.open();
		
		nio.start();
	}
}

Now if we run both clients, we get the following log output:

02:53:41.328129-INFO SenderPacketClient-localhost:45151 Bound datagram channel to /0.0.0.0:55365
02:53:41.329297-INFO SenderPacketClient-localhost:45151 Client opened! sequence=1 session=null
02:53:41.331682-INFO SenderPacketClient-localhost:45151 Connection established!
02:53:41.333870-INFO SenderPacketClient-localhost:45151 Connection opened!
02:53:41.334212-INFO NioReactor Reactor started! type=OptimumNioReactor impl=KQueueSelectorImpl
02:53:41.800535-INFO SenderPacketClient-localhost:45151 Sending packet...
02:53:42.801833-INFO SenderPacketClient-localhost:45151 Sending packet...
02:53:43.802194-INFO SenderPacketClient-localhost:45151 Sending packet...

03:00:08.926596-INFO PrintPacketClient-0.0.0.0:45151 Bound datagram channel to /0.0.0.0:45151
03:00:08.927742-INFO PrintPacketClient-0.0.0.0:45151 Client opened! sequence=1 session=null
03:00:08.937026-INFO NioReactor Reactor started! type=OptimumNioReactor impl=KQueueSelectorImpl
03:00:08.943330-INFO PrintPacketClient-0.0.0.0:45151 Connection established!
03:00:08.943557-INFO PrintPacketClient-0.0.0.0:45151 Connection opened!
03:00:08.943622-INFO PrintPacketClient-0.0.0.0:45151 Got packet: Hello there!
03:00:09.838106-INFO PrintPacketClient-0.0.0.0:45151 Got packet: Hello there!
03:00:10.838293-INFO PrintPacketClient-0.0.0.0:45151 Got packet: Hello there!

		ByteBuffer byteBuffer = ByteBuffer.allocateDirect(1024);
		
		String storeDir = ".";
		String theSession = "theSession";
		
		// Store implementations:
		// - FileStore: in-disk
		// - MapStore: in-memory (for testing / debugging)
		// - CircularStore: in-memory (backed up by a circular array)
		// - CircularTailFileStore (hybrid of FileStore and CircularStore)
		Store store = new FileStore(storeDir, theSession);
		
		byteBuffer.clear();
		byteBuffer.put("A message".getBytes());
		byteBuffer.flip();
		
		store.addMessage(byteBuffer);
		
		byteBuffer.clear();
		byteBuffer.put("Another message".getBytes());
		byteBuffer.flip();
		
		store.addMessage(byteBuffer);
		
		store.flush();
		
		System.out.println("Store size: " + store.size()); // => 2
		System.out.println("Store next seq: " + store.getNextExpectedSequence()); // => 3
		
		byteBuffer.clear();
		int msgSize = store.getMessage(2, byteBuffer);
		System.out.println("Size read: " + msgSize); // => 15
		byteBuffer.flip();
		ByteBufferUtils.println(byteBuffer); // => [Another message]
		
		byteBuffer.clear();
		byteBuffer.put("Yet another message".getBytes());
		byteBuffer.flip();
		
		store.addMessage(byteBuffer);
		store.flush();

		System.out.println("Has sequence 2: " + store.checkSequence(2)); // => true
		System.out.println("Has sequence 4: " + store.checkSequence(4)); // => false
		
		System.out.println("Has range 2-3: " + store.checkRange(2, 2)); // => true
		System.out.println("Has range 2-4: " + store.checkRange(2, 3)); // => false
		
		store.close();

AsyncStore

To create an asynchronous store all you have to do is pass a store in the constructor of AsyncStore.

		Store store = new FileStore(storeDir, theSession);
		AsyncStore asyncStore = new AsyncStore(store);
		
		// now use it as you would use any store

		// one extra method:
		asyncStore.drainAndWait(); // block and drain

		asyncStore.close(); // returns immediately but don't worry: async store will be drained

Level Logging

// this static import is all you need to start using CoralLog:
import static com.coralblocks.corallog.Log.*;

// if you want to log to a file, instead of to the console (stdout)
Log.setFile(true); // or -DlogFile=true (you can also use a configuration file)
 
// then, anywhere in your code you can write:

Warn.log("This is a log message!", "string=", myString, "byteBuffer=", myByteBuffer, "price=", price);

Error.log(appName, "An exception happened:", exception);

Info.log(myStringBuilder);
Info.log(myByteBuffer);
Info.log(myByteArray);

// you can also use placeholders:

Debug.log("This is a log message! user={} age={}", "foo", 21);

Event Sourcing

// pass a filename to be created in the current directory
Logger myLogger = Log.createLogger("myLogFile.log");
 
// or you can pass the directory
Logger myLogger = Log.createLogger("/var/mydir/", "myLogFile.log");

// turn off timestamps before each log line
Logger myLogger = Log.createLogger("myLogFile.log", false); // no timestamps
 
// turn off timestamps before each log line
Logger myLogger = Log.createLogger("/var/mydir/", "myLogFile.log", false); // no timestamps

// then log as usual:

myLogger.log("This is a log message!", "string=", myString, "byteBuffer=", myByteBuffer, "price=", price);

myLogger.log(appName, "An exception happened:", exception);

myLogger.log(myStringBuilder);
myLogger.log(myByteBuffer);
myLogger.log(myByteArray);

// you can also use placeholders:

myLogger.log("This is a log message! user={} age={}", "foo", 21);

Using LogConfig

LogConfig logConfig = new LogConfig(filename); // current directory
// or LogConfig logConfig = new LogConfig(dir, filename);
logConfig.includeLogEntrySeparator = false; // default is true
logConfig.includeTopHeader = true; // default is false

Logger myLogger = Log.createLogger(logConfig);

Below all the LogConfig options with their defaults:

	public String dir = Log.getDir();
	public boolean isSynchronized = false;
	public boolean isMemoryMapped = false;
	public int memoryMappedBufferSize = 64 * 1024 * 1024; // 64m
	public List<Encoder> encoders = Log.getEncoders();
	public boolean isAsynchronous = true;
	public boolean includeTopHeader = false;
	public boolean includeLogEntrySeparator = true;
	public int outputBufferSize = 64 * 1024; // 64k (optimum)
	public boolean flushImmediately = false;
	public boolean includeTimestamp = true;
	public int secondsToFlush = -1;
	public boolean isNoSpaceBetweenObjects = false;

Queue

One producer sending messages to one consumer. One thread sending to another thread.

package com.coralblocks.coralqueue.sample.queue;

import com.coralblocks.coralqueue.AtomicQueue;
import com.coralblocks.coralqueue.Queue;
import com.coralblocks.coralqueue.util.MutableLong;

public class Sample {
	
	public static void main(String[] args) throws InterruptedException {
		
		final Queue<MutableLong> queue = new AtomicQueue<MutableLong>(1024, MutableLong.class);
		
		Thread consumer = new Thread() {
			
			@Override
			public void run() {
				
				boolean running = true;
				
				while(running) {
					long avail;
					while((avail = queue.availableToPoll()) == 0); // busy spin
					for(int i = 0; i < avail; i++) {
						MutableLong ml = queue.poll();
						if (ml.get() == -1) { // message to flag exit...
							running = false;
							break;
						}
						System.out.println(ml.get());
					}
					queue.donePolling();
				}
			}
			
		};
		
		consumer.start();
		
		MutableLong ml;
		
		for(int i = 0; i < 10; i++) {
			while((ml = queue.nextToDispatch()) == null); // busy spin
			ml.set(System.nanoTime());
			queue.flush();
		}
		
		// send a message to stop consumer...
		while((ml = queue.nextToDispatch()) == null); // busy spin
		ml.set(-1);
		queue.flush();
		
		consumer.join(); // wait for the consumer thread to die...
	}
}

Demultiplexer

One producer distributing messages to multiple consumers. Each message is processed only once by a random consumer. One thread sending to many threads. Great for parallel processing. Note that you can also route a message to a specific consumer (line 60).

package com.coralblocks.coralqueue.sample.demux;

import com.coralblocks.coralqueue.demux.AtomicDemux;
import com.coralblocks.coralqueue.demux.Consumer;
import com.coralblocks.coralqueue.demux.Demux;

public class SampleWithConsumer {

	private static final int NUMBER_OF_CONSUMERS = 4;
	
	public static void main(String[] args) throws InterruptedException {
		
		final Demux<StringBuilder> demux = new AtomicDemux<StringBuilder>(1024, StringBuilder.class, NUMBER_OF_CONSUMERS);
		
		Thread[] consumers = new Thread[NUMBER_OF_CONSUMERS];
		
		for(int i = 0; i < consumers.length; i++) {
			
    		consumers[i] = new Thread("Consumer-" + i) {
    			
    			private final Consumer<StringBuilder> consumer = demux.nextConsumer();
    			
    			@Override
    			public void run() {
    				
    				boolean running = true;
    				
    				while(running) {
    					long avail;
    					while((avail = consumer.availableToPoll()) == 0); // busy spin
    					for(int i = 0; i < avail; i++) {
    						StringBuilder sb = consumer.poll();
    						if (sb == null) break; // mandatory for demuxes!
    						if (sb.length() == 0) {
    							running = false;
    							break; // exit immediately...
    						}
    						System.out.println(sb.toString());
    					}
    					consumer.donePolling();
    				}
    			}
    		};
    		
    		consumers[i].start();
		}
		
		StringBuilder sb;
		
		for(int i = 0; i < 3; i++) {
			while((sb = demux.nextToDispatch()) == null); // busy spin
			sb.setLength(0);
			sb.append("message ").append(i);
			demux.flush();
		}
		
		// send a message to stop consumers...
		for(int i = 0; i < NUMBER_OF_CONSUMERS; i++) {
			// routing is being used here...
			while((sb = demux.nextToDispatch(i)) == null); // busy spin
			sb.setLength(0);
		}
		
		demux.flush(); // sent batch
		
		for(int i = 0; i < consumers.length; i++) consumers[i].join();
	}
}

Multiplexer

Multiple producers pipelining (i.e. sending) messages to a single consumer. Many threads sending to one thread. Great for gathering results from parallel processing.

package com.coralblocks.coralqueue.sample.mux;

import com.coralblocks.coralbits.util.Builder;
import com.coralblocks.coralqueue.mux.AtomicMux;
import com.coralblocks.coralqueue.mux.Mux;
import com.coralblocks.coralqueue.mux.Producer;

public class SampleWithProducer {
	
	private static final int NUMBER_OF_PRODUCERS = 4;
	
	public static void main(String[] args) throws InterruptedException {
		
		Builder<StringBuilder> builder = new Builder<StringBuilder>() {
			@Override
            public StringBuilder newInstance() {
	            return new StringBuilder(1024);
            }
		};
		
		final Mux<StringBuilder> mux = new AtomicMux<StringBuilder>(1024, builder, NUMBER_OF_PRODUCERS);
		
		Thread[] producers = new Thread[NUMBER_OF_PRODUCERS];
		
		for(int i = 0; i < producers.length; i++) {
			
			producers[i] = new Thread(new Runnable() {
				
				private final Producer<StringBuilder> producer = mux.nextProducer();

				@Override
                public void run() {
					
					StringBuilder sb;
					
					for(int j = 0; j < 4; j++) {
						while((sb = producer.nextToDispatch()) == null); // busy spin
						sb.setLength(0);
						sb.append("message ").append(j).append(" from producer ").append(producer.getIndex());
						producer.flush();
					}
					
					// send final message
					while((sb = producer.nextToDispatch()) == null); // busy spin
					sb.setLength(0); // empty string to signal we are done
					producer.flush();
                }
			}, "Producer" + i);
		}
		
		Thread consumer = new Thread(new Runnable() {

			@Override
            public void run() {
				
				boolean running = true;
				int finalMessages = 0;
				
				while(running) {
					
					long avail;
					while((avail = mux.availableToPoll()) == 0); // busy spin
					for(int i = 0; i < avail; i++) {
						StringBuilder sb = mux.poll();
						if (sb.length() == 0) {
							if (++finalMessages == NUMBER_OF_PRODUCERS) {
								// and we are done!
								running = false;
								break;
							}
						} else {
							System.out.println(sb.toString());
						}
					}
					mux.donePolling();
				}
            }
		}, "Consumer");
		
		consumer.start();
		for(int i = 0; i < producers.length; i++) producers[i].start();
		
		consumer.join();
		for(int i = 0; i < producers.length; i++) producers[i].join();
	}
}

Splitter / Broadcaster

One producer sending messages to multiple consumers. Each message is processed by each and every consumer. One thread sending to many threads. Great for broadcasting messages to multiple threads.

package com.coralblocks.coralqueue.sample.splitter;

import com.coralblocks.coralqueue.splitter.AtomicSplitter;
import com.coralblocks.coralqueue.splitter.Consumer;
import com.coralblocks.coralqueue.splitter.Splitter;

public class SampleWithConsumer {

	private static final int NUMBER_OF_CONSUMERS = 4;
	
	public static void main(String[] args) throws InterruptedException {
		
		final Splitter<StringBuilder> splitter = new AtomicSplitter<StringBuilder>(1024, StringBuilder.class, NUMBER_OF_CONSUMERS);
		
		Thread[] consumers = new Thread[NUMBER_OF_CONSUMERS];
		
		for(int i = 0; i < consumers.length; i++) {
			
    		consumers[i] = new Thread("Consumer-" + i) {
    			
    			private final Consumer<StringBuilder> consumer = splitter.nextConsumer();
    			
    			@Override
    			public void run() {
    				
    				boolean running = true;
    				
    				while(running) {
    					long avail;
    					while((avail = consumer.availableToPoll()) == 0); // busy spin
    					for(int i = 0; i < avail; i++) {
    						StringBuilder sb = consumer.poll();
    						if (sb == null) break; // mandatory for splitters!
    						if (sb.length() == 0) {
    							running = false;
    							break; // exit immediately...
    						}
    						System.out.println("got " + sb.toString() + " at consumer " + consumer.getIndex());
    					}
    					consumer.donePolling();
    				}
    			}
    		};
    		
    		consumers[i].start();
		}
		
		StringBuilder sb;
		
		for(int i = 0; i < 3; i++) {
			while((sb = splitter.nextToDispatch()) == null); // busy spin
			sb.setLength(0);
			sb.append("message ").append(i);
			splitter.flush();
		}
		
		// send a message to stop consumers...
		while((sb = splitter.nextToDispatch()) == null); // busy spin
		sb.setLength(0);
		splitter.flush();
		
		for(int i = 0; i < consumers.length; i++) consumers[i].join();
	}
}

MpmcQueue

Multiple-producers sending messages to multiple-consumers. You can choose any number of producers and consumers. You can also route a message to a specific consumer (line 90).

package com.coralblocks.coralqueue.sample.mpmc;

import java.util.concurrent.atomic.AtomicLong;

import com.coralblocks.coralqueue.mpmc.Consumer;
import com.coralblocks.coralqueue.mpmc.MpmcQueue;
import com.coralblocks.coralqueue.mpmc.Producer;

public class Sample {

	private static final int NUMBER_OF_PRODUCERS = 4;
	private static final int NUMBER_OF_CONSUMERS = 2;
	
	public static void main(String[] args) throws InterruptedException {
		
		final MpmcQueue<StringBuilder> mpmc = new MpmcQueue<StringBuilder>(1024, StringBuilder.class, NUMBER_OF_PRODUCERS, NUMBER_OF_CONSUMERS);
		
		Thread[] consumers = new Thread[NUMBER_OF_CONSUMERS];
		
		for(int i = 0; i < consumers.length; i++) {
			
    		consumers[i] = new Thread("Consumer-" + i) {
    			
    			private final Consumer<StringBuilder> consumer = mpmc.nextConsumer();
    			
    			@Override
    			public void run() {
    				
    				boolean running = true;
    				
    				while(running) {
    					long avail;
    					while((avail = consumer.availableToPoll()) == 0); // busy spin
    					for(int i = 0; i < avail; i++) {
    						StringBuilder sb = consumer.poll();
    						if (sb == null) break; // mandatory for mpmc!
    						if (sb.length() == 0) {
								running = false;
								break; // exit immediately...
    						}
    						System.out.println(sb.toString() + " got by consumer " + consumer.getIndex());
    					}
    					consumer.donePolling();
    				}
    			}
    		};
    		
    		consumers[i].start();
		}
		
		Thread[] producers = new Thread[NUMBER_OF_PRODUCERS];
		
		final AtomicLong counter = new AtomicLong(0);
		
		for(int i = 0; i < producers.length; i++) {
			
    		producers[i] = new Thread("Producer-" + i) {
    			
    			private final Producer<StringBuilder> producer = mpmc.nextProducer();
    			
    			@Override
    			public void run() {

    				StringBuilder sb;
    				
    				for(int i = 0; i < 3; i++) {
    					while((sb = producer.nextToDispatch()) == null); // busy spin
    					long msgNumber = counter.getAndIncrement();
    					sb.setLength(0);
    					sb.append("message ").append(msgNumber);
    					System.out.println("sending message " + msgNumber + " from producer " + producer.getIndex());
    					producer.flush();
    				}
    			}
    		};
    		
    		producers[i].start();
		}
		
		for(int i = 0; i < producers.length; i++) producers[i].join();
		
		Thread.sleep(4000);
		
		Producer<StringBuilder> p = mpmc.getProducer(0);
	
		for(int i = 0; i < consumers.length; i++) {
			StringBuilder sb;
			// send a message to stop consumers...
			// routing is being used here...
			while((sb = p.nextToDispatch(i)) == null); // busy spin
			sb.setLength(0);
		}
		
		p.flush();
		
		for(int i = 0; i < consumers.length; i++) consumers[i].join();
	}
}

import com.coralblocks.coralthreads.Affinity;
 
public class Basics {
     
    public static void main(String[] args) throws Exception {
         
        Thread thread = new Thread(new Runnable() {
 
            @Override
            public void run() {
 
                // must be the first thing inside the run method
                Affinity.bind();
                 
                try {
                     
                    while(true) {
                         
                        // do whatever you want here...
                    }
                     
                } finally {
                     
                    // must be the last thing inside the run method
                    Affinity.unbind();
                }
            }
        }, "MyPinnedThread");
         
        System.out.println();
        Affinity.printSituation(); // nothing done yet...
         
        // assign thread to processor:
        int procToBind = Integer.parseInt(args[0]);
        Affinity.assignToProcessor(procToBind, thread);
         
        Affinity.printSituation(); // now you see it there...
         
        // start the thread!
        thread.start();
         
        Affinity.printSituation(); // now it is running with a pid...
    }
}

Data Structures

All data structures have garbage-free iterators

Maps:

Sets:

Lists:

Pools:

Garbage Collector Utilities

Memory Allocation

Timestampers

Benchmarks

Utilities

Others

And much more…