replicant-vendor_cmsdk/sdk/src/java/cyanogenmod/weatherservice/WeatherProviderService.java

/*
 * Copyright (C) 2016 The CyanogenMod 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 cyanogenmod.weatherservice;

import android.annotation.SdkConstant;
import android.app.Service;
import android.content.Context;
import android.content.Intent;
import android.os.Handler;
import android.os.IBinder;
import android.os.Looper;
import android.os.Message;
import cyanogenmod.weather.RequestInfo;

import java.util.Collections;
import java.util.Set;
import java.util.WeakHashMap;

/**
 * This is the base class for implementing a weather provider service. A weather provider service
 * can handle weather update requests and update the weather content provider data by processing
 * a {@link ServiceRequest}
 *
 * A weather provider service is declared as any other service in an AndroidManifest.xml but it must
 * also specify that in handles the {@link android.content.Intent} with action
 * {@link #SERVICE_INTERFACE cyanogenmod.weatherservice.WeatherProviderService}. Failure to declare
 * this intent will cause the system to ignore the weather provider service. Additionally, a
 * weather provider service must request the
 * {@link cyanogenmod.platform.Manifest.permission#BIND_WEATHER_PROVIDER_SERVICE} permission to
 * ensure that only the system can bind to it. Failure to request this permission will cause the
 * system to ignore this weather provider service. Following is an example declaration:
 *
 * <pre>
 *    &lt;service android:name=".MyWeatherProviderService"
 *          android:permission="cyanogenmod.permission.BIND_WEATHER_PROVIDER_SERVICE"&gt;
 *      &lt;intent-filter&gt;
 *          &lt;action android:name="cyanogenmod.weatherservice.WeatherProviderService" /&gt;
 *      &lt;intent-filter&gt;
 *      . . .
 *    &lt;/service&gt;
 * </pre>
 *
 */
public abstract class WeatherProviderService extends Service {

    private Handler mHandler;
    private IWeatherProviderServiceClient mClient;
    private Set<ServiceRequest> mWeakRequestsSet
            = Collections.newSetFromMap(new WeakHashMap<ServiceRequest, Boolean>());

    /**
     * The {@link android.content.Intent} action that must be declared as handled by a service in
     * its manifest for the system to recognize it as a weather provider service
     */
    @SdkConstant(SdkConstant.SdkConstantType.SERVICE_ACTION)
    public static final String SERVICE_INTERFACE
            = "cyanogenmod.weatherservice.WeatherProviderService";

    /**
     * Name under which a {@link WeatherProviderService} publishes information about itself.
     * This meta-data must reference an XML resource containing
     * a <code>&lt;weather-provider-service&gt;</code>
     * tag.
     */
    public static final String SERVICE_META_DATA = "cyanogenmod.weatherservice";

    @Override
    protected final void attachBaseContext(Context base) {
        super.attachBaseContext(base);
        mHandler = new ServiceHandler(base.getMainLooper());
    }

    @Override
    public final IBinder onBind(Intent intent) {
        return mBinder;
    }

    private final IWeatherProviderService.Stub mBinder = new IWeatherProviderService.Stub() {

        @Override
        public void processWeatherUpdateRequest(final RequestInfo info) {
            mHandler.obtainMessage(ServiceHandler.MSG_ON_NEW_REQUEST, info).sendToTarget();
        }

        @Override
        public void processCityNameLookupRequest(final RequestInfo info) {
            mHandler.obtainMessage(ServiceHandler.MSG_ON_NEW_REQUEST, info).sendToTarget();
        }

        @Override
        public void setServiceClient(IWeatherProviderServiceClient client) {
            mHandler.obtainMessage(ServiceHandler.MSG_SET_CLIENT, client).sendToTarget();
        }

        @Override
        public void cancelOngoingRequests() {
            mHandler.obtainMessage(ServiceHandler.MSG_CANCEL_ALL_OUTSTANDING_REQUESTS)
                    .sendToTarget();
        }

        @Override
        public void cancelRequest(RequestInfo info) {
            mHandler.obtainMessage(ServiceHandler.MSG_CANCEL_REQUEST, info).sendToTarget();
        }
    };

    private class ServiceHandler extends Handler {

        public ServiceHandler(Looper looper) {
            super(looper);
        }
        public static final int MSG_SET_CLIENT = 1;
        public static final int MSG_ON_NEW_REQUEST = 2;
        public static final int MSG_CANCEL_ALL_OUTSTANDING_REQUESTS = 3;
        public static final int MSG_CANCEL_REQUEST = 4;

        @Override
        public void handleMessage(Message msg) {
            switch (msg.what) {
                case MSG_SET_CLIENT: {
                    mClient = (IWeatherProviderServiceClient) msg.obj;
                    if (mClient != null) {
                        onConnected();
                    } else {
                        onDisconnected();
                    }
                    return;
                }
                case MSG_ON_NEW_REQUEST: {
                    RequestInfo info = (RequestInfo) msg.obj;
                    if (info != null) {
                        ServiceRequest request = new ServiceRequest(info, mClient);
                        synchronized (mWeakRequestsSet) {
                            mWeakRequestsSet.add(request);
                        }
                        onRequestSubmitted(request);
                    }
                    return;
                }
                case MSG_CANCEL_ALL_OUTSTANDING_REQUESTS: {
                    synchronized (mWeakRequestsSet) {
                        for (final ServiceRequest request : mWeakRequestsSet) {
                            if (request != null) {
                                request.cancel();
                                mWeakRequestsSet.remove(request);
                                mHandler.post(new Runnable() {
                                    @Override
                                    public void run() {
                                        onRequestCancelled(request);
                                    }
                                });
                            }
                        }
                    }
                    return;
                }
                case MSG_CANCEL_REQUEST: {
                    synchronized (mWeakRequestsSet) {
                        RequestInfo info = (RequestInfo) msg.obj;
                        if (info == null) return;
                        for (final ServiceRequest request : mWeakRequestsSet) {
                            if (request.getRequestInfo().equals(info)) {
                                request.cancel();
                                mWeakRequestsSet.remove(request);
                                mHandler.post(new Runnable() {
                                    @Override
                                    public void run() {
                                        onRequestCancelled(request);
                                    }
                                });
                                break;
                            }
                        }
                    }
                    return;
                }
            }
        }
    }

    /**
     * The system has connected to this service.
     */
    protected void onConnected() {
        /* Do nothing */
    }

    /**
     * The system has disconnected from this service.
     */
    protected void onDisconnected() {
        /* Do nothing */
    }

    /**
     * A new request has been submitted to this service
     * @param request The service request to be processed by this service
     */
    protected abstract void onRequestSubmitted(ServiceRequest request);

    /**
     * Called when the system is not interested on this request anymore. Note that the service
     * <b>has marked the request as cancelled</b> and you must stop any ongoing operation
     * (such as pulling data from internet) that this service could've been performing to honor the
     * request.
     *
     * @param request The request cancelled by the system
     */
    protected abstract void onRequestCancelled(ServiceRequest request);
}