This repository has been archived on 2026-11-17. You can view files and clone it, but cannot push or open issues or pull requests.
gitgram-ai/aitimemachine/gitnexus/test/unit/java-spring-route-ingestion.test.ts
caelum0x 49b183818c Unify gitgram + aitimemachine into the monorepo (de-submodule) and merge vendored engines
Convert gitgram/ and aitimemachine/ from embedded git repos (which showed as
opaque submodule gitlinks on GitHub) into fully-tracked first-party content.

AITM now merges its 7 vendored repos as first-party engines:
- memory: beads (Go task DAG) + context7 (docs SDK), unified into saved_contexts
- git: vendored C git (bundled binary) + gitnexus (in-process code intelligence)
- agentic: a2a (@a2a-js/sdk) + pal (AITM-managed Python subprocess)

Includes the full session's product build: Gitgram web/mobile/backend features,
AITM website/CLI/MCP, the unified memory layer, engine build tooling
(scripts/build-engines.sh, Dockerfile, CI), docs (README, ENGINES.md, ARCHITECTURE.md),
and extensive test suites.

Build artifacts, node_modules, external/, and gemini-cli are gitignored.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-23 14:14:09 +03:00

243 lines
7.0 KiB
TypeScript

/**
* Unit test: Java Spring @RequestMapping / @GetMapping route extraction
* via the dedicated `route-extractors/spring.ts` module.
*
* Tests the extractSpringRoutes function directly (no worker pool needed)
* and validates per-class prefix resolution, multi-class handling, and
* all HTTP method annotations.
*/
import { describe, it, expect } from 'vitest';
import Parser from 'tree-sitter';
import Java from 'tree-sitter-java';
import { extractSpringRoutes } from '../../src/core/ingestion/route-extractors/spring.js';
function parse(code: string): Parser.Tree {
const parser = new Parser();
parser.setLanguage(Java);
return parser.parse(code);
}
describe('extractSpringRoutes', () => {
it('extracts method-level routes with class-level @RequestMapping prefix', () => {
const tree = parse(`
@RestController
@RequestMapping("/api/users")
public class UserController {
@GetMapping("/list")
public List<User> listUsers() { return null; }
@PostMapping("/create")
public User createUser() { return null; }
@DeleteMapping(path = "/delete")
public void deleteUser() {}
@PutMapping(value = "/update")
public void updateUser() {}
@PatchMapping("/patch")
public void patchUser() {}
}
`);
const routes = extractSpringRoutes(tree, 'UserController.java');
expect(routes).toHaveLength(5);
const byMethod = new Map(routes.map((r) => [r.httpMethod, r]));
expect(byMethod.get('GET')!.routePath).toBe('/list');
expect(byMethod.get('GET')!.prefix).toBe('/api/users');
expect(byMethod.get('POST')!.routePath).toBe('/create');
expect(byMethod.get('POST')!.prefix).toBe('/api/users');
expect(byMethod.get('DELETE')!.routePath).toBe('/delete');
expect(byMethod.get('DELETE')!.prefix).toBe('/api/users');
expect(byMethod.get('PUT')!.routePath).toBe('/update');
expect(byMethod.get('PUT')!.prefix).toBe('/api/users');
expect(byMethod.get('PATCH')!.routePath).toBe('/patch');
expect(byMethod.get('PATCH')!.prefix).toBe('/api/users');
});
it('emits bare routes when no class-level @RequestMapping exists', () => {
const tree = parse(`
@RestController
public class HealthController {
@GetMapping("/health")
public String health() { return "OK"; }
@GetMapping("/ready")
public String ready() { return "OK"; }
}
`);
const routes = extractSpringRoutes(tree, 'HealthController.java');
expect(routes).toHaveLength(2);
for (const route of routes) {
expect(route.prefix).toBeUndefined();
}
const paths = routes.map((r) => r.routePath).sort();
expect(paths).toEqual(['/health', '/ready']);
});
it('does NOT emit class-level @RequestMapping as a standalone Route', () => {
const tree = parse(`
@RestController
@RequestMapping("/api/users")
public class UserController {
@GetMapping("/list")
public List<User> listUsers() { return null; }
}
`);
const routes = extractSpringRoutes(tree, 'UserController.java');
// Only the method-level route, not the class-level prefix
expect(routes).toHaveLength(1);
expect(routes[0].decoratorName).toBe('GetMapping');
});
it('handles multiple classes in one file with independent prefixes', () => {
const tree = parse(`
@RestController
@RequestMapping("/api/admin")
class AdminController {
@GetMapping("/dashboard")
public String dashboard() { return "admin"; }
}
@RestController
@RequestMapping("/api/public")
class PublicController {
@GetMapping("/info")
public String info() { return "public"; }
}
`);
const routes = extractSpringRoutes(tree, 'MultiController.java');
expect(routes).toHaveLength(2);
const adminRoute = routes.find((r) => r.routePath === '/dashboard');
expect(adminRoute).toBeDefined();
expect(adminRoute!.prefix).toBe('/api/admin');
const publicRoute = routes.find((r) => r.routePath === '/info');
expect(publicRoute).toBeDefined();
expect(publicRoute!.prefix).toBe('/api/public');
});
it('supports @PatchMapping (previously missing)', () => {
const tree = parse(`
@RestController
@RequestMapping("/api")
public class PatchController {
@PatchMapping("/update")
public void patch() {}
}
`);
const routes = extractSpringRoutes(tree, 'PatchController.java');
expect(routes).toHaveLength(1);
expect(routes[0].httpMethod).toBe('PATCH');
expect(routes[0].routePath).toBe('/update');
expect(routes[0].prefix).toBe('/api');
});
it('handles named annotation arguments with path= and value=', () => {
const tree = parse(`
@RestController
@RequestMapping(value = "/api/v2")
public class V2Controller {
@GetMapping(path = "/items")
public String items() { return "[]"; }
@PostMapping(value = "/items")
public String createItem() { return "{}"; }
}
`);
const routes = extractSpringRoutes(tree, 'V2Controller.java');
expect(routes).toHaveLength(2);
for (const route of routes) {
expect(route.prefix).toBe('/api/v2');
expect(route.routePath).toBe('/items');
}
});
it('ignores non-route named args like produces/consumes', () => {
const tree = parse(`
@RestController
@RequestMapping("/api")
public class MediaController {
@GetMapping(value = "/json", produces = "application/json")
public String json() { return "{}"; }
}
`);
const routes = extractSpringRoutes(tree, 'MediaController.java');
// Should only extract the route path, not the produces value
expect(routes).toHaveLength(1);
expect(routes[0].routePath).toBe('/json');
expect(routes[0].prefix).toBe('/api');
});
it('does not bleed prefix across unrelated classes', () => {
const tree = parse(`
@RestController
@RequestMapping("/api/v1")
class V1Controller {
@GetMapping("/old")
public String old() { return "v1"; }
}
@RestController
class NoPrefix {
@GetMapping("/bare")
public String bare() { return "no prefix"; }
}
@RestController
@RequestMapping("/api/v3")
class V3Controller {
@GetMapping("/new")
public String newer() { return "v3"; }
}
`);
const routes = extractSpringRoutes(tree, 'Multi.java');
expect(routes).toHaveLength(3);
const v1 = routes.find((r) => r.routePath === '/old');
expect(v1!.prefix).toBe('/api/v1');
const bare = routes.find((r) => r.routePath === '/bare');
expect(bare!.prefix).toBeUndefined();
const v3 = routes.find((r) => r.routePath === '/new');
expect(v3!.prefix).toBe('/api/v3');
});
it('reports correct line numbers', () => {
const tree = parse(`@RestController
@RequestMapping("/api")
public class LineTest {
@GetMapping("/first")
public String first() { return "1"; }
@PostMapping("/second")
public String second() { return "2"; }
}
`);
const routes = extractSpringRoutes(tree, 'LineTest.java');
expect(routes).toHaveLength(2);
// @GetMapping is on line index 3 (0-based)
const first = routes.find((r) => r.routePath === '/first');
expect(first!.lineNumber).toBe(3);
// @PostMapping is on line index 6
const second = routes.find((r) => r.routePath === '/second');
expect(second!.lineNumber).toBe(6);
});
});