1 /* 2 * Copyright 2013 Google Inc. 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17 package com.example.android.basicsyncadapter; 18 19 import android.app.Service; 20 import android.content.Intent; 21 import android.os.IBinder; 22 import android.util.Log; 23 24 /** Service to handle sync requests. 25 * 26 * <p>This service is invoked in response to Intents with action android.content.SyncAdapter, and 27 * returns a Binder connection to SyncAdapter. 28 * 29 * <p>For performance, only one sync adapter will be initialized within this application's context. 30 * 31 * <p>Note: The SyncService itself is not notified when a new sync occurs. It's role is to 32 * manage the lifecycle of our {@link SyncAdapter} and provide a handle to said SyncAdapter to the 33 * OS on request. 34 */ 35 public class SyncService extends Service { 36 private static final String TAG = "SyncService"; 37 38 private static final Object sSyncAdapterLock = new Object(); 39 private static SyncAdapter sSyncAdapter = null; 40 41 /** 42 * Thread-safe constructor, creates static {@link SyncAdapter} instance. 43 */ 44 @Override 45 public void onCreate() { 46 super.onCreate(); 47 Log.i(TAG, "Service created"); 48 synchronized (sSyncAdapterLock) { 49 if (sSyncAdapter == null) { 50 sSyncAdapter = new SyncAdapter(getApplicationContext(), true); 51 } 52 } 53 } 54 55 @Override 56 /** 57 * Logging-only destructor. 58 */ 59 public void onDestroy() { 60 super.onDestroy(); 61 Log.i(TAG, "Service destroyed"); 62 } 63 64 /** 65 * Return Binder handle for IPC communication with {@link SyncAdapter}. 66 * 67 * <p>New sync requests will be sent directly to the SyncAdapter using this channel. 68 * 69 * @param intent Calling intent 70 * @return Binder handle for {@link SyncAdapter} 71 */ 72 @Override 73 public IBinder onBind(Intent intent) { 74 return sSyncAdapter.getSyncAdapterBinder(); 75 } 76 }