/* * Copyright (C) 2006-2007 Google Inc. * * 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.internal.telephony.cat; import com.android.internal.telephony.GsmAlphabet; import com.android.internal.telephony.cat.Duration.TimeUnit; import com.android.internal.telephony.uicc.IccUtils; import java.io.UnsupportedEncodingException; import java.util.ArrayList; import java.util.List; abstract class ValueParser { /** * Search for a Command Details object from a list. * * @param ctlv List of ComprehensionTlv objects used for search * @return An CtlvCommandDetails object found from the objects. If no * Command Details object is found, ResultException is thrown. * @throws ResultException */ static CommandDetails retrieveCommandDetails(ComprehensionTlv ctlv) throws ResultException { CommandDetails cmdDet = new CommandDetails(); byte[] rawValue = ctlv.getRawValue(); int valueIndex = ctlv.getValueIndex(); try { cmdDet.compRequired = ctlv.isComprehensionRequired(); cmdDet.commandNumber = rawValue[valueIndex] & 0xff; cmdDet.typeOfCommand = rawValue[valueIndex + 1] & 0xff; cmdDet.commandQualifier = rawValue[valueIndex + 2] & 0xff; return cmdDet; } catch (IndexOutOfBoundsException e) { throw new ResultException(ResultCode.CMD_DATA_NOT_UNDERSTOOD); } } /** * Search for a Device Identities object from a list. * * @param ctlv List of ComprehensionTlv objects used for search * @return An CtlvDeviceIdentities object found from the objects. If no * Command Details object is found, ResultException is thrown. * @throws ResultException */ static DeviceIdentities retrieveDeviceIdentities(ComprehensionTlv ctlv) throws ResultException { DeviceIdentities devIds = new DeviceIdentities(); byte[] rawValue = ctlv.getRawValue(); int valueIndex = ctlv.getValueIndex(); try { devIds.sourceId = rawValue[valueIndex] & 0xff; devIds.destinationId = rawValue[valueIndex + 1] & 0xff; return devIds; } catch (IndexOutOfBoundsException e) { throw new ResultException(ResultCode.REQUIRED_VALUES_MISSING); } } /** * Retrieves Duration information from the Duration COMPREHENSION-TLV * object. * * @param ctlv A Text Attribute COMPREHENSION-TLV object * @return A Duration object * @throws ResultException */ static Duration retrieveDuration(ComprehensionTlv ctlv) throws ResultException { int timeInterval = 0; TimeUnit timeUnit = TimeUnit.SECOND; byte[] rawValue = ctlv.getRawValue(); int valueIndex = ctlv.getValueIndex(); try { timeUnit = TimeUnit.values()[(rawValue[valueIndex] & 0xff)]; timeInterval = rawValue[valueIndex + 1] & 0xff; } catch (IndexOutOfBoundsException e) { throw new ResultException(ResultCode.CMD_DATA_NOT_UNDERSTOOD); } return new Duration(timeInterval, timeUnit); } /** * Retrieves Item information from the COMPREHENSION-TLV object. * * @param ctlv A Text Attribute COMPREHENSION-TLV object * @return An Item * @throws ResultException */ static Item retrieveItem(ComprehensionTlv ctlv) throws ResultException { Item item = null; byte[] rawValue = ctlv.getRawValue(); int valueIndex = ctlv.getValueIndex(); int length = ctlv.getLength(); if (length != 0) { int textLen = length - 1; try { int id = rawValue[valueIndex] & 0xff; String text = IccUtils.adnStringFieldToString(rawValue, valueIndex + 1, textLen); item = new Item(id, text); } catch (IndexOutOfBoundsException e) { throw new ResultException(ResultCode.CMD_DATA_NOT_UNDERSTOOD); } } return item; } /** * Retrieves Item id information from the COMPREHENSION-TLV object. * * @param ctlv A Text Attribute COMPREHENSION-TLV object * @return An Item id * @throws ResultException */ static int retrieveItemId(ComprehensionTlv ctlv) throws ResultException { int id = 0; byte[] rawValue = ctlv.getRawValue(); int valueIndex = ctlv.getValueIndex(); try { id = rawValue[valueIndex] & 0xff; } catch (IndexOutOfBoundsException e) { throw new ResultException(ResultCode.CMD_DATA_NOT_UNDERSTOOD); } return id; } /** * Retrieves icon id from an Icon Identifier COMPREHENSION-TLV object * * @param ctlv An Icon Identifier COMPREHENSION-TLV object * @return IconId instance * @throws ResultException */ static IconId retrieveIconId(ComprehensionTlv ctlv) throws ResultException { IconId id = new IconId(); byte[] rawValue = ctlv.getRawValue(); int valueIndex = ctlv.getValueIndex(); try { id.selfExplanatory = (rawValue[valueIndex++] & 0xff) == 0x00; id.recordNumber = rawValue[valueIndex] & 0xff; } catch (IndexOutOfBoundsException e) { throw new ResultException(ResultCode.CMD_DATA_NOT_UNDERSTOOD); } return id; } /** * Retrieves item icons id from an Icon Identifier List COMPREHENSION-TLV * object * * @param ctlv An Item Icon List Identifier COMPREHENSION-TLV object * @return ItemsIconId instance * @throws ResultException */ static ItemsIconId retrieveItemsIconId(ComprehensionTlv ctlv) throws ResultException { CatLog.d("ValueParser", "retrieveItemsIconId:"); ItemsIconId id = new ItemsIconId(); byte[] rawValue = ctlv.getRawValue(); int valueIndex = ctlv.getValueIndex(); int numOfItems = ctlv.getLength() - 1; id.recordNumbers = new int[numOfItems]; try { // get icon self-explanatory id.selfExplanatory = (rawValue[valueIndex++] & 0xff) == 0x00; for (int index = 0; index < numOfItems;) { id.recordNumbers[index++] = rawValue[valueIndex++]; } } catch (IndexOutOfBoundsException e) { throw new ResultException(ResultCode.CMD_DATA_NOT_UNDERSTOOD); } return id; } /** * Retrieves text attribute information from the Text Attribute * COMPREHENSION-TLV object. * * @param ctlv A Text Attribute COMPREHENSION-TLV object * @return A list of TextAttribute objects * @throws ResultException */ static List retrieveTextAttribute(ComprehensionTlv ctlv) throws ResultException { ArrayList lst = new ArrayList(); byte[] rawValue = ctlv.getRawValue(); int valueIndex = ctlv.getValueIndex(); int length = ctlv.getLength(); if (length != 0) { // Each attribute is consisted of four bytes int itemCount = length / 4; try { for (int i = 0; i < itemCount; i++, valueIndex += 4) { int start = rawValue[valueIndex] & 0xff; int textLength = rawValue[valueIndex + 1] & 0xff; int format = rawValue[valueIndex + 2] & 0xff; int colorValue = rawValue[valueIndex + 3] & 0xff; int alignValue = format & 0x03; TextAlignment align = TextAlignment.fromInt(alignValue); int sizeValue = (format >> 2) & 0x03; FontSize size = FontSize.fromInt(sizeValue); if (size == null) { // Font size value is not defined. Use default. size = FontSize.NORMAL; } boolean bold = (format & 0x10) != 0; boolean italic = (format & 0x20) != 0; boolean underlined = (format & 0x40) != 0; boolean strikeThrough = (format & 0x80) != 0; TextColor color = TextColor.fromInt(colorValue); TextAttribute attr = new TextAttribute(start, textLength, align, size, bold, italic, underlined, strikeThrough, color); lst.add(attr); } return lst; } catch (IndexOutOfBoundsException e) { throw new ResultException(ResultCode.CMD_DATA_NOT_UNDERSTOOD); } } return null; } /** * Retrieves alpha identifier from an Alpha Identifier COMPREHENSION-TLV * object. * * @param ctlv An Alpha Identifier COMPREHENSION-TLV object * @return String corresponding to the alpha identifier * @throws ResultException */ static String retrieveAlphaId(ComprehensionTlv ctlv) throws ResultException { if (ctlv != null) { byte[] rawValue = ctlv.getRawValue(); int valueIndex = ctlv.getValueIndex(); int length = ctlv.getLength(); if (length != 0) { try { return IccUtils.adnStringFieldToString(rawValue, valueIndex, length); } catch (IndexOutOfBoundsException e) { throw new ResultException(ResultCode.CMD_DATA_NOT_UNDERSTOOD); } } else { return CatService.STK_DEFAULT; } } else { return CatService.STK_DEFAULT; } } /** * Retrieves text from the Text COMPREHENSION-TLV object, and decodes it * into a Java String. * * @param ctlv A Text COMPREHENSION-TLV object * @return A Java String object decoded from the Text object * @throws ResultException */ static String retrieveTextString(ComprehensionTlv ctlv) throws ResultException { byte[] rawValue = ctlv.getRawValue(); int valueIndex = ctlv.getValueIndex(); byte codingScheme = 0x00; String text = null; int textLen = ctlv.getLength(); // In case the text length is 0, return a null string. if (textLen == 0) { return text; } else { // one byte is coding scheme textLen -= 1; } try { codingScheme = (byte) (rawValue[valueIndex] & 0x0c); if (codingScheme == 0x00) { // GSM 7-bit packed text = GsmAlphabet.gsm7BitPackedToString(rawValue, valueIndex + 1, (textLen * 8) / 7); } else if (codingScheme == 0x04) { // GSM 8-bit unpacked text = GsmAlphabet.gsm8BitUnpackedToString(rawValue, valueIndex + 1, textLen); } else if (codingScheme == 0x08) { // UCS2 text = new String(rawValue, valueIndex + 1, textLen, "UTF-16"); } else { throw new ResultException(ResultCode.CMD_DATA_NOT_UNDERSTOOD); } return text; } catch (IndexOutOfBoundsException e) { throw new ResultException(ResultCode.CMD_DATA_NOT_UNDERSTOOD); } catch (UnsupportedEncodingException e) { // This should never happen. throw new ResultException(ResultCode.CMD_DATA_NOT_UNDERSTOOD); } } }