/** * jVCard remote uses a simple plain text protocol to * transfer/retrieve/delete information from/to the server. * *

* * The protocol is based around lines of text and blocks of * lines. The client sends commands while the server only * answers with text data. * *

* * Some definitions: *

A line is the text between two new-line characters (\n). *
A block is all the lines between two end-of-block * lines. *
An end-of-block line is a special line * containing only a dot (.). *
A command is block whose first line * contains the command in upper case text and an optional text * argument, optionally followed by a second block of "input" data *

* *

* * Upon connection, the first thing that happen is that the server sends * a VERSION command (a block whose first line is * VERSION 1, possibly followed by some help text * lines). * *

* * The client MUST answer with another VERSION command. * *

* * From that time on, the client is allowed to send commands * as described by {@link be.nikiroo.jvcard.remote.Command}. * If the client doesn't follow the rules in * {@link be.nikiroo.jvcard.remote.Command}, the server will close * the connection. * * @author niki */ package be.nikiroo.jvcard.remote;