| commit | 9814f577cd29518c64028f521503aa1e6fbb4272 | [log] [tgz] |
|---|---|---|
| author | James Bognar <james.bognar@salesforce.com> | Wed Oct 22 09:52:19 2025 -0400 |
| committer | James Bognar <james.bognar@salesforce.com> | Wed Oct 22 09:52:19 2025 -0400 |
| tree | bbf179845784d54d9bae87bb6cea28969f404164 | |
| parent | 71abbb46f5f1da4ee0d13cc9f26ab1d222650ec3 [diff] |
Utility class cleanup
📢 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.
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>9.1.0</version> </dependency>
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.annotation.*; 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.annotation.*; // 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:
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.
Building requires: