hy.common.net下載hy.common.net源代碼下載

hy.common.net

其他類別

3.0.4

下載

hy.common.net

特點1：客戶端請求數據、服務端響應數據均為Java對象，無須格式轉換（如Json、xml報文的轉換工作）。大大降低了開發成本，使兩個物理分離的程序或服務間的訪問如同一個程序一樣的操作。

特點2：數據通訊均通過浮動的臨時端口，高頻訪問時不會造成主端口1721的擁塞瓶頸。

特點3：支持免密登陸或密碼驗證登陸，並且密碼驗證規則可自行定義。

特點4：支持自定義事件，程序或服務間的事件。默認為XJava事件處理機制，即內存共享模式。

特點5：數據通訊的浮動端口，超時自動關閉功能。

服務端配置舉例

<? xml version = " 1.0 " encoding = " UTF-8 " ?>

< config >

	< import name = " xconfig "         class = " java.util.ArrayList " />
	< import name = " server "          class = " org.hy.common.net.ServerSocket " />
	
	
	
	<!-- 系统服务配置信息 -->
	< xconfig >
	
		< server id = " Server " >
			< port >1721</ port >               <!-- 服务端监听主端口 -->
			< minPort >17000</ minPort >        <!-- 数据通讯的浮动端口的最小值 -->
			< maxPort >17999</ maxPort >        <!-- 数据通讯的浮动端口的最大值 -->
			< closeTimeout >60</ closeTimeout > <!-- 数据通讯的浮动端口的自动关闭超时时长（单位：秒） -->
			< log >false</ log >                <!-- 是否显示通讯日志 -->
			
			<!-- 自定义服务端登陆验证接口。可选的，当没有定义验证方法时，免登陆 -->
			< validate class = " org.hy.demo.ServerValidate " />
			
			< call name = " addListener " >       <!-- 添加自定义通讯事件 -->
				< listener class = " org.hy.demo.ServerDemo " />
			</ call >
			
			< call name = " open " />            <!-- 打开监听主端号服务 -->
		</ server >
		
	</ xconfig >
	
</ config >

服務端自定義事件

 public class ServerDemo implements ServerEventListener
{
    
    /**
     *  数据通讯的事件类型。
     *  
     *  事件类型区分大小写
     */
    public String getEventType ()
    {
        return "Demo" ;
    }
    
    
    
    /**
     * 数据通讯事件的执行动作
     */
    public CommunicationResponse communication ( CommunicationRequest i_RequestData )
    {
        CommunicationResponse v_ResponseData = new CommunicationResponse ();
        
        // 获取客户端请求数据
        Map < String , Object > v_DataMap = ( Map < String , Object >) i_RequestData . getData ();
        
        System . out . println ( "-- 服务端接收到的数据为：" );
        Help . print ( v_DataMap );
        
        v_ResponseData . setData ( Help . toListKeys ( v_DataMap ));   // 设置返回结果
        
        return v_ResponseData ;
    }
    
}

客戶端訪問舉例

    Map < String , Object > v_DataMap = new HashMap < String , Object >();
    v_DataMap . put ( "String"  , "ABCDEFG" );
    v_DataMap . put ( "Integer" , 1234567890 );
    v_DataMap . put ( "Date"    , new Date ());

    
    CommunicationRequest  v_RequestData  = new CommunicationRequest ();
    CommunicationResponse v_ResponseData = null ;
    List < String >          v_Results      = null ;
    
    v_RequestData . setEventType ( "Demo" );                // 通讯的事件类型。如果没有设置此属性，默认为XJava事件类型
    v_RequestData . setDataXID (  "2017" );                // 通讯数据的标识ID。可选的，按具体业务而定
    v_RequestData . setData (      i_DataMap );            // 通讯数据。可选的，按具体业务而定。可为任何Java类型，须实现 java.io.Serializable 接口
	
    ClientSocket v_Client = new ClientSocket ( "服务端IP" , 1721 );
	
    v_Client . setValidate ( new ClientValidate ());        // 如果服务端启用了登陆验证，则客户端要提供用户名及密码
	
    v_ResponseData = v_Client . send ( v_RequestData );     // 发送通讯数据
	
    v_Results = ( List < String >) v_ResponseData . getData (); // 获取服务端的返回结果。可为任何Java类型，只须实现 java.io.Serializable 接口即可