Fix : Remove exception handling codes at the sample code

[platform/framework/native/content.git] / inc / FCntContentTransfer.h

diff --git a/inc/FCntContentTransfer.h b/inc/FCntContentTransfer.h
index e2a3d11..784e37a 100644 (file)
--- a/inc/FCntContentTransfer.h
+++ b/inc/FCntContentTransfer.h
@@ -59,61 +59,51 @@ class IContentTransferListener;
  *
  * The following example demonstrates how to use the %ContentTransfer class.
  *
- *     @code
- *     class  MyClass
- *             :public Tizen::Content::IContentTransferListener
- *     {
- *     public:
- *             MyClass(void);
- *             virtual ~MyClass(void);
+ * @code
+ * #include <FBase.h>
+ * #include <FContent.h>
+ * #include <FSystem.h>
  *
- *     public:
- *             void OnContentTransferInProgress(RequestId requestID, int totalReceivedSize);
- *             void OnContentDownloadCompleted(RequestId requestID, ContentId contentID, result res, const Tizen::Base::String& errorCode, const Tizen::Base::String& errorMessage);
- *             void OnContentDownloadToBufferCompleted(RequestId reqId, Tizen::Base::ByteBuffer* pBuffer, result r, const Tizen::Base::String& errorCode, const Tizen::Base::String& errorMessage);
- *             void OnContentTransferCanceled(RequestId reqId, result res, const Tizen::Base::String& errorCode, const Tizen::Base::String& errorMessage);
- *     };
- *
- *     // Implementation for the listener function and Implementation of other listener function is
- *     void MyClass::OnContentDownloadCompleted(RequestId requestID, ContentId contentID, result res, const Tizen::Base::String& errorCode, const Tizen::Base::String& errorMessage)
- *     {
- *             result r = E_SUCCESS;
- *             ContentManager contentManager;
- *             ContentInfo* pContentInfo = null;
- *
- *             // Error check
- *             TryCatch(!IsFailed(res), r, "Download Error [%s]", GetErrorMessage(res));
+ * using namespace Tizen::Content;
  *
- *             // Do something
- *             r = contentManager.Construct();
- *             TryCatch(!IsFailed(r), r, "Construct failed.");
- *
- *             // Get ContentInfo
- *             pContentInfo = contentManager.GetContentInfoN(contentID);
- *     CATCH:
- *             if (pContentInfo)
- *                     delete pContentInfo;
- *     }
+ * class MyClass
+ *             : public Tizen::Content::IContentTransferListener
+ * {
+ * public:
+ *             result Download(void);
+ *             void OnContentTransferInProgress(RequestId requestID, int totalReceivedSize) {}
+ *             void OnContentDownloadCompleted(RequestId requestID, ContentId contentID, result res, const Tizen::Base::String& errorCode, const Tizen::Base::String& errorMessage);
+ *             void OnContentDownloadToBufferCompleted(RequestId reqId, Tizen::Base::ByteBuffer* pBuffer, result r, const Tizen::Base::String& errorCode, const Tizen::Base::String& errorMessage) {}
+ *             void OnContentTransferCanceled(RequestId reqId, result res, const Tizen::Base::String& errorCode, const Tizen::Base::String& errorMessage) {}
+ * };
  *
- *     result
- *     MyClass::RequestDownload(void)
- *     {
+ * result
+ * MyClass::Download(void)
+ * {
  *             ContentTransfer contentTransfer;
- *             RequestId requestId;
+ *             result r = contentTransfer.Construct(*this);
+ *
  *             Tizen::Base::Utility::Uri contentUri;
- *             int contentSize;
- *             Tizen::Base::String downloadPath;
+ *             contentUri.SetUri(L"https://www.tizen.org");
+ *             Tizen::Base::String downloadPath(Tizen::System::Environment::GetMediaPath() + L"test");
+ *             RequestId requestId;
+ *             r = contentTransfer.Download(contentUri, downloadPath, requestId, false);
  *
- *             result r = contentTransfer.Construct(*this);
- *             TryReturn(!IsFailed(r), r, ("Construct is failed.\n"));
+ *             result r;
+ * }
  *
- *             // TODO: set uri and download path
+ * void
+ * MyClass::OnContentDownloadCompleted(RequestId requestID, ContentId contentID, result res, const Tizen::Base::String& errorCode, const Tizen::Base::String& errorMessage)
+ * {
+ *             ContentManager contentManager;
+ *             result r = contentManager.Construct();
  *
- *             r = contentTransfer.Download(contentUri, downloadPath, requestId, false);
- *             TryReturn(!IsFailed(r), r, ("Download Request is failed.\n"));
- *     }
- *     @endcode
- *     @endif
+ *             ContentInfo* pContentInfo = contentManager.GetContentInfoN(contentID);
+ *             r = GetLastResult();
+ * }
+ *
+ * @endcode
+ * @endif
  */
 class _OSP_EXPORT_ ContentTransfer
        : virtual public Tizen::Base::Object