protocol.mf

该系统是一个基于p2p的即时聊天系统

一、端点和服务之间的通信协议
-------------------------------------------------------------
1.注册服务：处理新用户的注册
请求消息：
<Request>
    <User>
        <Basic>
            <ID />
            <Nickname>aGang</Nickname>
            <Password>111111</Password>
        </Basic>
        <Optional>
            <Name>程刚</Name>
            <Gender>男</Gender>
            <Birthday>1979年12月30日</Birthday>
            <Country>中华人民共和国</Country>
            <Province>湖北省</Province>
            <City>黄冈市</City>
            <Telephone>13654985701</Telephone>
            <Email>[e-mail]</Email>
            <Address />
            <Postalcode />
            <Homepage />
            <Remark />
        </Optional>
        <Friends />
        <Shares />
    </User>
</Request>
响应消息：
<Response>
    <ID>x</ID>
</Response>
-------------------------------------------------------------
2.更新服务：处理注册用户的资料更新
请求消息：
<Request>
    <User>
        <Basic>
            <ID>1</ID>
            <Nickname>aGang</Nickname>
            <Password>111111</Password>
        </Basic>
        <Optional>
            <Name>程刚</Name>
            <Gender>男</Gender>
            <Birthday>1979年12月30日</Birthday>
            <Country>中华人民共和国</Country>
            <Province>湖北省</Province>
            <City>黄冈市</City>
            <Telephone>13654985701</Telephone>
            <Email>[e-mail]</Email>
            <Address />
            <Postalcode />
            <Homepage />
            <Remark />
        </Optional>
        <Friends>
            <Friend id="1" />
                ...
            <Friend id="n" />
        </Friends>
    </User>
</Request>
响应消息：
<Response>
    <Result>A Java String</Result>
</Response>
-------------------------------------------------------------
3.登录服务：处理注册用户的登录
请求消息：
<Request>
	<ID>x</ID>
	<Password>123456</Password>
	<IP>a.b.c.d</IP>
</Request>
响应消息：
<Response>
    <Result>A Java String</Result>
</Response>
-------------------------------------------------------------
4.注销服务：处理登录用户注销
请求消息：
<Request>
	<ID>x</ID>
	<IP>a.b.c.d</IP>
</Request>
响应消息：无
-------------------------------------------------------------
5.地址服务：获取指定用户的IP地址
请求消息：
<Request>
    <ID>x</ID>
</Request>
响应消息：
<Response>
    <IP>a.b.c.d</IP>
</Response>
-------------------------------------------------------------
6.用户服务：获取指定用户的资料
请求消息：
<Request>
    <ID>x</ID>
</Request>
响应消息：
<Response>
    <User>
        <Basic>
            <ID>x</ID>
            <Nickname>aGang</Nickname>
            <Password>111111</Password>
        </Basic>
        <Optional>
            <Name>程刚</Name>
            <Gender>男</Gender>
            <Birthday>1979年12月30日</Birthday>
            <Country>中华人民共和国</Country>
            <Province>湖北省</Province>
            <City>黄冈市</City>
            <Telephone>13654985701</Telephone>
            <Email>[e-mail]</Email>
            <Address />
            <Postalcode />
            <Homepage />
            <Remark />
        </Optional>
        <Friends>
            <Friend id="1" />
                ...
            <Friend id="n" />
        </Friends>
        <Shares>
            <Share file="/">
                <Friends>
                    <Friend id="1" />
                </Friends>
            </Share>
        </Shares>
    </User>
</Response>
-------------------------------------------------------------
7.好友服务：添加好友时，列举除当前用户及其好友外所有用户的详细信息
请求消息：
<Request>
    <ID>x</ID>
</Request>
响应消息：
<Response>
    <User>
        <Basic>
            <ID>1</ID>
            <Nickname>aGang</Nickname>
            <Password>111111</Password>
        </Basic>
        <Optional>
            <Name>程刚</Name>
            <Gender>男</Gender>
            <Birthday>1979年12月30日</Birthday>
            <Country>中华人民共和国</Country>
            <Province>湖北省</Province>
            <City>黄冈市</City>
            <Telephone>13654985701</Telephone>
            <Email>[e-mail]</Email>
            <Address />
            <Postalcode />
            <Homepage />
            <Remark />
        </Optional>
        <Friends>
            <Friend id="1" />
                ...
            <Friend id="n" />
        </Friends>
        <Shares>
            <Share file="/">
                <Friends>
                    <Friend id="1" />
                </Friends>
            </Share>
        </Shares>
    </User>
     ......
     <User>
        <Basic>
            <ID>n</ID>
            <Nickname>aGang</Nickname>
            <Password>111111</Password>
        </Basic>
        <Optional>
            <Name>程刚</Name>
            <Gender>男</Gender>
            <Birthday>1979年12月30日</Birthday>
            <Country>中华人民共和国</Country>
            <Province>湖北省</Province>
            <City>黄冈市</City>
            <Telephone>13654985701</Telephone>
            <Email>[e-mail]</Email>
            <Address />
            <Postalcode />
            <Homepage />
            <Remark />
        </Optional>
        <Friends>
            <Friend id="1" />
                ...
            <Friend id="n" />
        </Friends>
        <Shares>
            <Share file="/">
                <Friends>
                    <Friend id="1" />
                </Friends>
            </Share>
        </Shares>
    </User>
</Response>
-------------------------------------------------------------
8.设置服务：处理用户对文件共享的设置(只能设置对文件的共享，不能设置整个目录共享)
请求消息：
<Request>
    <Share id="x" file="y">
        <Friends>
            <Friend id="1" />
                ...
            <Friend id="n" />
        </Friends>
    </Share>
</Request>
响应消息：
<Response>
    <Result>A Java String</Result>
</Response>
-------------------------------------------------------------
9.获取服务：获取所有共享给指定用户的文件
请求消息：
<Request>
    <ID>x</ID>
</Request>
响应消息：
<Response>
    <Shares>
        <Share id="x">
            <Files>
                <File file="1" />
                    ...
                <File file="n" />
            </Files>
        </Share>
        ...
        <Share id="y">
            <Files>
                <File file="1" />
                    ...
                <File file="n" />
            </Files>
        </Share>
    </Shares>
</Response>
-------------------------------------------------------------
10.文件服务：获取指定文件所共享的好友
请求消息：
<Request>
    <Share id="x" file="y" />
</Request>
响应消息：
<Response>
    <Friends>
        <Friend id="1" />
            ...
        <Friend id="n" />
    </Friends>
</Response>
-------------------------------------------------------------
二、端点和端点之间的通信协议
-------------------------------------------------------------
1.消息通信
<Chat>
    <Sender id="x" msg="y" />
</Chat>
-------------------------------------------------------------
2.文件请求
<Request>
    <Requester id="x" dir="y" file="z" />
</Request>
3.文件传输
<Transfer>
    <File dir="d" file="f" size="s" content="c" first="true"/>
</Transfer>