mirror of
https://github.com/zhigang1992/RestKit.git
synced 2026-04-19 13:09:19 +08:00
3d0f0ab39e
RKTableController provides a flexible, integrated system for driving iOS table views using the RestKit object mapping engine. Local domain objects can be mapped into table cells within a collection or presented for editing as part of a form. There are three flavors of table controllers available: * Static Tables: RKTableController can be used to render simple static tables that are composed of RKTableItems presented in RKTableSections. Table items can quickly be built and added to a table without a backing model or can have content object mapped into them for presentation. * Network Tables: RKTableController can also render a table with the results of a network load. The typical use case here is to have RestKit retrieve a JSON/XML payload from your remote system and then render the content into a table. * Core Data Tables: RKFetchedResultsTableController can efficiently drive a table view using objects pulled from a Core Data managed object context. Typical use-cases here are for the presentation of large collections that are pulled from a remote system, offering offline access, or speeding up a UI by using Core Data as a fast local cache. RKTableController supports a number of bells and whistles including integrated searching/filtering and pull to refresh.
91 lines
3.5 KiB
Objective-C
91 lines
3.5 KiB
Objective-C
//
|
|
// RKDotNetDateFormatter.h
|
|
// RestKit
|
|
//
|
|
// Created by Greg Combs on 9/8/11.
|
|
// Copyright (c) 2011 RestKit.
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
//
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
//
|
|
|
|
#import <Foundation/Foundation.h>
|
|
|
|
/**
|
|
A subclass of NSDateFormatter that serves as translator between ASP.NET date serializations in JSON
|
|
strings and NSDate objects. This is useful for properly mapping these dates from an ASP.NET driven backend.
|
|
*NOTE* - DO NOT attempt to use setDateFormat: on this class. It will return invalid results.
|
|
*/
|
|
@interface RKDotNetDateFormatter : NSDateFormatter {
|
|
NSRegularExpression *dotNetExpression;
|
|
}
|
|
|
|
/**
|
|
Instantiates an autoreleased RKDotNetDateFormatter object with the timezone set to UTC
|
|
(Greenwich Mean Time).
|
|
|
|
@return An autoreleased RKDotNetDateFormatter object
|
|
@see dotNetDateFormatterWithTimeZone
|
|
*/
|
|
+ (RKDotNetDateFormatter *)dotNetDateFormatter;
|
|
|
|
/**
|
|
Instantiates an autoreleased RKDotNetDateFormatter object.
|
|
The supplied timeZone, such as one produced with [NSTimeZone timeZoneWithName:@"UTC"],
|
|
is only used during calls to stringFromDate:, for a detailed explanation see dateFromString:
|
|
|
|
@param timeZone An NSTimeZone object.
|
|
@return An autoreleased RKDotNetDateFormatter object
|
|
@see dotNetDateFormatter
|
|
*/
|
|
+ (RKDotNetDateFormatter *)dotNetDateFormatterWithTimeZone:(NSTimeZone *)timeZone;
|
|
|
|
/**
|
|
Returns an NSDate object from an ASP.NET style date string respresentation, as seen in JSON.
|
|
Acceptable examples are:
|
|
/Date(1112715000000-0500)/
|
|
/Date(1112715000000)/
|
|
/Date(-1112715000000)/
|
|
Where 1112715000000 is the number of milliseconds since January 1, 1970 00:00 GMT/UTC, and -0500 represents the
|
|
timezone offset from GMT in 24-hour time. Negatives milliseconds are treated as dates before January 1, 1970.
|
|
|
|
*NOTE* NSDate objects do not have timezones, and you should never change an actual date value based on a
|
|
timezone offset. However, timezones are important when presenting dates to the user. Therefore,
|
|
If an offset is present in the ASP.NET string (it should be), we actually ignore the offset portion because
|
|
we want to store the actual date value in its raw form, without any pollution of timezone information.
|
|
If, on the other hand, there is no offset in the ASP.NET string, we assume GMT (+0000) anyway.
|
|
In summation, for this class setTimeZone: is ignored except when using stringFromDate:
|
|
|
|
@param string The ASP.NET style string, /Date(1112715000000-0500)/
|
|
@return An NSDate object
|
|
@see stringFromDate
|
|
@see NSDateFormatter
|
|
@see NSTimeZone
|
|
*/
|
|
- (NSDate *)dateFromString:(NSString *)string;
|
|
|
|
/**
|
|
Returns an ASP.NET style date string from an NSDate, such as /Date(1112715000000+0000)/
|
|
Where 1112715000000 is the number of milliseconds since January 1, 1970 00:00 GMT/UTC, and +0000 is the
|
|
timezone offset from GMT in 24-hour time.
|
|
|
|
*NOTE* GMT (+0000) is assumed otherwise specified via setTimeZone:
|
|
|
|
@param date An NSDate
|
|
@return The ASP.NET style string, /Date(1112715000000-0500)/
|
|
@see dateFromString
|
|
@see NSDateFormatter
|
|
@see NSTimeZone
|
|
*/
|
|
- (NSString *)stringFromDate:(NSDate *)date;
|
|
@end
|