156ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson/* 256ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * Copyright (C) 2010 Google Inc. 356ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * 456ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * Licensed under the Apache License, Version 2.0 (the "License"); 556ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * you may not use this file except in compliance with the License. 656ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * You may obtain a copy of the License at 756ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * 856ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * http://www.apache.org/licenses/LICENSE-2.0 956ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * 1056ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * Unless required by applicable law or agreed to in writing, software 1156ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * distributed under the License is distributed on an "AS IS" BASIS, 1256ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 1356ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * See the License for the specific language governing permissions and 1456ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * limitations under the License. 1556ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson */ 1656ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson 1756ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodsonpackage com.google.clearsilver.jsilver.data; 1856ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson 1956ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson 2056ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson/** 2156ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * Static methods for converting stuff in a ClearSilver compatible way. 2256ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson */ 2356ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodsonpublic class TypeConverter { 2456ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson private TypeConverter() {} 2556ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson 2656ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson private static final String ZERO = "0"; 2756ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson private static final String ONE = "1"; 2856ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson 2956ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson /** 3056ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * Determines if the given data node exists in a ClearSilver compatible way. 3156ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson */ 3256ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson public static boolean exists(Data data) { 3356ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson return data != null && data.getValue() != null; 3456ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson } 3556ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson 3656ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson /** 3756ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * Helper method to safely convert an arbitrary data instance (including null) into a valid 3856ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * (non-null) string representation. 3956ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson */ 4056ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson public static String asString(Data data) { 4156ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson // Non-existent variables become the empty string 4256ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson // (the data instance will return null to us) 4356ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson String value = data != null ? data.getValue() : null; 4456ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson return value != null ? value : ""; 4556ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson } 4656ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson 4756ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson /** 4856ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * Parses a non-null string in a ClearSilver compatible way. 4956ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * 5056ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * The is the underlying parsing function which can fail for badly formatted strings. It is really 5156ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * important that anyone doing parsing of strings calls this function (rather than doing it 5256ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * themselves). 5356ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * 5456ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * This is an area where JSilver and ClearSilver have some notable differences. ClearSilver relies 5556ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * on the template compiler to parse strings in the template and a different parser at runtime for 5656ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * HDF values. JSilver uses the same code for both cases. 5756ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * 5856ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * In ClearSilver HDF: Numbers are parsed sequentially and partial results are returned when an 5956ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * invalid character is reached. This means that {@code "123abc"} parses to {@code 123}. 6056ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * 6156ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * Additionally, ClearSilver doesn't do hex in HDF values, so {@code "a.b=0x123"} will just 6256ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * resolve to {@code 0}. 6356ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * 6456ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * In ClearSilver templates: Hex is supported, including negative values. 6556ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * 6656ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * In JSilver: A string must be a complete, valid numeric value for parsing. This means {@code 6756ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * "123abc"} is invalid and will default to {@code 0}. 6856ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * 6956ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * In JSilver: Positive hex values are supported for both HDF and templates but negative values 7056ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * aren't. This means a template containing something like "<?cs if:foo == -0xff ?>" will parse 7156ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * correctly but fail to render. 7256ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * 7356ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * @throws NumberFormatException is the string is badly formatted 7456ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson */ 7556ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson public static int parseNumber(String value) throws NumberFormatException { 7656ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson // NOTE: This is likely to be one of the areas we will want to optimize 7756ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson // for speed eventually. 7856ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson if (value.startsWith("0x") || value.startsWith("0X")) { 7956ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson return Integer.parseInt(value.substring(2), 16); 8056ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson } else { 8156ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson return Integer.parseInt(value); 8256ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson } 8356ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson } 8456ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson 8556ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson /** 8656ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * Parses and returns the given string as an integer in a ClearSilver compatible way. 8756ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson */ 8856ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson public static int asNumber(String value) { 8956ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson if (value == null || value.isEmpty()) { 9056ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson return 0; 9156ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson } 9256ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson // fast detection for common constants to avoid parsing common values 9356ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson // TODO: Maybe push this down into parseNumber ?? 9456ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson if (value.equals(ONE)) { 9556ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson return 1; 9656ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson } 9756ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson if (value.equals(ZERO)) { 9856ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson return 0; 9956ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson } 10056ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson try { 10156ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson return parseNumber(value); 10256ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson } catch (NumberFormatException e) { 10356ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson return 0; 10456ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson } 10556ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson } 10656ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson 10756ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson /** 10856ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * Helper method to safely convert an arbitrary data instance (including null) into a valid 10956ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * integer representation. 11056ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson */ 11156ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson public static int asNumber(Data data) { 11256ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson // Non-existent variables become zero 11356ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson return data != null ? data.getIntValue() : 0; 11456ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson } 11556ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson 11656ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson /** 11756ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * Parses and returns the given string as a boolean in a ClearSilver compatible way. 11856ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson */ 11956ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson public static boolean asBoolean(String value) { 12056ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson if (value == null || value.isEmpty()) { 12156ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson return false; 12256ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson } 12356ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson // fast detection for common constants to avoid parsing common values 12456ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson if (value.equals(ONE)) { 12556ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson return true; 12656ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson } 12756ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson if (value.equals(ZERO)) { 12856ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson return false; 12956ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson } 13056ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson 13156ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson // fast detection of any string not starting with '0' 13256ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson if (value.charAt(0) != '0') { 13356ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson return true; 13456ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson } 13556ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson 13656ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson try { 13756ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson return parseNumber(value) != 0; 13856ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson } catch (NumberFormatException e) { 13956ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson // Unlike number parsing, we return a positive value when the 14056ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson // string is badly formatted (it's what clearsilver does). 14156ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson return true; 14256ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson } 14356ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson } 14456ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson 14556ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson /** 14656ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * Helper method to safely convert an arbitrary data instance (including null) into a valid 14756ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * boolean representation. 14856ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson */ 14956ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson public static boolean asBoolean(Data data) { 15056ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson // Non-existent variables become false 15156ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson return data != null ? data.getBooleanValue() : false; 15256ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson } 15356ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson} 154