HTTPDNSLib: A Java repository from zhaoxingyu

该项目是手机微博研发团队和手机微博技术保障部共同努力的成果。
在此特别感谢：
张杰微博:@木泽水
王春生微博:@平凡的香草
胡波微博:@胡波_
韩超微博:@超朝炒觘
赵星宇微博:@淘淘不逃008
聂钰微博:@古夜
冯磊微博:@冯磊424

等同学的支持。感谢大家提出的宝贵意见，感谢大家为该项目付出的努力！

项目中有任何问题欢迎大家来吐槽，一起完善、一起提高、一起使用！
email：fenglei1@staff.sina.com.cn

接入说明：

由于该工程需要用户自定义部分配置文件，所以建议以源码方式使用。（同时也支持项目中设定lib库的参数） lib库目前还没有打包成 jar 文件，大家测试使用的话可以直接将工程包含到自己的工程内即可。 apk文件夹下内有打包好的对httpDNS库进行测试的程序。该测试程序模拟了用户使用的场景，并且记录了相关统计数据。以及Lib库的时时的状态信息。

在AndroidManifest.xml文件中需要配置

     <!-- 主要注册一个广播 监听网络发生变化，本地更新dns解析记录-->
    <receiver
        android:name="com.sina.util.networktype.NetworkStateReceiver"
        android:label="NetworkConnection" >
        <intent-filter>
            <action android:name="android.net.conn.CONNECTIVITY_CHANGE" />
            <action android:name="android.intent.action.USER_PRESENT" />
        </intent-filter>
    </receiver>
    
<!-- 需要配置的权限 -->
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

在使用 http dns前需要初始化一次

DNSCache.Init(this);

直接调用该方法获取 A记录对象

DomainInfo[] infoList = DNSCache.getInstance().getDomainServerIp( "http://api.weibo.cn/index.html" ) ;

//DomainInfo 返回有可能为null，如果为空则使用域名直接请求数据吧~ 因为在http server 故障的时候会出现这个问题。

if( infoList != null ) { 
//A记录可能会返回多个， 没有特殊需求直接使用第一个即可。  这个数组是经过排序的。 
DomainInfo domainModel = infoList[0] ;  

//这里是 android 请求网络。  只需要在http头里添加一个数据即可。 省下的请求数据和原先一样。
HttpGet getMethod = new HttpGet( domainModel.url );  
getMethod.setHeader("host", domainModel.host);
HttpClient httpClient = new DefaultHttpClient();  
long startDomainRequests = System.currentTimeMillis(); 
HttpResponse response = httpClient.execute(getMethod); 
String res = EntityUtils.toString(response.getEntity(), "utf-8") ; 
Log.d("DINFO", res) ; 

//在请求倒数据后，请配合将一部分信息传递给我。 lib库里面会对这个服务器进行评分计算，lib库永远会优先给你最快，最稳定的服务器地址。
domainModel.code = String.valueOf( response.getStatusLine().getStatusCode() );
domainModel.data = res ;
domainModel.startTime = String.valueOf(startDomainRequests) ;
DNSCache.getInstance().setDomainServerIpInfo( domainModel );
}

更多配置

你可以创建一个 com.sina.util.dnscache.DNSCacheConfig.Data 对象分别设置下面属性。
然后调用 DNSCacheConfig.saveLocalConfigAndSync 方法传入设定好的配置选项。

    /**
     * 是否启用自己家的HTTP_DNS服务器 默认不启用 | 1启用 0不启用
     */
    public String IS_MY_HTTP_SERVER = null;
    /**
     * 自己家HTTP_DNS服务API地址 使用时直接在字符串后面拼接domain地址 |
     * 示例（http://xxx.xxx.xxx.xxx/dns?domain=）+ domain
     */
    public String HTTPDNS_SERVER_API = null;
    /**
     * 是否启用dnspod服务器 默认不启用 | 1启用 0不启用
     */
    public String IS_DNSPOD_SERVER = null;
    /**
     * DNSPOD HTTP_DNS 服务器API地址 | 默认（http://119.29.29.29/d?ttl=1&dn=）
     */
    public String DNSPOD_SERVER_API = null;
    /**
     * DNSPOD 企业级ID配置选项 
     */
    public String DNSPOD_ID = null;
    /**
     * DNSPOD 企业级KEY配置选项 
     */
    public String DNSPOD_KEY = null;
    /**
     * 是否开启 本地排序插件算法 默认开启 | 1开启 0不开启
     */
    public String IS_SORT = null;
    /**
     * 速度插件 比重分配值：默认40%
     */
    public String SPEEDTEST_PLUGIN_NUM = null;
    /**
     * 服务器推荐优先级插件 比重分配：默认30% （需要自家HTTP_DNS服务器支持）
     */
    public String PRIORITY_PLUGIN_NUM = null;
    /**
     * 历史成功次数计算插件 比重分配：默认10%
     */
    public String SUCCESSNUM_PLUGIN_NUM = null;
    /**
     * 历史错误次数计算插件 比重分配：默认10%
     */
    public String ERRNUM_PLUGIN_NUM = null;
    /**
     * 最后一次成功时间计算插件 比重分配：默认10%
     */
    public String SUCCESSTIME_PLUGIN_NUM = null;
    /**
     * domain对应的测速文件，如果需要对服务器进行测速请给domain设置一个可以下载的资源文件来计算服务器速度
     */
    public ArrayList<String> SPEEDPATH_LIST = new ArrayList<String>();

