/// <summary>
/// takes a given feed, and does a batch post of that feed
/// against the batchUri parameter. If that one is NULL
/// it will try to use the batch link URI in the feed
/// </summary>
/// <param name="feed">the feed to post</param>
/// <param name="batchUri">the URI to user</param>
/// <param name="userData">the userdata identifying this request</param>
/// <returns></returns>
public void BatchAsync(AtomFeed feed, Uri batchUri, Object userData)
{
AsyncSendData data = new AsyncSendData(this, batchUri, feed, this.ProgressReportDelegate, userData);
WorkerSendEventHandler workerDelegate = new WorkerSendEventHandler(AsyncBatchWorker);
this.AsyncStarter(data, workerDelegate, userData);
}
/// <summary>
/// takes a given feed, and does a batch post of that feed
/// against the batchUri parameter. If that one is NULL
/// it will try to use the batch link URI in the feed
/// </summary>
/// <param name="feed">the feed to post</param>
/// <param name="batchUri">the URI to user</param>
/// <param name="data">The async data payload</param>
/// <returns>the returned AtomFeed</returns>
private AtomFeed Batch(AtomFeed feed, Uri batchUri, AsyncSendData data)
{
Uri uriToUse = batchUri;
if (feed == null)
{
throw new ArgumentNullException("feed");
}
if (uriToUse == null)
{
uriToUse = feed.Batch == null ? null : new Uri(feed.Batch);
}
if (uriToUse == null)
{
throw new ArgumentNullException("batchUri");
}
Tracing.Assert(feed != null, "feed should not be null");
if (feed == null)
{
throw new ArgumentNullException("feed");
}
if (feed.BatchData == null)
{
// setting this will make the feed output the namespace, instead of each entry
feed.BatchData = new GDataBatchFeedData();
}
Stream returnStream = EntrySend(uriToUse, feed, GDataRequestType.Batch, data);
return(CreateAndParseFeed(returnStream, uriToUse));
}
/// <summary>
/// inserts the entry asynchronous, you need to supply a valid and unique
/// token. Events will be send to the async delegates you setup on the service
/// object
/// </summary>
/// <param name="feedUri">the target feed the entry get's inserted into</param>
/// <param name="entry"></param>
/// <param name="userData">a unique identifier to associate this request with</param>
/// <returns></returns>
public void InsertAsync(Uri feedUri, AtomEntry entry, Object userData)
{
AsyncSendData data = new AsyncSendData(this, feedUri, entry, this.ProgressReportDelegate, userData);
WorkerSendEventHandler workerDelegate = new WorkerSendEventHandler(AsyncInsertWorker);
this.AsyncStarter(data, workerDelegate, userData);
}
/// <summary>
/// updates the entry asynchronous, you need to supply a valid and unique
/// token. Events will be send to the async delegates you setup on the service
/// object
/// </summary>
/// <param name="entry"></param>
/// <param name="userData">a unique identifier to associate this request with</param>
/// <returns></returns>
public void UpdateAsync(AtomEntry entry, Object userData)
{
AsyncSendData data = new AsyncSendData(this, entry, this.ProgressReportDelegate, userData);
WorkerSendEventHandler workerDelegate = new WorkerSendEventHandler(AsyncUpdateWorker);
this.AsyncStarter(data, workerDelegate, userData);
}
/// <summary>
/// worker method for the batch case
/// </summary>
/// <param name="data"></param>
/// <param name="asyncOp"></param>
/// <param name="completionMethodDelegate"></param>
/// <returns></returns>
private void AsyncBatchWorker(AsyncSendData data,
AsyncOperation asyncOp,
SendOrPostCallback completionMethodDelegate)
{
try
{
data.Feed = this.Batch(data.Feed, data.UriToUse, data);
}
catch (Exception e)
{
data.Exception = e;
}
completionMethodDelegate(data);
}
/// <summary>
/// worker method for the Insert case
/// </summary>
/// <param name="data"></param>
/// <param name="asyncOp"></param>
/// <param name="completionMethodDelegate"></param>
/// <returns></returns>
private void AsyncInsertWorker(AsyncSendData data,
AsyncOperation asyncOp,
SendOrPostCallback completionMethodDelegate)
{
try
{
data.Entry = this.Insert(data.UriToUse, data.Entry, data);
}
catch (Exception e)
{
data.Exception = e;
}
completionMethodDelegate(data);
}
/// <summary>
/// this is a helper function for to send binary data asyncronous to a resource
/// </summary>
/// <param name="targetUri"></param>
/// <param name="inputStream"></param>
/// <param name="type"></param>
/// <param name="contentType">the contenttype to use in the request, if NULL is passed, factory default is used</param>
/// <param name="slugHeader">the slugHeader to use in the request, if NULL is passed, factory default is used</param>
/// <param name="userData">a unique identifier to associate this request with</param>
/// <param name="parseFeed">indicates if the async operation should try to parse the server returned stream, or just return the stream</param>
/// <returns></returns>
private void StreamSendAsync(Uri targetUri,
Stream inputStream,
GDataRequestType type,
string contentType,
string slugHeader,
object userData,
bool parseFeed)
{
AsyncSendData data = new AsyncSendData(this, targetUri, inputStream, type, contentType, slugHeader,
this.ProgressReportDelegate, userData, parseFeed);
WorkerSendEventHandler workerDelegate = new WorkerSendEventHandler(AsyncStreamSendWorker);
this.AsyncStarter(data, workerDelegate, userData);
}
/// <summary>
/// starts the async job
/// </summary>
/// <param name="data"></param>
/// <param name="userData"></param>
/// <param name="workerDelegate"></param>
/// <returns></returns>
private void AsyncStarter(AsyncSendData data, WorkerSendEventHandler workerDelegate, Object userData)
{
AsyncOperation asyncOp = AsyncOperationManager.CreateOperation(userData);
data.Operation = asyncOp;
AddUserDataToDictionary(userData, asyncOp);
// Start the asynchronous operation.
workerDelegate.BeginInvoke(
data,
asyncOp,
this.CompletionMethodDelegate,
null,
null);
}
/// <summary>
/// worker method for the direct stream send
/// </summary>
/// <param name="data"></param>
/// <param name="asyncOp"></param>
/// <param name="completionMethodDelegate"></param>
/// <returns></returns>
private void AsyncStreamSendWorker(AsyncSendData data, AsyncOperation asyncOp, SendOrPostCallback completionMethodDelegate)
{
try
{
using (var responseStream = StreamSend(data.UriToUse, data.DataStream, data.Type, data.ContentType, data.SlugHeader, null, data))
{
HandleResponseStream(data, responseStream, -1);
}
}
catch (Exception e)
{
data.Exception = e;
}
completionMethodDelegate(data);
}
/// <summary>WebResponse Update(Uri updateUri, Stream entryStream, ICredentials credentials)</summary>
/// <param name="entry">the old entry to update</param>
/// <param name="data">the async data block used</param>
/// <returns> the new Entry, as returned from the server</returns>
private AtomEntry Update(AtomEntry entry, AsyncSendData data)
{
Tracing.Assert(entry != null, "entry should not be null");
if (entry == null)
{
throw new ArgumentNullException("entry");
}
if (entry.ReadOnly)
{
throw new GDataRequestException("Can not update a read-only entry");
}
Uri target = new Uri(entry.EditUri.ToString());
Stream returnStream = EntrySend(target, entry, GDataRequestType.Update, data);
return(CreateAndParseEntry(returnStream, target));
}
/// <summary>public WebResponse Insert(Uri insertUri, Stream entryStream, ICredentials credentials)</summary>
/// <param name="feedUri">the uri for the feed this entry should be inserted into</param>
/// <param name="newEntry">the entry to be inserted</param>
/// <param name="data">the data used for an async request</param>
/// <returns> the inserted entry</returns>
private AtomEntry Insert(Uri feedUri, AtomEntry newEntry, AsyncSendData data)
{
Tracing.Assert(feedUri != null, "feedUri should not be null");
if (feedUri == null)
{
throw new ArgumentNullException("feedUri");
}
Tracing.Assert(newEntry != null, "newEntry should not be null");
if (newEntry == null)
{
throw new ArgumentNullException("newEntry");
}
this.versionInfo.ImprintVersion(newEntry);
Stream returnStream = EntrySend(feedUri, newEntry, GDataRequestType.Insert, data);
return(CreateAndParseEntry(returnStream, feedUri));
}
/// <summary>
/// this is a helper function for to send binary data to a resource
/// it is not worth running the other insert/saves through here, as this would involve
/// double buffering/copying of the bytes
/// </summary>
/// <param name="targetUri"></param>
/// <param name="inputStream"></param>
/// <param name="type"></param>
/// <param name="contentType">the contenttype to use in the request, if NULL is passed, factory default is used</param>
/// <param name="slugHeader">the slugHeader to use in the request, if NULL is passed, factory default is used</param>
/// <param name="etag">The http etag to pass into the request</param>
/// <param name="data">The async data needed for notifications</param>
/// <returns>Stream from the server response. You should close this stream explicitly.</returns>
private Stream StreamSend(Uri targetUri,
Stream inputStream,
GDataRequestType type,
string contentType,
string slugHeader,
string etag,
AsyncSendData data)
{
Tracing.Assert(targetUri != null, "targetUri should not be null");
if (targetUri == null)
{
throw new ArgumentNullException("targetUri");
}
if (inputStream == null)
{
Tracing.Assert(inputStream != null, "payload should not be null");
throw new ArgumentNullException("inputStream");
}
if (type != GDataRequestType.Insert && type != GDataRequestType.Update)
{
Tracing.Assert(type != GDataRequestType.Insert && type != GDataRequestType.Update, "type needs to be insert or update");
throw new ArgumentNullException("type");
}
IGDataRequest request = this.RequestFactory.CreateRequest(type, targetUri);
request.Credentials = this.Credentials;
if (data != null)
{
GDataGAuthRequest gr = request as GDataGAuthRequest;
if (gr != null)
{
gr.AsyncData = data;
}
}
// set the contenttype of the request
if (contentType != null)
{
GDataRequest r = request as GDataRequest;
if (r != null)
{
r.ContentType = contentType;
}
}
if (slugHeader != null)
{
GDataRequest r = request as GDataRequest;
if (r != null)
{
r.Slug = slugHeader;
}
}
if (etag != null)
{
ISupportsEtag ise = request as ISupportsEtag;
if (ise != null)
{
ise.Etag = etag;
}
}
Stream outputStream = request.GetRequestStream();
WriteInputStreamToRequest(inputStream, outputStream);
request.Execute();
outputStream.Close();
return(new GDataReturnStream(request));
}
/// <summary>Inserts an AtomBase entry against a Uri</summary>
/// <param name="feedUri">the uri for the feed this object should be posted against</param>
/// <param name="baseEntry">the entry to be inserted</param>
/// <param name="type">the type of request to create</param>
/// <param name="data">the async data payload</param>
/// <returns> the response as a stream</returns>
internal virtual Stream EntrySend(Uri feedUri, AtomBase baseEntry, GDataRequestType type, AsyncSendData data)
{
Tracing.Assert(feedUri != null, "feedUri should not be null");
if (feedUri == null)
{
throw new ArgumentNullException("feedUri");
}
Tracing.Assert(baseEntry != null, "baseEntry should not be null");
if (baseEntry == null)
{
throw new ArgumentNullException("baseEntry");
}
this.versionInfo.ImprintVersion(baseEntry);
IGDataRequest request = this.RequestFactory.CreateRequest(type, feedUri);
request.Credentials = this.Credentials;
ISupportsEtag eTarget = request as ISupportsEtag;
ISupportsEtag eSource = baseEntry as ISupportsEtag;
if (eTarget != null && eSource != null)
{
eTarget.Etag = eSource.Etag;
}
request.ContentStore = baseEntry;
request.IsBatch = type == GDataRequestType.Batch;
if (data != null)
{
GDataGAuthRequest gr = request as GDataGAuthRequest;
if (gr != null)
{
gr.AsyncData = data;
}
}
Stream outputStream = request.GetRequestStream();
baseEntry.SaveToXml(outputStream);
request.Execute();
outputStream.Close();
return(request.GetResponseStream());
}