module Noir::TreeSitterKotlinParameterExtractor

Overview

Tree-sitter-backed parameter extractor for Kotlin Spring.

Mirrors TreeSitterJavaParameterExtractor for the Kotlin AST (parameter modifiers come before the parameter, primary constructor properties carry DTO fields, annotation arguments use value_arguments instead of annotation_argument_list).

Covered:

• @PathVariable (skipped — URL carries it)
• @RequestBody — defaults to "json" (or "form" via consumes=)
• @RequestParam(value/name = "x", defaultValue = "y") — query
• @RequestHeader(value/name = "x") — header, including HttpHeaders.X_FOO constant normalisation
• @CookieValue(name = "lorem", defaultValue = "ipsum") — cookie
• Primitive types (Long/Int/String/Boolean/MultipartFile) emit directly with the declared parameter name
• User-defined classes — DTO field expansion via the caller-supplied class_fields index. Kotlin DTOs are usually data class Foo(val a, var b) — properties live on the primary constructor and are all exposed as if they were public fields with synthesised setters.
• params = ["x=v"] and headers = ["X-H=v"] on the method's mapping annotation synthesise extra Params. params= for GET/HEAD/OPTIONS is "query"; otherwise "form" (matches Spring's dispatch convention).

Not covered yet (see #1298):

• HttpServletRequest body scan — Kotlin idiom rarely uses it.
• Meta-annotations (custom annotations composing @RequestMapping).

Extended Modules

• Noir::TreeSitterKotlinParameterExtractor

Defined in:

miniparsers/kotlin_parameter_extractor_ts.cr

Constant Summary

HTTP_HEADER_SPECIAL_CASES = {"Etag" => "ETag", "Te" => "TE", "Www-Authenticate" => "WWW-Authenticate", "X-Frame-Options" => "X-Frame-Options"}

PRIMITIVE_TYPES = Set {"long", "int", "integer", "short", "byte", "char", "boolean", "string", "float", "double", "number", "multipartfile"}

QUERY_VERB_PARAMS = Set {"GET", "HEAD", "OPTIONS"}

Verbs whose params = [...] constraint emits as query parameters. Anything else uses form data.

Instance Method Summary

• #extract_class_fields(source : String) : Hash(String, Array(FieldInfo))

  Extract {class_name => [FieldInfo]} from source.

• #extract_class_fields_from(root : LibTreeSitter::TSNode, source : String) : Hash(String, Array(FieldInfo))

  _from(root, source, ...) variants accept a pre-parsed root so the Kotlin Spring analyzer can amortise the tree-sitter parse across multiple extractions on the same file.

• #extract_consumes(source : String, class_name : String, method_name : String) : String | Nil

  Read consumes = ["..."] / consumes = arrayOf("...") off the method's mapping annotation.

• #extract_consumes_from(root : LibTreeSitter::TSNode, source : String, class_name : String, method_name : String) : String | Nil
• #extract_imports(source : String) : Array(ImportDecl)
• #extract_imports_from(root : LibTreeSitter::TSNode, source : String) : Array(ImportDecl)
• #extract_method_parameters(source : String, class_name : String, method_name : String, verb : String, parameter_format : String | Nil, class_fields : Hash(String, Array(FieldInfo))) : Array(Param)

  Walk method formal parameters + synthesised params=/headers= constraints on the method's mapping annotation.

• #extract_method_parameters_from(root : LibTreeSitter::TSNode, source : String, class_name : String, method_name : String, verb : String, parameter_format : String | Nil, class_fields : Hash(String, Array(FieldInfo))) : Array(Param)
• #extract_package_name(source : String) : String
• #extract_package_name_from(root : LibTreeSitter::TSNode, source : String) : String

Instance Method Detail