org.quickserver.net.server
Interface ClientCommandHandler

All Superinterfaces:

ClientEventHandler

All Known Implementing Classes:

CommandHandler

public interface ClientCommandHandler

extends ClientEventHandler

This interface defines the methods that should be implemented by any class that wants to handle client interaction.

Recommendations to be followed when implementing ClientCommandHandler

• Should have a default constructor.
• Should be thread safe.
• It should not store any data that may is associated with a particular client.
• If any client data is need to be saved from the client session, it should be saved to a ClientData class, which can be retrieved using handler.getClientData() method.

Ex:

package echoserver;

import java.net.*;
import java.io.*;
import org.quickserver.net.server.ClientCommandHandler;
import org.quickserver.net.server.ClientHandler;

public class EchoCommandHandler implements ClientCommandHandler {

        public void gotConnected(ClientHandler handler)
                throws SocketTimeoutException, IOException {
                handler.sendSystemMsg("Connection opened : "+
                        handler.getSocket().getInetAddress());

                handler.sendClientMsg("Welcome to EchoServer v1.0 ");
                handler.sendClientMsg("Note: Password = Username");
                handler.sendClientMsg("Send 'Quit' to exit");
        }

        public void lostConnection(ClientHandler handler) 
                throws IOException {
                handler.sendSystemMsg("Connection lost : " + 
                        handler.getSocket().getInetAddress());
        }
        public void closingConnection(ClientHandler handler) 
                throws IOException {
                handler.sendSystemMsg("Connection closing : " + 
                        handler.getSocket().getInetAddress());
        }

        public void handleCommand(ClientHandler handler, String command)
                        throws SocketTimeoutException, IOException {
                if(command.toLowerCase().equals("quit")) {
                        handler.sendClientMsg("Bye ;-)");
                        handler.closeConnection();
                } else {
                        handler.sendClientMsg("Echo : " + command);
                }
        }
}

Author:

Akshathkumar Shetty

Method Summary

void	handleCommand(ClientHandler handler, java.lang.String command) Method called every time client sends a line of data.

Methods inherited from interface org.quickserver.net.server.ClientEventHandler

closingConnection, gotConnected, lostConnection

Method Detail

handleCommand

public void handleCommand(ClientHandler handler,
                          java.lang.String command)
                   throws java.net.SocketTimeoutException,
                          java.io.IOException

Method called every time client sends a line of data. Should be used to handle the command sent and send any requested data.

Throws:

java.net.SocketTimeoutException - if socket times out

java.io.IOException - if io error in socket