动态更新参数

DNSCacheConfig 类下的 ConfigText_API 字段可以配置成自动更新配置参数的接口。该接口返回json数据类型具体数据格式详见DNSCacheConfig.Data toJson()方法。

自己家HttpDNS服务接入

首先开启 DNSCacheConfig.Data.IS_MY_HTTP_SERVER = 1 ; 然后设定 DNSCacheConfig.Data.HTTPDNS_SERVER_API 接口地址示例（http://XXX.XXX.XXX.XXX/dns?domain=）+ domain

该接口返回格式(当然你也可以自定义格式需要重载 com.sina.util.dnscache.httpdns.IJsonParser 类即可): { "domain": "api.weibo.cn", "device_ip": "10.209.70.192", "device_sp": "0", "dns": [ { "priority": "0", "ip": "123.125.105.231", "ttl": "60" }, { "priority": "0", "ip": "123.125.105.246", "ttl": "60" }, { "priority": "0", "ip": "202.108.7.133", "ttl": "60" } ] } PS： priority 字段是服务器推荐优先级。 | device_sp 字段是该设备出口运营商。

HttpDns是什么？

如果你对 httpdns 还不了解他是什么！
你可以阅读：【鹅厂网事】全局精确流量调度新思路-HttpDNS服务详解

传统DNS解析和 HTTPDNS解析本质的区别：

传统DNS解析

客户端发送udp数据包到dns服务器,dns服务器返回该域名的相关A记录信息。

HTTPDNS解析

客户端发起http请求携带需要查询的域名,通过IP直接访问服务器,该Http服务器接倒请求后返回域名对应的A记录。

HttpDns sdk （android版本）

希望解决的问题：

1.LocalDNS劫持
2.平均访问延迟下降
3.用户连接失败率下降

目录结构说明：

HttpDns/code/DNSCache --- HttpDns lib库主工程。
HttpDns/code/DNSCacheTest --- HttpDns库测试工程。
HttpDns/doc --- 项目相关的一些文档、流程图、结构图等。
HttpDns/ui/DNSCacheTest --- 存放HttpDns测试项目UI源文件以及切图文件。

HttpDns 交互流程

HttpDns Lib库交互流程

查询模块

检测本地是否有相应的域名缓存
没有记录则根据当前运营商返回内置的ip节点
从httpdns查询域名相应A记录，缓存域名信息
查询模块必须保证响应速度，基于已有设备测试平均在5毫秒左右

数据缓存模块

根据sp（或wifi名）缓存域名信息
根据sp（或wifi名）缓存服务器ip信息、优先级
记录服务器ip每次请求成功数、错误数
记录服务器ip最后成功访问时间、最后测速
添加 内存 -》数据库 之间的缓存层

评估模块

根据本地数据，对一组ip排序
处理用户反馈回来的请求明细，入库
针对用户反馈是失败请求，进行分析上报预警
给HttpDns服务端智能分配A记录提供数据依据

评估算法插件

本次测速 - 对ip组的每个ip测速打分
官方推荐 - HttpDns接口 A记录中返回的优先级
历史成功 - 该ip7天内成功访问次数
历史错误 - 该ip7天内访问错误次数
最后成功时间 - 该ip最后一次成功时间，阈值24

打分比重权值分配

对每个IP打分，总分100分。
本次测速 - 40分
官方推荐 - 30分
历史成功 - 10分
历史错误 - 10分
最后成功时间 - 10分
总分=本次测速+官方推荐+历史成功次数+历史错误次数+最后成功时间

目前权重分配完全基于主观认识，后期会根据建立的相应基线进行权重分配调整。

使用者需要自己权衡，有可能随机的ip速度都好于权重打分的ip。

PS:给出一副算法计算分数时的细节图，有兴趣的朋友可以一起探讨研究。

![image](https://github.com/SinaMSRE/HTTPDNSLib/raw/master/doc/%E7%AE%97%E6%B3%95%E6%8F%92%E4%BB%B6%E8%AE%A1%E7%AE%97%E5%9B%BE.png)

你可能更需要“它” HttpHook（android版本）（工程还未上传）

HttpHook是一个转发http请求工具库。
他可以让你在不修改工程源代码的情况下对网络层进行修改、替换、等更多的操作。

由于我没有微博客户端的源码，为了测试微博客户端是否可以正常使用httpdns库，才诞生的这个项目。
HttpHook 截取 api.weibo.cn 的所有请求，提取到url。
将url中的host域名，传入httpdns库中，使用返回的a记录替换host，进行访问。
访问服务器成功后，在将服务器返回的数据传给客户端，从而完成一次访问请求。
这是在 httpdns 项目中使用场景。大家如果感兴趣可以到httphook项目中详细查看。

HttpDns Test （android版本）

测试工程主要最初为了模拟用户使用APP发出的网络请求，进行数据记录和对比。
在页面中能很直观的看到每个任务的相关信息。
比如：任务总耗时，httpdns lib库耗时、http请求耗时、以及设备当前环境信息等。。
由于UE，UI都是自己设计，对于表达信息的布局和美观可能还有欠缺，本程序猿的能力有限，大家多多包涵。

你未必会需要“它”，上传几张测试工程的截图，提供参考。

zhaoxingyu/HTTPDNSLib