bvn13/sewy

Sewy - is lightweight library for protocol-based communications over network.

Sew'y [səʊi]

What is it?

The lightweight network library providing client-server communications that could be described with commands.

Why another network library?

1. other protocol-based network libraries are old (in e. kryonet)
2. or they are heavy and very overloaded

How to use?

Simple ECHO server

1. Describe ECHOed client listener

sewy/src/test/java/me/bvn13/sewy/EchoClientListener.java

Lines 24 to 40 in 380dd5f

	public class EchoClientListener extends AbstractClientListener {
	public EchoClientListener(Socket socket) {
	super(socket);
	}
	/**
	* Thread runner
	*/
	@Override
	public void run() {
	while (socket.isConnected()) {
	Thread.yield();
	final String data = readLine();
	writeLine(data);
	}
	}
	}

2. Create Server

new Server("192.168.0.153", port, EchoClientListener.class);

3. Create Client to communicate with server

Client<SimpleClientListener> client = new Client<>("192.168.0.153", port, SimpleClientListener.class);

4. Send raw data and read the response

client.writeLine("hello");
String response1 = client.readLine();
Assertions.assertEquals("hello", response1);

Command-based client listener

1. Implement commands inheriting from AbstractCommand
2. Register all commands as white listed

Sewy.register(PingCommand.class);
Sewy.register(PongCommand.class);

3. Start server with CommandClientListener implementing response creation logic

CommandServer server = new CommandServer("localhost", port, (socket) -> new CommandClientListener(socket) {
    @Override
    public AbstractCommand onCommand(AbstractCommand command) {
        if (command instanceof PingCommand) {
            return new PongCommand((PingCommand) command);
        }
        throw new IllegalArgumentException(command.toString());
    }
});

4. Start client to send commands to server

AtomicLong latency = new AtomicLong(0);
CommandClient client = new CommandClient("localhost", port, (socket) -> new CommandClientListener(socket) {
    @Override
    public AbstractCommand onCommand(AbstractCommand command) {
        if (command instanceof PongCommand) {
            latency.set(((PongCommand)command).getLatency());
            return null;
        } else {
            throw new IllegalArgumentException(command.toString());
        }
    }
});
client.send(new PingCommand());
Thread.sleep(1000);
Assertions.assertTrue(latency.get() > 0);