ArcGIS Runtime SDK for iOS
100.15
|
Represents a table in an OGC Web Feature Service.
populateFromServiceWithRequestXML
or populateFromServiceWithParameters
to populate the table. Use AGSWFSService
to connect to a WFS service and discover available layers that can be opened using a WFS feature table via initWithLayerInfo
. Class Methods | |
(instancetype) | + WFSFeatureTableWithLayerInfo: |
(instancetype) | + WFSFeatureTableWithURL:tableName: |
Properties | |
AGSOGCAxisOrder | axisOrder |
BOOL | canAddFeature |
BOOL | canEditGeometry |
AGSCredential * | credential |
NSString * | displayName |
BOOL | editable |
AGSEnvelope * | extent |
AGSFeatureLayer * | featureLayer |
AGSFeatureRequestMode | featureRequestMode |
NSArray< AGSField * > * | fields |
AGSOGCAxisOrder | filterAxisOrder |
AGSGeometryType | geometryType |
BOOL | hasGeometry |
BOOL | hasM |
BOOL | hasZ |
AGSLayer * | layer |
AGSWFSLayerInfo * | layerInfo |
NSError * | loadError |
AGSLoadStatus | loadStatus |
NSInteger | numberOfFeatures |
AGSPopupDefinition * | popupDefinition |
BOOL | popupEnabled |
AGSSpatialReference * | preferredSpatialReference |
AGSRequestConfiguration * | requestConfiguration |
AGSSpatialReference * | spatialReference |
NSString * | tableName |
NSURL * | URL |
|
requiredinherited |
Cancels loading if it is in progress, otherwise it does nothing. This should be called carefully because other objects could be waiting for loadWithCompletion:
or retryLoadWithCompletion:
to complete and this will call them all back with the error of NSUserCancelledError
- (BOOL) canDeleteFeature: | (AGSFeature *) | feature |
Indicates whether the source allows this particular feature to be deleted. The method first checks to verify if the source is capable of deleting any features in general. It also checks specific ownership-based access control policies of the source to see if the user attempting to perform the operation has persmissions to delete this particular feature.
feature | Can be nil, in which case, this method only checks if the source is capable of deleting any features in general |
- (BOOL) canUpdateFeature: | (AGSFeature *) | feature |
Indicates whether the source allows updating this particular feature. The method first checks to verify if the source is capable of updating any features in general. It also checks specific ownership-based access control policies of the source to see if the user attempting to perform the operation has persmissions to edit this patricular feature.
feature | Can be nil, in which case, this method only checks if the source is capable of updating any features in general |
- (AGSFeature *) createFeature |
Create a new, empty feature. Note, the new feature is only available in memory at this point, it is not committed to the dataset.
addFeature:completion:
- (AGSFeature *) createFeatureWithAttributes: | (NSDictionary< NSString *, id > *) | attributes | |
geometry: | (nullable AGSGeometry *) | geometry | |
Create a new feature with the provided attribute values and, optionally, geometry. Note, the new feature is only available in memory at this point, it is not committed to the dataset.
attributes | for the feature |
geometry | for the feature |
addFeature:completion:
- (void) doCancelLoading |
Never call this method directly. The framework calls this method on a background thread when cancelLoad (AGSLoadable-p)
is called. It is meant to be overriden by subclasses. Subclasses should override this method to cancel loading their data and call loadDidFinishWithError: (AGSLoadableBase(ForSubclassEyesOnly))
at the end passing in an error representing NSUserCancelledError
.
Provided by category AGSLoadableBase(ForSubclassEyesOnly).
- (void) doStartLoading: | (BOOL) | retrying |
Never call this method directly. The framework calls this method on a background thread when loadWithCompletion: (AGSLoadable-p)
or retryLoadWithCompletion: (AGSLoadable-p)
is called. It is meant to be overriden by subclasses. Subclasses should override this method to load their data and call loadDidFinishWithError: (AGSLoadableBase(ForSubclassEyesOnly))
upon completion, passing in the error if any.
retrying | flag that is true if this method was called from retryLoadWithCompletion: (AGSLoadable-p) . |
Provided by category AGSLoadableBase(ForSubclassEyesOnly).
- (nullable AGSField *) fieldForName: | (NSString *) | fieldName |
Convenience method to getting a field object given its name
fieldName | The name of the field. |
- (instancetype) initWithLayerInfo: | (AGSWFSLayerInfo *) | layerInfo |
- (instancetype) initWithURL: | (NSURL *) | URL | |
tableName: | (NSString *) | tableName | |
Creates a new WFS feature table.
URL | The URL of the WFS service to connect to. |
tableName | The name of the WFS feature table object. |
- (void) loadDidFinishWithError: | (nullable NSError *) | error |
Only subclasses should call this method in doStartLoading: (AGSLoadableBase(ForSubclassEyesOnly))
and doCancelLoading (AGSLoadableBase(ForSubclassEyesOnly))
when done loading or failed to load.
Provided by category AGSLoadableBase(ForSubclassEyesOnly).
|
requiredinherited |
Loads data for the object asynchronously. The completion block is invoked upon completion.
You can call this method any number of times, however only one attempt is made to load the data. If it is already loading, it will just continue to load (i.e. not force a reload). If it has already loaded successfully, the completion block will be invoked right away. If it has already failed to load, the completion block will be invoked right away with error previously encountered. This method supports multiple callers and will call them all back on completion. However, each caller's completion block will be invoked once and only once.
completion | block that is invoked when object loads successfully or fails to load. An error is passed to the block if the object fails to load. |
- cancelLoad
to cancel loading - retryLoadWithCompletion:
to force reload - (void) onLoadStatusChanged |
Never call this method directly. The framework calls this method on a background thread when AGSLoadable::loadStatus
changes is called. Subclasses can optionally implement this to know when their loading status has changed.
Provided by category AGSLoadableBase(ForSubclassEyesOnly).
- (id<AGSCancelable>) populateFromServiceWithParameters: | (AGSQueryParameters *) | parameters | |
clearCache: | (BOOL) | clearCache | |
outFields: | (nullable NSArray< NSString * > *) | outFields | |
completion: | (nullable void(^)(AGSFeatureQueryResult *__nullable result, NSError *__nullable error)) | completion | |
Manually populate the table using a query.
Specifying nil
or an empty array for outFields
will result in the default set of outFields
being used.
AGSQueryParameters
to get all features from the service. WFS is only compatible with a subset of possible queries defined by AGSQueryParameters
. Where clause only works when the table is backed by a service powered by GeoServer. Spatial queries (those that specify a geometry) must use the Intersects
spatial relationship. parameters | defining which data should be requested from the service and added to the table |
clearCache | If true, existing data will be cleared before adding the new data |
outFields | A list of field names specifying which attribute values (columns) should be included in the table. |
completion | block that is invoked when the operation finishes. The result parameter is populated if the operation completed successfully, otherwise the error parameter is populated. |
- (id<AGSCancelable>) populateFromServiceWithRequestXML: | (NSString *) | requestXML | |
clearCache: | (BOOL) | clearCache | |
completion: | (nullable void(^)(AGSFeatureQueryResult *__nullable result, NSError *__nullable error)) | completion | |
Manually populate the table using an XML query.
requestXML | A string containing the XML of the complete GetFeature request including but not limited to filters, joins, and aliases. |
clearCache | If true, existing data will be cleared before adding the new data. |
completion | A block that is invoked when the operation finishes. The result parameter is populated if the operation completed successfully, otherwise the error parameter is populated. |
- (id<AGSCancelable>) queryExtentWithParameters: | (AGSQueryParameters *) | parameters | |
completion: | (void(^)(AGSEnvelope *__nullable extent, NSError *__nullable error)) | completion | |
Query the dataset to find the geographic extent covering matched features or records.
parameters | representing the query criteria |
completion | The block that is called when the query is complete |
AGSFeatureServiceSessionType
- (id<AGSCancelable>) queryFeatureCountWithParameters: | (AGSQueryParameters *) | parameters | |
completion: | (void(^)(NSInteger count, NSError *__nullable error)) | completion | |
Query the dataset to find the number of matched features or records.
parameters | representing the query criteria |
completion | The block that is called when the query is complete |
AGSFeatureServiceSessionType
- (id<AGSCancelable>) queryFeaturesWithParameters: | (AGSQueryParameters *) | parameters | |
completion: | (nullable void(^)(AGSFeatureQueryResult *__nullable result, NSError *__nullable error)) | completion | |
Query the dataset to find specific features or records.
parameters | representing the query criteria |
completion | The block that is called when the query is complete |
AGSFeatureServiceSessionType
- (id<AGSCancelable>) queryStatisticsWithParameters: | (AGSStatisticsQueryParameters *) | parameters | |
completion: | (void(^)(AGSStatisticsQueryResult *__nullable result, NSError *__nullable error)) | completion | |
Query the dataset to compute statistics on matched features or records.
parameters | representing the query criteria |
completion | The block that is called when the query is complete |
AGSFeatureServiceSessionType
|
requiredinherited |
Tries to reload when an object has failed to load. This method should be called judiciously. It should be called when:
cancelLoad
and then this methodIf the data hasn't started loading, it will start loading. If it is already loading, it will just continue to load. If it has already loaded successfully, calls back right away. If it has already failed to load, tries again. This method supports multiple callers and will call them all back on completion. However, each caller's completion block will be invoked once and only once.
completion | block that is invoked when object loads successfully or fails to load. An error is passed to the block if the object fails to load. |
+ (instancetype) WFSFeatureTableWithLayerInfo: | (AGSWFSLayerInfo *) | layerInfo |
+ (instancetype) WFSFeatureTableWithURL: | (NSURL *) | URL | |
tableName: | (NSString *) | tableName | |
Creates a new WFS feature table.
URL | The URL of the WFS service to connect to. |
tableName | The name of the WFS feature table object. |
|
readwritenonatomicassign |
The axis order, which defines how coordinates are interpreted (X,Y or Y,X).
Swap
will result in all coordinates in geometries being swapped from what was sent by the server. Setting to NoSwap
will cause coordinates to be interpreted as-is. Defaults to Auto
. In this mode, Runtime will make its best guess using heuristics that are optimized for good results with most popular WFS services. Axis order may be changed on an already-loaded feature table, but the change will only affect future calls to populateFromService
. Features that are already in the table will not be modified/swapped.
|
readnonatomicassigninherited |
Indicates whether the source supports adding new features.
|
readnonatomicassigninherited |
Indicates whether the source supports updating geometry of existing features.
|
readwritenonatomicstronginherited |
Security credentials to access the remote resource. Only applicable if the resource is secured.
|
readwritenonatomiccopyinherited |
User-friendly name that can be displayed in the UI (for example in a Table of Contents)
|
readnonatomicassigninherited |
Indicates whether the dataset can be edited. For details on which fine-grained editing capabilites are supported, refer to canUpdateFeature:
and canDeleteFeature:
|
readnonatomicstronginherited |
The extent of the dataset.
|
readnonatomicweakinherited |
The feature layer this table is associated with, or created from, if any. nil
if this table is not associated with a feature layer. This property is populated when the AGSFeatureLayer
is created from the AGSFeatureTable
.
AGSFeatureTable::layer
instead Provided by category AGSFeatureTable(AGSDeprecated).
|
readwritenonatomicassign |
The mode defining when features are requested from the service.
ManualCache
but defaults to OnInteractionCache
. Set the feature request mode to Manual
before attempting to populate the table with populateFromServiceWithParameters
or populateFromServiceWithRequestXML
.
|
readnonatomiccopyinherited |
|
readwritenonatomicassign |
The filter axis order, which determines how coordinates are ordered when sent to the server as part of spatial queries (those that specify a Geometry).
Swap
to send coordinates in (Y,X) order and NoSwap
to use (X,Y) order. Defaults to Auto
.
|
readnonatomicassigninherited |
The type of geometry used by geographic feautres. Only applicable if hasGeometry
is true.
|
readnonatomicassigninherited |
Indicates whether the dataset contains a geometry field (column). If YES, the dataset contains geographic features. If NO, the dataset contains non-spatial records, similar to a database table.
|
readnonatomicassigninherited |
Indicates whether features may contain M values
|
readnonatomicassigninherited |
Indicates whether features may contain Z values
|
readnonatomicweakinherited |
The layer this table is associated with, or created from, if any. This can be an AGSAnnotationLayer
, an AGSDimensionLayer
, an AGSFeatureLayer
, or nil
if this table is not associated with a layer. This property is populated when the layer is created from the AGSFeatureTable
.
|
readnonatomicstrong |
Metadata describing the WFS layer.
|
readnonatomicstronginherited |
The error that was encountered during the most recent load operation. Will be nil if the operation succeeded.
|
readrequirednonatomicassigninherited |
Status of the load operation.
|
readnonatomicassigninherited |
The total number of features or records in the dataset.
|
readwritenonatomicstronginherited |
The AGSPopupDefinition
associated with the popup source. This property will be nil
if an error occurs or if the popup source is not associated with a popup definition.
|
readwriterequirednonatomicassigninherited |
Indicates whether popups are enabled on this source.
|
readwritenonatomicstrong |
The preferred spatial reference for the WFS feature table.
|
readwritenonatomicstronginherited |
The AGSRequestConfiguration object which defines the behavior and policies to use when accessing the remote resource. The default will be nil. If it is nil the [AGSRequestConfiguration globalConfiguration] will be used.
|
readnonatomicstronginherited |
The spatial reference of the dataset.
|
readnonatomiccopyinherited |
Name of the dataset.
|
readrequirednonatomicstronginherited |
The URL of the remote resource.