Quarkus Roq Generator

import io.quarkiverse.roq.generator.runtime.RoqSelection;
import io.quarkiverse.roq.generator.runtime.SelectedPath;
import jakarta.enterprise.context.ApplicationScoped;
import jakarta.enterprise.inject.Produces;
import jakarta.inject.Singleton;
import java.util.List;

@ApplicationScoped
public class SiteSelection {

    @Produces
    @Singleton
    RoqSelection produce() {
        return new RoqSelection(List.of(
            SelectedPath.builder().html("/blog/hello-roq").build(), (1)
            SelectedPath.builder().html("/search?tag=java").build(), (2)
            SelectedPath.builder().path("/api/posts").outputPath("/posts.json").build() (3)
        ));
    }
}

import io.quarkiverse.roq.generator.runtime.RoqSelection;
import io.quarkiverse.roq.generator.runtime.SelectedPath;
import org.eclipse.microprofile.rest.client.inject.RegisterRestClient;
import org.eclipse.microprofile.rest.client.inject.RestClient;
import jakarta.enterprise.context.ApplicationScoped;
import jakarta.enterprise.inject.Produces;
import jakarta.inject.Singleton;
import jakarta.inject.Inject;
import jakarta.ws.rs.GET;
import jakarta.ws.rs.Path;
import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Paths;
import java.util.List;

@ApplicationScoped
public class RemoteContentSelection {

    @Inject
    @RestClient
    ContentApiClient apiClient; (1)

    @Produces
    @Singleton
    RoqSelection produce() throws IOException {

        // Another use case: download a JavaScript file from the API
        String analyticsScript = apiClient.getAnalyticsScript();
        // Download into the public directory (this file should be included in the .gitignore)
        // Alternatively, you can download outside the source tree and add a vertx route so the generator can access the served content
        java.nio.file.Path publicDir = Paths.get("public/js");
        Files.createDirectories(publicDir);
        Files.writeString(publicDir.resolve("analytics.js"), analyticsScript); (2)

        // Build selection paths
        List<SelectedPath> paths = new ArrayList<>();

        // Add the downloaded JavaScript file to the selection
        // Files downloaded during the selection phase need
        // explicit selection paths, because they're created after the normal public/
        // directory copy happens
        paths.add(SelectedPath.builder()
            .path("/js/analytics.js")
            .outputPath("/js/analytics.js")
            .build()); (3)

        return new RoqSelection(paths);
    }
}

record Post(String slug, String title, String content) {}

quarkus.rest-client.content-api.url=https://api.example.com

import io.quarkiverse.roq.generator.runtime.RoqSelection;
import io.quarkiverse.roq.generator.runtime.SelectedPath;
import jakarta.enterprise.context.ApplicationScoped;
import jakarta.enterprise.inject.Produces;
import jakarta.inject.Singleton;
import jakarta.inject.Inject;
import jakarta.persistence.Entity;
import jakarta.persistence.EntityManager;
import jakarta.persistence.Id;
import jakarta.transaction.Transactional;
import java.util.List;

@ApplicationScoped
public class DatabaseSelection {

    @Inject
    EntityManager em;

    @Produces
    @Singleton
    @Transactional (1)
    RoqSelection produce() {
        // Query all products from the database
        List<Product> products = em.createQuery(
            "SELECT p FROM Product p WHERE p.published = true",
            Product.class
        ).getResultList(); (2)

        // Generate a page for each product
        List<SelectedPath> paths = products.stream()
            .map(product -> SelectedPath.builder()
                .html("/products/" + product.slug)
                .build())
            .toList();

        return new RoqSelection(paths);
    }
}

@Entity
class Product {
    @Id Long id;
    String slug;
    String name;
    boolean published;
}

quarkus.roq.generator.paths=/,/about/,/contact/ (1)

@Produces
@Singleton
RoqSelection produce() {
    return new RoqSelection(dynamicPaths()); (2)
}