{"id":21802885,"url":"https://github.com/coderzhuxh/xhnetworking","last_synced_at":"2025-04-13T18:51:46.611Z","repository":{"id":56927969,"uuid":"58986654","full_name":"CoderZhuXH/XHNetworking","owner":"CoderZhuXH","description":"基于AFNNetworking 3.x 的轻量级数据请求库,支持数据自动/手动缓存","archived":false,"fork":false,"pushed_at":"2016-05-27T03:54:28.000Z","size":236,"stargazers_count":15,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-12T23:48:46.597Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Objective-C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CoderZhuXH.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-05-17T03:14:53.000Z","updated_at":"2019-06-14T09:10:28.000Z","dependencies_parsed_at":"2022-08-21T06:20:26.081Z","dependency_job_id":null,"html_url":"https://github.com/CoderZhuXH/XHNetworking","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CoderZhuXH%2FXHNetworking","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CoderZhuXH%2FXHNetworking/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CoderZhuXH%2FXHNetworking/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CoderZhuXH%2FXHNetworking/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CoderZhuXH","download_url":"https://codeload.github.com/CoderZhuXH/XHNetworking/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248765984,"owners_count":21158296,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-27T11:34:01.374Z","updated_at":"2025-04-13T18:51:46.577Z","avatar_url":"https://github.com/CoderZhuXH.png","language":"Objective-C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# XHNetworking\n* 基于AFNNetworking 3.x 的轻量级数据请求框架,支持数据自动/手动缓存--支持CocoaPods\n\n## 写在最前:\n*  默认使用: \u003cbr\u003e\n   `请求数据类型` 为:`HTTP` \u003cbr\u003e\n   `返回结果类型`为:`JSON` \u003cbr\u003e\n*  若需修改:\u003cbr\u003e\n   请在`XHNetworking.m` 文件,`+(AFHTTPSessionManager *)createManager` 中进行配置\n   \n## 使用方法:\n### 1.数据请求+自动缓存\n```objc\n\n/**\n*  POST请求,自动缓存\n*\n*  @param URL       URL String\n*  @param dic       参数\n*  @param jsonCache 缓存回调\n*  @param success   成功回调\n*  @param failure   失败回调\n*/\n+(void)POST:(NSString *)URL parameters:(NSDictionary *)dic jsonCache:(httpRequestCache)jsonCache  success:(httpRequestSucess)success failure:(httpRequestFailed)failure;\n\n/**\n*  GET请求,自动缓存\n*\n*  @param URL           URL String\n*  @param dic           参数\n*  @param jsonCache 缓存回调\n*  @param success       成功回调\n*  @param failure       失败回调\n*/\n+(void)GET:(NSString *)URL parameters:(NSDictionary *)dic  jsonCache:(httpRequestCache)jsonCache success:(httpRequestSucess)success failure:(httpRequestFailed)failure;\n\n```\n### 栗子:\n```objc\n\n NSString *URL = @\"http://www.qinto.com/wap/index.php?ctl=article_cate\u0026act=api_app_getarticle_cate\u0026num=1\u0026p=1\";\n\n[XHNetworking POST:RequestURL parameters:nil jsonCache:^(id cache) {\n\n//缓存\nNSLog(@\"缓存:\\n%@\",cache);\n//To Do...\n\n} success:^(id responseObject) {\n\n//成功\nNSLog(@\"success:%@\\n\",responseObject);\n//刷新数据\n//To Do...\n\n} failure:^(NSError *error) {\n\n//失败\nNSLog(@\"error:%@\\n\",error);\n\n}];\n\n```\n\n### 2.普通数据请求+手动缓存\n```objc\n\n/**\n*  POST请求\n*\n*  @param URL     URL String\n*  @param dic     参数\n*  @param success 成功回调\n*  @param failure 失败回调\n*/\n+(void)POST:(NSString *)URL parameters:(NSDictionary *)dic success:(httpRequestSucess)success failure:(httpRequestFailed)failure;\n\n/**\n*  GET请求\n*\n*  @param URL     URL String\n*  @param dic     参数\n*  @param success 成功回调\n*  @param failure 失败回调\n*/\n+(void)GET:(NSString *)URL parameters:(NSDictionary *)dic success:(httpRequestSucess)success failure:(httpRequestFailed)failure;\n\n/**\n*  手动写入/更新缓存\n*\n*  @param jsonResponse 要写入的数据\n*  @param URL    请求URL\n*\n*  @return 是否写入成功\n*/\n+(BOOL)saveJsonResponseToCacheFile:(id)jsonResponse andURL:(NSString *)URL;\n\n/**\n*  获取缓存的对象\n*\n*  @param URL 请求URL\n*\n*  @return 缓存对象\n*/\n+(id )cacheJsonWithURL:(NSString *)URL;\n\n```\n### 栗子:\n```objc\n\nNSString *URL =@\"http://www.qinto.com/wap/index.php?ctl=article_cate\u0026act=api_app_getarticle_cate\u0026num=1\u0026p=2\";\n\n//手动获取缓存\nNSDictionary *cache = [XHNetworkCache cacheJsonWithURL:URL];\n//To Do...\n\nNSLog(@\"缓存:\\n%@\",cache);\n\n[XHNetworking POST:URL parameters:nil success:^(id responseObject) {\n\n//成功\nNSLog(@\"success:%@\\n\",responseObject);\n\n//刷新数据\n//To Do...\n\n//手动写入/更新缓存\n[XHNetworkCache saveJsonResponseToCacheFile:responseObject andURL:URL];\n\n\n} failure:^(NSError *error) {\n\n//失败\nNSLog(@\"error:%@\\n\",error);\n\n}];\n\n```\n\n##  安装\n### 手动添加:\u003cbr\u003e\n*   1.将 XHNetworking 文件夹添加到工程目录中\u003cbr\u003e\n*   2.添加 AFNNetworking 3.x 到工程目录中\u003cbr\u003e\n*   3.导入 XHNetworking.h\n\n### CocoaPods:\u003cbr\u003e\n*   1.在 Podfile 中添加 pod 'XHNetworking'\u003cbr\u003e\n*   2.执行 pod install 或 pod update\u003cbr\u003e\n*   3.导入 XHNetworking.h\n\n##  系统要求\n*   该项目最低支持 iOS 7.0 和 Xcode 7.0\n\n##  许可证\n    XHNetworking 使用 MIT 许可证，详情见 LICENSE 文件\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoderzhuxh%2Fxhnetworking","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcoderzhuxh%2Fxhnetworking","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoderzhuxh%2Fxhnetworking/lists"}