Class RemoteCommandUtils

java.lang.Object
de.xima.fc.gui.common.utils.RemoteCommandUtils
public final class RemoteCommandUtils extends Object
Helper methods for <p:remoteCommand>, such as reading parameters and returning a value.
Since:
7.0.0
Author:
XIMA MEDIA GmbH

  • Method Details

    • addError

      public static void addError(Throwable e)
      Sets the success return value to false and also add the error message as a return parameter.
      Parameters:
      e - Exception that occurred.

    • addReturnValue

      public static void addReturnValue(String paramName, boolean value)
      Adds a return value for the remote command with the given parameter name. Also sets the success return parameter to true.
      Parameters:
      paramName - Name of the parameter, can be used on the client to access the parameter.
      value - Boolean value to be returned.

    • addReturnValue

      public static void addReturnValue(String paramName, int value)
      Adds a return value for the remote command with the given parameter name. Also sets the success return parameter to true.
      Parameters:
      paramName - Name of the parameter, can be used on the client to access the parameter.
      value - Integer value to be returned.

    • addReturnValue

      public static void addReturnValue(String paramName, long value)
      Adds a return value for the remote command with the given parameter name. Also sets the success return parameter to true.
      Parameters:
      paramName - Name of the parameter, can be used on the client to access the parameter.
      value - Long value to be returned.

    • addReturnValue

      public static void addReturnValue(String paramName, Object value)
      Adds a return value for the remote command with the given parameter name. Also sets the success return parameter to true.
      Parameters:
      paramName - Name of the parameter, can be used on the client to access the parameter.
      value - Value to be returned. This value is stringified.

    • addReturnValueJson

      public static void addReturnValueJson(String paramName, Object value)
      Adds a return value for the remote command with the given parameter name. Also sets the success return parameter to true. The value is converted to a JSON string.
      Parameters:
      paramName - Name of the parameter, can be used on the client to access the parameter.
      value - Value to be returned. This value is stringified.

    • addSuccess

      public static void addSuccess()
      Sets the success return parameter to true.

    • delayResponse

      public static void delayResponse(String delayId)
      Can be used when the response to a remote command cannot be computed synchronously. Must be given a delay ID that should be passed to resolveDelayed(String).
      Parameters:
      delayId - The delay ID that must be used to resolve the delayed remote command. Must be passed to resolveDelayed(String) or the client-side promise will never resolve

    • getAs

      public static <T> T getAs(String paramName, Function<String,T> parser)
      Gets the value of the parameter with the given name and parses it using the given parser.
      Type Parameters:
      T - Type to parse the parameter value to.
      Parameters:
      paramName - Name of the parameter to read.
      parser - Function to parse the parameter value.
      Returns:
      The parsed value of the parameter, or null if the parameter is not present or its value cannot be parsed.

    • getBoolean

      public static boolean getBoolean(String paramName)
      Parameters:
      paramName - Name of the parameter to read.
      Returns:
      The boolean value of the parameter, false when the parameter is not present.

    • getBooleanOptional

      public static Optional<Boolean> getBooleanOptional(String paramName)
      Parameters:
      paramName - Name of the parameter to read.
      Returns:
      The boolean value of the parameter, empty optional when the parameter is not present.

    • getEnum

      public static <T extends Enum<T>> T getEnum(String paramName, Class<T> enumType)
      Type Parameters:
      T - Type of the enum.
      Parameters:
      paramName - Name of the parameter to read.
      enumType - Type of the enum.
      Returns:
      The enum value of the parameter, or null when the parameter is not present or no such enum constant exists.

    • getInt

      public static OptionalInt getInt(String paramName)
      Parameters:
      paramName - Name of the parameter to read.
      Returns:
      The int value of the parameter, empty if no such parameter exists or it its not a valid int.

    • getInt

      public static int getInt(String paramName, int defaultValue)
      Parameters:
      paramName - Name of the parameter to read.
      defaultValue - Default value used when parameter does not exist or is not a valid int.
      Returns:
      The int value of the parameter, default value if no such parameter exists or it its not a valid int.

    • getJsonArray

      public static <T> List<T> getJsonArray(String paramName, Class<T> clazz)
      Type Parameters:
      T - Type to create from the JSON.
      Parameters:
      paramName - Name of the parameter to read.
      clazz - Type to create from the JSON.
      Returns:
      The value of the parameter parsed as a deserialized list, empty list if no such parameter exists or it is invalid.

    • getJsonObject

      public static com.alibaba.fastjson.JSONObject getJsonObject(String paramName)
      Parameters:
      paramName - Name of the parameter to read.
      Returns:
      The value of the parameter parsed as a JSON object, empty object if no such parameter exists or it is invalid.

    • getJsonObject

      public static <T> T getJsonObject(String paramName, Class<T> clazz)
      Type Parameters:
      T - Type to create from the JSON.
      Parameters:
      paramName - Name of the parameter to read.
      clazz - Type to create from the JSON.
      Returns:
      The value of the parameter parsed as a deserialized object, null if no such parameter exists or it is invalid.

    • getJsonObject

      public static <T> T getJsonObject(String paramName, Class<T> clazz, T defaultValue)
      Type Parameters:
      T - Type to create from the JSON.
      Parameters:
      paramName - Name of the parameter to read.
      clazz - Type to create from the JSON.
      defaultValue - Default value to return when the parameter could not be read.
      Returns:
      The value of the parameter parsed as a deserialized object, default value if no such parameter exists or it is invalid.

    • getJsonObject

      public static com.alibaba.fastjson.JSONObject getJsonObject(String paramName, com.alibaba.fastjson.JSONObject defaultValue)
      Parameters:
      paramName - Name of the parameter to read.
      defaultValue - Default value used when parameter does not exist or is invalid.
      Returns:
      The value of the parameter parsed as a JSON object, default value if no such parameter exists or it is invalid.

    • getListOfJsonObjects

      public static List<com.alibaba.fastjson.JSONObject> getListOfJsonObjects(String paramName)
      Parameters:
      paramName - Name of the parameter to read. Never null, only empty.
      Returns:
      A list of all values for the given parameter, parsed as a JSON object of the given class.

    • getListOfJsonObjects

      public static <T> List<T> getListOfJsonObjects(String paramName, Class<T> clazz)
      Type Parameters:
      T - Type to create from the JSON.
      Parameters:
      paramName - Name of the parameter to read. Never null, only empty.
      clazz - Type to create from the JSON.
      Returns:
      A list of all values for the given parameter, parsed as a JSON object of the given class.

    • getListOfLongs

      public static Optional<List<Long>> getListOfLongs(String paramName)
      Parameters:
      paramName - Name of the parameter to read. Never null, only empty.
      Returns:
      A list of all values for the given parameter.

    • getListOfStrings

      public static List<String> getListOfStrings(String paramName)
      Parameters:
      paramName - Name of the parameter to read. Never null, only empty.
      Returns:
      A list of all values for the given parameter.

    • getLocale

      public static Locale getLocale(String paramName)
      Parameters:
      paramName - Name of the parameter to read.
      Returns:
      The locale indicated by the parameter, or null if no such parameter exists.

    • getLocale

      public static Locale getLocale(String paramName, Locale defaultValue)
      Parameters:
      paramName - Name of the parameter to read.
      defaultValue - Default value used when parameter does not exist.
      Returns:
      The locale indicated by the parameter, or the default value if no such parameter exists.

    • getLong

      public static OptionalLong getLong(String paramName)
      Parameters:
      paramName - Name of the parameter to read.
      Returns:
      The long value of the parameter, empty if no such parameter exists or it its not a valid long.

    • getLong

      public static long getLong(String paramName, long defaultValue)
      Parameters:
      paramName - Name of the parameter to read.
      defaultValue - Default value used when parameter does not exist or is not a valid long.
      Returns:
      The long value of the parameter, default value if no such parameter exists or it its not a valid long.

    • getSemver

      public static Optional<com.vdurmont.semver4j.Semver> getSemver(String paramName, com.vdurmont.semver4j.Semver.SemverType type)
      Parameters:
      paramName - Name of the parameter to read.
      type - Semver type to use for parsing.
      Returns:
      The boolean value of the parameter, false when the parameter is not present.

    • getSemver

      public static com.vdurmont.semver4j.Semver getSemver(String paramName, com.vdurmont.semver4j.Semver.SemverType type, com.vdurmont.semver4j.Semver defaultValue)
      Parameters:
      paramName - Name of the parameter to read.
      type - Semver type to use for parsing.
      defaultValue - Default used when the value cannot be parsed as a semver.
      Returns:
      The boolean value of the parameter, false when the parameter is not present.

    • getSetOfStrings

      public static Set<String> getSetOfStrings(String paramName)
      Parameters:
      paramName - Name of the parameter to read. Never null, only empty.
      Returns:
      A set of all values for the given parameter.

    • getSetOfLongs

      public static Set<Long> getSetOfLongs(String paramName)
      Parameters:
      paramName - Name of the parameter to read. Never null, only empty.
      Returns:
      A set of all values for the given parameter.

    • getString

      public static String getString(String paramName)
      Parameters:
      paramName - Name of the parameter to read.
      Returns:
      The string value of the parameter, empty string if no such parameter exists.

    • getString

      public static String getString(String paramName, String defaultValue)
      Parameters:
      paramName - Name of the parameter to read.
      defaultValue - Default value used when parameter does not exist.
      Returns:
      The string value of the parameter, or the default value if no such parameter exists.

    • getStringOptional

      public static Optional<String> getStringOptional(String paramName)
      Parameters:
      paramName - Name of the parameter to read.
      Returns:
      The string value of the parameter, empty optional if no such parameter exists.

    • resolveDelayed

      public static void resolveDelayed(String delayId)
      Marks the response as the result for the given delay ID. Must be called after all other calls that add values, such as addSuccess(), addError(Throwable), addReturnValue(String, boolean) etc.
      Parameters:
      delayId - The delay ID that was passed to delayResponse(String).