1 /*
2  * Copyright (C) 2022 The Android Open Source Project
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.android.ondevicepersonalization.services.process;
18 
19 import android.annotation.NonNull;
20 import android.content.ComponentName;
21 import android.os.Bundle;
22 
23 import com.google.common.util.concurrent.ListenableFuture;
24 
25 /**
26  * Interface for process runners used to support various request flows. Note that only one type
27  * of runner can be used until the process restarts.
28  */
29 public interface ProcessRunner {
30     /** Binds to/Loads a service in a (shared) isolated process. */
31     @NonNull
loadIsolatedService( @onNull String taskName, @NonNull ComponentName componentName)32     ListenableFuture<IsolatedServiceInfo> loadIsolatedService(
33             @NonNull String taskName, @NonNull ComponentName componentName);
34 
35     /** Executes a service loaded in a (shared) isolated process. */
36     @NonNull
runIsolatedService( @onNull IsolatedServiceInfo isolatedProcessInfo, int operationCode, @NonNull Bundle serviceParams)37     ListenableFuture<Bundle> runIsolatedService(
38             @NonNull IsolatedServiceInfo isolatedProcessInfo,
39             int operationCode,
40             @NonNull Bundle serviceParams);
41 
42     /** Unbinds/Unloads a service loaded in a (shared) isolated process. */
43     @NonNull
unloadIsolatedService( @onNull IsolatedServiceInfo isolatedServiceInfo)44     ListenableFuture<Void> unloadIsolatedService(
45             @NonNull IsolatedServiceInfo isolatedServiceInfo);
46 }