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 map service request
26 /// <typeparam name="T"></typeparam>
27 public abstract class MapServiceRequest<T> : IDisposable
29 protected TaskCompletionSource<IEnumerable<T>> _requestTask;
30 protected string errMessage;
31 protected int? _requestID;
32 protected ServiceRequestType _type;
34 internal Action startExecutionAction;
35 internal Interop.ErrorCode errorCode;
37 internal MapService _service;
40 /// Creates a map service request.
42 /// <param name="service">map service object</param>
43 /// <param name="type">Request type</param>
44 internal MapServiceRequest(MapService service, ServiceRequestType type)
51 /// Sends a request to map service provider.
53 /// <returns>Response from map service provider</returns>
54 /// <privilege>http://tizen.org/privilege/mapservice</privilege>
55 /// <privilege>http://tizen.org/privilege/internet</privilege>
56 /// <privilege>http://tizen.org/privilege/network.get</privilege>
57 /// <exception cref="System.NotSupportedException">Thrown when the required feature is not supported.</exception>
58 /// <exception cref="System.UnauthorizedAccessException">Thrown when application does not have some privilege to access this method.</exception>
59 /// <exception cref="System.InvalidOperationException">Thrown when the result is invalid.</exception>
60 /// <exception cref="System.ArgumentException">Thrown when arguments are invalid</exception>
61 public async Task<IEnumerable<T>> GetResponseAsync()
63 IEnumerable<T> task = null;
64 if (_requestTask == null || _requestTask.Task.IsCanceled)
66 _requestTask = new TaskCompletionSource<IEnumerable<T>>();
67 startExecutionAction();
68 task = await _requestTask.Task;
70 errorCode.WarnIfFailed(errMessage);
74 internal void Cancel()
76 if (_requestTask?.Task.IsCompleted == false)
78 _requestTask?.SetCanceled();
79 if (_requestID != null)
81 var err = Interop.CancelRequest(_service.handle, (int)_requestID);
82 err.ThrowIfFailed($"Unable to cancel service request, Type: {_type}, ID: {_requestID}");
85 errorCode = Interop.ErrorCode.Canceled;
89 #region IDisposable Support
90 private bool _disposedValue = false;
92 protected virtual void Dispose(bool disposing)
101 _disposedValue = true;
106 /// Releases all resources used by this object.
108 public void Dispose()
111 GC.SuppressFinalize(this);