软件简介

Beetle.NetPackage是一个多平台Client Socket
TCP通讯组件，组件制统一的对象协议制定规则，可以灵活方便地通过对象来描述TCP通讯交互.支持平台有Flash,.NET和Android。

组件制定了不同语言平台下访问TCP服务的统一处理规则;分别有协议描述规范和消息处理控制。不同语言平台下都提供了一致的对象和接口主要包括：IMessage,Packge,INetClientHandler和NetClient等。

• 2013-08-23
  修复android和.net在写入utf字符为空的错误
  添加消息和消息列表写入读取方法(.net android)

  • android

            <T extends IMessage> T ReadMessage(Class<T> type) throws Exception;
    <T extends IMessage> AbstractCollection<T> ReadMessages(Class<T> type) throws Exception; void Write(IMessage msg)throws Exception;
    <T extends IMessage> void Write(AbstractCollection<T> messages) throws Exception;
    

  • .net

                T Reads<T>() where T : IMessage, new();
        IList<T> ReadMessages<T>() where T : IMessage, new(); void Write(IMessage message); void Write(IList<IMessage> messages);
    

• 2013-08-15
  添加写入和读取接口IDataWriter和IDataReader.IMessage的Save和Load依赖于以上两个接口

IMessage

消息描述接口，所有通讯消息必须实现相关规则。

• flase

      public class Register implements IMessage
  { public var Name:String; public var EMail:String; public var City:String; public var Country:String; public var RegTime:Date; public function Register()
      {
      } public function Load(reader:ByteArray):void {
          Name= reader.readUTF();
          EMail= reader.readUTF();
          City= reader.readUTF();
          Country = reader.readUTF(); var dv:String= reader.readUTF();
          RegTime=DateFormatter.parseDateString(dv);
  
      } public function Save(writer:ByteArray):void {
          writer.writeUTF(Name);
          writer.writeUTF(EMail);
          writer.writeUTF(City);
          writer.writeUTF(Country); var d:DateFormatter =new DateFormatter();
          d.formatString="YYYY-MM-DD HH:NN:SS";
          writer.writeUTF(d.format(RegTime));
  
      }
  }
  

• android

  public class Register implements IMessage { public String Name; public String EMail; public String City; public String Country; public Date RegTime;
  
  @Override public void Load(DataInputStream stream) throws Exception { // TODO Auto-generated method stub Name = stream.readUTF();
      EMail = stream.readUTF();
      City = stream.readUTF();
      Country = stream.readUTF();
      String format = "yyyy-MM-dd HH🇲🇲ss";
      SimpleDateFormat sdf = new SimpleDateFormat(format);
      RegTime = sdf.parse(stream.readUTF());
  
  }
  
  @Override public void Save(DataOutputStream stream) throws Exception { // TODO Auto-generated method stub stream.writeUTF(Name);
      stream.writeUTF(EMail);
      stream.writeUTF(City);
      stream.writeUTF(Country);
      String format = "yyyy-MM-dd HH🇲🇲ss";
      SimpleDateFormat sdf = new SimpleDateFormat(format);
      stream.writeUTF(sdf.format(RegTime));
  }
  

  }

• c#

      public class Register:Beetle.NetPackage.IMessage
  { public String Name; public String EMail; public String City; public String Country; public DateTime RegTime; public void Load(Beetle.NetPackage.BufferStream reader)
      {
          Name = reader.ReadUTF();
          EMail = reader.ReadUTF();
          City = reader.ReadUTF();
          Country = reader.ReadUTF(); string date = reader.ReadUTF();
          Console.WriteLine(date);
          RegTime = DateTime.ParseExact(date, "yyyy-MM-dd HH🇲🇲ss", CultureInfo.InvariantCulture);
      } public void Save(Beetle.NetPackage.BufferStream writer)
      {
          writer.WriteUTF(Name);
          writer.WriteUTF(EMail);
          writer.WriteUTF(City);
          writer.WriteUTF(Country);
          writer.WriteUTF(RegTime.ToString("yyyy-MM-dd HH🇲🇲ss"));
      }
  }
  

Package

该对象是用于通讯协议描述，默认实现４字节描述消息大小规范。Package的主要工作是对象写入通讯数据和从通讯数据获取对象。对象只是提供一个基础的处理规则，在应用中使用者必须从此类的基础上派生出新的协议处理对象。

• flash

      public class NPPackage extends Package
  { public function NPPackage()
      { super();
      } protected override function WriteMessageType(writer:ByteArray, message:IMessage):void {
          writer.writeUTF(flash.utils.getQualifiedClassName(message));    
      } protected override function GetMessage(reader:ByteArray):IMessage
      { var name:String = reader.readUTF(); if(name=="Register") return new Register(); return null;
      }
  }
  

• android

  public class NPPackage extends Package {
  
  @Override protected void WriteMessageType(DataOutputStream writer, IMessage message) throws Exception { // TODO Auto-generated method stub writer.writeUTF(message.getClass().getSimpleName());
  }
  
  @Override protected IMessage GetMessage(DataInputStream reader) throws Exception { // TODO Auto-generated method stub String name= reader.readUTF(); if(name.equals("Register")) return new Register(); return null;
  }
  

  }

• c#

      class NPPackage:Beetle.NetPackage.Package
  { protected override void WriteMessageType(Beetle.NetPackage.BufferStream writer, Beetle.NetPackage.IMessage message)
      {
          writer.WriteUTF(message.GetType().Name);
      } protected override Beetle.NetPackage.IMessage GetMessage(Beetle.NetPackage.BufferStream reader)
      { string Name = reader.ReadUTF(); switch (Name)
          { case "Register": return new Register();
          } return null;
      }
  }
  

INetClientHandler

该接口主要用于描述TCP连接处理规则，包括有数据接收事件，错误处理事件，连接创建成功和失败事件。

public interface INetClientHandler { void Receive(NetClient client, Object msg); void Error(NetClient client, Exception e); void Disposed(NetClient client); void Connected(NetClient client);

}

NetClient

该对象主要用于创建ＴＣＰ通讯和进行消息发送接收处理。

• flash

  mClient = new NetClient("127.0.0.1",9088,new NPPackage(),new NetClientHandler(
  ClientReceive,ClientError,ClientDisposed,ClientConnected));
  

  mClient.SocketEndian = Endian.BIG_ENDIAN;
  mClient.Connect();

• android

  mClient = new NetClient("10.0.2.2", 9088, new NPPackage(), this);
  

  mClient.Connect();

• c#

  mClient = new Beetle.NetPackage.NetClient("127.0.0.1", 9088, new NPPackage(), this);
  

  mClient.LittleEndian = false;
  mClient.Connect();