BlueRocketFuelCore 0.14.0

BlueRocketFuelCore 0.14.0

测试已测试
Lang语言 Obj-CObjective C
许可证 Apache 2
发布上次发布2016年9月

Matt Magoffinwmjesstaylor 维护。



Blue Rocket Fuel Core

此项目提供核心模块以帮助启动 iOS 应用。它与 BlueRocketFuelAppp 初始项目协同工作。每个模块都可作为 Cocoapod 子规格 提供,并可以导入到以下类型的项目中:

pod 'BlueRocketFuelCore/Core'

默认情况下,如果您的 Podfile 中仅包含以下内容,则所有模块都将导入:

pod 'BlueRocketFuelCore'

模块:核心

核心 模块为以下领域提供基本支持

  • 一个 用户 领域对象
  • 一个简单的 密钥链服务,用于在操作系统密钥链中保存敏感信息
  • 一个基于 JSON 字符串文件格式的本地化框架
  • 一个基于 BREnvironment 和 JSON 配置文件格式的配置框架
  • 各种实用工具,如日期格式化和验证

模块:UI

UI 模块提供 UI 组件以及以下方面的支持

  • 基于 Core 模块本地化框架的 NIB 对象和视图本地化
  • 用于应用程序导航的 选项板 视图控制器
  • 各种实用工具,如图像操纵和效果

模块:WebApiClient-RestKit

WebApiClient-RestKit 模块提供对核心领域对象的映射支持。BRRestKitDataMapping 类是应用程序扩展的好起点:它为 BRAppUser 领域对象注册了对标准 loginregister 路由名称的对象映射器。

模块:WebApiClient-Services

WebApiClient-Services 模块提供 BRUserService API 的 WebApiClient 实现,用于处理登录和注册任务。

模块:WebRequest

WebRequest 模块提供了一个基于 NSURLConnection 的 HTTP 客户端框架,可以通过 Core 模块配置框架及一些简单约定进行配置。

配置

Web服务配置和支持通过以下三个区域进行管理

config.json文件

此JSON文件用于定义您Web服务提供的所有端点。您需要在此处指定每个端点的路径和方法(GET、POST、PUT等)。

BREnvironment设置

您的Web服务的URL、端口和协议通过BREnvironment进行配置。

Web服务端点类

对于您Web服务中的每个端点,您都需要实现一个类。使用以下命名约定命名类:{EndPoint}WebServiceRequest,其中{EndPoint}是在config.json文件中定义的端点名称,且首字母大写。

您的自定义Web服务端点类应然后继承以下内置BRFC类之一,具体取决于端点最适合哪个

BRWebServiceRequest

对于公共、非限制性端点,这些端点不需要身份验证用户令牌即可访问。

BRAuthenticatedWebServiceRequest

对于需要通过“USER-AUTHORIZATION”HTTP头传递身份验证用户令牌才能访问的端点。

BRUserWebServiceRequest

对于不仅需要身份验证用户令牌才能访问,还需要将用户的记录ID附加到端点路径中的端点。此类的子类通常用于提供用户特定详情的端点,例如用户配置文件端点。