2012-03-05 20:53:14 -08:00
|
|
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
2012-05-24 13:17:46 -07:00
|
|
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
|
|
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
2011-12-21 08:44:08 -08:00
|
|
|
|
|
|
|
package org.mozilla.gecko.sync.net;
|
|
|
|
|
|
|
|
public interface SyncStorageRequestDelegate {
|
|
|
|
String credentials();
|
|
|
|
String ifUnmodifiedSince();
|
2012-02-03 13:09:29 -08:00
|
|
|
|
|
|
|
// TODO: at this point we can access X-Weave-Timestamp, compare
|
|
|
|
// that to our local timestamp, and compute an estimate of clock
|
|
|
|
// skew. Bug 721887.
|
2012-03-12 19:17:56 -07:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Override this to handle a successful SyncStorageRequest.
|
|
|
|
*
|
|
|
|
* SyncStorageResourceDelegate implementers <b>must</b> ensure that the HTTP
|
|
|
|
* responses underlying SyncStorageResponses are fully consumed to ensure that
|
|
|
|
* connections are returned to the pool, for example by calling
|
|
|
|
* <code>BaseResource.consumeEntity(response)</code>.
|
|
|
|
*/
|
2011-12-21 08:44:08 -08:00
|
|
|
void handleRequestSuccess(SyncStorageResponse response);
|
2012-03-12 19:17:56 -07:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Override this to handle a failed SyncStorageRequest.
|
|
|
|
*
|
|
|
|
*
|
|
|
|
* SyncStorageResourceDelegate implementers <b>must</b> ensure that the HTTP
|
|
|
|
* responses underlying SyncStorageResponses are fully consumed to ensure that
|
|
|
|
* connections are returned to the pool, for example by calling
|
|
|
|
* <code>BaseResource.consumeEntity(response)</code>.
|
|
|
|
*/
|
2011-12-21 08:44:08 -08:00
|
|
|
void handleRequestFailure(SyncStorageResponse response);
|
2012-03-12 19:17:56 -07:00
|
|
|
|
2011-12-21 08:44:08 -08:00
|
|
|
void handleRequestError(Exception ex);
|
|
|
|
}
|