Sirikata
|
00001 /* Sirikata 00002 * ResourceDownloadTask.hpp 00003 * 00004 * Copyright (c) 2009, Stanford University 00005 * All rights reserved. 00006 * 00007 * Redistribution and use in source and binary forms, with or without 00008 * modification, are permitted provided that the following conditions are 00009 * met: 00010 * * Redistributions of source code must retain the above copyright 00011 * notice, this list of conditions and the following disclaimer. 00012 * * Redistributions in binary form must reproduce the above copyright 00013 * notice, this list of conditions and the following disclaimer in 00014 * the documentation and/or other materials provided with the 00015 * distribution. 00016 * * Neither the name of Sirikata nor the names of its contributors may 00017 * be used to endorse or promote products derived from this software 00018 * without specific prior written permission. 00019 * 00020 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS 00021 * IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 00022 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A 00023 * PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER 00024 * OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, 00025 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 00026 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR 00027 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF 00028 * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING 00029 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS 00030 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 00031 */ 00032 00033 #ifndef _SIRIKATA_CORE_TRANSFER_RESOURCE_DOWNLOAD_TASK_HPP 00034 #define _SIRIKATA_CORE_TRANSFER_RESOURCE_DOWNLOAD_TASK_HPP 00035 00036 #include <sirikata/core/transfer/TransferMediator.hpp> 00037 #include <sirikata/core/transfer/TransferPool.hpp> 00038 #include <sirikata/core/transfer/RemoteFileMetadata.hpp> 00039 #include <sirikata/core/transfer/Range.hpp> 00040 #include <sirikata/core/transfer/RemoteFileMetadata.hpp> 00041 #include <sirikata/core/util/SelfWeakPtr.hpp> 00042 00043 namespace Sirikata { 00044 namespace Transfer { 00045 00046 class ResourceDownloadTask; 00047 typedef std::tr1::shared_ptr<ResourceDownloadTask> ResourceDownloadTaskPtr; 00048 typedef std::tr1::weak_ptr<ResourceDownloadTask> ResourceDownloadTaskWPtr; 00049 00059 class SIRIKATA_EXPORT ResourceDownloadTask : public SelfWeakPtr<ResourceDownloadTask> { 00060 public: 00061 typedef std::tr1::function<void( 00062 ResourceDownloadTaskPtr taskptr, 00063 TransferRequestPtr request, 00064 DenseDataPtr response)> DownloadCallback; 00065 00066 /* Download this resource based on URI 00067 * - First a name lookup will be performed for the URI 00068 * - Then the hash that comes back from the name lookup will be downloaded 00069 */ 00070 static ResourceDownloadTaskPtr construct(const URI& uri, TransferPoolPtr transfer_pool, double priority, DownloadCallback cb); 00071 00072 /* Download this resource based on a hash 00073 * - Just directly download the hash given 00074 */ 00075 static ResourceDownloadTaskPtr construct(const Chunk& chunk, TransferPoolPtr transfer_pool, double priority, DownloadCallback cb); 00076 00077 virtual ~ResourceDownloadTask(); 00078 00079 void mergeData(const SparseData &dataToMerge); 00080 00081 void start(); 00082 00083 bool isStarted() { 00084 return mStarted; 00085 } 00086 00087 void updatePriority(float64 priority); 00088 void cancel(); 00089 00090 inline const String& getIdentifier() const { 00091 return mID; 00092 } 00093 00094 protected: 00095 ResourceDownloadTask(const URI& uri, TransferPoolPtr transfer_pool, double priority, DownloadCallback cb); 00096 ResourceDownloadTask(const Chunk& chunk, TransferPoolPtr transfer_pool, double priority, DownloadCallback cb); 00097 00098 static void metadataFinishedWeak(ResourceDownloadTaskWPtr thiswptr, 00099 MetadataRequestPtr request, 00100 RemoteFileMetadataPtr response); 00101 void metadataFinished(MetadataRequestPtr request, 00102 RemoteFileMetadataPtr response); 00103 00104 static void chunkFinishedWeak(ResourceDownloadTaskWPtr thiswptr, 00105 ChunkRequestPtr request, 00106 DenseDataPtr response); 00107 static void directChunkFinishedWeak(ResourceDownloadTaskWPtr thiswptr, 00108 DirectChunkRequestPtr request, 00109 DenseDataPtr response); 00110 00111 void chunkFinished(TransferRequestPtr request, 00112 DenseDataPtr response); 00113 00114 bool mStarted; 00115 const URI mURI; 00116 const Chunk mChunk; 00117 TransferPoolPtr mTransferPool; 00118 TransferRequestPtr mCurrentRequest; 00119 SparseData mMergeData; 00120 double mPriority; 00121 DownloadCallback cb; 00122 const String mID; 00123 }; 00124 00125 } // namespace Transfer 00126 } // namespace Sirikata 00127 00128 #endif // _SIRIKATA_CORE_TRANSFER_RESOURCE_DOWNLOAD_TASK_HPP