ESFramework 4.0 版本升级说明（持续更新 2011.04.25）

　　ESFramework 4.0 内核（ESFramework.dll）已经相当成熟，不会轻易修改，而在不断增强中的是ESPlus和ESFramework.SL，所以，如下的一些版本变更几乎都是针对ESPlus和ESFramework.SL的。最新版本以及最新demo和帮助文档请到ESFramework 4.0 概述文末下载。

 

第01次版本更新

更新时间：2011.04.12 

最新版本：ESPlus v1.2.1.0 ，ESFramework.SL v1.0.2.0

更新列表：

（1）ESPlus.Application.Basic.Passive.IBasicOutter 增加了查询用户是否在线的功能（IsUserOnline）。

（2）ESPlus.Application.CustomizeInfo.Passive.ICustomizeInfoOutter 增加了客户端可以同步调用其它在线客户端的功能（CommitP2PRequest方法）。

（3）ESPlus.Application.CustomizeInfo.Server.ICustomizeInfoController 增加了服务端可以同步调用在线客户端的功能（QueryClient方法）。   

（4）ESPlus.Application.CustomizeInfo.Server.ICustomizeInfoController 增加了InformationReceived事件，以监控所有自定义信息。

（5）为了支持上述功能，ESPlus.Application.CustomizeInfo.Passive.ICustomizeInfoBusinessHandler回调接口增加了相应的方法，如果不需要用到新增的功能，可以直接实现为空，或者返回null。

（6）除不支持P2P外，ESFramework.SL的本次更新与ESPlus完全一致。

 

---

 

第02次版本更新

更新时间：2011.04.18

最新版本：ESPlus v1.3.0.0 ，ESFramework.SL v1.1.0.0

更新列表：

（1）ESPlus.Application.Basic.Passive.IBasicOutter 增加了获取在线的好友列表（GetAllOnlineFriends方法）、获取所有好友列表（GetFriends方法）、获取在线组友（GetAllOnlineGroupmates方法）等功能。

（2）ESPlus.Application.Basic.Passive.IBasicBusinessHandler 增加了组友上下线通知（OnGroupmateConnected方法、OnGroupmateOffline方法）等功能。

（3）IGroupManager 增加了GetGroupmateList方法以获取组友列表，以支持上述的获取在线组友、组友上下线通知的功能。

（4）IGroupManager 增加了GetOwnerGroupIDList方法以获取目标用户加入的所有组的ID集合，该方法将被用于ESPlatform。

（5）ESPlus.Application.CustomizeInfo.Passive.ICustomizeInfoOutter 增加了使用ACK机制发送自定义信息给服务端或其它在线用户的功能（SendCertainly方法）。

（6）ESPlus.Application.CustomizeInfo.Server.ICustomizeInfoController 增加了使用ACK机制发送自定义信息给客户端的功能（SendCertainly方法）。

（7）ESPlus.Rapid.IRapidServerEngine 增加了FriendNotifyEnabled属性，以控制当用户上线/掉线时，是否通知其好友。

（8）ESPlus.Rapid.IRapidServerEngine 增加了GroupNotifyEnabled属性，以控制当用户上线/掉线时，是否通知其组友（groupmate）。

（9）ESFramework.SL的本次更新与ESPlus完全一致。 

 

---

  

第03次版本更新

更新时间：2011.04.25

最新版本：ESFramework v4.0.5.0 , ESPlus v1.3.2.0 ，ESFramework.SL v1.1.2.0

更新列表：

（1）ESFramework在其ESFramework.Server.UserManagement空间下增加了IPlatformUserManager接口，用于支持对ESPlatform群集中所有在线用户的管理。

（2）IBasicOutter增加了Logon方法，用于客户端登录验证；ESPlus.Application.Basic.Server命名空间增加了IBasicBusinessHandler接口，实现该接口可以验证用户的登录密码。

（3）基于（2），客户端Rapid引擎增加了客户端初始化时验证用户登录密码的功能。

      a.客户端Rapid引擎的Initialize方法增加logonPassword参数和LogonResult返回值，用于在初始化时交由服务端验证用户的登录密码是否正确。

      b.服务端Rapid引擎的Initialize方法增加IBasicBusinessHandler参数，该接口用于验证用户登陆密码。     

（4）客户端Rapid引擎增加了CurrentUserID属性，其值为当前登录成功的用户的UserID。

（5）服务端Rapid引擎增加了PlatformUserManager属性（get），通过该属性可以获取群集中所有在线用户信息；在非群集状态下，PlatformUserManager等同于UserManager。

（6）服务端Rapid引擎增加了对文件传送的支持，即服务端可以参与文件的收发，从而可以实现类似FTP的文件上传下载功能。 

（7）ESFramework.SL的本次更新与ESPlus完全一致。  

 

---

  

第04次版本更新（即将推出......）

本次更新最主要的内容是增加了对P2P通道的支持，客户端Rapid引擎支持基于TCP和UDP的P2P Channel。

更新时间：

最新版本：ESFramework v4.0.6.0 , ESPlus v1.3.3.0

更新列表：

（1）包含"Friends"字眼的名称更改为包含"Friend"，如 IFriendsManager更改为IFriendManager。

（2）ESPlus.Core.Server.IFriendManager 接口增加FriendChanged事件。当某个用户的好友列表发生变化时，触发此事件。

（3）ESPlus.Core.Server 空间增加CachedFriendManager类，其用于在本地内存中缓存好友列表。（主要用于ESPlatform） 

（4）ESPlus.Core.Server.IGroupManager 接口增加GroupMembersChanged事件。当某个组的成员发生变化时，触发此事件。

（5）ESPlus.Core.Server 空间增加CachedGroupManager类，其用于在本地内存中缓存组成员列表。（主要用于ESPlatform）

（6）ESFramework.Core 空间去掉了IUserAddress接口，可以直接使用UserAddress类。

（7）移除ESPlus.Application.Basic.Passive.IBasicOutter多余的Logout方法，可以直接通过客户端Rapid引擎的Close方法来关闭连接。 

（8）ESPlus.Application.Basic.Passive 空间移除了IBasicBusinessHandler接口，该接口中的所有回调方法都转换成了IBasicOutter的对应事件（如FriendConnected事件）。

（9）接口名称更换，使接口名称更简洁：ICustomizeInfoOutter更改为ICustomizeOutter；ICustomizeInfoBusinessHandler更改为ICustomizeHandler；ICustomizeInfoController更改为ICustomizeController；IFileTransferingController更改为IFileController；IFileBusinessHandler更改为IFileHandler。

（10）IRapidPassiveEngine增加P2PController属性，用于控制和管理所有的P2P通道。

（11）除文件传送和P2P之外，ESFramework.SL的本次更新与ESPlus完全一致。