Add emphasis styling for detail-view action buttons, and normalize non-error statuses to 404 in RestContext.handleNotFound. Detail-view action buttons (juneau-rest-server-widgets / juneau-rest-server-views): ActionRef gains an Emphasis enum (SECONDARY default, PRIMARY) via a new emphasis(...) builder method; ActionBar.validate() accepts it without moving CONTRACT_VERSION off "1". ViewTable's emitActionBar stamps the emphasis onto the rendered button, and juneau-views.css adds the .juneau-view-detail-action recipe plus its -primary variant and :hover/:disabled/[hidden] states -- settling the PROVISIONAL chrome-scale tokens the recipe depends on. ActionBar_Test, ViewTable_RowDetail_Emit_Test and DetailFieldGrid_Emit_Test gain or adjust cases (DetailFieldGrid_Emit_Test.c06 is inverted from asserting two tokens are still PROVISIONAL to asserting they no longer are, since this change is the sweep its own name predicted); a new RowDetail_ActionButton_BrowserTest plus detail-action-button-browser.cjs pin the rendered result in a real browser. Board item TODO-J0452, wave WAVE-0007. juneau-rest-server: RestContext.handleNotFound now treats any non-error status code (< 400 -- e.g. a real servlet container's spec default of 200, or MockServletResponse's coincidental default of 0) as a 404 instead of falling through to a generic "Invalid method response" 500 ServletException, so an unmatched request path can no longer surface as an HTTP 500 in production. RestSession's javadoc is updated to describe the new normalization, and a new RestContext_HandleNotFound_Test adds regression coverage for both status defaults plus the pre-existing 404/412/405/500 branches. This is a concurrent session's work, staged and reviewed by the operator alongside the item above; it is unrelated to WAVE-0007 / TODO-J0452.
📢 Documentation Update
This README has been updated to reflect our new Docusaurus-based documentation site. For the most current documentation, please visit the official Apache Juneau website.
Apache Juneau™ is a single cohesive Java ecosystem consisting of a comprehensive toolkit for marshalling POJOs to a wide variety of content types using a common framework, along with universal REST server and client APIs for creating Swagger-based self-documenting REST interfaces.
⚠️ Upgrading from 9.x? The project is currently developing the 10.0.0 release, which includes a number of breaking changes (the public
ObjectRestclass removed,SerializerSet/ParserSetlookups now returningOptional, the next-genRestClientno longer implicitly defaulting to JSON, thejuneau-assertions/juneau-bct/juneau-junit5modules merged into a singlejuneau-testartifact, and the legacyjuneau-my-jetty-microservice/juneau-examples-restmodules removed, among others). See the 10.0.0 Migration Guide for the full list before upgrading.
2025-06-18 and 2026-07-28 protocol revisionsApache Juneau ships first-party MCP integration, built the same way as the rest of the framework: annotation-driven, POJO-based, no magic. The module family is split into revision-neutral cores plus thin adapters per protocol revision, so a 2025-06-18-only deployment never pulls in 2026-07-28-only dependencies (OAuth 2.1, JWT, reactive-streams SSE, etc.):
juneau-bean-mcp-v20250618 / juneau-bean-mcp-v20260728 adapters for each revision's wire beans.juneau-rest-server-mcp-v20250618 / juneau-rest-server-mcp-v20260728 adapters for exposing tools, prompts, and resources (dedicated servlet or drop-in mixin, plain or Spring Boot).juneau-rest-client-mcp-v20250618 / juneau-rest-client-mcp-v20260728 typed client facades, plus juneau-rest-client-mcp-auth for the client-side OAuth 2.1 acquisition flow.The 2026-07-28 revision is a strict superset of 2025-06-18 and is where new capability work (Multi-Round-Trip Requests/elicitation, subscriptions, cache hints, trace-context propagation) lands going forward. See MCP (Model Context Protocol) for the quickstart, setup guide, and full API reference.
Note: The documentation is automatically updated and provides the most current project information.
Apache Juneau™ excels in the following scenarios:
<dependency> <groupId>org.apache.juneau</groupId> <artifactId>juneau-shaded-all</artifactId> <version>10.0.0-SNAPSHOT</version> </dependency>
10.0.0is currently under development (tracking-SNAPSHOTbuilds) and has not yet been released. See the Downloads page for the latest released version.
import org.apache.juneau.json.*; public class QuickStart { public static void main(String[] args) { // Create a simple POJO Person person = new Person("John", 30); // Serialize to JSON String json = Json.of(person); System.out.println(json); // Output: {"name":"John","age":30} } public static class Person { public String name; public int age; public Person(String name, int age) { this.name = name; this.age = age; } } }
// Parse JSON back to POJO Person parsed = Json.to(json, Person.class); System.out.println(parsed.name); // Output: John
import org.apache.juneau.rest.*; import org.apache.juneau.rest.servlet.*; @Rest( title="Hello World API", description="Simple REST API example" ) public class HelloWorldResource extends BasicRestServlet { @RestGet("/hello/{name}") public String sayHello(@Path String name) { return "Hello " + name + "!"; } @RestGet("/person") public Person getPerson() { return new Person("Jane", 25); } }
import org.apache.juneau.rest.mock.*; public class ApiTest { @Test public void testHello() throws Exception { String response = MockRestClient .create(HelloWorldResource.class) .json5() .build() .get("/hello/World") .run() .assertStatus().is(200) .getContent().asString(); assertEquals("Hello World!", response); } }
That's it! You now have:
juneau-config for INI-style configsjuneau-rest-server-springbootimport org.apache.juneau.xml.*; // Serialize to XML String xml = Xml.of(person); System.out.println(xml); // Output: <object><name>John</name><age>30</age></object> // Parse XML back to POJO Person parsed = Xml.to(xml, Person.class);
import org.apache.juneau.html.*; // Serialize to HTML table String html = Html.of(person); System.out.println(html); // Output: <table><tr><th>name</th><td>John</td></tr><tr><th>age</th><td>30</td></tr></table>
import org.apache.juneau.config.*; // Create configuration Config config = Config.create() .set("database.host", "localhost") .set("database.port", 5432) .set("features.enabled", true) .build(); // Read configuration String host = config.get("database.host"); int port = config.get("database.port", Integer.class); boolean enabled = config.get("features.enabled", Boolean.class);
import org.apache.juneau.rest.client.*; import org.apache.juneau.http.*; // Define REST interface @Remote("http://api.example.com") public interface UserService { @Get("/users/{id}") User getUser(@Path String id); @Post("/users") User createUser(@Body User user); } // Use as regular Java interface UserService service = RestClient.create().build().getRemote(UserService.class); User user = service.getUser("123");
import org.apache.juneau.rest.mock.*; // Test without starting a server @Test public void testUserAPI() throws Exception { String response = MockRestClient .create(UserResource.class) .json5() .build() .get("/users/123") .run() .assertStatus().is(200) .getContent().asString(); assertThat(response).contains("John"); }
import org.apache.juneau.microservice.*; // Create microservice Microservice microservice = Microservice.create() .servlet(UserResource.class) .port(8080) .build(); // Start server microservice.start();
Apache Juneau™ is a single cohesive Java ecosystem consisting of the following parts, grouped by aggregator module. For the complete, always-current per-artifact list, see the Juneau Ecosystem Overview.
juneau-assertions/juneau-bct/juneau-junit5 artifacts).juneau-bean-mcp-* adapters.)GitControl, etc.).SecretStore implementation backed by the macOS security keychain CLI (implements the SecretStore SPI in juneau-commons).Questions via email to dev@juneau.apache.org are always welcome.
Juneau is packed with features that may not be obvious at first. Users are encouraged to ask for code reviews by providing links to specific source files such as through GitHub. Not only can we help you with feedback, but it helps us understand usage patterns to further improve the product.
This repository uses multiple branches to separate different concerns:
master - Contains the main source code for Apache Juneaudocs - Contains the Docusaurus-based documentation siteasf-staging - Contains the staging/preview version of the websiteasf-site - Contains the production version of the websiteWhen working with the repository, ensure you're on the correct branch for your task:
master branchdocs branchasf-staging and asf-site branches are automatically updated during the release processBuilding requires: