unit-test-controller-layer

Unit testing REST controllers in isolation with MockMvc and mocked service dependencies.

giuseppe-trisciuoglio/developer-kit|Updated Apr 8, 2026

Works with

Claude CodeCursorClineWindsurfCodexGoose

What it does

Covers testing all HTTP methods (GET, POST, PUT, PATCH, DELETE) with status code and response body validation using JsonPath assertions
Includes patterns for request parameter binding, validation errors, exception handling, and content negotiation across different Accept and Content-Type headers
Uses standalone MockMvc setup with Mockito to mock service layer dependencies, keeping tests focused o

Repository

giuseppe-trisciuoglio/developer-kit

Last updated

Apr 8, 2026

Installation Guide

Select your AI agent

How to use unit-test-controller-layer on Cursor

AI-first code editor with Composer

Prerequisites

Before installing skills in Cursor, ensure your development environment meets these requirements:

›Cursor installed and configured on your machine
›Node.js 16+ with npm — verify with node --version
›Active project directory where you want to add unit-test-controller-layer

Run the install command

Execute the skills CLI command in your project's root directory to begin installation:

$npx skills add https://github.com/giuseppe-trisciuoglio/developer-kit --skill unit-test-controller-layer

Fetches unit-test-controller-layer from giuseppe-trisciuoglio/developer-kit and configures it for Cursor.

Select Cursor when prompted

The CLI shows a list of agents. Use arrow keys and space to select Cursor:

◆ Which agents do you want to install to?

│

│ ── Universal (.agents/skills) ────────────────

│ · Cline · Codex · Goose · Windsurf

│ ●Cursor(selected)

│ · Cursor · Aider · Continue

Verify installation

Confirm successful installation by checking the skill directory location:

.cursor/skills/unit-test-controller-layer

Restart Cursor to activate unit-test-controller-layer. Access via /unit-test-controller-layer in your agent's command palette.

⚠

Security Notice

We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.

Skills execute code in your environment. Always review source, verify the publisher, and test in isolation before production.

›View source on GitHub ›Skills CLI docs ›About Cursor ›What are agent skills?

Documentation

List & Monetize Your Skill

Submit your Claude Code skill and start earning

Get started →

Use Cases

Task Automation & Efficiency

Automate repetitive workflows and reduce manual effort

Example

Generate reports, summarize documents, draft communications

✓

Save 3-5 hours per week on routine tasks

Knowledge Enhancement

Learn new skills, understand complex topics, get expert guidance

Example

Explain concepts, provide examples, suggest learning resources

✓

Accelerate learning and skill development by 2x

Quality Improvement

Enhance output quality through reviews, suggestions, and refinements

Example

Review drafts, suggest improvements, catch errors

✓

Improve work quality by 30-40% with less effort

Instructions

Setup standalone MockMvc: MockMvcBuilders.standaloneSetup(controller) for isolated testing

Mock service dependencies: Use @Mock for all services, @InjectMocks for the controller

Test HTTP methods: GET, POST, PUT, PATCH, DELETE with correct status codes

Validate responses: JsonPath assertions for JSON, content matchers for body

Test validation: Send invalid input, verify 400 status with error details

Test errors: Verify 404, 400, 401, 403, 500 for appropriate conditions

Validate headers: Both request (Authorization) and response headers

Test content negotiation: Different Accept and Content-Type headers

Validation Workflow

Run test → If fails: add .andDo(print()) → Check actual vs expected → Fix assertion

Examples

Maven / Gradle Dependencies

<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-test</artifactId> <scope>test</scope> </dependency>

Basic Pattern: GET Endpoint

import static org.mockito.Mockito.*; import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.*; import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.*; @ExtendWith(MockitoExtension.class) class UserControllerTest { @Mock private UserService userService; @InjectMocks private UserController userController; private MockMvc mockMvc; @BeforeEach void setUp() { mockMvc = MockMvcBuilders.standaloneSetup(userController).build(); } @Test void shouldReturnAllUsers() throws Exception { List<UserDto> users = List.of(new UserDto(1L, "Alice"), new UserDto(2L, "Bob")); when(userService.getAllUsers()).thenReturn(users); mockMvc.perform(get("/api/users")) .andExpect(status().isOk()) .andExpect(jsonPath("$[0].id").value(1)) .andExpect(jsonPath("$[0].name").value("Alice")); verify(userService, times(1)).getAllUsers(); } @Test void shouldReturn404WhenUserNotFound() throws Exception { when(userService.getUserById(999L)) .thenThrow(new UserNotFoundException("User not found")); mockMvc.perform(get("/api/users/999")) .andExpect(status().isNotFound()); verify(userService).getUserById(999L); } }

POST: Create Resource

@Test void shouldCreateUserAndReturn201() throws Exception { UserDto createdUser = new UserDto(1L, "Alice", "[email protected]"); when(userService.createUser(any())).thenReturn(createdUser); mockMvc.perform(post("/api/users") .contentType("application/json") .content("{\"name\":\"Alice\",\"email\":\"[email protected]\"}")) .andExpect(status().isCreated()) .andExpect(jsonPath("$.id").value(1)) .andExpect(jsonPath("$.name").value("Alice")); verify(userService).createUser(any(UserCreateRequest.class)); }

PUT: Update Resource

@Test void shouldUpdateUserAndReturn200() throws Exception { UserDto updatedUser = new UserDto(1L, "Updated"); when(userService.updateUser(eq(1L), any())).thenReturn(updatedUser); mockMvc.perform(put("/api/users/1") .contentType("application/json") .content("{\"name\":\"Updated\"}")) .andExpect(status().isOk()) .andExpect(jsonPath("$.name").value("Updated"<

unit-test-controller-layer

What it does

Category

Repository

Last updated

Installation Guide

How to use unit-test-controller-layer on Cursor

Prerequisites

Run the install command

Select Cursor when prompted

Verify installation

Security Notice

Documentation

List & Monetize Your Skill

Use Cases

Task Automation & Efficiency

Knowledge Enhancement

Quality Improvement

Install Skill

Unit Testing REST Controllers with MockMvc

Overview

When to Use

Instructions

Validation Workflow

Examples

Maven / Gradle Dependencies

Basic Pattern: GET Endpoint

POST: Create Resource

PUT: Update Resource

Implementation Guide

Best Practices

When to Use This

Learning Path

Related Skills

tailwind-css-patterns

nextjs-code-review

drizzle-orm-patterns

nestjs-best-practices

graalvm-native-image

polyglot-test-agent

Reviews

Discussion

`Implementation Guide`

`Best Practices`

`When to Use This`

`Learning Path`

`Related Skills`

`Reviews`

`Discussion`