/* Docs — Getting started, core concepts, code walkthrough, architecture. Globals from shared.jsx. */ const DocsDS = window.ZeroZ4JDesignSystem_f7e0ed; function DocHeader() { return (
Documentation

Everything is Java. Here is how it fits.

A unified, zero-impedance Java stack — no REST, no JSON, no ORM, no JavaScript. Build a full-stack feature, learn the core concepts that define the model, then start coding.

{[["#start", "Getting started"], ["#concepts", "Core concepts"], ["#walkthrough", "Code walkthrough"], ["#arch", "Architecture"]].map(([h, l]) => {l} ↓ )}
); } function GettingStarted() { return (
01 · Getting started

A full-stack feature in four files.

You avoid boilerplate HTTP mapping, JSON translation, and ORM schemas entirely. Define a model, an interface, its implementation, and a UI — all Java, all sharing the exact same object.

{cm("// becomes serializable + persistable")}{"\n"} {cy("@DataModel")}{"\n"} {kw("public class")} ChatMessage {kw("implements")} BinaryPackable {"{"}{"\n"} {" "}{kw("private")} String author;{"\n"} {" "}{kw("private")} String text;{"\n\n"} {" "}{kw("public")} ChatMessage() {"{}"}{"\n"} {" "}{cm("// constructor, getters, setters…")}{"\n"} {"}"} {cm("// the RPC contract — one interface")}{"\n"} {cy("@RmiService")}{"\n"} {kw("public interface")} ChatService {"{"}{"\n"} {" "}{kw("void")} sendMessage(ChatMessage msg);{"\n"} {"}"} {cy("@ApplicationScoped")}{"\n"} {kw("public class")} ChatServiceImpl {kw("implements")} ChatService {"{"}{"\n"} {" "}{cy("@Override")}{"\n"} {" "}{kw("public")} {kw("void")} sendMessage(ChatMessage msg) {"{"}{"\n"} {" "}{cm("// receives the exact object sent")}{"\n"} {" "}System.out.println(msg.getText());{"\n"} {" "}{"}"}{"\n"} {"}"} {kw("public class")} ChatView {kw("extends")} Div {"{"}{"\n"} {" "}ChatView(ChatService chat) {"{"}{"\n"} {" "}Button b = {kw("new")} Button({cy("\"Send\"")});{"\n"} {" "}b.onClick(e -> {"{"}{"\n"} {" "}{cm("// calls backend over binary WS")}{"\n"} {" "}chat.sendMessage({kw("new")} ChatMessage({cy("\"Alice\"")}, {cy("\"Hi!\"")}));{"\n"} {" "}{"}"});{"\n"} {" "}add(b);{"\n"} {" "}{"}"}{"\n"} {"}"}
→ scaffold the multi-module project with the Maven archetype, then mvn clean install and open http://localhost:8080
); } function Concepts() { const items = [ ["@DataModel", "Marks a domain model or entity for transmission. Triggers zeroz4j-apt to generate an ultra-fast binary serializer at compile time."], ["@RmiService", "Annotates a service interface. A client-side Wasm stub is generated; you call the interface, it executes on the server over a persistent WebSocket."], ["Zeroz4jClient", "Bootstraps the Wasm client. connect(url, callback) opens the binary WebSocket and initializes the RMI subsystem."], ["Zeroz4jServer", "Bootstraps the Helidon backend. start(port, name) spins up HTTP/WebSocket, the Weld CDI environment, and the RMI dispatcher."], ["@Secured / @RolesAllowed", "Method-level security on the server. Restrict RMI invocations to authenticated users, or to specific roles."], ["RmiSecurityContext", "Handles auth. On a validated AUTH frame, onAuthenticated() fires client-side so you can load authenticated views."], ["@LiveSync", "Reactive real-time updates, fully implicit. Annotate a @DataModel with @LiveSync and a fetched object updates itself inline whenever the server changes it — no watch(), no subscribe(), no polling."], ["EclipseStore", "Native persistence. Your Java memory graph is the database. store(object) serializes the delta straight to disk — no JPA, no SQL."], ["zeroz4j-ui-components", "A Vaadin-like programmatic UI model in Java — new Button(\"Click\") — styled with Tailwind + DaisyUI. No HTML or DOM code."], ["Reactive Signals", "Frontend reactive primitives in com.zeroz4j.ui.signals: ValueSignal holds state, Computed derives from it, Effect re-runs when tracked dependencies change — all in the Wasm heap."]]; return (
02 · Core concepts

Ten ideas define the whole model.

{items.map(([t, b], i) =>
{t} [{String(i + 1).padStart(2, "0")}]

{b}

)}
); } function Walkthrough() { const steps = [ { n: "01", t: "Declare the domain model", d: "Annotate the model with @DataModel and implement BinaryPackable. A compile-time serializer reads and writes fields without reflection.", code: {cy("@DataModel")}{"\n"} {kw("public class")} UserInfo {kw("implements")} BinaryPackable {"{"}{"\n"} {" "}{kw("private")} String name;{"\n"} {" "}{kw("private")} {kw("int")} score;{"\n"} {" "}{kw("public")} UserInfo() {"{}"} {cm("// required")}{"\n"} {"}"} }, { n: "02", t: "Declare the service", d: "Annotate the contract interface with @RmiService. Client stub and server dispatch are generated from this one definition.", code: {cy("@RmiService")}{"\n"} {kw("public interface")} UserService {"{"}{"\n"} {" "}UserInfo getUserInfo(String username);{"\n"} {" "}{kw("void")} updateScore(String username, {kw("int")} newScore);{"\n"} {"}"} }, { n: "03", t: "Persist with EclipseStore", d: "No JPA, no SQL. Query with plain Java streams over the stored object graph, then store(user) to persist the delta. Saves are always explicit.", code: {cy("@ApplicationScoped")}{"\n"} {kw("public class")} UserServiceImpl {kw("implements")} UserService {"{"}{"\n"} {" "}{cy("@Inject")} EmbeddedStorageManager storage;{"\n\n"} {" "}{kw("public")} {kw("void")} updateScore(String user, {kw("int")} n) {"{"}{"\n"} {" "}UserInfo u = root().getUsers().stream(){"\n"} {" "}.filter(x -> x.getName().equals(user)){"\n"} {" "}.findFirst().orElseThrow();{"\n"} {" "}u.setScore(n);{"\n"} {" "}storage.store(u); {cm("// persist the delta")}{"\n"} {" "}{"}"}{"\n"} {"}"} }, { n: "04", t: "Run the Wasm client", d: "Register serializers, open the channel, obtain the generated stub, and invoke. The call suspends cooperatively until the response returns — the UI thread never blocks.", code: BinaryPackableRegistrar.registerAll();{"\n"} {kw("var")} channel = {kw("new")} WasmRmiClientChannel({"\n"} {" "}{cy("\"ws://localhost:8080/wasm-rmi\"")}, () -> {"{}"});{"\n"} WasmRmiClient.initialize(channel);{"\n\n"} UserService service = {kw("new")} UserService_Stub();{"\n"} UserInfo profile = service.getUserInfo({cy("\"franz\"")}); }]; return (
03 · Code walkthrough

One object, front end to persistence.

{steps.map((s) =>
STEP {s.n}

{s.t}

{s.d}

{s.code}
)}
); } function ArchitectureBlock() { const cards = [ { i: "AOT.01", t: "Annotation processing", b: "During Maven compilation, zeroz4j-apt scans for @DataModel and @RmiService, generating _Serializer and _Stub classes. No runtime reflection — which WebAssembly handles poorly." }, { i: "AOT.02", t: "TeaVM WasmGC", b: "The client module transpiles Java bytecode — including generated stubs and serializers — directly into WasmGC to run in the browser." }, { i: "AOT.03", t: "Cooperative coroutines", b: "Wasm runs on the single UI thread, so it cannot block. An RMI call suspends the coroutine, sends its frame, yields to the browser, and resumes exactly when the response arrives." }, { i: "SRV.01", t: "Virtual threads (Loom)", b: "Each incoming WebSocket frame is handed to a virtual thread, so the server's I/O threads never block on long queries — thousands of persistent connections stay responsive." }, { i: "SRV.02", t: "Modular backend", b: "zeroz4j-server-core is the agnostic CDI engine and RMI dispatcher; a binding such as zeroz4j-server-helidon supplies the HTTP/WebSocket transport." }, { i: "SYNC.01", t: "Explicit LiveSync", b: "Subscriptions are explicit, never sync-everything: it protects bandwidth and browser memory, keeps the UI contextually scoped, and lets the server authorize each watched object." }]; return (
04 · Architecture

Ahead-of-time by design, reflection-free.

Performance in the browser is guaranteed at compile time, not hoped for at runtime.

{cards.map((c) =>
{c.b}
)}
); } function Docs() { return ( ); } ReactDOM.createRoot(document.getElementById("root")).render();