setup_env.bat included and improved setup text a bit

[pub/Android/ownCloud.git] / src / com / owncloud / android / syncadapter / FileSyncAdapter.java

diff --git a/src/com/owncloud/android/syncadapter/FileSyncAdapter.java b/src/com/owncloud/android/syncadapter/FileSyncAdapter.java
index 1e83375..6da3e81 100644 (file)
--- a/src/com/owncloud/android/syncadapter/FileSyncAdapter.java
+++ b/src/com/owncloud/android/syncadapter/FileSyncAdapter.java
@@ -1,9 +1,10 @@
 /* ownCloud Android client application\r
  *   Copyright (C) 2011  Bartek Przybylski\r
 /* ownCloud Android client application\r
  *   Copyright (C) 2011  Bartek Przybylski\r

+ *   Copyright (C) 2012-2013 ownCloud Inc.\r

  *\r
  *   This program is free software: you can redistribute it and/or modify\r
  *   it under the terms of the GNU General Public License as published by\r
  *\r
  *   This program is free software: you can redistribute it and/or modify\r
  *   it under the terms of the GNU General Public License as published by\r

- *   the Free Software Foundation, either version 3 of the License, or\r
+ *   the Free Software Foundation, either version 2 of the License, or\r

  *   (at your option) any later version.\r
  *\r
  *   This program is distributed in the hope that it will be useful,\r
  *   (at your option) any later version.\r
  *\r
  *   This program is distributed in the hope that it will be useful,\r


@@ -19,23 +20,23 @@
 package com.owncloud.android.syncadapter;\r
 \r
 import java.io.IOException;\r
 package com.owncloud.android.syncadapter;\r
 \r
 import java.io.IOException;\r

+import java.net.UnknownHostException;\r
+import java.util.ArrayList;\r
+import java.util.HashMap;\r

 import java.util.List;\r
 import java.util.List;\r

-import java.util.Vector;\r
+import java.util.Map;\r

 \r
 \r

-import org.apache.http.HttpStatus;\r

 import org.apache.jackrabbit.webdav.DavException;\r
 import org.apache.jackrabbit.webdav.DavException;\r

-import org.apache.jackrabbit.webdav.MultiStatus;\r
-import org.apache.jackrabbit.webdav.client.methods.PropFindMethod;\r
-import org.json.JSONObject;\r

 \r
 \r

-import com.owncloud.android.AccountUtils;\r

 import com.owncloud.android.R;\r
 import com.owncloud.android.R;\r

-import com.owncloud.android.authenticator.AccountAuthenticator;\r
+import com.owncloud.android.datamodel.DataStorageManager;\r

 import com.owncloud.android.datamodel.FileDataStorageManager;\r
 import com.owncloud.android.datamodel.OCFile;\r
 import com.owncloud.android.datamodel.FileDataStorageManager;\r
 import com.owncloud.android.datamodel.OCFile;\r

-import com.owncloud.android.files.services.FileDownloader;\r
-import com.owncloud.android.utils.OwnCloudVersion;\r
-\r
+import com.owncloud.android.operations.RemoteOperationResult;\r
+import com.owncloud.android.operations.SynchronizeFolderOperation;\r
+import com.owncloud.android.operations.UpdateOCVersionOperation;\r
+import com.owncloud.android.operations.RemoteOperationResult.ResultCode;\r
+import com.owncloud.android.ui.activity.ErrorsWhileCopyingHandlerActivity;\r

 import android.accounts.Account;\r
 import android.app.Notification;\r
 import android.app.NotificationManager;\r
 import android.accounts.Account;\r
 import android.app.Notification;\r
 import android.app.NotificationManager;\r


@@ -47,8 +48,6 @@ import android.content.Intent;
 import android.content.SyncResult;\r
 import android.os.Bundle;\r
 import android.util.Log;\r
 import android.content.SyncResult;\r
 import android.os.Bundle;\r
 import android.util.Log;\r

-import eu.alefzero.webdav.WebdavEntry;\r
-import eu.alefzero.webdav.WebdavUtils;\r

 \r
 /**\r
  * SyncAdapter implementation for syncing sample SyncAdapter contacts to the\r
 \r
 /**\r
  * SyncAdapter implementation for syncing sample SyncAdapter contacts to the\r


@@ -58,25 +57,31 @@ import eu.alefzero.webdav.WebdavUtils;
  */\r
 public class FileSyncAdapter extends AbstractOwnCloudSyncAdapter {\r
 \r
  */\r
 public class FileSyncAdapter extends AbstractOwnCloudSyncAdapter {\r
 \r

-    private final static String TAG = "FileSyncAdapter"; \r
-    \r
-    /*  Commented code for ugly performance tests\r
-    private final static int MAX_DELAYS = 100;\r
-    private static long[] mResponseDelays = new long[MAX_DELAYS]; \r
-    private static long[] mSaveDelays = new long[MAX_DELAYS];\r
-    private int mDelaysIndex = 0;\r
-    private int mDelaysCount = 0;\r
-    */\r
+    private final static String TAG = "FileSyncAdapter";\r
+\r
+    /** \r
+     * Maximum number of failed folder synchronizations that are supported before finishing the synchronization operation\r
+     */\r
+    private static final int MAX_FAILED_RESULTS = 3; \r

     \r
     private long mCurrentSyncTime;\r
     private boolean mCancellation;\r
     private boolean mIsManualSync;\r
     \r
     private long mCurrentSyncTime;\r
     private boolean mCancellation;\r
     private boolean mIsManualSync;\r

-    private boolean mRightSync;\r
+    private int mFailedResultsCounter;    \r
+    private RemoteOperationResult mLastFailedResult;\r
+    private SyncResult mSyncResult;\r
+    private int mConflictsFound;\r
+    private int mFailsInFavouritesFound;\r
+    private Map<String, String> mForgottenLocalFiles;\r
+\r

     \r
     public FileSyncAdapter(Context context, boolean autoInitialize) {\r
         super(context, autoInitialize);\r
     }\r
 \r
     \r
     public FileSyncAdapter(Context context, boolean autoInitialize) {\r
         super(context, autoInitialize);\r
     }\r
 \r

+    /**\r
+     * {@inheritDoc}\r
+     */\r

     @Override\r
     public synchronized void onPerformSync(Account account, Bundle extras,\r
             String authority, ContentProviderClient provider,\r
     @Override\r
     public synchronized void onPerformSync(Account account, Bundle extras,\r
             String authority, ContentProviderClient provider,\r


@@ -84,296 +89,282 @@ public class FileSyncAdapter extends AbstractOwnCloudSyncAdapter {
 \r
         mCancellation = false;\r
         mIsManualSync = extras.getBoolean(ContentResolver.SYNC_EXTRAS_MANUAL, false);\r
 \r
         mCancellation = false;\r
         mIsManualSync = extras.getBoolean(ContentResolver.SYNC_EXTRAS_MANUAL, false);\r

-        mRightSync = true;\r
-        \r
+        mFailedResultsCounter = 0;\r
+        mLastFailedResult = null;\r
+        mConflictsFound = 0;\r
+        mFailsInFavouritesFound = 0;\r
+        mForgottenLocalFiles = new HashMap<String, String>();\r
+        mSyncResult = syncResult;\r
+        mSyncResult.fullSyncRequested = false;\r
+        mSyncResult.delayUntil = 60*60*24; // sync after 24h\r
+\r

         this.setAccount(account);\r
         this.setContentProvider(provider);\r
         this.setStorageManager(new FileDataStorageManager(account, getContentProvider()));\r
         this.setAccount(account);\r
         this.setContentProvider(provider);\r
         this.setStorageManager(new FileDataStorageManager(account, getContentProvider()));\r

+        try {\r
+            this.initClientForCurrentAccount();\r
+        } catch (UnknownHostException e) {\r
+            /// the account is unknown for the Synchronization Manager, or unreachable for this context; don't try this again\r
+            mSyncResult.tooManyRetries = true;\r
+            notifyFailedSynchronization();\r
+            return;\r
+        }\r

         \r
         \r

-        /*  Commented code for ugly performance tests\r
-        mDelaysIndex = 0;\r
-        mDelaysCount = 0;\r
-        */\r
-\r
-        Log.d(TAG, "syncing owncloud account " + account.name);\r
-\r
-        sendStickyBroadcast(true, null);  // message to signal the start to the UI\r
+        Log.d(TAG, "Synchronization of ownCloud account " + account.name + " starting");\r
+        sendStickyBroadcast(true, null, null);  // message to signal the start of the synchronization to the UI\r

         \r
         \r

-        updateOCVersion();\r
-\r
-        String uri = getUri().toString();\r
-        PropFindMethod query = null;\r

         try {\r
         try {\r

+            updateOCVersion();\r

             mCurrentSyncTime = System.currentTimeMillis();\r
             mCurrentSyncTime = System.currentTimeMillis();\r

-            query = new PropFindMethod(uri + "/");\r
-            int status = getClient().executeMethod(query);\r
-            if (status != HttpStatus.SC_UNAUTHORIZED) {\r
-                MultiStatus resp = query.getResponseBodyAsMultiStatus();\r
-\r
-                if (resp.getResponses().length > 0) {\r
-                    WebdavEntry we = new WebdavEntry(resp.getResponses()[0], getUri().getPath());\r
-                    OCFile file = fillOCFile(we);\r
-                    file.setParentId(0);\r
-                    getStorageManager().saveFile(file);\r
-                    if (!mCancellation) {\r
-                        fetchData(uri, syncResult, file.getFileId());\r
-                    }\r
-                }\r
-\r
+            if (!mCancellation) {\r
+                fetchData(OCFile.PATH_SEPARATOR, DataStorageManager.ROOT_PARENT_ID);\r
+                \r

             } else {\r
             } else {\r

-                syncResult.stats.numAuthExceptions++;\r
+                Log.d(TAG, "Leaving synchronization before any remote request due to cancellation was requested");\r

             }\r
             }\r

-        } catch (IOException e) {\r
-            syncResult.stats.numIoExceptions++;\r
-            logException(e, uri + "/");\r

             \r
             \r

-        } catch (DavException e) {\r
-            syncResult.stats.numParseExceptions++;\r
-            logException(e, uri + "/");\r
-            \r
-        } catch (Exception e) {\r
-            // TODO something smart with syncresult\r
-            logException(e, uri + "/");\r
-            mRightSync = false;\r

             \r
         } finally {\r
             \r
         } finally {\r

-            if (query != null)\r
-                query.releaseConnection();  // let the connection available for other methods\r
-            mRightSync &= (syncResult.stats.numIoExceptions == 0 && syncResult.stats.numAuthExceptions == 0 && syncResult.stats.numParseExceptions == 0);\r
-            if (!mRightSync && mIsManualSync) {\r
+            // it's important making this although very unexpected errors occur; that's the reason for the finally\r
+            \r
+            if (mFailedResultsCounter > 0 && mIsManualSync) {\r

                 /// don't let the system synchronization manager retries MANUAL synchronizations\r
                 //      (be careful: "MANUAL" currently includes the synchronization requested when a new account is created and when the user changes the current account)\r
                 /// don't let the system synchronization manager retries MANUAL synchronizations\r
                 //      (be careful: "MANUAL" currently includes the synchronization requested when a new account is created and when the user changes the current account)\r

-                syncResult.tooManyRetries = true;\r
+                mSyncResult.tooManyRetries = true;\r

                 \r
                 /// notify the user about the failure of MANUAL synchronization\r
                 \r
                 /// notify the user about the failure of MANUAL synchronization\r

-                Notification notification = new Notification(R.drawable.icon, getContext().getString(R.string.sync_fail_ticker), System.currentTimeMillis());\r
-                notification.flags |= Notification.FLAG_AUTO_CANCEL;\r
-                // TODO put something smart in the contentIntent below\r
-                notification.contentIntent = PendingIntent.getActivity(getContext().getApplicationContext(), 0, new Intent(), PendingIntent.FLAG_UPDATE_CURRENT);\r
-                notification.setLatestEventInfo(getContext().getApplicationContext(), \r
-                                                getContext().getString(R.string.sync_fail_ticker), \r
-                                                String.format(getContext().getString(R.string.sync_fail_content), account.name), \r
-                                                notification.contentIntent);\r
-                ((NotificationManager) getContext().getSystemService(Context.NOTIFICATION_SERVICE)).notify(R.string.sync_fail_ticker, notification);\r
+                notifyFailedSynchronization();\r
+                \r

             }\r
             }\r

-            sendStickyBroadcast(false, null);        // message to signal the end to the UI\r
-        }\r
-        \r
-        /*  Commented code for ugly performance tests\r
-        long sum = 0, mean = 0, max = 0, min = Long.MAX_VALUE;\r
-        for (int i=0; i<MAX_DELAYS && i<mDelaysCount; i++) {\r
-            sum += mResponseDelays[i];\r
-            max = Math.max(max, mResponseDelays[i]);\r
-            min = Math.min(min, mResponseDelays[i]);\r
+            if (mConflictsFound > 0 || mFailsInFavouritesFound > 0) {\r
+                notifyFailsInFavourites();\r
+            }\r
+            if (mForgottenLocalFiles.size() > 0) {\r
+                notifyForgottenLocalFiles();\r
+                \r
+            }\r
+            sendStickyBroadcast(false, null, mLastFailedResult);        // message to signal the end to the UI\r

         }\r
         }\r

-        mean = sum / mDelaysCount;\r
-        Log.e(TAG, "SYNC STATS - response: mean time = " + mean + " ; max time = " + max + " ; min time = " + min);\r

         \r
         \r

-        sum = 0; max = 0; min = Long.MAX_VALUE;\r
-        for (int i=0; i<MAX_DELAYS && i<mDelaysCount; i++) {\r
-            sum += mSaveDelays[i];\r
-            max = Math.max(max, mSaveDelays[i]);\r
-            min = Math.min(min, mSaveDelays[i]);\r
+    }\r
+\r
+    \r
+    /**\r
+     * Called by system SyncManager when a synchronization is required to be cancelled.\r
+     * \r
+     * Sets the mCancellation flag to 'true'. THe synchronization will be stopped when before a new folder is fetched. Data of the last folder\r
+     * fetched will be still saved in the database. See onPerformSync implementation.\r
+     */\r
+    @Override\r
+    public void onSyncCanceled() {\r
+        Log.d(TAG, "Synchronization of " + getAccount().name + " has been requested to cancel");\r
+        mCancellation = true;\r
+        super.onSyncCanceled();\r
+    }\r
+    \r
+    \r
+    /**\r
+     * Updates the locally stored version value of the ownCloud server\r
+     */\r
+    private void updateOCVersion() {\r
+        UpdateOCVersionOperation update = new UpdateOCVersionOperation(getAccount(), getContext());\r
+        RemoteOperationResult result = update.execute(getClient());\r
+        if (!result.isSuccess()) {\r
+            mLastFailedResult = result; \r

         }\r
         }\r

-        mean = sum / mDelaysCount;\r
-        Log.e(TAG, "SYNC STATS - save:     mean time = " + mean + " ; max time = " + max + " ; min time = " + min);\r
-        Log.e(TAG, "SYNC STATS - folders measured: " + mDelaysCount);\r
-        */\r
-        \r

     }\r
 \r
     }\r
 \r

-    private void fetchData(String uri, SyncResult syncResult, long parentId) {\r
-        PropFindMethod query = null;\r
-        try {\r
-            Log.d(TAG, "fetching " + uri);\r
+    \r
+    \r
+    /**\r
+     * Synchronize the properties of files and folders contained in a remote folder given by remotePath.\r
+     * \r
+     * @param remotePath        Remote path to the folder to synchronize.\r
+     * @param parentId          Database Id of the folder to synchronize.\r
+     */\r
+    private void fetchData(String remotePath, long parentId) {\r
+        \r
+        if (mFailedResultsCounter > MAX_FAILED_RESULTS || isFinisher(mLastFailedResult))\r
+            return;\r
+        \r
+        // perform folder synchronization\r
+        SynchronizeFolderOperation synchFolderOp = new SynchronizeFolderOperation(  remotePath, \r
+                                                                                    mCurrentSyncTime, \r
+                                                                                    parentId, \r
+                                                                                    getStorageManager(), \r
+                                                                                    getAccount(), \r
+                                                                                    getContext()\r
+                                                                                  );\r
+        RemoteOperationResult result = synchFolderOp.execute(getClient());\r
+        \r
+        \r
+        // synchronized folder -> notice to UI - ALWAYS, although !result.isSuccess\r
+        sendStickyBroadcast(true, remotePath, null);\r
+        \r
+        if (result.isSuccess() || result.getCode() == ResultCode.SYNC_CONFLICT) {\r

             \r
             \r

-            // remote request \r
-            query = new PropFindMethod(uri);\r
-            /*  Commented code for ugly performance tests\r
-            long responseDelay = System.currentTimeMillis();\r
-            */\r
-            int status = getClient().executeMethod(query);\r
-            /*  Commented code for ugly performance tests\r
-            responseDelay = System.currentTimeMillis() - responseDelay;\r
-            Log.e(TAG, "syncing: RESPONSE TIME for " + uri + " contents, " + responseDelay + "ms");\r
-            */\r
-            if (status != HttpStatus.SC_UNAUTHORIZED) {\r
-                MultiStatus resp = query.getResponseBodyAsMultiStatus();\r
+            if (result.getCode() == ResultCode.SYNC_CONFLICT) {\r
+                mConflictsFound += synchFolderOp.getConflictsFound();\r
+                mFailsInFavouritesFound += synchFolderOp.getFailsInFavouritesFound();\r
+            }\r
+            if (synchFolderOp.getForgottenLocalFiles().size() > 0) {\r
+                mForgottenLocalFiles.putAll(synchFolderOp.getForgottenLocalFiles());\r
+            }\r
+            // synchronize children folders \r
+            List<OCFile> children = synchFolderOp.getChildren();\r
+            fetchChildren(children);    // beware of the 'hidden' recursion here!\r

             \r
             \r

-                // insertion or update of files\r
-                List<OCFile> updatedFiles = new Vector<OCFile>(resp.getResponses().length - 1);\r
-                for (int i = 1; i < resp.getResponses().length; ++i) {\r
-                    WebdavEntry we = new WebdavEntry(resp.getResponses()[i], getUri().getPath());\r
-                    OCFile file = fillOCFile(we);\r
-                    file.setParentId(parentId);\r
-                    if (getStorageManager().getFileByPath(file.getRemotePath()) != null &&\r
-                            getStorageManager().getFileByPath(file.getRemotePath()).keepInSync() &&\r
-                            file.getModificationTimestamp() > getStorageManager().getFileByPath(file.getRemotePath())\r
-                                                                         .getModificationTimestamp()) {\r
-                        Intent intent = new Intent(this.getContext(), FileDownloader.class);\r
-                        intent.putExtra(FileDownloader.EXTRA_ACCOUNT, getAccount());\r
-                        intent.putExtra(FileDownloader.EXTRA_FILE, file);\r
-                        /*intent.putExtra(FileDownloader.EXTRA_FILE_PATH, file.getRemotePath());\r
-                        intent.putExtra(FileDownloader.EXTRA_REMOTE_PATH, file.getRemotePath());\r
-                        intent.putExtra(FileDownloader.EXTRA_FILE_SIZE, file.getFileLength());*/\r
-                        file.setKeepInSync(true);\r
-                        getContext().startService(intent);\r
-                    }\r
-                    if (getStorageManager().getFileByPath(file.getRemotePath()) != null)\r
-                        file.setKeepInSync(getStorageManager().getFileByPath(file.getRemotePath()).keepInSync());\r
+        } else {\r
+            if (result.getCode() == RemoteOperationResult.ResultCode.UNAUTHORIZED) {\r
+                mSyncResult.stats.numAuthExceptions++;\r

                 \r
                 \r

-                    // Log.v(TAG, "adding file: " + file);\r
-                    updatedFiles.add(file);\r
-                    if (parentId == 0)\r
-                        parentId = file.getFileId();\r
-                }\r
-                /*  Commented code for ugly performance tests\r
-                long saveDelay = System.currentTimeMillis();\r
-                 */            \r
-                getStorageManager().saveFiles(updatedFiles);    // all "at once" ; trying to get a best performance in database update\r
-                /*  Commented code for ugly performance tests\r
-                saveDelay = System.currentTimeMillis() - saveDelay;\r
-                Log.e(TAG, "syncing: SAVE TIME for " + uri + " contents, " + mSaveDelays[mDelaysIndex] + "ms");\r
-                 */\r
-            \r
-                // removal of obsolete files\r
-                Vector<OCFile> files = getStorageManager().getDirectoryContent(\r
-                        getStorageManager().getFileById(parentId));\r
-                OCFile file;\r
-                String currentSavePath = FileDownloader.getSavePath(getAccount().name);\r
-                for (int i=0; i < files.size(); ) {\r
-                    file = files.get(i);\r
-                    if (file.getLastSyncDate() != mCurrentSyncTime) {\r
-                        Log.v(TAG, "removing file: " + file);\r
-                        getStorageManager().removeFile(file, (file.isDown() && file.getStoragePath().startsWith(currentSavePath)));\r
-                        files.remove(i);\r
-                    } else {\r
-                        i++;\r
-                    }\r
-                }\r
-            \r
-                // recursive fetch\r
-                for (int i=0; i < files.size() && !mCancellation; i++) {\r
-                    OCFile newFile = files.get(i);\r
-                    if (newFile.getMimetype().equals("DIR")) {\r
-                        fetchData(getUri().toString() + WebdavUtils.encodePath(newFile.getRemotePath()), syncResult, newFile.getFileId());\r
-                    }\r
-                }\r
-                if (mCancellation) Log.d(TAG, "Leaving " + uri + " because cancelation request");\r
+            } else if (result.getException() instanceof DavException) {\r
+                mSyncResult.stats.numParseExceptions++;\r

                 \r
                 \r

-                /*  Commented code for ugly performance tests\r
-                mResponseDelays[mDelaysIndex] = responseDelay;\r
-                mSaveDelays[mDelaysIndex] = saveDelay;\r
-                mDelaysCount++;\r
-                mDelaysIndex++;\r
-                if (mDelaysIndex >= MAX_DELAYS)\r
-                    mDelaysIndex = 0;\r
-                 */\r
-\r
-            } else {\r
-                syncResult.stats.numAuthExceptions++;\r
+            } else if (result.getException() instanceof IOException) { \r
+                mSyncResult.stats.numIoExceptions++;\r

             }\r
             }\r

-        } catch (IOException e) {\r
-            syncResult.stats.numIoExceptions++;\r
-            logException(e, uri);\r
-            \r
-        } catch (DavException e) {\r
-            syncResult.stats.numParseExceptions++;\r
-            logException(e, uri);\r
+            mFailedResultsCounter++;\r
+            mLastFailedResult = result;\r
+        }\r

             \r
             \r

-        } catch (Exception e) {\r
-            // TODO something smart with syncresult\r
-            mRightSync = false;\r
-            logException(e, uri);\r
-\r
-        } finally {\r
-            if (query != null)\r
-                query.releaseConnection();  // let the connection available for other methods\r
+    }\r

 \r
 \r

-            // synchronized folder -> notice to UI\r
-            sendStickyBroadcast(true, getStorageManager().getFileById(parentId).getRemotePath());\r
+    /**\r
+     * Checks if a failed result should terminate the synchronization process immediately, according to\r
+     * OUR OWN POLICY\r
+     * \r
+     * @param   failedResult        Remote operation result to check.\r
+     * @return                      'True' if the result should immediately finish the synchronization\r
+     */\r
+    private boolean isFinisher(RemoteOperationResult failedResult) {\r
+        if  (failedResult != null) {\r
+            RemoteOperationResult.ResultCode code = failedResult.getCode();\r
+            return (code.equals(RemoteOperationResult.ResultCode.SSL_ERROR) ||\r
+                    code.equals(RemoteOperationResult.ResultCode.SSL_RECOVERABLE_PEER_UNVERIFIED) ||\r
+                    code.equals(RemoteOperationResult.ResultCode.BAD_OC_VERSION) ||\r
+                    code.equals(RemoteOperationResult.ResultCode.INSTANCE_NOT_CONFIGURED));\r

         }\r
         }\r

+        return false;\r

     }\r
 \r
     }\r
 \r

-    private OCFile fillOCFile(WebdavEntry we) {\r
-        OCFile file = new OCFile(we.decodedPath());\r
-        file.setCreationTimestamp(we.createTimestamp());\r
-        file.setFileLength(we.contentLength());\r
-        file.setMimetype(we.contentType());\r
-        file.setModificationTimestamp(we.modifiedTimesamp());\r
-        file.setLastSyncDate(mCurrentSyncTime);\r
-        return file;\r
+    /**\r
+     * Synchronize data of folders in the list of received files\r
+     * \r
+     * @param files         Files to recursively fetch \r
+     */\r
+    private void fetchChildren(List<OCFile> files) {\r
+        int i;\r
+        for (i=0; i < files.size() && !mCancellation; i++) {\r
+            OCFile newFile = files.get(i);\r
+            if (newFile.isDirectory()) {\r
+                fetchData(newFile.getRemotePath(), newFile.getFileId());\r
+            }\r
+        }\r
+        if (mCancellation && i <files.size()) Log.d(TAG, "Leaving synchronization before synchronizing " + files.get(i).getRemotePath() + " because cancelation request");\r

     }\r
     }\r

+\r

     \r
     \r

-    \r
-    private void sendStickyBroadcast(boolean inProgress, String dirRemotePath) {\r
+    /**\r
+     * Sends a message to any application component interested in the progress of the synchronization.\r
+     * \r
+     * @param inProgress        'True' when the synchronization progress is not finished.\r
+     * @param dirRemotePath     Remote path of a folder that was just synchronized (with or without success)\r
+     */\r
+    private void sendStickyBroadcast(boolean inProgress, String dirRemotePath, RemoteOperationResult result) {\r

         Intent i = new Intent(FileSyncService.SYNC_MESSAGE);\r
         i.putExtra(FileSyncService.IN_PROGRESS, inProgress);\r
         i.putExtra(FileSyncService.ACCOUNT_NAME, getAccount().name);\r
         if (dirRemotePath != null) {\r
             i.putExtra(FileSyncService.SYNC_FOLDER_REMOTE_PATH, dirRemotePath);\r
         }\r
         Intent i = new Intent(FileSyncService.SYNC_MESSAGE);\r
         i.putExtra(FileSyncService.IN_PROGRESS, inProgress);\r
         i.putExtra(FileSyncService.ACCOUNT_NAME, getAccount().name);\r
         if (dirRemotePath != null) {\r
             i.putExtra(FileSyncService.SYNC_FOLDER_REMOTE_PATH, dirRemotePath);\r
         }\r

+        if (result != null) {\r
+            i.putExtra(FileSyncService.SYNC_RESULT, result);\r
+        }\r

         getContext().sendStickyBroadcast(i);\r
     }\r
         getContext().sendStickyBroadcast(i);\r
     }\r

+\r
+    \r

     \r
     /**\r
     \r
     /**\r

-     * Called by system SyncManager when a synchronization is required to be cancelled.\r
-     * \r
-     * Sets the mCancellation flag to 'true'. THe synchronization will be stopped when before a new folder is fetched. Data of the last folder\r
-     * fetched will be still saved in the database. See onPerformSync implementation.\r
+     * Notifies the user about a failed synchronization through the status notification bar \r

      */\r
      */\r

-    @Override\r
-    public void onSyncCanceled() {\r
-        Log.d(TAG, "Synchronization of " + getAccount().name + " has been requested to cancel");\r
-        mCancellation = true;\r
-        super.onSyncCanceled();\r
+    private void notifyFailedSynchronization() {\r
+        Notification notification = new Notification(R.drawable.icon, getContext().getString(R.string.sync_fail_ticker), System.currentTimeMillis());\r
+        notification.flags |= Notification.FLAG_AUTO_CANCEL;\r
+        // TODO put something smart in the contentIntent below\r
+        notification.contentIntent = PendingIntent.getActivity(getContext().getApplicationContext(), (int)System.currentTimeMillis(), new Intent(), 0);\r
+        notification.setLatestEventInfo(getContext().getApplicationContext(), \r
+                                        getContext().getString(R.string.sync_fail_ticker), \r
+                                        String.format(getContext().getString(R.string.sync_fail_content), getAccount().name), \r
+                                        notification.contentIntent);\r
+        ((NotificationManager) getContext().getSystemService(Context.NOTIFICATION_SERVICE)).notify(R.string.sync_fail_ticker, notification);\r

     }\r
 \r
     }\r
 \r

-    \r
+\r

     /**\r
     /**\r

-     * Logs an exception triggered in a synchronization request. \r
+     * Notifies the user about conflicts and strange fails when trying to synchronize the contents of kept-in-sync files.\r

      * \r
      * \r

-     * @param e       Caught exception.\r
-     * @param uri     Uri to the remote directory that was fetched when the synchronization failed \r
+     * By now, we won't consider a failed synchronization.\r

      */\r
      */\r

-    private void logException(Exception e, String uri) {\r
-        if (e instanceof IOException) {\r
-            Log.e(TAG, "Unrecovered transport exception while synchronizing " + uri + " at " + getAccount().name, e);\r
-\r
-        } else if (e instanceof DavException) {\r
-            Log.e(TAG, "Unexpected WebDAV exception while synchronizing " + uri + " at " + getAccount().name, e);\r
-\r
+    private void notifyFailsInFavourites() {\r
+        if (mFailedResultsCounter > 0) {\r
+            Notification notification = new Notification(R.drawable.icon, getContext().getString(R.string.sync_fail_in_favourites_ticker), System.currentTimeMillis());\r
+            notification.flags |= Notification.FLAG_AUTO_CANCEL;\r
+            // TODO put something smart in the contentIntent below\r
+            notification.contentIntent = PendingIntent.getActivity(getContext().getApplicationContext(), (int)System.currentTimeMillis(), new Intent(), 0);\r
+            notification.setLatestEventInfo(getContext().getApplicationContext(), \r
+                                            getContext().getString(R.string.sync_fail_in_favourites_ticker), \r
+                                            String.format(getContext().getString(R.string.sync_fail_in_favourites_content), mFailedResultsCounter + mConflictsFound, mConflictsFound), \r
+                                            notification.contentIntent);\r
+            ((NotificationManager) getContext().getSystemService(Context.NOTIFICATION_SERVICE)).notify(R.string.sync_fail_in_favourites_ticker, notification);\r
+            \r

         } else {\r
         } else {\r

-            Log.e(TAG, "Unexpected exception while synchronizing " + uri  + " at " + getAccount().name, e);\r
-        }\r
+            Notification notification = new Notification(R.drawable.icon, getContext().getString(R.string.sync_conflicts_in_favourites_ticker), System.currentTimeMillis());\r
+            notification.flags |= Notification.FLAG_AUTO_CANCEL;\r
+            // TODO put something smart in the contentIntent below\r
+            notification.contentIntent = PendingIntent.getActivity(getContext().getApplicationContext(), (int)System.currentTimeMillis(), new Intent(), 0);\r
+            notification.setLatestEventInfo(getContext().getApplicationContext(), \r
+                                            getContext().getString(R.string.sync_conflicts_in_favourites_ticker), \r
+                                            String.format(getContext().getString(R.string.sync_conflicts_in_favourites_content), mConflictsFound), \r
+                                            notification.contentIntent);\r
+            ((NotificationManager) getContext().getSystemService(Context.NOTIFICATION_SERVICE)).notify(R.string.sync_conflicts_in_favourites_ticker, notification);\r
+        } \r

     }\r
 \r
     }\r
 \r

-    private void updateOCVersion() {\r
-        String statUrl = getAccountManager().getUserData(getAccount(), AccountAuthenticator.KEY_OC_BASE_URL);\r
-        statUrl += AccountUtils.STATUS_PATH;\r
+    \r
+    /**\r
+     * Notifies the user about local copies of files out of the ownCloud local directory that were 'forgotten' because \r
+     * copying them inside the ownCloud local directory was not possible.\r
+     * \r
+     * We don't want links to files out of the ownCloud local directory (foreign files) anymore. It's easy to have \r
+     * synchronization problems if a local file is linked to more than one remote file.\r
+     * \r
+     * We won't consider a synchronization as failed when foreign files can not be copied to the ownCloud local directory.\r
+     */\r
+    private void notifyForgottenLocalFiles() {\r
+        Notification notification = new Notification(R.drawable.icon, getContext().getString(R.string.sync_foreign_files_forgotten_ticker), System.currentTimeMillis());\r
+        notification.flags |= Notification.FLAG_AUTO_CANCEL;\r
+\r
+        /// includes a pending intent in the notification showing a more detailed explanation\r
+        Intent explanationIntent = new Intent(getContext(), ErrorsWhileCopyingHandlerActivity.class);\r
+        explanationIntent.putExtra(ErrorsWhileCopyingHandlerActivity.EXTRA_ACCOUNT, getAccount());\r
+        ArrayList<String> remotePaths = new ArrayList<String>();\r
+        ArrayList<String> localPaths = new ArrayList<String>();\r
+        remotePaths.addAll(mForgottenLocalFiles.keySet());\r
+        localPaths.addAll(mForgottenLocalFiles.values());\r
+        explanationIntent.putExtra(ErrorsWhileCopyingHandlerActivity.EXTRA_LOCAL_PATHS, localPaths);\r
+        explanationIntent.putExtra(ErrorsWhileCopyingHandlerActivity.EXTRA_REMOTE_PATHS, remotePaths);  \r
+        explanationIntent.setFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);\r
+        \r
+        notification.contentIntent = PendingIntent.getActivity(getContext().getApplicationContext(), (int)System.currentTimeMillis(), explanationIntent, 0);\r
+        notification.setLatestEventInfo(getContext().getApplicationContext(), \r
+                                        getContext().getString(R.string.sync_foreign_files_forgotten_ticker), \r
+                                        String.format(getContext().getString(R.string.sync_foreign_files_forgotten_content), mForgottenLocalFiles.size(), getContext().getString(R.string.app_name)), \r
+                                        notification.contentIntent);\r
+        ((NotificationManager) getContext().getSystemService(Context.NOTIFICATION_SERVICE)).notify(R.string.sync_foreign_files_forgotten_ticker, notification);\r

         \r
         \r

-        try {\r
-            String result = getClient().getResultAsString(statUrl);\r
-            if (result != null) {\r
-                try {\r
-                    JSONObject json = new JSONObject(result);\r
-                    if (json != null && json.getString("version") != null) {\r
-                        OwnCloudVersion ocver = new OwnCloudVersion(json.getString("version"));\r
-                        if (ocver.isVersionValid()) {\r
-                            getAccountManager().setUserData(getAccount(), AccountAuthenticator.KEY_OC_VERSION, ocver.toString());\r
-                            Log.d(TAG, "Got new OC version " + ocver.toString());\r
-                        } else {\r
-                            Log.w(TAG, "Invalid version number received from server: " + json.getString("version"));\r
-                        }\r
-                    }\r
-                } catch (Throwable e) {\r
-                    Log.w(TAG, "Couldn't parse version response", e);\r
-                }\r
-            } else {\r
-                Log.w(TAG, "Problem while getting ocversion from server");\r
-            }\r
-        } catch (Exception e) {\r
-            Log.e(TAG, "Problem getting response from server", e);\r
-        }\r

     }\r
     }\r

+    \r
+    \r

 }\r
 }\r