Field Detail

• private static final java.util.regex.Pattern cmdUrlPattern

• private static final java.util.regex.Pattern cmdUrlPattern2

• private static final java.util.Map<java.lang.String, java.lang.reflect.Method> methodMap

• private final javax.servlet.ServletConfig servletConfig

• private final org.springframework.context.ApplicationContext springAppCtx

Constructor Detail

• ConfigurationProvider(javax.servlet.ServletConfig servletConfig)

Method Detail

• java.lang.Object callController(java.lang.Object controller, javax.servlet.http.HttpServletRequest request, java.lang.String json)

  Read the JSON request (susceptible to Exceptions that are allowed to be thrown from here), and then call the appropriate Controller method. The controller method exceptions are caught and returned carefully as JSON error String responses. Note, this should not happen - if they do, it is a case of a missing try/catch handler in a Controller method (or Advice around the Controller).

• protected static java.lang.Object[] convertArgs(java.lang.reflect.Method method, java.lang.Object[] args)

  Convert the passed in arguments to match the arguments of the passed in method.

  Parameters:

  method - Method which contains argument types.

  args - Object[] of values, which need to be converted.

  Returns:

  Object[] of converted values. The original values from args[], will be converted to match the argument types in the method. Java-util's Converter.convert() handles the primitive and simple types (date, etc.). Collections and Arrays will be converted to match the respective argument type, and Maps will be converted to classes (if the matching argument is not a Map). This is done by bring the Class type of the argument into the json-io JsonObject which represents the instance of the class.

• static java.lang.Object getArguments(java.lang.String json, java.lang.String controllerName, java.lang.String methodName)

  Build the argument list from the passed in json

  Parameters:

  json - String argument lists

  controllerName - String name of controller

  methodName - String name of method to call on the controller

  Returns:

  Object[] of arguments to be passed to method, or Envelope if an error occurred.

• protected java.lang.Object getController(java.lang.String name)

  Fetch the controller with the given name.

  Parameters:

  name - String name of a Controller instance (Spring bean name).

  Returns:

  Controller instance if successful, otherwise throw BeansException if controller bean doesn't exist or IllegalArgumentException if class isn't annotated as a controller

• protected static java.lang.reflect.Method getMethod(java.lang.Object controller, java.lang.String controllerName, java.lang.String methodName, int argCount)

  Fetch the named method from the controller. First a local cache will be checked, and if not found, the method will be found reflectively on the controller. If the method is found, then it will be checked for a ControllerMethod annotation, which can indicate that it is NOT allowed to be called. This permits a public controller method to be blocked from remote access.

  Parameters:

  controller - Object on which the named method will be found.

  controllerName - String name of the controller (Spring name, n-cube name, etc.)

  methodName - String name of method to be located on the controller.

  argCount - int number of arguments. This is used as part of the cache key to allow for duplicate method names as long as the argument list length is different.

• protected static java.lang.reflect.Method getMethod(java.lang.Class c, java.lang.String name, int argc)

  Reflectively find the requested method on the requested class.

  Parameters:

  c - Class containing the method

  name - String method name

  argc - int number of arguments

  Returns:

  Method instance located on the passed in class.

• javax.servlet.ServletConfig getServletConfig()

• static java.util.regex.Matcher getUrlMatcher(javax.servlet.http.HttpServletRequest request)

  Get a regex Matcher that matches the URL String for /context/cmd/controller/method

  Parameters:

  request - HttpServletRequest passed to the command servlet.

  json - String arguments in JSON form from HTTP request

  Returns:

  Matcher that pattern matches the URL or

• static java.util.Map objectToMap(java.lang.Object o)

  Convert an Object to a Map. This allows an object to then be passed into n-cube as a coordinate. Of course the returned map can have additional key/value pairs added to it after calling this method, but before calling getCell().

  Parameters:

  o - Object any Java object to bind to an NCube.

  Returns:

  Map where the fields of the object are the field names from the class, and the associated values are the values associated to the fields on the object.