/* * Copyright (C) 2013 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.printspooler.ui; import android.content.ComponentName; import android.content.Context; import android.content.Loader; import android.content.pm.ServiceInfo; import android.os.AsyncTask; import android.print.PrintManager; import android.print.PrinterDiscoverySession; import android.print.PrinterDiscoverySession.OnPrintersChangeListener; import android.print.PrinterId; import android.print.PrinterInfo; import android.printservice.PrintServiceInfo; import android.text.TextUtils; import android.util.ArrayMap; import android.util.ArraySet; import android.util.AtomicFile; import android.util.Log; import android.util.Slog; import android.util.Xml; import com.android.internal.util.FastXmlSerializer; import org.xmlpull.v1.XmlPullParser; import org.xmlpull.v1.XmlPullParserException; import org.xmlpull.v1.XmlSerializer; import java.io.File; import java.io.FileInputStream; import java.io.FileNotFoundException; import java.io.FileOutputStream; import java.io.IOException; import java.nio.charset.StandardCharsets; import java.util.ArrayList; import java.util.Collections; import java.util.LinkedHashMap; import java.util.List; import java.util.Map; import java.util.Set; import libcore.io.IoUtils; /** * This class is responsible for loading printers by doing discovery * and merging the discovered printers with the previously used ones. */ public final class FusedPrintersProvider extends Loader> { private static final String LOG_TAG = "FusedPrintersProvider"; private static final boolean DEBUG = false; private static final double WEIGHT_DECAY_COEFFICIENT = 0.95f; private static final int MAX_HISTORY_LENGTH = 50; private static final int MAX_FAVORITE_PRINTER_COUNT = 4; private final List mPrinters = new ArrayList<>(); private final List mFavoritePrinters = new ArrayList<>(); private final PersistenceManager mPersistenceManager; private PrinterDiscoverySession mDiscoverySession; private PrinterId mTrackedPrinter; private boolean mPrintersUpdatedBefore; public FusedPrintersProvider(Context context) { super(context); mPersistenceManager = new PersistenceManager(context); } public void addHistoricalPrinter(PrinterInfo printer) { mPersistenceManager.addPrinterAndWritePrinterHistory(printer); } private void computeAndDeliverResult(Map discoveredPrinters, List favoritePrinters) { List printers = new ArrayList<>(); // Add the updated favorite printers. final int favoritePrinterCount = favoritePrinters.size(); for (int i = 0; i < favoritePrinterCount; i++) { PrinterInfo favoritePrinter = favoritePrinters.get(i); PrinterInfo updatedPrinter = discoveredPrinters.remove( favoritePrinter.getId()); if (updatedPrinter != null) { printers.add(updatedPrinter); } else { printers.add(favoritePrinter); } } // Add other updated printers. final int printerCount = mPrinters.size(); for (int i = 0; i < printerCount; i++) { PrinterInfo printer = mPrinters.get(i); PrinterInfo updatedPrinter = discoveredPrinters.remove( printer.getId()); if (updatedPrinter != null) { printers.add(updatedPrinter); } } // Add the new printers, i.e. what is left. printers.addAll(discoveredPrinters.values()); // Update the list of printers. mPrinters.clear(); mPrinters.addAll(printers); if (isStarted()) { // If stated deliver the new printers. deliverResult(printers); } else { // Otherwise, take a note for the change. onContentChanged(); } } @Override protected void onStartLoading() { if (DEBUG) { Log.i(LOG_TAG, "onStartLoading() " + FusedPrintersProvider.this.hashCode()); } // The contract is that if we already have a valid, // result the we have to deliver it immediately. if (!mPrinters.isEmpty()) { deliverResult(new ArrayList<>(mPrinters)); } // Always load the data to ensure discovery period is // started and to make sure obsolete printers are updated. onForceLoad(); } @Override protected void onStopLoading() { if (DEBUG) { Log.i(LOG_TAG, "onStopLoading() " + FusedPrintersProvider.this.hashCode()); } onCancelLoad(); } @Override protected void onForceLoad() { if (DEBUG) { Log.i(LOG_TAG, "onForceLoad() " + FusedPrintersProvider.this.hashCode()); } loadInternal(); } private void loadInternal() { if (mDiscoverySession == null) { PrintManager printManager = (PrintManager) getContext() .getSystemService(Context.PRINT_SERVICE); mDiscoverySession = printManager.createPrinterDiscoverySession(); mPersistenceManager.readPrinterHistory(); } else if (mPersistenceManager.isHistoryChanged()) { mPersistenceManager.readPrinterHistory(); } if (mPersistenceManager.isReadHistoryCompleted() && !mDiscoverySession.isPrinterDiscoveryStarted()) { mDiscoverySession.setOnPrintersChangeListener(new OnPrintersChangeListener() { @Override public void onPrintersChanged() { if (DEBUG) { Log.i(LOG_TAG, "onPrintersChanged() count:" + mDiscoverySession.getPrinters().size() + " " + FusedPrintersProvider.this.hashCode()); } updatePrinters(mDiscoverySession.getPrinters(), mFavoritePrinters); } }); final int favoriteCount = mFavoritePrinters.size(); List printerIds = new ArrayList<>(favoriteCount); for (int i = 0; i < favoriteCount; i++) { printerIds.add(mFavoritePrinters.get(i).getId()); } mDiscoverySession.startPrinterDiscovery(printerIds); List printers = mDiscoverySession.getPrinters(); if (!printers.isEmpty()) { updatePrinters(printers, mFavoritePrinters); } } } private void updatePrinters(List printers, List favoritePrinters) { if (mPrintersUpdatedBefore && mPrinters.equals(printers) && mFavoritePrinters.equals(favoritePrinters)) { return; } mPrintersUpdatedBefore = true; // Some of the found printers may have be a printer that is in the // history but with its name changed. Hence, we try to update the // printer to use its current name instead of the historical one. mPersistenceManager.updatePrintersHistoricalNamesIfNeeded(printers); Map printersMap = new LinkedHashMap<>(); final int printerCount = printers.size(); for (int i = 0; i < printerCount; i++) { PrinterInfo printer = printers.get(i); printersMap.put(printer.getId(), printer); } computeAndDeliverResult(printersMap, favoritePrinters); } @Override protected boolean onCancelLoad() { if (DEBUG) { Log.i(LOG_TAG, "onCancelLoad() " + FusedPrintersProvider.this.hashCode()); } return cancelInternal(); } private boolean cancelInternal() { if (mDiscoverySession != null && mDiscoverySession.isPrinterDiscoveryStarted()) { if (mTrackedPrinter != null) { mDiscoverySession.stopPrinterStateTracking(mTrackedPrinter); mTrackedPrinter = null; } mDiscoverySession.stopPrinterDiscovery(); return true; } else if (mPersistenceManager.isReadHistoryInProgress()) { return mPersistenceManager.stopReadPrinterHistory(); } return false; } @Override protected void onReset() { if (DEBUG) { Log.i(LOG_TAG, "onReset() " + FusedPrintersProvider.this.hashCode()); } onStopLoading(); mPrinters.clear(); if (mDiscoverySession != null) { mDiscoverySession.destroy(); mDiscoverySession = null; } } @Override protected void onAbandon() { if (DEBUG) { Log.i(LOG_TAG, "onAbandon() " + FusedPrintersProvider.this.hashCode()); } onStopLoading(); } public boolean areHistoricalPrintersLoaded() { return mPersistenceManager.mReadHistoryCompleted; } public void setTrackedPrinter(PrinterId printerId) { if (isStarted() && mDiscoverySession != null && mDiscoverySession.isPrinterDiscoveryStarted()) { if (mTrackedPrinter != null) { if (mTrackedPrinter.equals(printerId)) { return; } mDiscoverySession.stopPrinterStateTracking(mTrackedPrinter); } mTrackedPrinter = printerId; if (printerId != null) { mDiscoverySession.startPrinterStateTracking(printerId); } } } public boolean isFavoritePrinter(PrinterId printerId) { final int printerCount = mFavoritePrinters.size(); for (int i = 0; i < printerCount; i++) { PrinterInfo favoritePritner = mFavoritePrinters.get(i); if (favoritePritner.getId().equals(printerId)) { return true; } } return false; } public void forgetFavoritePrinter(PrinterId printerId) { List newFavoritePrinters = null; // Remove the printer from the favorites. final int favoritePrinterCount = mFavoritePrinters.size(); for (int i = 0; i < favoritePrinterCount; i++) { PrinterInfo favoritePrinter = mFavoritePrinters.get(i); if (favoritePrinter.getId().equals(printerId)) { newFavoritePrinters = new ArrayList<>(); newFavoritePrinters.addAll(mPrinters); newFavoritePrinters.remove(i); break; } } // If we removed a favorite printer, we have work to do. if (newFavoritePrinters != null) { // Remove the printer from history and persist the latter. mPersistenceManager.removeHistoricalPrinterAndWritePrinterHistory(printerId); // Recompute and deliver the printers. updatePrinters(mDiscoverySession.getPrinters(), newFavoritePrinters); } } private final class PersistenceManager { private static final String PERSIST_FILE_NAME = "printer_history.xml"; private static final String TAG_PRINTERS = "printers"; private static final String TAG_PRINTER = "printer"; private static final String TAG_PRINTER_ID = "printerId"; private static final String ATTR_LOCAL_ID = "localId"; private static final String ATTR_SERVICE_NAME = "serviceName"; private static final String ATTR_NAME = "name"; private static final String ATTR_DESCRIPTION = "description"; private static final String ATTR_STATUS = "status"; private final AtomicFile mStatePersistFile; private List mHistoricalPrinters = new ArrayList<>(); private boolean mReadHistoryCompleted; private ReadTask mReadTask; private volatile long mLastReadHistoryTimestamp; private PersistenceManager(Context context) { mStatePersistFile = new AtomicFile(new File(context.getFilesDir(), PERSIST_FILE_NAME)); } public boolean isReadHistoryInProgress() { return mReadTask != null; } public boolean isReadHistoryCompleted() { return mReadHistoryCompleted; } public boolean stopReadPrinterHistory() { return mReadTask.cancel(true); } public void readPrinterHistory() { if (DEBUG) { Log.i(LOG_TAG, "read history started " + FusedPrintersProvider.this.hashCode()); } mReadTask = new ReadTask(); mReadTask.executeOnExecutor(AsyncTask.SERIAL_EXECUTOR, (Void[]) null); } public void updatePrintersHistoricalNamesIfNeeded(List printers) { boolean writeHistory = false; final int printerCount = printers.size(); for (int i = 0; i < printerCount; i++) { PrinterInfo printer = printers.get(i); writeHistory |= renamePrinterIfNeeded(printer); } if (writeHistory) { writePrinterHistory(); } } public boolean renamePrinterIfNeeded(PrinterInfo printer) { boolean renamed = false; final int printerCount = mHistoricalPrinters.size(); for (int i = 0; i < printerCount; i++) { PrinterInfo historicalPrinter = mHistoricalPrinters.get(i); if (historicalPrinter.getId().equals(printer.getId()) && !TextUtils.equals(historicalPrinter.getName(), printer.getName())) { mHistoricalPrinters.set(i, printer); renamed = true; } } return renamed; } public void addPrinterAndWritePrinterHistory(PrinterInfo printer) { if (mHistoricalPrinters.size() >= MAX_HISTORY_LENGTH) { mHistoricalPrinters.remove(0); } mHistoricalPrinters.add(printer); writePrinterHistory(); } public void removeHistoricalPrinterAndWritePrinterHistory(PrinterId printerId) { boolean writeHistory = false; final int printerCount = mHistoricalPrinters.size(); for (int i = printerCount - 1; i >= 0; i--) { PrinterInfo historicalPrinter = mHistoricalPrinters.get(i); if (historicalPrinter.getId().equals(printerId)) { mHistoricalPrinters.remove(i); writeHistory = true; } } if (writeHistory) { writePrinterHistory(); } } @SuppressWarnings("unchecked") private void writePrinterHistory() { new WriteTask().executeOnExecutor(AsyncTask.SERIAL_EXECUTOR, new ArrayList<>(mHistoricalPrinters)); } public boolean isHistoryChanged() { return mLastReadHistoryTimestamp != mStatePersistFile.getBaseFile().lastModified(); } private List computeFavoritePrinters(List printers) { Map recordMap = new ArrayMap<>(); // Recompute the weights. float currentWeight = 1.0f; final int printerCount = printers.size(); for (int i = printerCount - 1; i >= 0; i--) { PrinterInfo printer = printers.get(i); // Aggregate weight for the same printer PrinterRecord record = recordMap.get(printer.getId()); if (record == null) { record = new PrinterRecord(printer); recordMap.put(printer.getId(), record); } record.weight += currentWeight; currentWeight *= WEIGHT_DECAY_COEFFICIENT; } // Soft the favorite printers. List favoriteRecords = new ArrayList<>( recordMap.values()); Collections.sort(favoriteRecords); // Write the favorites to the output. final int favoriteCount = Math.min(favoriteRecords.size(), MAX_FAVORITE_PRINTER_COUNT); List favoritePrinters = new ArrayList<>(favoriteCount); for (int i = 0; i < favoriteCount; i++) { PrinterInfo printer = favoriteRecords.get(i).printer; favoritePrinters.add(printer); } return favoritePrinters; } private final class PrinterRecord implements Comparable { public final PrinterInfo printer; public float weight; public PrinterRecord(PrinterInfo printer) { this.printer = printer; } @Override public int compareTo(PrinterRecord another) { return Float.floatToIntBits(another.weight) - Float.floatToIntBits(weight); } } private final class ReadTask extends AsyncTask> { @Override protected List doInBackground(Void... args) { return doReadPrinterHistory(); } @Override protected void onPostExecute(List printers) { if (DEBUG) { Log.i(LOG_TAG, "read history completed " + FusedPrintersProvider.this.hashCode()); } // Ignore printer records whose target services are not enabled. PrintManager printManager = (PrintManager) getContext() .getSystemService(Context.PRINT_SERVICE); List services = printManager .getEnabledPrintServices(); Set enabledComponents = new ArraySet<>(); final int installedServiceCount = services.size(); for (int i = 0; i < installedServiceCount; i++) { ServiceInfo serviceInfo = services.get(i).getResolveInfo().serviceInfo; ComponentName componentName = new ComponentName( serviceInfo.packageName, serviceInfo.name); enabledComponents.add(componentName); } final int printerCount = printers.size(); for (int i = printerCount - 1; i >= 0; i--) { ComponentName printerServiceName = printers.get(i).getId().getServiceName(); if (!enabledComponents.contains(printerServiceName)) { printers.remove(i); } } // Store the filtered list. mHistoricalPrinters = printers; // Compute the favorite printers. mFavoritePrinters.clear(); mFavoritePrinters.addAll(computeFavoritePrinters(mHistoricalPrinters)); mReadHistoryCompleted = true; // Deliver the printers. updatePrinters(mDiscoverySession.getPrinters(), mFavoritePrinters); // We are done. mReadTask = null; // Loading the available printers if needed. loadInternal(); } @Override protected void onCancelled(List printerInfos) { // We are done. mReadTask = null; } private List doReadPrinterHistory() { final FileInputStream in; try { in = mStatePersistFile.openRead(); } catch (FileNotFoundException fnfe) { if (DEBUG) { Log.i(LOG_TAG, "No existing printer history " + FusedPrintersProvider.this.hashCode()); } return new ArrayList<>(); } try { List printers = new ArrayList<>(); XmlPullParser parser = Xml.newPullParser(); parser.setInput(in, StandardCharsets.UTF_8.name()); parseState(parser, printers); // Take a note which version of the history was read. mLastReadHistoryTimestamp = mStatePersistFile.getBaseFile().lastModified(); return printers; } catch (IllegalStateException | NullPointerException | NumberFormatException | XmlPullParserException | IOException | IndexOutOfBoundsException e) { Slog.w(LOG_TAG, "Failed parsing ", e); } finally { IoUtils.closeQuietly(in); } return Collections.emptyList(); } private void parseState(XmlPullParser parser, List outPrinters) throws IOException, XmlPullParserException { parser.next(); skipEmptyTextTags(parser); expect(parser, XmlPullParser.START_TAG, TAG_PRINTERS); parser.next(); while (parsePrinter(parser, outPrinters)) { // Be nice and respond to cancellation if (isCancelled()) { return; } parser.next(); } skipEmptyTextTags(parser); expect(parser, XmlPullParser.END_TAG, TAG_PRINTERS); } private boolean parsePrinter(XmlPullParser parser, List outPrinters) throws IOException, XmlPullParserException { skipEmptyTextTags(parser); if (!accept(parser, XmlPullParser.START_TAG, TAG_PRINTER)) { return false; } String name = parser.getAttributeValue(null, ATTR_NAME); String description = parser.getAttributeValue(null, ATTR_DESCRIPTION); final int status = Integer.parseInt(parser.getAttributeValue(null, ATTR_STATUS)); parser.next(); skipEmptyTextTags(parser); expect(parser, XmlPullParser.START_TAG, TAG_PRINTER_ID); String localId = parser.getAttributeValue(null, ATTR_LOCAL_ID); ComponentName service = ComponentName.unflattenFromString(parser.getAttributeValue( null, ATTR_SERVICE_NAME)); PrinterId printerId = new PrinterId(service, localId); parser.next(); skipEmptyTextTags(parser); expect(parser, XmlPullParser.END_TAG, TAG_PRINTER_ID); parser.next(); PrinterInfo.Builder builder = new PrinterInfo.Builder(printerId, name, status); builder.setDescription(description); PrinterInfo printer = builder.build(); outPrinters.add(printer); if (DEBUG) { Log.i(LOG_TAG, "[RESTORED] " + printer); } skipEmptyTextTags(parser); expect(parser, XmlPullParser.END_TAG, TAG_PRINTER); return true; } private void expect(XmlPullParser parser, int type, String tag) throws IOException, XmlPullParserException { if (!accept(parser, type, tag)) { throw new XmlPullParserException("Exepected event: " + type + " and tag: " + tag + " but got event: " + parser.getEventType() + " and tag:" + parser.getName()); } } private void skipEmptyTextTags(XmlPullParser parser) throws IOException, XmlPullParserException { while (accept(parser, XmlPullParser.TEXT, null) && "\n".equals(parser.getText())) { parser.next(); } } private boolean accept(XmlPullParser parser, int type, String tag) throws IOException, XmlPullParserException { if (parser.getEventType() != type) { return false; } if (tag != null) { if (!tag.equals(parser.getName())) { return false; } } else if (parser.getName() != null) { return false; } return true; } } private final class WriteTask extends AsyncTask, Void, Void> { @Override protected Void doInBackground(List... printers) { doWritePrinterHistory(printers[0]); return null; } private void doWritePrinterHistory(List printers) { FileOutputStream out = null; try { out = mStatePersistFile.startWrite(); XmlSerializer serializer = new FastXmlSerializer(); serializer.setOutput(out, StandardCharsets.UTF_8.name()); serializer.startDocument(null, true); serializer.startTag(null, TAG_PRINTERS); final int printerCount = printers.size(); for (int i = 0; i < printerCount; i++) { PrinterInfo printer = printers.get(i); serializer.startTag(null, TAG_PRINTER); serializer.attribute(null, ATTR_NAME, printer.getName()); // Historical printers are always stored as unavailable. serializer.attribute(null, ATTR_STATUS, String.valueOf( PrinterInfo.STATUS_UNAVAILABLE)); String description = printer.getDescription(); if (description != null) { serializer.attribute(null, ATTR_DESCRIPTION, description); } PrinterId printerId = printer.getId(); serializer.startTag(null, TAG_PRINTER_ID); serializer.attribute(null, ATTR_LOCAL_ID, printerId.getLocalId()); serializer.attribute(null, ATTR_SERVICE_NAME, printerId.getServiceName() .flattenToString()); serializer.endTag(null, TAG_PRINTER_ID); serializer.endTag(null, TAG_PRINTER); if (DEBUG) { Log.i(LOG_TAG, "[PERSISTED] " + printer); } } serializer.endTag(null, TAG_PRINTERS); serializer.endDocument(); mStatePersistFile.finishWrite(out); if (DEBUG) { Log.i(LOG_TAG, "[PERSIST END]"); } } catch (IOException ioe) { Slog.w(LOG_TAG, "Failed to write printer history, restoring backup.", ioe); mStatePersistFile.failWrite(out); } finally { IoUtils.closeQuietly(out); } } } } }