基于Linux、C、JSON、Socket的编程实例

一、前言

上一篇分享的基于控制台的简易天气客户端是基于Windows的: ,这篇分享的是基于Linux的。关于源码有需要的朋友可私信我。

基于Linux、C、JSON、Socket的编程实例

二、天气客户端实现的要点

1、秘钥

心知天气:www.seniverse.com

我们完成这个实验必须得到这个上面去注册一个账号才能使用它的天气数据,注册之后每个账户都会有一个私钥,例如:

私钥 SMEieQjde1C9eXnbE

这个是我们程序中需要用到。

2、IP和端口

我们与服务端通信,需要知道三个重要的信息,分别是:

  1. IP地址
  2. 端口
  3. 传输方式

这里的心知天气的IP是116.62.81.138,端口是80,传输方式是TCP,对应的代码如下:

/* 设置要访问的服务器的信息 */struct sockaddr_in ServerSockAddr;memset(&ServerSockAddr, 0, sizeof(ServerSockAddr));      // 每个字节都用0填充ServerSockAddr.sin_family = PF_INET;              // IPv4ServerSockAddr.sin_addr.s_addr = inet_addr(WEATHER_IP_ADDR); // 心知天气服务器IPServerSockAddr.sin_port = htons(WEATHER_PORT);         // 端口 

这里的WEATHER_IP_ADDR对应的就是116.62.81.138,WEATHER_PORT对应的就是80。

3、GET请求

HTTP有几种请求方法,我们这里使用的是GET请求。查看心知天气API文档可知,请求地址示例为:

https://api.seniverse.com/v3/weather/now.json?key=your_api_key&location=beijing&language=zh-Hans&unit=c

这是一个天气实况的请求地址示例,其有几个重要的参数:

基于Linux、C、JSON、Socket的编程实例

这里的key是个很重要的参数,就是我们前面说的私钥。

我们的天气客户端就是要往天气服务端发送类似这样的GET请求来获取天气数据,具体的请求方法示例为:

GET https://api.seniverse.com/v3/weather/now.json?key=2owqvhhd2dd9o9f8&location=beijing&language=zh-Hans&unit=c

对应代码如下:

/* 秘钥,注意!!如果要用这一份代码,这个一定要改为自己的,因为这个我已经故意改错了,防止有人与我公用一个KEY */#define  KEY   "2owqvhhd2dd9o9f8"    // 这是在心知天气注册后,每个用户自己的一个key​/* GET请求包 */#define  GET_REQUEST_PACKAGE   \\     "GET https://api.seniverse.com/v3/weather/%s.json?key=%s&location=%s&language=zh-Hans&unit=c\\r\\n\\r\\n"​/* JSON数据包 */  #define  NOW_JSON   "now"#define  DAILY_JSON  "daily"//....还用更多其他的天气数据包可查阅心知天气​/* 组合GET请求包 */sprintf(GetRequestBuf, GET_REQUEST_PACKAGE, weather_json, KEY, location);​/* 发送数据到服务端 */write(ClientSock, GetRequestBuf, strlen(GetRequestBuf));

这里简单复习一下sprintf函数的用法:

(1)函数功能:字符串格式化

(2)函数原型:int sprintf(char *string, char *format [,argument,…]);

string:这是指向一个字符数组的指针,该数组存储了 C 字符串。

format :这是字符串,包含了要被写入到字符串 str 的文本。

[argument]..**.**:根据不同的 format 字符串,函数可能需要一系列的附加参数,每个参数包含了一个要被插入的值,替换了 format 参数中指定的每个 % 标签。

(3)使用示例:

sprintf(buf, "%s,%d", str, num);

假如此时str为"hello",num为5201314,则此时buf中的内容为:hello,5201314,需要注意的是buf的容量要足够大。

4、天气服务端返回的数据

天气服务端给我们天气客户端返回的数据为JSON格式数据。我们这个天气客户端只是实现了查询此刻天气(对应的数据包为now.json)及近三天天气情况(对应的数据包为daily.json),如要查询其他信息,可模仿我们这里处理now.json和daily.json的方法,我们用cJson库进行解析。

只要把cJSON.c与cJSON.h放到工程主程序所在目录,然后在主程序中包含头文件JSON.h即可引入该库。

为了解析now.json和daily.json中的有用数据,我们建立如下结构体:

