参数

字符串参数

• 参数值需要在方法内部，通过代码获取，这些方法由args *route.ServiceArgs提供，具体如下：

  方法/说明
  GetStringParamWithCheck(paramName string, canBeNullOrEmpty bool) string
  获取字符串参数，canBeNullOrEmpty指定是否可以为空
  GetStringParam(paramName string) string
  获取字符串参数，可以为空
  GetStringParamWithDefault(paramName string, defaultValue string)
  获取字符串参数，可指定默认值

bool参数

• bool

  方法/说明
  GetBoolParam(paramName string) bool
  获取bool参数，不能为空
  GetBoolParamWithDefault(paramName string, defaultValue bool) (r bool)
  获取bool参数，可指定默认值

int参数

• int

  方法/说明
  GetIntParam(paramName string) int
  获取int参数，不能为空
  GetIntParamWithDefault(paramName string, defaultValue int) (r int)
  获取bool参数，可指定默认值

float参数

• float

  方法/说明
  GetFloatParam(paramName string) float64
  获取float参数，不能为空
  GetFloatParamWithDefault(paramName string, defaultValue float64) (r float64)
  获取float参数，可指定默认值

time参数

• time

  方法/说明
  GetDateTimeParam(paramName string) time.Time
  获取DateTime参数，不能为空
  GetDateTimeParamWithDefault(paramName string, defaultValue time.Time) (r time.Time)
  获取DateTime参数，可指定默认值
  GetDateParam(paramName string) time.Time
  获取Date参数，不能为空（只有日期部分）
  GetDateParamWithDefault(paramName string, defaultValue time.Time) (r time.Time)
  获取Date参数，可指定默认值
  GetBeginDateParam() time.Time
  获取开始日期（仅日期部分），获取不到d.IsZero()==true，对应参数名beginDate，格式2019-08-12
  GetEndDateParam() time.Time
  获取结束日期（仅日期部分，且加1天），获取不到d.IsZero()==true，对应参数名endDate，格式2019-08-12
  GetBeginDateTimeParam() time.Time
  获取开始日期时间
  GetEndDateTimeParam() time.Time
  获取结束日期时间

分页相关参数

• 分页

  方法/说明
  GetPageSizeParam() int
  获取参数：每页数据条数，默认20，最大100
  GetCurrentPageParam() int
  获取参数：当前页数，从1开始，默认为1，值小于1时重置为1

其他参数

• 其他

  方法/说明
  GetObjectParam(paramName string, obj interface{})
  获取一个对象，注意传入结构体指针，会解析json字符串并将结果写入对象
  GetIsMobile()
  是否从移动设备访问，对应参数isMobile=true
  GetIsApp() bool
  是否从app访问，对应参数isApp=true

packageResult

• 添加packageResult=false时，不会用JSONServiceResult对结果进行封装

convertResult

• 添加convertResult=false时，最终结果不会转换为json字符串，并且也不会用JSONServiceResult封装
  例如函数本来返回一个字符串aaa，packageResult=false时返回"aaa"， packageResult=false&convertResult=false时返回aaa

useJsonp

• useJsonp=true时，表示此条请求是跨域请求（前提是httpServer支持跨域）

jsonpCallback

• jsonpCallback：跨域时的回调函数名，如果使用jQuery请求，jQuery会默认传递参数callback，此时jsonpCallback可传可不传
• jsonpCallback参数优先级更高
• jsonpCallback、callback任一参数有值时，最终的json字符串还会做一次封装，比如jsonpCallback=aaa，则封装为aaa(jsonstr)。如果是使用jQuery，会被自动解析。