AGPageConfig Protocol Reference
Conforms to | AGConfig |
Declared in | AGPageConfig.h |
Tasks
-
parameterProvider
property required method -
offset
property required method -
limit
property required method -
metadataLocation
property required method -
nextIdentifier
property required method -
previousIdentifier
property required method -
pageExtractor
property required method
Properties
limit
The maximum number of results the server should return (default: 10)
@property (strong, nonatomic) NSNumber *limit
Discussion
The maximum number of results the server should return (default: 10)
If a parameter provider has been given, the limit value is ignored.
Declared In
AGPageConfig.h
metadataLocation
Indicates whether paging information (see identifiers) is received from the response ‘header’, the response ‘body’ or via RFC 5988 (‘webLinking’), which is the default. Other values are ignored and the default is being used.
@property (copy, nonatomic) NSString *metadataLocation
Discussion
Indicates whether paging information (see identifiers) is received from the response ‘header’, the response ‘body’ or via RFC 5988 (‘webLinking’), which is the default. Other values are ignored and the default is being used.
Note: if the pageExtractor option is not set, the library will default to use an appropriate pagination strategy according to the metadataLocation. If set this option is not required and is ignored if set. See pageExtraction configuration property for more information.
Declared In
AGPageConfig.h
nextIdentifier
The next identifier name (default: ‘next’).
@property (copy, nonatomic) NSString *nextIdentifier
Discussion
The next identifier name (default: ‘next’).
Declared In
AGPageConfig.h
offset
The offset of the first element that should be included in the returned collection (default: 0)
@property (copy, nonatomic) NSString *offset
Discussion
The offset of the first element that should be included in the returned collection (default: 0)
If a parameter provider has been given, the offset value is ignored.
Declared In
AGPageConfig.h
pageExtractor
An extension point to override the default strategies provided by the library. If set, the library will use this strategy to determine server paging. The strategy should conform to the protocol AGPageParameterExtractor.
@property (strong, nonatomic) id<AGPageParameterExtractor> pageExtractor
Discussion
An extension point to override the default strategies provided by the library. If set, the library will use this strategy to determine server paging. The strategy should conform to the protocol AGPageParameterExtractor.
Note: If this config setting is NOT set, the library will default to use an internal defined paging extractor implementation as defined by the metadataLocation configuration setting. See AGNSMutableArray+Paging API doc for example usage. See internal AGPageWebLinkingExtractor, AGPageHeaderExtractor and AGPageBodyExtractor for example pagination strategies.
Declared In
AGPageConfig.h
parameterProvider
A dictionary containing all the HTTP request parameters and their values, that are passed to the server, used when issuing paging requests.
@property (copy, nonatomic) NSDictionary *parameterProvider
Discussion
A dictionary containing all the HTTP request parameters and their values, that are passed to the server, used when issuing paging requests.
If no “parameter provider” has been provided, the values for limit/offset are used
Declared In
AGPageConfig.h