158 lines
5.3 KiB
Java
158 lines
5.3 KiB
Java
/*
|
|
* Copyright (C) 2008-2009 Marc Blank
|
|
* Licensed to The Android Open Source Project.
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
package com.android.exchange.adapter;
|
|
|
|
import com.android.emailcommon.AccountManagerTypes;
|
|
import com.android.emailcommon.provider.EmailContent.Account;
|
|
import com.android.emailcommon.provider.EmailContent.Mailbox;
|
|
import com.android.exchange.Eas;
|
|
import com.android.exchange.EasSyncService;
|
|
|
|
import android.content.ContentResolver;
|
|
import android.content.Context;
|
|
|
|
import java.io.IOException;
|
|
import java.io.InputStream;
|
|
|
|
/**
|
|
* Parent class of all sync adapters (EasMailbox, EasCalendar, and EasContacts)
|
|
*
|
|
*/
|
|
public abstract class AbstractSyncAdapter {
|
|
|
|
public static final int SECONDS = 1000;
|
|
public static final int MINUTES = SECONDS*60;
|
|
public static final int HOURS = MINUTES*60;
|
|
public static final int DAYS = HOURS*24;
|
|
public static final int WEEKS = DAYS*7;
|
|
|
|
protected static final String PIM_WINDOW_SIZE = "4";
|
|
|
|
public Mailbox mMailbox;
|
|
public EasSyncService mService;
|
|
public Context mContext;
|
|
public Account mAccount;
|
|
public final ContentResolver mContentResolver;
|
|
public final android.accounts.Account mAccountManagerAccount;
|
|
|
|
// Create the data for local changes that need to be sent up to the server
|
|
public abstract boolean sendLocalChanges(Serializer s)
|
|
throws IOException;
|
|
// Parse incoming data from the EAS server, creating, modifying, and deleting objects as
|
|
// required through the EmailProvider
|
|
public abstract boolean parse(InputStream is)
|
|
throws IOException;
|
|
// The name used to specify the collection type of the target (Email, Calendar, or Contacts)
|
|
public abstract String getCollectionName();
|
|
public abstract void cleanup();
|
|
public abstract boolean isSyncable();
|
|
// Add sync options (filter, body type - html vs plain, and truncation)
|
|
public abstract void sendSyncOptions(Double protocolVersion, Serializer s)
|
|
throws IOException;
|
|
/**
|
|
* Delete all records of this class in this account
|
|
*/
|
|
public abstract void wipe();
|
|
|
|
public boolean isLooping() {
|
|
return false;
|
|
}
|
|
|
|
public AbstractSyncAdapter(EasSyncService service) {
|
|
mService = service;
|
|
mMailbox = service.mMailbox;
|
|
mContext = service.mContext;
|
|
mAccount = service.mAccount;
|
|
mAccountManagerAccount = new android.accounts.Account(mAccount.mEmailAddress,
|
|
AccountManagerTypes.TYPE_EXCHANGE);
|
|
mContentResolver = mContext.getContentResolver();
|
|
}
|
|
|
|
public void userLog(String ...strings) {
|
|
mService.userLog(strings);
|
|
}
|
|
|
|
public void incrementChangeCount() {
|
|
mService.mChangeCount++;
|
|
}
|
|
|
|
/**
|
|
* Set sync options common to PIM's (contacts and calendar)
|
|
* @param protocolVersion the protocol version under which we're syncing
|
|
* @param the filter to use (or null)
|
|
* @param s the Serializer
|
|
* @throws IOException
|
|
*/
|
|
protected void setPimSyncOptions(Double protocolVersion, String filter, Serializer s)
|
|
throws IOException {
|
|
s.tag(Tags.SYNC_DELETES_AS_MOVES);
|
|
s.tag(Tags.SYNC_GET_CHANGES);
|
|
s.data(Tags.SYNC_WINDOW_SIZE, PIM_WINDOW_SIZE);
|
|
s.start(Tags.SYNC_OPTIONS);
|
|
// Set the filter (lookback), if provided
|
|
if (filter != null) {
|
|
s.data(Tags.SYNC_FILTER_TYPE, filter);
|
|
}
|
|
// Set the truncation amount and body type
|
|
if (protocolVersion >= Eas.SUPPORTED_PROTOCOL_EX2007_DOUBLE) {
|
|
s.start(Tags.BASE_BODY_PREFERENCE);
|
|
// Plain text
|
|
s.data(Tags.BASE_TYPE, Eas.BODY_PREFERENCE_TEXT);
|
|
s.data(Tags.BASE_TRUNCATION_SIZE, Eas.EAS12_TRUNCATION_SIZE);
|
|
s.end();
|
|
} else {
|
|
s.data(Tags.SYNC_TRUNCATION, Eas.EAS2_5_TRUNCATION_SIZE);
|
|
}
|
|
s.end();
|
|
}
|
|
|
|
/**
|
|
* Returns the current SyncKey; override if the SyncKey is stored elsewhere (as for Contacts)
|
|
* @return the current SyncKey for the Mailbox
|
|
* @throws IOException
|
|
*/
|
|
public String getSyncKey() throws IOException {
|
|
if (mMailbox.mSyncKey == null) {
|
|
userLog("Reset SyncKey to 0");
|
|
mMailbox.mSyncKey = "0";
|
|
}
|
|
return mMailbox.mSyncKey;
|
|
}
|
|
|
|
public void setSyncKey(String syncKey, boolean inCommands) throws IOException {
|
|
mMailbox.mSyncKey = syncKey;
|
|
}
|
|
|
|
/**
|
|
* Sync failures can use SyncStatusException, which includes the actual error status and
|
|
* server id
|
|
*/
|
|
static class SyncStatusException extends IOException {
|
|
private static final long serialVersionUID = 1L;
|
|
|
|
public final int mStatus;
|
|
public final String mServerId;
|
|
|
|
protected SyncStatusException(String serverId, int status) {
|
|
mServerId = serverId;
|
|
mStatus = status;
|
|
}
|
|
}
|
|
}
|
|
|