/* 天气数据结构体 */typedef struct{  /* 实况天气数据 */  char id[32];        //id  char name[32];       //地名  char country[32];      //国家  char path[32];       //完整地名路径  char timezone[32];     //时区  char timezone_offset[32];  //时差  char text[32];       //天气预报文字  char code[32];       //天气预报代码  char temperature[32];    //气温  char last_update[32];    //最后一次更新的时间​  /* 今天、明天、后天天气数据 */  char date[3][32];      //日期  char text_day[3][64];    //白天天气现象文字  char code_day[3][32];    //白天天气现象代码  char code_night[3][64];   //晚间天气现象代码  char high[3][32];      //最高温  char low[3][32];      //最低温  char wind_direction[3][64]; //风向  char wind_speed[3][32];   //风速,单位km/h(当unit=c时)  char wind_scale[3][32];   //风力等级}Weather;

现在看一下now.json的内容是怎样的:

(1)now.json示例及解析:

now.json:

{ "results": [   {   "location": {    "id": "C23NB62W20TF",    "name": "西雅图",    "country": "US",    "path": "西雅图,华盛顿州,美国",    "timezone": "America/Los_Angeles",    "timezone_offset": "-07:00"    },   "now": {    "text": "多云", //天气现象文字    "code": "4", //天气现象代码    "temperature": "14", //温度,单位为c摄氏度或f华氏度    "feels_like": "14", //体感温度,单位为c摄氏度或f华氏度    "pressure": "1018", //气压,单位为mb百帕或in英寸    "humidity": "76", //相对湿度,0~100,单位为百分比    "visibility": "16.09", //能见度,单位为km公里或mi英里    "wind_direction": "西北", //风向文字    "wind_direction_degree": "340", //风向角度,范围0~360,0为正北,90为正东,180为正南,270为正西    "wind_speed": "8.05", //风速,单位为km/h公里每小时或mph英里每小时    "wind_scale": "2", //风力等级,请参考:http://baike.baidu.com/view/465076.htm    "clouds": "90", //云量,单位%,范围0~100,天空被云覆盖的百分比 #目前不支持中国城市#    "dew_point": "-12" //露点温度,请参考:http://baike.baidu.com/view/118348.htm #目前不支持中国城市#    },   "last_update": "2015-09-25T22:45:00-07:00" //数据更新时间(该城市的本地时间)   }  ]}

这里实测了一下,我们普通用户(因为没充钱,哈哈~)申请的now.json数据中,now对象中只有如下三个键值对:

"text": "多云", //天气现象文字"code": "4", //天气现象代码"temperature": "14", //温度,单位为c摄氏度或f华氏度

now.json的解析函数:

/********************************************************************************************************* 函数: cJSON_NowWeatherParse,解析天气实况数据**------------------------------------------------------------------------------------------------------** 参数: JSON:天气数据包  result:数据解析的结果** 返回: void********************************************************************************************************/static int cJSON_NowWeatherParse(char *JSON, Weather *result){    cJSON *json,*arrayItem,*object,*subobject,*item;        json = cJSON_Parse(JSON); //解析JSON数据包    if(json == NULL)         //检测JSON数据包是否存在语法上的错误,返回NULL表示数据包无效    {        printf("Error before: [%s]\\n",cJSON_GetErrorPtr()); //打印数据包语法错误的位置        return 1;    }    else    {        if((arrayItem = cJSON_GetObjectItem(json,"results")) != NULL); //匹配字符串"results",获取数组内容        {            int size = cJSON_GetArraySize(arrayItem);   //获取数组中对象个数#if DEBUG            printf("cJSON_GetArraySize: size=%d\\n",size); #endif            if((object = cJSON_GetArrayItem(arrayItem,0)) != NULL)//获取父对象内容            {                /* 匹配子对象1:城市地区相关 */                if((subobject = cJSON_GetObjectItem(object,"location")) != NULL)                {                    // 匹配id                    if((item = cJSON_GetObjectItem(subobject,"id")) != NULL)                      {                        memcpy(result->id, item->valuestring,strlen(item->valuestring));        // 保存数据供外部调用                    }                    // 匹配城市名                    if((item = cJSON_GetObjectItem(subobject,"name")) != NULL)                     {                        memcpy(result->name, item->valuestring,strlen(item->valuestring));      // 保存数据供外部调用                    }                    // 匹配城市所在的国家                    if((item = cJSON_GetObjectItem(subobject,"country")) != NULL)                    {                        memcpy(result->country, item->valuestring,strlen(item->valuestring));   // 保存数据供外部调用                    }                    // 匹配完整地名路径                    if((item = cJSON_GetObjectItem(subobject,"path")) != NULL)                     {                        memcpy(result->path, item->valuestring,strlen(item->valuestring));      // 保存数据供外部调用                        }                    // 匹配时区                    if((item = cJSON_GetObjectItem(subobject,"timezone")) != NULL)                    {                        memcpy(result->timezone, item->valuestring,strlen(item->valuestring));  // 保存数据供外部调用                        }                    // 匹配时差                    if((item = cJSON_GetObjectItem(subobject,"timezone_offset")) != NULL)                    {                        memcpy(result->timezone_offset, item->valuestring,strlen(item->valuestring));   // 保存数据供外部调用                    }                }                /* 匹配子对象2:今天的天气情况 */                if((subobject = cJSON_GetObjectItem(object,"now")) != NULL)                {                    // 匹配天气现象文字                    if((item = cJSON_GetObjectItem(subobject,"text")) != NULL)                    {                        memcpy(result->text, item->valuestring,strlen(item->valuestring)); // 保存数据供外部调用                    }                    // 匹配天气现象代码                    if((item = cJSON_GetObjectItem(subobject,"code")) != NULL)                    {                        memcpy(result->code, item->valuestring,strlen(item->valuestring)); // 保存数据供外部调用                    }                    // 匹配气温                    if((item = cJSON_GetObjectItem(subobject,"temperature")) != NULL)                     {                        memcpy(result->temperature, item->valuestring,strlen(item->valuestring));  // 保存数据供外部调用                    }                   }                /* 匹配子对象3:数据更新时间(该城市的本地时间) */                if((subobject = cJSON_GetObjectItem(object,"last_update")) != NULL)                {                    memcpy(result->last_update, subobject->valuestring,strlen(subobject->valuestring));  // 保存数据供外部调用                }            }         }    }        cJSON_Delete(json); //释放cJSON_Parse()分配出来的内存空间        return 0;} 

5、获取天气数据并解析

实现的总体框图(这是Window版的框图,Linux版的也是类似这样的思路):

基于Linux、C、JSON、Socket的编程实例


6、编译、运行

gcc -std=c99 weather_client.c cJSON.c -o weather_client
基于Linux、C、JSON、Socket的编程实例


分享到:


相關文章: