Package su.onno.ui

Class DocumentCommandService

java.lang.Object

su.onno.ui.DocumentCommandService

public class DocumentCommandService
extends Object

Write-side commands for documents — create, update, delete, post, unpost — plus the document reconstruction needed for posting. Extracted from GenericDocumentController so the same code path is shared by the REST API and other callers (e.g. the MCP server), and access control / read-only checks are enforced in exactly one place.

Every mutating method enforces requireWritable() (global read-only mode) and UiAccessService.requireWrite(java.security.Principal, su.onno.metadata.CatalogDescriptor) against the caller's Principal, so callers never bypass the role model.

Constructor Summary

Constructors

Constructor	Description
DocumentCommandService(MetadataRegistry registry, org.jdbi.v3.core.Jdbi jdbi, UiProperties properties, NumberGenerator numberGenerator, PostingService postingService, DocumentQueryService query, UiAccessService access, org.springframework.context.ApplicationEventPublisher events, SecretCipher secretCipher)

Method Summary

Modifier and Type	Method	Description
Map<String,Object>	create(DocumentDescriptor desc, Map<String,Object> requestBody, Principal principal)
void	delete(DocumentDescriptor desc, UUID id, Principal principal)
Map<String,Object>	post(DocumentDescriptor desc, UUID id, Principal principal)
PostingPreview	postingPreview(DocumentDescriptor desc, UUID id, Principal principal)
Map<String,Object>	unpost(DocumentDescriptor desc, UUID id, Principal principal)
Map<String,Object>	update(DocumentDescriptor desc, UUID id, Map<String,Object> requestBody, Principal principal)
Map<String,Object>	validate(DocumentDescriptor desc, UUID id, Map<String,Object> requestBody, Principal principal)	Dry-run the write lifecycle against a form's current values and report every failure without persisting anything — the backend of the form's live (as-you-type) validation.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

DocumentCommandService

public DocumentCommandService(MetadataRegistry registry,
 org.jdbi.v3.core.Jdbi jdbi,
 UiProperties properties,
 NumberGenerator numberGenerator,
 PostingService postingService,
 DocumentQueryService query,
 UiAccessService access,
 org.springframework.context.ApplicationEventPublisher events,
 SecretCipher secretCipher)

Method Details

create

public Map<String,Object> create(DocumentDescriptor desc,
 Map<String,Object> requestBody,
 Principal principal)

update

public Map<String,Object> update(DocumentDescriptor desc,
 UUID id,
 Map<String,Object> requestBody,
 Principal principal)

validate

public Map<String,Object> validate(DocumentDescriptor desc,
 UUID id,
 Map<String,Object> requestBody,
 Principal principal)

Dry-run the write lifecycle against a form's current values and report every failure without persisting anything — the backend of the form's live (as-you-type) validation. Runs the same pipeline as create(su.onno.metadata.DocumentDescriptor, java.util.Map<java.lang.String, java.lang.Object>, java.security.Principal)/update(su.onno.metadata.DocumentDescriptor, java.util.UUID, java.util.Map<java.lang.String, java.lang.Object>, java.security.Principal): declarative attribute constraints, then the typed document's onFilling/beforeWrite hooks and Validated rules on the merged state (tabular rows included), so a conflict check written in Java surfaces while the user is still on the field. No number is consumed from the sequence and no events fire. Always returns 200 — the outcome is the {valid, fieldErrors, formErrors} payload.

post

public Map<String,Object> post(DocumentDescriptor desc,
 UUID id,
 Principal principal)

postingPreview

public PostingPreview postingPreview(DocumentDescriptor desc,
 UUID id,
 Principal principal)

unpost

public Map<String,Object> unpost(DocumentDescriptor desc,
 UUID id,
 Principal principal)

delete

public void delete(DocumentDescriptor desc,
 UUID id,
 Principal principal)