2 * Copyright (c) 2016 Samsung Electronics Co., Ltd All Rights Reserved
4 * Licensed under the Apache License, Version 2.0 (the License);
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
8 * http://www.apache.org/licenses/LICENSE-2.0
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an AS IS BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
18 using System.Collections.Generic;
19 using System.Threading.Tasks;
24 /// Base class for a map service request.
26 /// <since_tizen> 3 </since_tizen>
27 /// <typeparam name="T"></typeparam>
28 public abstract class MapServiceRequest<T> : IDisposable
30 internal TaskCompletionSource<IEnumerable<T>> _requestTask;
31 internal string errMessage;
32 internal int? _requestID;
33 internal ServiceRequestType _type;
35 internal Action startExecutionAction;
36 internal Interop.ErrorCode errorCode;
38 internal MapService _service;
41 /// Creates a map service request.
43 /// <param name="service">Map service object.</param>
44 /// <param name="type">Request type.</param>
45 internal MapServiceRequest(MapService service, ServiceRequestType type)
52 /// Sends a request to the map service provider.
54 /// <since_tizen> 3 </since_tizen>
55 /// <returns>Response from the map service provider.</returns>
56 /// <privilege>http://tizen.org/privilege/mapservice</privilege>
57 /// <privilege>http://tizen.org/privilege/internet</privilege>
58 /// <privilege>http://tizen.org/privilege/network.get</privilege>
59 /// <exception cref="System.NotSupportedException">Thrown when the required feature is not supported.</exception>
60 /// <exception cref="System.UnauthorizedAccessException">Thrown when application does not have some privilege to access this method.</exception>
61 /// <exception cref="System.InvalidOperationException">Thrown when the result is invalid.</exception>
62 /// <exception cref="System.ArgumentException">Thrown when arguments are invalid.</exception>
63 public async Task<IEnumerable<T>> GetResponseAsync()
65 IEnumerable<T> task = null;
66 if (_requestTask == null || _requestTask.Task.IsCanceled)
68 _requestTask = new TaskCompletionSource<IEnumerable<T>>();
69 startExecutionAction();
70 task = await _requestTask.Task.ConfigureAwait(false);
72 errorCode.WarnIfFailed(errMessage);
76 internal void Cancel()
78 if (_requestTask?.Task.IsCompleted == false)
80 _requestTask?.SetCanceled();
81 if (_requestID != null)
83 var err = Interop.CancelRequest(_service.handle, (int)_requestID);
84 err.ThrowIfFailed($"Unable to cancel service request, Type: {_type}, ID: {_requestID}");
87 errorCode = Interop.ErrorCode.Canceled;
91 #region IDisposable Support
92 private bool _disposedValue = false;
95 /// Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.
97 /// <param name="disposing">If true, managed and unmanaged resources can be disposed, otherwise only unmanaged resources can be disposed.</param>
98 protected virtual void Dispose(bool disposing)
107 _disposedValue = true;
112 /// Releases all the resources used by this object.
114 /// <since_tizen> 3 </since_tizen>
115 public void Dispose()
118 GC.SuppressFinalize(this);