• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /*
2  * Copyright (C) 2011 The Android Open Source Project
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License"); you may not
5  * use this file except in compliance with the License. You may obtain a copy of
6  * 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, WITHOUT
12  * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
13  * License for the specific language governing permissions and limitations under
14  * the License.
15  */
16 
17 package com.android.inputmethod.dictionarypack;
18 
19 import android.content.Context;
20 import android.database.Cursor;
21 
22 import java.io.IOException;
23 import java.io.InputStreamReader;
24 import java.util.Collections;
25 import java.util.ArrayList;
26 import java.util.List;
27 
28 /**
29  * Helper class to easy up manipulation of dictionary pack metadata.
30  */
31 public class MetadataHandler {
32     @SuppressWarnings("unused")
33     private static final String TAG = "DictionaryProvider:" + MetadataHandler.class.getSimpleName();
34 
35     // The canonical file name for metadata. This is not the name of a real file on the
36     // device, but a symbolic name used in the database and in metadata handling. It is never
37     // tested against, only used for human-readability as the file name for the metadata.
38     public final static String METADATA_FILENAME = "metadata.json";
39 
40     /**
41      * Reads the data from the cursor and store it in metadata objects.
42      * @param results the cursor to read data from.
43      * @return the constructed list of wordlist metadata.
44      */
makeMetadataObject(final Cursor results)45     private static List<WordListMetadata> makeMetadataObject(final Cursor results) {
46         final ArrayList<WordListMetadata> buildingMetadata = new ArrayList<WordListMetadata>();
47 
48         if (results.moveToFirst()) {
49             final int localeColumn = results.getColumnIndex(MetadataDbHelper.LOCALE_COLUMN);
50             final int typeColumn = results.getColumnIndex(MetadataDbHelper.TYPE_COLUMN);
51             final int descriptionColumn =
52                     results.getColumnIndex(MetadataDbHelper.DESCRIPTION_COLUMN);
53             final int idIndex = results.getColumnIndex(MetadataDbHelper.WORDLISTID_COLUMN);
54             final int updateIndex = results.getColumnIndex(MetadataDbHelper.DATE_COLUMN);
55             final int fileSizeIndex = results.getColumnIndex(MetadataDbHelper.FILESIZE_COLUMN);
56             final int checksumIndex = results.getColumnIndex(MetadataDbHelper.CHECKSUM_COLUMN);
57             final int localFilenameIndex =
58                     results.getColumnIndex(MetadataDbHelper.LOCAL_FILENAME_COLUMN);
59             final int remoteFilenameIndex =
60                     results.getColumnIndex(MetadataDbHelper.REMOTE_FILENAME_COLUMN);
61             final int versionIndex = results.getColumnIndex(MetadataDbHelper.VERSION_COLUMN);
62             final int formatVersionIndex =
63                     results.getColumnIndex(MetadataDbHelper.FORMATVERSION_COLUMN);
64 
65             do {
66                 buildingMetadata.add(new WordListMetadata(results.getString(idIndex),
67                         results.getInt(typeColumn),
68                         results.getString(descriptionColumn),
69                         results.getLong(updateIndex),
70                         results.getLong(fileSizeIndex),
71                         results.getString(checksumIndex),
72                         results.getString(localFilenameIndex),
73                         results.getString(remoteFilenameIndex),
74                         results.getInt(versionIndex),
75                         results.getInt(formatVersionIndex),
76                         0, results.getString(localeColumn)));
77             } while (results.moveToNext());
78 
79             results.close();
80         }
81         return Collections.unmodifiableList(buildingMetadata);
82     }
83 
84     /**
85      * Gets the whole metadata, for installed and not installed dictionaries.
86      * @param context The context to open files over.
87      * @param clientId the client id for retrieving the database. null for default (deprecated)
88      * @return The current metadata.
89      */
getCurrentMetadata(final Context context, final String clientId)90     public static List<WordListMetadata> getCurrentMetadata(final Context context,
91             final String clientId) {
92         // If clientId is null, we get a cursor on the default database (see
93         // MetadataDbHelper#getInstance() for more on this)
94         final Cursor results = MetadataDbHelper.queryCurrentMetadata(context, clientId);
95         final List<WordListMetadata> resultList = makeMetadataObject(results);
96         results.close();
97         return resultList;
98     }
99 
100     /**
101      * Read metadata from a stream.
102      * @param input The stream to read from.
103      * @return The read metadata.
104      * @throws IOException if the input stream cannot be read
105      * @throws BadFormatException if the stream is not in a known format
106      */
readMetadata(final InputStreamReader input)107     public static List<WordListMetadata> readMetadata(final InputStreamReader input)
108             throws IOException, BadFormatException {
109         return MetadataParser.parseMetadata(input);
110     }
111 
112     /**
113      * Finds a single WordListMetadata inside a whole metadata chunk.
114      *
115      * Searches through the whole passed metadata for the first WordListMetadata associated
116      * with the passed ID. If several metadata chunks with the same id are found, it will
117      * always return the one with the bigger FormatVersion that is less or equal than the
118      * maximum supported format version (as listed in UpdateHandler).
119      * This will NEVER return the metadata with a FormatVersion bigger than what is supported,
120      * even if it is the only word list with this ID.
121      *
122      * @param metadata the metadata to search into.
123      * @param id the word list ID of the metadata to find.
124      * @return the associated metadata, or null if not found.
125      */
findWordListById(final List<WordListMetadata> metadata, final String id)126     public static WordListMetadata findWordListById(final List<WordListMetadata> metadata,
127             final String id) {
128         WordListMetadata bestWordList = null;
129         int bestFormatVersion = Integer.MIN_VALUE; // To be sure we can't be inadvertently smaller
130         for (WordListMetadata wordList : metadata) {
131             if (id.equals(wordList.mId)
132                     && wordList.mFormatVersion <= UpdateHandler.MAXIMUM_SUPPORTED_FORMAT_VERSION
133                     && wordList.mFormatVersion > bestFormatVersion) {
134                 bestWordList = wordList;
135                 bestFormatVersion = wordList.mFormatVersion;
136             }
137         }
138         // If we didn't find any match we'll return null.
139         return bestWordList;
140     }
141 }
142