Package ca.bc.gov.open.cpf.plugin.api

Annotation Type JobParameter

  • @Retention(RUNTIME)
@Target(METHOD)
public @interface JobParameter

    The JobParameter method annotation indicates that a setXXX method is a parameter that will be applied to all requests in a job on a BusinessApplicationPlugin class.

    Job parameters are implemented as Java bean properties on the plug-in class. The plug-in must implement a setXXX property method for each job parameter. The job parameter name is the name of the Java bean property. The parameter type can only use the supported data types. The job parameters will be converted by the CPF from the input data to the correct Java type.

    Before execution of the plug-in the job methods will be invoked to set the job parameter values.

    A JobParameter method can also be marked as a RequestParameter if the parameter can be specified either at the job or request level.

    The following example shows the use of the annotation.

    private String algorithmName;

@JobParameter
public void setAlgorithmName(final String algorithmName) {
  this.algorithmName = algorithmName;
}

    • Optional Element Summary

      Optional Elements 
      Modifier and Type Optional Element Description
      String description
      The description of the job parameter to display on the plug-in overview page and as instructions on the create job forms.
      String descriptionUrl
      The url to a page that describes the parameter in greater detail than is possible on the form.
      int index
      The index (position) of the job parameter in the input file form.
      int length
      The maximum length of the job parameter including the scale.
      String maxValue
      The maximum allowed value for numeric parameters.
      String minValue
      The minimum allowed value for numeric parameters.
      int scale
      The number of decimal places for fixed precision numeric types.
      String units
      The units of measurement for numeric fields (e.g.

    • Element Detail

      • description

        String description
        The description of the job parameter to display on the plug-in overview page and as instructions on the create job forms.
        Default:
        ""

      • descriptionUrl

        String descriptionUrl
        The url to a page that describes the parameter in greater detail than is possible on the form. If specified the name of the parameter will be a hyper-link to this URL.
        Default:
        ""

      • index

        int index
        The index (position) of the job parameter in the input file form.
        Default:
        -1

      • length

        int length
        The maximum length of the job parameter including the scale. This is ignored for fixed size data types such as boolean, byte, short, int, long, float and double. The value -1 indicates no defined limit to the scale.
        Default:
        -1

      • maxValue

        String maxValue
        The maximum allowed value for numeric parameters. The string value will be converted to the correct data type.
        Default:
        ""

      • minValue

        String minValue
        The minimum allowed value for numeric parameters. The string value will be converted to the correct data type.
        Default:
        ""

      • scale

        int scale
        The number of decimal places for fixed precision numeric types.
        Default:
        -1

      • units

        String units
        The units of measurement for numeric fields (e.g. metres, feet, degrees). This will be displayed after the field on the form.
        Default:
        ""