This is an automated email from the ASF dual-hosted git repository. danhaywood pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/causeway.git
commit 96be4d9afc69ab94be86377cdde2ff009be719ef Author: danhaywood <[email protected]> AuthorDate: Wed Mar 13 12:29:09 2024 +0000 CAUSEWAY-3650: regens docs --- .../applib/pages/index/annotation/Action.adoc | 13 -- .../applib/pages/index/annotation/Collection.adoc | 13 -- .../applib/pages/index/annotation/Parameter.adoc | 13 -- .../applib/pages/index/annotation/Property.adoc | 13 -- .../services/ascii/AsciiIdentifierService.adoc | 17 +++ .../services/iactnlayer/InteractionService.adoc | 12 +- .../applib/fixturescripts/FixtureScripts.adoc | 77 ++++++++---- core/adoc/modules/_overview/pages/about.adoc | 2 +- .../adoc/modules/config/pages/sections/Other.adoc | 2 +- .../config/pages/sections/causeway.applib.adoc | 136 +++++++++++++++++---- .../pages/sections/causeway.core.meta-model.adoc | 2 +- .../causeway.core.meta-model.introspector.adoc | 4 +- .../causeway.core.meta-model.validator.adoc | 18 +-- .../sections/causeway.core.runtime-services.adoc | 10 +- .../config/pages/sections/causeway.extensions.adoc | 24 ++-- .../sections/causeway.persistence.commons.adoc | 2 +- .../sections/causeway.persistence.schema.adoc | 2 +- .../pages/sections/causeway.security.keycloak.adoc | 6 +- .../pages/sections/causeway.value-types.adoc | 4 +- .../pages/sections/causeway.viewer.common.adoc | 4 +- .../pages/sections/causeway.viewer.graphql.adoc | 16 +-- .../sections/causeway.viewer.restfulobjects.adoc | 5 +- .../pages/sections/causeway.viewer.wicket.adoc | 58 ++++----- .../modules/config/pages/sections/datanucleus.adoc | 8 +- .../modules/config/pages/sections/eclipselink.adoc | 50 ++++---- .../modules/config/pages/sections/resteasy.adoc | 2 +- 26 files changed, 307 insertions(+), 206 deletions(-) diff --git a/antora/components/refguide-index/modules/applib/pages/index/annotation/Action.adoc b/antora/components/refguide-index/modules/applib/pages/index/annotation/Action.adoc index a577e21260..d365729b78 100644 --- a/antora/components/refguide-index/modules/applib/pages/index/annotation/Action.adoc +++ b/antora/components/refguide-index/modules/applib/pages/index/annotation/Action.adoc @@ -19,7 +19,6 @@ Groups together all domain-specific metadata for an invokable action on a domain Class<?> typeOf() default // represents unspecified void.class; // <.> String fileAccept() default ""; // <.> - String asciiId() default ""; // <.> } ---- @@ -68,11 +67,6 @@ If the action returns a collection, then this hints as to the run-time type of t -- For downloading xref:refguide:applib:index/value/Blob.adoc[Blob] or xref:refguide:applib:index/value/Clob.adoc[Clob] , optionally restrict the files accepted (eg `.xslx` ). -- -<.> xref:#asciiId[asciiId] -+ --- -Returns an alternative id for the action, using only ASCII characters. --- == Members @@ -154,13 +148,6 @@ For downloading xref:refguide:applib:index/value/Blob.adoc[Blob] or xref:refguid The value should be of the form "file_extension|audio/*|video/*|image/*|media_type". -[#asciiId] -=== asciiId - -Returns an alternative id for the action, using only ASCII characters. - -Although Java itself allows the full UTF character set for identifiers, some integrations (such as GraphQL) have restrictions to only allow a more limited set of characters, in essence ASCII. This attribute allows a version of the action's Id using only the ASCII character set to be provided. - include::hooks/Action_010-examples-and-usage.adoc[] include::hooks/Action_021-associating.adoc[] diff --git a/antora/components/refguide-index/modules/applib/pages/index/annotation/Collection.adoc b/antora/components/refguide-index/modules/applib/pages/index/annotation/Collection.adoc index bb8c72702a..bdfa1e5993 100644 --- a/antora/components/refguide-index/modules/applib/pages/index/annotation/Collection.adoc +++ b/antora/components/refguide-index/modules/applib/pages/index/annotation/Collection.adoc @@ -12,7 +12,6 @@ Domain semantics for domain object collection. Class<? extends CollectionDomainEvent<?, ?>> domainEvent() default CollectionDomainEvent.Default.class; // <.> Class<?> typeOf() default // represents unspecified void.class; // <.> - String asciiId() default ""; // <.> } ---- @@ -26,11 +25,6 @@ Indicates that changes to the collection that should be posted to the _org.apach -- The type-of the elements held within the collection. -- -<.> xref:#asciiId[asciiId] -+ --- -Returns an alternative id for the collection, using only ASCII characters. --- == Members @@ -62,13 +56,6 @@ The type-of the elements held within the collection. This is only provided as a fallback; usually the framework can infer the element type of the collection from the collection method's generic type. -[#asciiId] -=== asciiId - -Returns an alternative id for the collection, using only ASCII characters. - -Although Java itself allows the full UTF character set for identifiers, some integrations (such as GraphQL) have restrictions to only allow a more limited set of characters, in essence ASCII. This attribute allows a version of the collection's Id using only the ASCII character set to be provided. - include::hooks/Collection_010-examples-and-usage.adoc[] include::hooks/Collection_021_domainEvent.adoc[] diff --git a/antora/components/refguide-index/modules/applib/pages/index/annotation/Parameter.adoc b/antora/components/refguide-index/modules/applib/pages/index/annotation/Parameter.adoc index 15e404ee45..eec25060ce 100644 --- a/antora/components/refguide-index/modules/applib/pages/index/annotation/Parameter.adoc +++ b/antora/components/refguide-index/modules/applib/pages/index/annotation/Parameter.adoc @@ -17,7 +17,6 @@ Collects together all domain semantics of an action parameter within a single an int regexPatternFlags() default 0; // <.> String regexPatternReplacement() default "Doesn't match pattern"; // <.> PrecedingParamsPolicy precedingParamsPolicy() default PrecedingParamsPolicy.AS_CONFIGURED; // <.> - String asciiId() default ""; // <.> } ---- @@ -61,11 +60,6 @@ Replacement text for the pattern in generated error message. -- Whether parameter values should be reset to their default if an earlier parameter changes its value, or whether instead a parameter value, once changed by the end-user, should never be overwritten even if the end-user changes an earlier parameter value. -- -<.> xref:#asciiId[asciiId] -+ --- -Returns an alternative id for the parameter, using only ASCII characters. --- == Members @@ -121,13 +115,6 @@ Replacement text for the pattern in generated error message. Whether parameter values should be reset to their default if an earlier parameter changes its value, or whether instead a parameter value, once changed by the end-user, should never be overwritten even if the end-user changes an earlier parameter value. -[#asciiId] -=== asciiId - -Returns an alternative id for the parameter, using only ASCII characters. - -Although Java itself allows the full UTF character set for identifiers, some integrations (such as GraphQL) have restrictions to only allow a more limited set of characters, in essence ASCII. This attribute allows a version of the parameter's Id using only the ASCII character set to be provided. - include::hooks/Parameter_010-examples-and-usage.adoc[] include::hooks/Parameter_021-optionality.adoc[] diff --git a/antora/components/refguide-index/modules/applib/pages/index/annotation/Property.adoc b/antora/components/refguide-index/modules/applib/pages/index/annotation/Property.adoc index 573f350737..6793a7beeb 100644 --- a/antora/components/refguide-index/modules/applib/pages/index/annotation/Property.adoc +++ b/antora/components/refguide-index/modules/applib/pages/index/annotation/Property.adoc @@ -28,7 +28,6 @@ Publishing entityChangePublishing() default Publishing.NOT_SPECIFIED; // <.> String regexPattern() default ""; // <.> int regexPatternFlags() default 0; // <.> String regexPatternReplacement() default "Doesn't match pattern"; // <.> - String asciiId() default ""; // <.> } ---- @@ -112,11 +111,6 @@ Pattern flags, as per _java.util.regex.Pattern#compile(String, int)_ . -- Replacement text for the pattern in generated error message. -- -<.> xref:#asciiId[asciiId] -+ --- -Returns an alternative id for the property, using only ASCII characters. --- == Members @@ -242,13 +236,6 @@ The default value, `0` , means that no flags have been specified. Replacement text for the pattern in generated error message. -[#asciiId] -=== asciiId - -Returns an alternative id for the property, using only ASCII characters. - -Although Java itself allows the full UTF character set for identifiers, some integrations (such as GraphQL) have restrictions to only allow a more limited set of characters, in essence ASCII. This attribute allows a version of the property's Id using only the ASCII character set to be provided. - include::hooks/Property_010-examples-and-usage.adoc[] include::hooks/Property_021-optionality.adoc[] diff --git a/antora/components/refguide-index/modules/applib/pages/index/services/ascii/AsciiIdentifierService.adoc b/antora/components/refguide-index/modules/applib/pages/index/services/ascii/AsciiIdentifierService.adoc new file mode 100644 index 0000000000..854c7860f3 --- /dev/null +++ b/antora/components/refguide-index/modules/applib/pages/index/services/ascii/AsciiIdentifierService.adoc @@ -0,0 +1,17 @@ += AsciiIdentifierService +:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or ag [...] + +Optional SPI to provide an equivalent identifier using only ASCII character set, for the specified feature (a property, collection, action or action parameter). + +The GraphQL API (viewer) may require this SPI to be implemented if any of the features use non-ASCII characters, because feature Ids are used as GraphQL (field) names. + +== API + +[source,java] +.AsciiIdentifierService.java +---- +interface AsciiIdentifierService { + String asciiIdFor(String featureId) +} +---- + diff --git a/antora/components/refguide-index/modules/applib/pages/index/services/iactnlayer/InteractionService.adoc b/antora/components/refguide-index/modules/applib/pages/index/services/iactnlayer/InteractionService.adoc index f069bd7dd0..a12701ded5 100644 --- a/antora/components/refguide-index/modules/applib/pages/index/services/iactnlayer/InteractionService.adoc +++ b/antora/components/refguide-index/modules/applib/pages/index/services/iactnlayer/InteractionService.adoc @@ -61,12 +61,12 @@ Variant of _#call(InteractionContext, Callable)_ that takes a runnable. <.> xref:#callAnonymous_Callable[callAnonymous(Callable)] + -- -As per _#call(InteractionContext, Callable)_ , but using an anonymous xref:refguide:applib:index/services/iactnlayer/InteractionContext.adoc[InteractionContext] . +As per _#call(InteractionContext, Callable)_ , but (normally) using an anonymous xref:refguide:applib:index/services/iactnlayer/InteractionContext.adoc[InteractionContext] . -- <.> xref:#runAnonymous_ThrowingRunnable[runAnonymous(ThrowingRunnable)] + -- -As per _#callAnonymous(Callable)_ , but for a runnable. +As per _#run(InteractionContext, ThrowingRunnable)_ , but (normally) using an anonymous xref:refguide:applib:index/services/iactnlayer/InteractionContext.adoc[InteractionContext] . -- <.> xref:#callAndCatch_InteractionContext_Callable[callAndCatch(InteractionContext, Callable)] + @@ -140,12 +140,16 @@ Variant of _#call(InteractionContext, Callable)_ that takes a runnable. [#callAnonymous_Callable] === callAnonymous(Callable) -As per _#call(InteractionContext, Callable)_ , but using an anonymous xref:refguide:applib:index/services/iactnlayer/InteractionContext.adoc[InteractionContext] . +As per _#call(InteractionContext, Callable)_ , but (normally) using an anonymous xref:refguide:applib:index/services/iactnlayer/InteractionContext.adoc[InteractionContext] . + +However, if an _#isInInteraction() interaction (session)_ already exists (with possibly some other non-anonymous xref:refguide:applib:index/services/iactnlayer/InteractionContext.adoc[InteractionContext] ), then this is used instead. [#runAnonymous_ThrowingRunnable] === runAnonymous(ThrowingRunnable) -As per _#callAnonymous(Callable)_ , but for a runnable. +As per _#run(InteractionContext, ThrowingRunnable)_ , but (normally) using an anonymous xref:refguide:applib:index/services/iactnlayer/InteractionContext.adoc[InteractionContext] . + +However, if an _#isInInteraction() interaction (session)_ already exists (with possibly some other non-anonymous xref:refguide:applib:index/services/iactnlayer/InteractionContext.adoc[InteractionContext] ), then this is used instead. [#callAndCatch_InteractionContext_Callable] === callAndCatch(InteractionContext, Callable) diff --git a/antora/components/refguide-index/modules/testing/pages/index/fixtures/applib/fixturescripts/FixtureScripts.adoc b/antora/components/refguide-index/modules/testing/pages/index/fixtures/applib/fixturescripts/FixtureScripts.adoc index b12e2941d6..9004a02fed 100644 --- a/antora/components/refguide-index/modules/testing/pages/index/fixtures/applib/fixturescripts/FixtureScripts.adoc +++ b/antora/components/refguide-index/modules/testing/pages/index/fixtures/applib/fixturescripts/FixtureScripts.adoc @@ -11,7 +11,6 @@ Provides the mechanism to execute xref:refguide:testing:index/fixtures/applib/fi class FixtureScripts { // secman seeding public static final String LOGICAL_TYPE_NAME; - public static final String PACKAGE_PREFIX; // <.> FixtureScripts(FixtureScriptsSpecificationProvider fixtureScriptsSpecificationProvider, ServiceRegistry serviceRegistry) List<FixtureResult> runFixtureScript(String fixtureScriptName, String parameters) // <.> List<FixtureResult> runFixtureScript(FixtureScript fixtureScript, String parameters) @@ -22,25 +21,16 @@ public static final String LOGICAL_TYPE_NAME; String validateRunFixtureScript(String fixtureScriptName, String parameters) Object recreateObjectsAndReturnFirst() // <.> boolean hideRecreateObjectsAndReturnFirst() - void run(FixtureScript... fixtureScriptList) - void runPersonas(PersonaWithBuilderScript<?, ? extends BuilderScriptAbstract<?>>... personas) - T runPersona(PersonaWithBuilderScript<T, ? extends BuilderScriptAbstract<? extends T>> persona) + void run(FixtureScript... fixtureScriptList) // <.> + void runPersonas(PersonaWithBuilderScript<?, ? extends BuilderScriptAbstract<?>>... personas) // <.> + T runPersona(PersonaWithBuilderScript<T, ? extends BuilderScriptAbstract<? extends T>> persona) // <.> T runBuilder(BuilderScriptAbstract<T> builderScript) // <.> T runBuilderScriptNonTransactional(BuilderScriptAbstract<T> builderScript) // <.> - String findFixtureScriptNameFor(Class<? extends FixtureScript> fixtureScriptClass) - FixtureScript.ExecutionContext newExecutionContext(String parameters) - String mementoFor(FixtureScript fs) - void initOf(String xml, FixtureScript fs) FixtureResult newFixtureResult(FixtureScript script, String subkey, Object object, boolean firstTime) String titleOf(FixtureResult fixtureResult) } ---- -<.> xref:#PACKAGE_PREFIX[PACKAGE_PREFIX] -+ --- -The package prefix to search for fixture scripts. This default value will result in no fixture scripts being found. However, normally it will be overridden. --- <.> xref:#runFixtureScript_String_String[runFixtureScript(String, String)] + -- @@ -51,24 +41,34 @@ Main action - as exposed in the UI - to execute the specified fixture script. -- Convenience action - exposed through the UI - to execute the specified "recreate" xref:refguide:testing:index/fixtures/applib/fixturescripts/FixtureScript.adoc[FixtureScript] and return/show the first object returned by that fixture script. -- +<.> xref:#run_FixtureScript[run(FixtureScript)] ++ +-- +Runs the provided xref:refguide:testing:index/fixtures/applib/fixturescripts/FixtureScript.adoc[FixtureScript] s, using _InteractionService#runAnonymous(ThrowingRunnable)_ and _TransactionService#runWithinCurrentTransactionElseCreateNew(ThrowingRunnable)_ . +-- +<.> xref:#runPersonas_PersonaWithBuilderScript[runPersonas(PersonaWithBuilderScript)] ++ +-- +Runs the provided xref:refguide:testing:index/fixtures/applib/personas/PersonaWithBuilderScript.adoc[PersonaWithBuilderScript] s, using _InteractionService#runAnonymous(ThrowingRunnable)_ and _TransactionService#runWithinCurrentTransactionElseCreateNew(ThrowingRunnable)_ . +-- +<.> xref:#runPersona_PersonaWithBuilderScript[runPersona(PersonaWithBuilderScript)] ++ +-- +Runs the provided xref:refguide:testing:index/fixtures/applib/personas/PersonaWithBuilderScript.adoc[PersonaWithBuilderScript] , using _InteractionService#runAnonymous(ThrowingRunnable)_ and _TransactionService#runWithinCurrentTransactionElseCreateNew(ThrowingRunnable)_ . +-- <.> xref:#runBuilder_BuilderScriptAbstract[runBuilder(BuilderScriptAbstract)] + -- -Runs the builderScript within its own transactional boundary. +Runs the provided xref:refguide:testing:index/fixtures/applib/personas/BuilderScriptAbstract.adoc[BuilderScriptAbstract] , using _InteractionService#runAnonymous(ThrowingRunnable)_ and _TransactionService#runWithinCurrentTransactionElseCreateNew(ThrowingRunnable)_ . -- <.> xref:#runBuilderScriptNonTransactional_BuilderScriptAbstract[runBuilderScriptNonTransactional(BuilderScriptAbstract)] + -- -Runs the builderScript without its own transactional boundary.The caller is responsible to provide a transactional context/boundary. +Runs the xref:refguide:testing:index/fixtures/applib/personas/BuilderScriptAbstract.adoc[BuilderScriptAbstract] without its own transactional boundary. -- == Members -[#PACKAGE_PREFIX] -=== PACKAGE_PREFIX - -The package prefix to search for fixture scripts. This default value will result in no fixture scripts being found. However, normally it will be overridden. - [#runFixtureScript_String_String] === runFixtureScript(String, String) @@ -83,14 +83,47 @@ NOTE: this method can only be used for xref:refguide:testing:index/fixtures/appl Convenience action - exposed through the UI - to execute the specified "recreate" xref:refguide:testing:index/fixtures/applib/fixturescripts/FixtureScript.adoc[FixtureScript] and return/show the first object returned by that fixture script. +[#run_FixtureScript] +=== run(FixtureScript) + +Runs the provided xref:refguide:testing:index/fixtures/applib/fixturescripts/FixtureScript.adoc[FixtureScript] s, using _InteractionService#runAnonymous(ThrowingRunnable)_ and _TransactionService#runWithinCurrentTransactionElseCreateNew(ThrowingRunnable)_ . + +This means that if there is an existing _org.apache.causeway.applib.services.iactn.Interaction interaction (session)_ and transaction, then they will be re-used, but otherwise (all of) the provided fixtures will be installed in a single transaction. + + *Be aware* that (unlike _#runPersonas(PersonaWithBuilderScript[])_ ), the scripts are _not_ called in a hierarchy; all provided fixture scripts will be executed in their own _org.apache.causeway.testing.fixtures.applib.fixturescripts.FixtureScript.ExecutionContext_ and therefore run irrespective of configured _#getMultipleExecutionStrategy()_ . + +Also note that _unlike_ _#runFixtureScript(FixtureScript, String)_ , then xref:refguide:testing:index/fixtures/applib/events/FixturesInstallingEvent.adoc[FixturesInstallingEvent] and xref:refguide:testing:index/fixtures/applib/events/FixturesInstalledEvent.adoc[FixturesInstalledEvent] s are _not_ fired. + +[#runPersonas_PersonaWithBuilderScript] +=== runPersonas(PersonaWithBuilderScript) + +Runs the provided xref:refguide:testing:index/fixtures/applib/personas/PersonaWithBuilderScript.adoc[PersonaWithBuilderScript] s, using _InteractionService#runAnonymous(ThrowingRunnable)_ and _TransactionService#runWithinCurrentTransactionElseCreateNew(ThrowingRunnable)_ . + +This means that if there is an existing _org.apache.causeway.applib.services.iactn.Interaction interaction (session)_ and transaction, then they will be re-used, but otherwise (all of) the provided persona fixtures will be installed in a single transaction. + +Also, the persona scripts _are_ called within a single hierarchy, in other words through a single _org.apache.causeway.testing.fixtures.applib.fixturescripts.FixtureScript.ExecutionContext_ ; they therefore honour the configured _#getMultipleExecutionStrategy()_ . + +But note that _unlike_ _#runFixtureScript(String, String)_ , then xref:refguide:testing:index/fixtures/applib/events/FixturesInstallingEvent.adoc[FixturesInstallingEvent] and xref:refguide:testing:index/fixtures/applib/events/FixturesInstalledEvent.adoc[FixturesInstalledEvent] s are _not_ fired. + +[#runPersona_PersonaWithBuilderScript] +=== runPersona(PersonaWithBuilderScript) + +Runs the provided xref:refguide:testing:index/fixtures/applib/personas/PersonaWithBuilderScript.adoc[PersonaWithBuilderScript] , using _InteractionService#runAnonymous(ThrowingRunnable)_ and _TransactionService#runWithinCurrentTransactionElseCreateNew(ThrowingRunnable)_ . + +This means that if there is an existing _org.apache.causeway.applib.services.iactn.Interaction interaction (session)_ and transaction, then they will be re-used, but otherwise the provided persona fixture will be installed in a single transaction. + +Also note that _unlike_ _#runFixtureScript(String, String)_ , then xref:refguide:testing:index/fixtures/applib/events/FixturesInstallingEvent.adoc[FixturesInstallingEvent] and xref:refguide:testing:index/fixtures/applib/events/FixturesInstalledEvent.adoc[FixturesInstalledEvent] s are _not_ fired. + [#runBuilder_BuilderScriptAbstract] === runBuilder(BuilderScriptAbstract) -Runs the builderScript within its own transactional boundary. +Runs the provided xref:refguide:testing:index/fixtures/applib/personas/BuilderScriptAbstract.adoc[BuilderScriptAbstract] , using _InteractionService#runAnonymous(ThrowingRunnable)_ and _TransactionService#runWithinCurrentTransactionElseCreateNew(ThrowingRunnable)_ . [#runBuilderScriptNonTransactional_BuilderScriptAbstract] === runBuilderScriptNonTransactional(BuilderScriptAbstract) -Runs the builderScript without its own transactional boundary.The caller is responsible to provide a transactional context/boundary. +Runs the xref:refguide:testing:index/fixtures/applib/personas/BuilderScriptAbstract.adoc[BuilderScriptAbstract] without its own transactional boundary. + +This means that the caller is responsible for ensuring that an _org.apache.causeway.applib.services.iactn.Interaction interaction_ and _TransactionService#runWithinCurrentTransactionElseCreateNew(ThrowingRunnable) transaction_ are in place. include::hooks/FixtureScripts_020-configuration-properties.adoc[] diff --git a/core/adoc/modules/_overview/pages/about.adoc b/core/adoc/modules/_overview/pages/about.adoc index 4d73a42336..4413114ad4 100644 --- a/core/adoc/modules/_overview/pages/about.adoc +++ b/core/adoc/modules/_overview/pages/about.adoc @@ -1072,7 +1072,7 @@ org.apache.causeway.core:causeway-schema:jar:<managed> + .Document Index Entries **** -xref:refguide:applib:index/CausewayModuleApplib.adoc[CausewayModuleApplib], xref:refguide:applib:index/CausewayModuleApplibChangeAndExecutionLoggers.adoc[CausewayModuleApplibChangeAndExecutionLoggers], xref:refguide:applib:index/CausewayModuleApplibMixins.adoc[CausewayModuleApplibMixins], xref:refguide:applib:index/Identifier.adoc[Identifier], xref:refguide:applib:index/ViewModel.adoc[ViewModel], xref:refguide:applib:index/annotation/Action.adoc[Action], xref:refguide:applib:index/annota [...] +xref:refguide:applib:index/CausewayModuleApplib.adoc[CausewayModuleApplib], xref:refguide:applib:index/CausewayModuleApplibChangeAndExecutionLoggers.adoc[CausewayModuleApplibChangeAndExecutionLoggers], xref:refguide:applib:index/CausewayModuleApplibMixins.adoc[CausewayModuleApplibMixins], xref:refguide:applib:index/Identifier.adoc[Identifier], xref:refguide:applib:index/ViewModel.adoc[ViewModel], xref:refguide:applib:index/annotation/Action.adoc[Action], xref:refguide:applib:index/annota [...] **** |Apache Causeway Core - Code Gen (ByteBuddy) diff --git a/core/config/src/main/adoc/modules/config/pages/sections/Other.adoc b/core/config/src/main/adoc/modules/config/pages/sections/Other.adoc index 49a66d09f4..2ad1476205 100644 --- a/core/config/src/main/adoc/modules/config/pages/sections/Other.adoc +++ b/core/config/src/main/adoc/modules/config/pages/sections/Other.adoc @@ -16,7 +16,7 @@ include::../section-hooks/Other~pre.adoc[] causeway.prototyping.h2-console. + generate-random-web-admin-password -| +| true | Whether to generate a random password for access to the H2 Web-Console advanced features. If a password is generated, it is logged to the logging subsystem (Log4j2). diff --git a/core/config/src/main/adoc/modules/config/pages/sections/causeway.applib.adoc b/core/config/src/main/adoc/modules/config/pages/sections/causeway.applib.adoc index 69a0ab4e0a..8d06da51fb 100644 --- a/core/config/src/main/adoc/modules/config/pages/sections/causeway.applib.adoc +++ b/core/config/src/main/adoc/modules/config/pages/sections/causeway.applib.adoc @@ -17,7 +17,88 @@ causeway.applib.annotation. + action-layout.css-class-fa. + patterns -| +| [all.*:fa-solid fa-list, list. + +*:fa-solid fa-list, find. + +*:fa-search, lookup. + +*:fa-search, search. + +*:fa-search, send. + +*:fa-regular fa-paper-plane, open. + +*:fa-solid fa-arrow-up-right-from- + +square, close. + +*:fa-solid fa-regular fa-rectangle- + +xmark, recent. + +*:fa-solid fa-clock-rotate- + +left, lock. + +*:fa-solid fa-lock, unlock. + +*:fa-solid fa-unlock, permit. + +*:fa-solid fa-unlock, review. + +*:fa-solid fa-eye, add. + +*:fa-regular fa-square-plus, plus. + +*:fa-regular fa-square- + +plus, remove. + +*:fa-regular fa-square- + +minus, minus. + +*:fa-regular fa-square-minus, sign. + +*:fa-solid fa-signature, clear. + +*:fa-solid fa-broom, create. + +*:fa-regular fa-square-plus, new. + +*:fa-regular fa-square- + +plus, delete. + +*:fa-solid fa-trash, change. + +*:fa-regular fa-pen-to- + +square, edit. + +*:fa-regular fa-pen-to- + +square, maintain. + +*:fa-regular fa-pen-to- + +square, update. + +*:fa-regular fa-pen-to-square, cut. + +*:fa-solid fa-scissors, move. + +*:fa-solid fa-angles-right, copy. + +*:fa-regular fa-copy, duplicate. + +*:fa-solid fa-clone, clone. + +*:fa-solid fa-clone, categorise. + +*:fa-regular fa-folder- + +open, download. + +*:fa-solid fa-download, upload. + +*:fa-solid fa-upload, execute. + +*:fa-solid fa-bolt, run. + +*:fa-solid fa-bolt, trigger. + +*:fa-solid fa-bolt, link. + +*:fa-solid fa-link, unlink. + +*:fa-solid fa-link-slash, start. + +*:fa-solid fa-play, play. + +*:fa-solid fa-play, resume. + +*:fa-solid fa-play, pause. + +*:fa-solid fa-pause, suspend. + +*:fa-solid fa-pause, stop. + +*:fa-solid fa-stop, terminate. + +*:fa-solid fa-stop, previous. + +*:fa-backward-step, next. + +*:fa-forward-step, approve. + +*:fa-regular fa-thumbs-up, reject. + +*:fa-regular fa-thumbs- + +down, verify. + +*:fa-solid fa-check, decline. + +*:fa-solid fa-xmark, cancel. + +*:fa-solid fa-xmark, discard. + +*:fa-regular fa-trash-can, assign. + +*:fa-regular fa-hand-point- + +right, calculate. + +*:fa-calculator, import. + +*:fa-solid fa-file-import, export. + +*:fa-solid fa-file-export, first. + +*:fa-regular fa-star, install. + +*:fa-solid fa-wrench, setup. + +*:fa-solid fa-gear, configure. + +*:fa-solid fa-gear, refresh. + +*:fa-sync, renew. + +*:fa-rotate-right, reset. + +*:fa-rotate-left, save. + +*:fa-regular fa-floppy- + +disk, switch.*:fa-exchange, random. + +*:fa-shuffle, view. + +*:fa-regular fa-eye, wizard. + +*:fa-solid fa-wand-magic-sparkles] | Provides a mapping of patterns to font-awesome CSS classes, where the pattern is used to match against the name of the action method in order to determine a CSS class to use, for example on the action's menu icon if rendered by the Wicket viewer. Providing a default set of patterns encourages a common set of verbs to be used. @@ -40,7 +121,18 @@ patterns-as-map causeway.applib.annotation. + action-layout.css-class.patterns -| +| [add.*:btn-info, remove. + +*:btn-warning, start. + +*:btn-info, play.*:btn-info, stop. + +*:btn-warning, reset. + +*:btn-warning, new. + +*:btn-info, create. + +*:btn-info, delete. + +*:btn-danger, verify. + +*:btn-success, decline. + +*:btn-danger, save. + +*:btn-success, approve. + +*:btn-success, reject.*:btn-danger] | Provides a mapping of patterns to CSS classes, where the pattern is used to match against the name of the action method in order to determine a CSS class to use, for example on the action's button if rendered by the Wicket viewer. Providing a default set of patterns encourages a common set of verbs to be used. @@ -74,7 +166,7 @@ This setting can be overridden on a case-by-case basis using ``Action#commandPub causeway.applib.annotation.action. + domain-event.post-for-default -| +| true | Influences whether an ``ActionDomainEvent`` should be published (on the internal ``EventBusService``) whenever an action is being interacted with. Up to five different events can be fired during an interaction, with the event's phase determining which (hide, disable, validate, executing and executed). Subscribers can influence the behaviour at each of these phases. @@ -115,7 +207,7 @@ The value of this can be overridden on a case-by-case basis using ``CollectionLa causeway.applib.annotation. + collection-layout.paged -| +| 12 | Defines the default number of objects that are shown in a "parented" collection of a domain object, result of invoking an action. This can be overridden on a case-by-case basis using ``CollectionLayout#paged()``. @@ -148,7 +240,7 @@ causeway.applib.annotation. + collection.domain-event. + post-for-default -| +| true | Influences whether an ``CollectionDomainEvent`` should be published (on the internal ``EventBusService``) whenever a collection is being interacted with. Up to two different events can be fired during an interaction, with the event's phase determining which (hide, disable)Subscribers can influence the behaviour at each of these phases. @@ -222,7 +314,7 @@ The default is ``false``, because otherwise the mere presence of ``@DomainObject causeway.applib.annotation. + domain-object-layout.paged -| +| 25 | Defines the default number of objects that are shown in a "standalone" collection obtained as the result of invoking an action. This can be overridden on a case-by-case basis using ``DomainObjectLayout#paged()``. @@ -263,7 +355,7 @@ domain-object. + created-lifecycle-event. + post-for-default -| +| true | Influences whether an ``ObjectCreatedEvent`` should be published (on the internal ``EventBusService``) whenever a domain object has been created using ``FactoryService``. The algorithm for determining whether (and what type of) an event is sent depends on the value of the ``DomainObject#createdLifecycleEvent() @DomainObject(createdLifecycleEvent=...)`` for the domain object in question. @@ -305,7 +397,7 @@ domain-object. + loaded-lifecycle-event. + post-for-default -| +| true | Influences whether an ``ObjectLoadedEvent`` should be published (on the internal ``EventBusService``) whenever a domain _entity_ has been loaded from the persistence store. The algorithm for determining whether (and what type of) an event is sent depends on the value of the ``DomainObject#loadedLifecycleEvent() @DomainObject(loadedLifecycleEvent=...)`` for the domain object in question. @@ -324,7 +416,7 @@ domain-object. + persisted-lifecycle-event. + post-for-default -| +| true | Influences whether an ``ObjectPersistedEvent`` should be published (on the internal ``EventBusService``) whenever a domain _entity_ has been persisted (for the first time) to the persistence store. The algorithm for determining whether (and what type of) an event is sent depends on the value of the ``DomainObject#persistedLifecycleEvent() @DomainObject(persistedLifecycleEvent=...)`` for the domain object in question. @@ -343,7 +435,7 @@ domain-object. + persisting-lifecycle-event. + post-for-default -| +| true | Influences whether an ``ObjectPersistingEvent`` should be published (on the internal ``EventBusService``) whenever a domain _entity_ is about to be persisting (for the first time) to the persistence store. The algorithm for determining whether (and what type of) an event is sent depends on the value of the ``DomainObject#persistingLifecycleEvent() @DomainObject(persistingLifecycleEvent=...)`` for the domain object in question. @@ -362,7 +454,7 @@ domain-object. + removing-lifecycle-event. + post-for-default -| +| true | Influences whether an ``ObjectRemovingEvent`` should be published (on the internal ``EventBusService``) whenever a persistent domain _entity_ is about to be removed (that is, deleted) from the persistence store. The algorithm for determining whether (and what type of) an event is sent depends on the value of the ``DomainObject#removingLifecycleEvent() @DomainObject(removingLifecycleEvent=...)`` for the domain object in question. @@ -383,7 +475,7 @@ domain-object. + updated-lifecycle-event. + post-for-default -| +| true | Influences whether an ``ObjectUpdatedEvent`` should be published (on the internal ``EventBusService``) whenever a persistent domain _entity_ has been updated in the persistence store. The algorithm for determining whether (and what type of) an event is sent depends on the value of the ``DomainObject#updatedLifecycleEvent() @DomainObject(updatedLifecycleEvent=...)`` for the domain object in question. @@ -402,7 +494,7 @@ domain-object. + updating-lifecycle-event. + post-for-default -| +| true | Influences whether an ``ObjectUpdatingEvent`` should be published (on the internal ``EventBusService``) whenever a persistent domain _entity_ is about to be updated in the persistence store. The algorithm for determining whether (and what type of) an event is sent depends on the value of the ``DomainObject#updatingLifecycleEvent() @DomainObject(updatingLifecycleEvent=...)`` for the domain object in question. @@ -428,15 +520,15 @@ If left as ``LabelPosition#NOT_SPECIFIED`` and not overridden, then the position | -[[causeway.applib.annotation.parameter.dependent-defaults-policy]] +[[causeway.applib.annotation.parameter.preceding-parameters-policy]] causeway.applib.annotation. + parameter. + -dependent-defaults-policy +preceding-parameters-policy | -| Whether dependent parameters should be reset to their default if an earlier parameter changes its value, or whether instead a parameter value, once changed by the end-user, should never be overwritten even if the end-user changes an earlier parameter value. +| Whether parameters should be reset to their default if an earlier parameter changes its value, or whether instead a parameter value, once changed by the end-user, should never be overwritten even if the end-user changes an earlier parameter value. -This setting can be overridden on a case-by-case basis using ``Parameter#precedingParamsPolicy() Parameter#precedingParamsPolicy()``. +This setting can be overridden on a case-by-case basis using ``Parameter#precedingParamsPolicy() Parameter#precedingParametersPolicy()``. | @@ -481,7 +573,7 @@ causeway.applib.annotation. + property.domain-event. + post-for-default -| +| true | Influences whether an ``PropertyDomainEvent`` should be published (on the internal ``EventBusService``) whenever an property is being interacted with. Up to five different events can be fired during an interaction, with the event's phase determining which (hide, disable, validate, executing and executed). Subscribers can influence the behaviour at each of these phases. @@ -513,7 +605,7 @@ view-model-layout. + css-class-ui-event. + post-for-default -| +| true | Influences whether an ``CssClassUiEvent`` should be published (on the internal ``EventBusService``) whenever a view model (annotated with @DomainObject#nature of ``Nature#VIEW_MODEL``) is about to be rendered in the UI - thereby allowing subscribers to optionally ``CssClassUiEvent#setCssClass(String)`` change) the CSS classes that are used. The algorithm for determining whether (and what type of) an event is sent depends on the value of the ``DomainObjectLayout#cssClassUiEvent() @DomainObjectLayout(cssClassEvent=...)`` for the domain object in question: @@ -529,7 +621,7 @@ causeway.applib.annotation. + view-model-layout.icon-ui-event. + post-for-default -| +| true | Influences whether an ``IconUiEvent`` should be published (on the internal ``EventBusService``) whenever a view model (annotated with @DomainObject#nature of ``Nature#VIEW_MODEL``) is about to be rendered in the UI - thereby allowing subscribers to optionally ``IconUiEvent#setIconName(String)`` change) the icon that is used. The algorithm for determining whether (and what type of) an event is sent depends on the value of the ``DomainObjectLayout#iconUiEvent() @ViewModelLayout(iconEvent=...)`` for the domain object in question: @@ -545,7 +637,7 @@ causeway.applib.annotation. + view-model-layout.layout-ui-event. + post-for-default -| +| true | Influences whether an ``LayoutUiEvent`` should be published (on the internal ``EventBusService``) whenever a view model (annotated with @DomainObject#nature of ``Nature#VIEW_MODEL``) is about to be rendered in the UI - thereby allowing subscribers to optionally ``LayoutUiEvent#setLayout(String)`` change) the layout that is used. If a different layout value has been set, then a layout in the form ``xml`` use used (where ``zzz`` is the name of the layout). @@ -563,7 +655,7 @@ causeway.applib.annotation. + view-model-layout.title-ui-event. + post-for-default -| +| true | Influences whether an ``TitleUiEvent`` should be published (on the internal ``EventBusService``) whenever a view model (annotated with @DomainObject#nature of ``Nature#VIEW_MODEL``) is about to be rendered in the UI - thereby allowing subscribers to optionally ``TitleUiEvent#setTitle(String)`` change) the title that is used. The algorithm for determining whether (and what type of) an event is sent depends on the value of the ``DomainObjectLayout#titleUiEvent() @DomainObjectLayout(titleEvent=...)`` for the domain object in question: diff --git a/core/config/src/main/adoc/modules/config/pages/sections/causeway.core.meta-model.adoc b/core/config/src/main/adoc/modules/config/pages/sections/causeway.core.meta-model.adoc index 9eeed2a3a7..a27314a92c 100644 --- a/core/config/src/main/adoc/modules/config/pages/sections/causeway.core.meta-model.adoc +++ b/core/config/src/main/adoc/modules/config/pages/sections/causeway.core.meta-model.adoc @@ -16,7 +16,7 @@ include::../section-hooks/causeway.core.meta-model~pre.adoc[] causeway.core.meta-model. + filter-visibility -| +| true | Whether domain objects to which the current user does not have visibility access should be rendered within collections or drop-down choices/autocompletes. One reason this filtering may be necessary is for multi-tenanted applications, whereby an end-user should only be able to "see" what data that they own. For efficiency, the application should only query for objects that the end-user owns. This configuration property acts as a safety net to prevent the end-user from viewing domain objects _even if_ those domain objects were rehydrated from the persistence store. diff --git a/core/config/src/main/adoc/modules/config/pages/sections/causeway.core.meta-model.introspector.adoc b/core/config/src/main/adoc/modules/config/pages/sections/causeway.core.meta-model.introspector.adoc index 40c8307e4b..003482e0a4 100644 --- a/core/config/src/main/adoc/modules/config/pages/sections/causeway.core.meta-model.introspector.adoc +++ b/core/config/src/main/adoc/modules/config/pages/sections/causeway.core.meta-model.introspector.adoc @@ -17,7 +17,7 @@ causeway.core.meta-model. + introspector. + lock-after-full-introspection -| +| true | If true, then no new specifications will be allowed to be loaded once introspection has been complete. Only applies if the introspector is configured to perform full introspection up-front (either because of ``IntrospectionMode#FULL`` or ``IntrospectionMode#LAZY_UNLESS_PRODUCTION`` when in production); otherwise is ignored. @@ -62,7 +62,7 @@ causeway.core.meta-model. + introspector. + validate-incrementally -| +| true | If true, then metamodel validation is performed after any new specification has been loaded (after the initial bootstrapping). This does _not_ apply if the introspector is configured to perform full introspection up-front AND when the metamodel is locked after initial bootstrapping (because in that case the lock check will simply prevent any new specs from being loaded). But it will apply otherwise. diff --git a/core/config/src/main/adoc/modules/config/pages/sections/causeway.core.meta-model.validator.adoc b/core/config/src/main/adoc/modules/config/pages/sections/causeway.core.meta-model.validator.adoc index f113000719..1fcb47ac2e 100644 --- a/core/config/src/main/adoc/modules/config/pages/sections/causeway.core.meta-model.validator.adoc +++ b/core/config/src/main/adoc/modules/config/pages/sections/causeway.core.meta-model.validator.adoc @@ -17,7 +17,7 @@ causeway.core.meta-model.validator. + action-collection-parameter- + choices -| +| true | Whether to validate that any actions that accept action parameters have either a corresponding choices or auto-complete for that action parameter, or are associated with a collection of the appropriate type. @@ -26,7 +26,7 @@ choices causeway.core.meta-model.validator. + allow-deprecated -| +| true | This setting is used to determine whether the use of such deprecated features is allowed. If not allowed, then metamodel validation errors will be flagged. @@ -62,7 +62,7 @@ causeway.core.meta-model.validator. + jaxb-view-model. + date-time-type-adapter -| +| true | If set, then ensures that for all properties of JAXB-style view models where the property's type is a date or time, then that property has been correctly annotated with @``XmlJavaTypeAdapter`` (so that the property's value can be converted into a serializable form). @@ -80,7 +80,7 @@ jaxb-view-model.no-arg-constructor causeway.core.meta-model.validator. + jaxb-view-model.not-abstract -| +| true | If set, then ensures that all JAXB-style view models are concrete classes, not abstract. @@ -89,7 +89,7 @@ jaxb-view-model.not-abstract causeway.core.meta-model.validator. + jaxb-view-model.not-inner-class -| +| true | If set, then ensures that all JAXB-style view models are either top-level classes or nested static classes (in other words, checks that they are not anonymous, local nor nested non-static classes). @@ -99,7 +99,7 @@ causeway.core.meta-model.validator. + jaxb-view-model. + reference-type-adapter -| +| true | If set, then ensures that for all properties of JAXB-style view models where the property's type is an entity, then that entity's type has been correctly annotated with @``XmlJavaTypeAdapter`` (so that the property's value can be converted into a serializable form). @@ -108,7 +108,7 @@ reference-type-adapter causeway.core.meta-model.validator. + jdoql.from-clause -| +| true | If set, then ensures that the 'FROM' clause within any JDOQL ``@Query``s annotations relates to a known entity type, and moreover that that type is compatible with the type on which the annotation appears: meaning its either a supertype of or the same type as the annotated type. @@ -117,7 +117,7 @@ jdoql.from-clause causeway.core.meta-model.validator. + jdoql.variables-clause -| +| true | If set, then ensures that the 'VARIABLES' clause within any JDOQL ``@Query``s relates to a known entity type. @@ -126,7 +126,7 @@ jdoql.variables-clause causeway.core.meta-model.validator. + parallelize -| +| true | Whether to perform metamodel validation in parallel. diff --git a/core/config/src/main/adoc/modules/config/pages/sections/causeway.core.runtime-services.adoc b/core/config/src/main/adoc/modules/config/pages/sections/causeway.core.runtime-services.adoc index 9e0ba7adb5..08149ed9e3 100644 --- a/core/config/src/main/adoc/modules/config/pages/sections/causeway.core.runtime-services.adoc +++ b/core/config/src/main/adoc/modules/config/pages/sections/causeway.core.runtime-services.adoc @@ -65,7 +65,7 @@ This configuration property is mandatory (for the default implementation of the causeway.core.runtime-services. + email.throw-exception-on-fail -| +| true | If an email fails to send, whether to propagate the exception (meaning that potentially the end-user might see the exception), or whether instead to just indicate failure through the return value of the method (``EmailService#send(List, List, List, String, String, DataSource...)`` that's being called. @@ -111,7 +111,7 @@ Replaces the former Servlet context parameter 'causeway.config.dir'; causeway.core.runtime-services. + email.port -| +| 587 | null @@ -147,7 +147,7 @@ email.sender.username causeway.core.runtime-services. + email.socket-connection-timeout -| +| 2000 | null @@ -156,7 +156,7 @@ email.socket-connection-timeout causeway.core.runtime-services. + email.socket-timeout -| +| 2000 | null @@ -165,7 +165,7 @@ email.socket-timeout causeway.core.runtime-services. + email.tls.enabled -| +| true | null diff --git a/core/config/src/main/adoc/modules/config/pages/sections/causeway.extensions.adoc b/core/config/src/main/adoc/modules/config/pages/sections/causeway.extensions.adoc index d3ad38714f..a3d0aaf367 100644 --- a/core/config/src/main/adoc/modules/config/pages/sections/causeway.extensions.adoc +++ b/core/config/src/main/adoc/modules/config/pages/sections/causeway.extensions.adoc @@ -38,7 +38,7 @@ One reason to use this option is if you wish to provide your own implementation causeway.extensions.command-replay. + analyser.exception.enabled -| +| true | null @@ -47,7 +47,7 @@ analyser.exception.enabled causeway.extensions.command-replay. + analyser.result.enabled -| +| true | null @@ -56,7 +56,7 @@ analyser.result.enabled causeway.extensions.command-replay. + batch-size -| +| 10 | null @@ -102,7 +102,7 @@ causeway.extensions.command-replay. + quartz-replicate-and-replay-job. + repeat-interval -| +| 10000 | Number of milliseconds before running again. @@ -112,7 +112,7 @@ causeway.extensions.command-replay. + quartz-replicate-and-replay-job. + start-delay -| +| 15000 | Number of milliseconds before starting the job. @@ -121,7 +121,8 @@ start-delay causeway.extensions.command-replay. + quartz-session.roles -| +| causewayModuleExtCommandReplaySeco + +ndaryRole | null @@ -130,7 +131,8 @@ quartz-session.roles causeway.extensions.command-replay. + quartz-session.user -| +| causewayModuleExtCommandReplaySeco + +ndaryUser | The user that runs the replay session secondary. @@ -191,7 +193,7 @@ For more information, check the usage of the ``methods`` init parameter for http causeway.extensions.cors. + allowed-origins -| +| * | Which origins are allowed to make CORS requests. The default is the wildcard ("*"), meaning any origin is allowed to access the resource, but this can be made more restrictive if necessary using a whitelist of comma separated origins eg: @@ -206,7 +208,7 @@ For more information, check the usage of the ``origins`` init parameter for http causeway.extensions.cors. + exposed-headers -| +| Authorization | Which HTTP headers are exposed in a CORS request. A comma separated list of headers other than the simple response headers that browsers are allowed to access. These are the headers which will also be included as part of 'Access-Control-Expose-Headers' header in the pre-flight response. @@ -244,7 +246,7 @@ causeway.extensions. + execution-outbox.rest-api. + max-pending -| +| 100 | The maximum number of interactions that will be returned when the REST API is polled. @@ -453,7 +455,7 @@ If using the wicket viewer, also requires causeway.viewer.wicket.suppress-signup causeway.extensions.session-log. + auto-logout-on-restart -| +| true | null diff --git a/core/config/src/main/adoc/modules/config/pages/sections/causeway.persistence.commons.adoc b/core/config/src/main/adoc/modules/config/pages/sections/causeway.persistence.commons.adoc index 302503ad91..1811f8b60b 100644 --- a/core/config/src/main/adoc/modules/config/pages/sections/causeway.persistence.commons.adoc +++ b/core/config/src/main/adoc/modules/config/pages/sections/causeway.persistence.commons.adoc @@ -17,7 +17,7 @@ causeway.persistence.commons. + entity-change-tracker. + suppress-auto-flush -| +| true | Normally any query submitted to ``RepositoryService#allMatches(Query)`` will trigger a flush first, unless auto-flush has been disabled. However, this auto-flush behaviour can be troublesome if the query occurs as a side-effect of the evaluation of a derived property, whose value in turn is enlisted by an implementation of a subscriber (in particular ``EntityPropertyChangeSubscriber``) which captures the value of all properties (both persisted and derived). However, this behaviour can (at least under JDO), result in a ``ConcurrentModificationException``. diff --git a/core/config/src/main/adoc/modules/config/pages/sections/causeway.persistence.schema.adoc b/core/config/src/main/adoc/modules/config/pages/sections/causeway.persistence.schema.adoc index 04ed530630..9811f8fec5 100644 --- a/core/config/src/main/adoc/modules/config/pages/sections/causeway.persistence.schema.adoc +++ b/core/config/src/main/adoc/modules/config/pages/sections/causeway.persistence.schema.adoc @@ -38,7 +38,7 @@ This configuration mechanism does not consider any schema-auto-creation configur causeway.persistence.schema. + create-schema-sql-template -| +| CREATE SCHEMA IF NOT EXISTS %S | Vendor specific SQL syntax to create a DB schema. This template is passed through ``String#format(String, Object...)`` to make the actual SQL statement thats to be used against the configured data-source. diff --git a/core/config/src/main/adoc/modules/config/pages/sections/causeway.security.keycloak.adoc b/core/config/src/main/adoc/modules/config/pages/sections/causeway.security.keycloak.adoc index d37a46fa07..86a5983b54 100644 --- a/core/config/src/main/adoc/modules/config/pages/sections/causeway.security.keycloak.adoc +++ b/core/config/src/main/adoc/modules/config/pages/sections/causeway.security.keycloak.adoc @@ -42,7 +42,7 @@ client-role-prefix causeway.security.keycloak. + extract-client-roles -| +| true | Whether to (attempt to) extract client roles and copy into the ``DefaultOidcUser``. By default, client roles are extracted using the "User Client Role" mapping type, into a token claim name "resource_access.$\{client_id}.roles" @@ -55,7 +55,7 @@ This has been made a configuration option because some versions of Keycloak seem causeway.security.keycloak. + extract-realm-roles -| +| true | Whether to (attempt to) extract realm roles and copy into the ``DefaultOidcUser``. By default, realm roles are obtained from the token claims using the "User Realm Role" mapping type, into a token claim name "realm_access.roles" @@ -81,7 +81,7 @@ This has been made a configuration option so that the workaround described in ht causeway.security.keycloak. + login-success-url -| +| /wicket | Specifies where users will be redirected after authenticating successfully if they have not visited a secured page prior to authenticating or \{@code alwaysUse} is true. diff --git a/core/config/src/main/adoc/modules/config/pages/sections/causeway.value-types.adoc b/core/config/src/main/adoc/modules/config/pages/sections/causeway.value-types.adoc index fbab39f1cb..bc36f0199a 100644 --- a/core/config/src/main/adoc/modules/config/pages/sections/causeway.value-types.adoc +++ b/core/config/src/main/adoc/modules/config/pages/sections/causeway.value-types.adoc @@ -44,7 +44,7 @@ The same configuration property is also used for rendering the value. causeway.value-types.big-decimal. + use-scale-for-min-fractional-facet -| +| true | Indicates how to derive the min fractional facet (the minimum number of digits after the decimal point). If this flag is set, then the ``Digits#fraction()`` annotation or ORM equivalent (the JDO ``@Column#scale`` or the JPA ``Column#scale()``) should be used for the ``MinFractionalFacet`` as well as the ``MaxFractionalFacet``. @@ -72,7 +72,7 @@ Eg. via docker instance like \{@literal yuzutech/kroki}. causeway.value-types.kroki. + request-timeout -| +| 5000ms | Max time for requests to the ``#getBackendUrl()``, when waiting for a response. (default: 5 seconds) diff --git a/core/config/src/main/adoc/modules/config/pages/sections/causeway.viewer.common.adoc b/core/config/src/main/adoc/modules/config/pages/sections/causeway.viewer.common.adoc index 4dafb62071..5f4b9ac4ab 100644 --- a/core/config/src/main/adoc/modules/config/pages/sections/causeway.viewer.common.adoc +++ b/core/config/src/main/adoc/modules/config/pages/sections/causeway.viewer.common.adoc @@ -58,7 +58,7 @@ This is expected to be a local resource. causeway.viewer.common.application. + menubars-layout-file -| +| menubars.layout.xml | Specifies the file name containing the menubars. This is expected to be a local resource. @@ -69,7 +69,7 @@ This is expected to be a local resource. causeway.viewer.common.application. + name -| +| Apache Causeway ™ | Identifies the application on the sign-in page (unless a sign-in image is configured) and on top-left in the header (unless a header image is configured). diff --git a/core/config/src/main/adoc/modules/config/pages/sections/causeway.viewer.graphql.adoc b/core/config/src/main/adoc/modules/config/pages/sections/causeway.viewer.graphql.adoc index 4e43f51e3a..8be5edaac9 100644 --- a/core/config/src/main/adoc/modules/config/pages/sections/causeway.viewer.graphql.adoc +++ b/core/config/src/main/adoc/modules/config/pages/sections/causeway.viewer.graphql.adoc @@ -43,7 +43,7 @@ authentication.fallback.username causeway.viewer.graphql.lookup. + arg-name -| +| object | This is the name of the synthetic first argument used to locate the object to be looked up. @@ -70,7 +70,7 @@ field-name-suffix causeway.viewer.graphql.meta-data. + field-name -| +| _meta | Note that field names _cannot_ being with "__", as that is reserved by the underlying GraphQL implementation. @@ -79,7 +79,7 @@ field-name causeway.viewer.graphql.mutation. + target-arg-name -| +| _target | The name of the synthetic argument of mutators representing the target domain object. @@ -100,7 +100,7 @@ causeway.viewer.graphql. + scalar-marshaller. + local-date-format -| +| yyyy-MM-dd | For both JDK8's ``LocalDate`` and JodaTime's ``LocalDate`` @@ -110,7 +110,7 @@ causeway.viewer.graphql. + scalar-marshaller. + local-time-format -| +| HH:mm:ss | For both JDK8's ``LocalTime`` and JodaTime's ``LocalTime`` @@ -120,7 +120,7 @@ causeway.viewer.graphql. + scalar-marshaller. + zoned-date-time-format -| +| yyyy-MM-dd'T'HH:mm:ssXXX | for JDK8's ``ZonedDateTime`` and JodaTime's ``DateTime`` @@ -149,7 +149,7 @@ Ignored if the ``#getSchemaStyle()`` is ``SchemaStyle#SIMPLE_ONLY``. causeway.viewer.graphql.schema. + rich.top-level-field-name -| +| rich | If the ``#getSchemaStyle()`` is set to ``SchemaStyle#SIMPLE_AND_RICH``, defines the name of the top-level field under which the "rich" schema resides. Ignored for any other ``#getSchemaStyle()``. @@ -160,7 +160,7 @@ Ignored for any other ``#getSchemaStyle()``. causeway.viewer.graphql.schema. + simple.top-level-field-name -| +| simple | If the ``#getSchemaStyle()`` is set to ``SchemaStyle#SIMPLE_AND_RICH``, defines the name of the top-level field under which the "simple" schema resides. Ignored for any other ``#getSchemaStyle()``. diff --git a/core/config/src/main/adoc/modules/config/pages/sections/causeway.viewer.restfulobjects.adoc b/core/config/src/main/adoc/modules/config/pages/sections/causeway.viewer.restfulobjects.adoc index 27d47b23d8..b2fa577c3f 100644 --- a/core/config/src/main/adoc/modules/config/pages/sections/causeway.viewer.restfulobjects.adoc +++ b/core/config/src/main/adoc/modules/config/pages/sections/causeway.viewer.restfulobjects.adoc @@ -16,7 +16,10 @@ include::../section-hooks/causeway.viewer.restfulobjects~pre.adoc[] causeway.viewer.restfulobjects. + authentication.strategy-class-name -| +| org.apache.causeway.viewer. + +restfulobjects.viewer.webmodule. + +auth. + +AuthenticationStrategyBasicAuth | Defaults to ``AuthenticationStrategyBasicAuth``. diff --git a/core/config/src/main/adoc/modules/config/pages/sections/causeway.viewer.wicket.adoc b/core/config/src/main/adoc/modules/config/pages/sections/causeway.viewer.wicket.adoc index ba40e9ba39..ff25ca1296 100644 --- a/core/config/src/main/adoc/modules/config/pages/sections/causeway.viewer.wicket.adoc +++ b/core/config/src/main/adoc/modules/config/pages/sections/causeway.viewer.wicket.adoc @@ -24,7 +24,9 @@ ajax-debug-mode [[causeway.viewer.wicket.app]] causeway.viewer.wicket.app -| +| org.apache.causeway.viewer.wicket. + +viewer.wicketapp. + +CausewayWicketApplication | Specifies the subclass of ``CausewayWicketApplication`` that is used to bootstrap Wicket. There is usually very little reason to change this from its default. @@ -34,7 +36,7 @@ There is usually very little reason to change this from its default. [[causeway.viewer.wicket.base-path]] causeway.viewer.wicket.base-path -| +| /wicket/ | The base path at which the Wicket viewer is mounted. @@ -43,7 +45,7 @@ causeway.viewer.wicket.base-path causeway.viewer.wicket. + bookmarked-pages.max-size -| +| 15 | Specifies the maximum number of bookmarks to show. These are aged out on an MRU-LRU basis. @@ -54,7 +56,7 @@ These are aged out on an MRU-LRU basis. causeway.viewer.wicket. + bookmarked-pages.show-chooser -| +| true | Whether the panel providing linsk to previously visited object should be accessible from the top-left of the header. @@ -64,7 +66,7 @@ causeway.viewer.wicket. + bookmarked-pages. + show-drop-down-on-footer -| +| true | Whether the drop-down list of previously visited objects should be shown in the footer. @@ -73,7 +75,7 @@ show-drop-down-on-footer causeway.viewer.wicket.breadcrumbs. + enabled -| +| true | Whether to enable the 'where am i' feature, in other words the breadcrumbs. @@ -82,7 +84,7 @@ enabled causeway.viewer.wicket.breadcrumbs. + max-parent-chain-length -| +| 64 | null @@ -91,7 +93,7 @@ max-parent-chain-length causeway.viewer.wicket. + clear-field-button-enabled -| +| true | Whether the clear-field-button, that allows to clear a null-able (optional) field (a property or a dialog argument) is enabled for rendering or not. The default is to enable (show) the clear-field-button. @@ -123,7 +125,7 @@ A typical value is ``css``. This will result in this file being read from the `` causeway.viewer.wicket.date-picker. + max-date -| +| 2100-01-01T00:00:00.000Z | Defines the first date available in the date picker. As per http://eonasdan.github.io/bootstrap-datetimepicker/Options/#maxdate, in ISO format (per https://github.com/moment/moment/issues/1407). @@ -136,7 +138,7 @@ Use time zone 'Z', as the date/time picker UI component is not wired up to suppo causeway.viewer.wicket.date-picker. + min-date -| +| 1900-01-01T00:00:00.000Z | Defines the first date available in the date picker. As per http://eonasdan.github.io/bootstrap-datetimepicker/Options/#maxdate, in ISO format (per https://github.com/moment/moment/issues/1407). @@ -195,7 +197,7 @@ causeway.viewer.wicket. + disable-reason-explanation-in- + prototyping-mode-enabled -| +| true | In prototyping mode, a text icon is appeneded to any property that is disabled, with its tool-tip explaining why the property is disabled. This configuration property can be used to suppress the icon, even in prototyping mode, if desired. The default is to enable (show) the text icon (if in prototyping mode). @@ -228,7 +230,7 @@ causeway.viewer.wicket. + max-title-length-in-parented- + tables -| +| -1 | null @@ -238,7 +240,7 @@ causeway.viewer.wicket. + max-title-length-in-standalone- + tables -| +| -1 | null @@ -247,7 +249,7 @@ tables causeway.viewer.wicket. + max-title-length-in-tables -| +| 12 | The maximum number of characters to use to render the title of a domain object (alongside the icon) in any table, if not otherwise overridden by either ``#getMaxTitleLengthInParentedTables()`` or ``#getMaxTitleLengthInStandaloneTables()``. If truncated, then the remainder of the title will be replaced with ellipses (...). @@ -259,7 +261,7 @@ causeway.viewer.wicket. + max-title-length-in-tables-not- + having-any-property-column -| +| 80 | If a table has no property columns, for the title column this value is used, to determine how many characters to render for the table element titles. Introduced for the case when max-title-length is set to zero for tables in general, that if a table has no property columns an exception to that title suppression can be made. @@ -270,7 +272,7 @@ Introduced for the case when max-title-length is set to zero for tables in gener causeway.viewer.wicket. + message-popups.error-delay -| +| 0ms | How long the error popup should display before disappearing. A value of 0 (the default) means do not disappear automatically. @@ -281,7 +283,7 @@ A value of 0 (the default) means do not disappear automatically. causeway.viewer.wicket. + message-popups.info-delay -| +| 3500ms | How long the info popup should display before disappearing. A value of 0 means do not disappear automatically. @@ -292,7 +294,7 @@ A value of 0 means do not disappear automatically. causeway.viewer.wicket. + message-popups.offset -| +| 100 | How far in from the edge the popup should display @@ -324,7 +326,7 @@ The default is to show them at the top. causeway.viewer.wicket. + message-popups.warning-delay -| +| 0ms | How long the warning popup should display before disappearing. A value of 0 (the default) means do not disappear automatically. @@ -336,7 +338,7 @@ causeway.viewer.wicket. + prevent-double-click-for-form- + submit -| +| true | Whether to disable a form submit button after it has been clicked, to prevent users causing an error if they do a double click. This behaviour is enabled by default, but can be disabled using this flag. @@ -346,7 +348,7 @@ causeway.viewer.wicket. + prevent-double-click-for-no-arg- + action -| +| true | Whether to disable a no-arg action button after it has been clicked, to prevent users causing an error if they do a double click. This behaviour is enabled by default, but can be disabled using this flag. @@ -381,7 +383,7 @@ This behaviour is disabled by default; the viewer will update the existing page causeway.viewer.wicket.remember-me. + cookie-key -| +| causewayWicketRememberMe | If the "remember me" feature is available, specifies the key to hold the encrypted credentials in the cookie. @@ -417,7 +419,7 @@ causeway.viewer.wicket. + replace-disabled-tag-with-readonly- + tag -| +| true | In Firefox and more recent versions of Chrome 54+, cannot copy out of disabled fields; instead we use the readonly attribute (https://www.w3.org/TR/2014/REC-html5-20141028/forms.html#the-readonly-attribute) This behaviour is enabled by default but can be disabled using this flag @@ -427,7 +429,7 @@ This behaviour is enabled by default but can be disabled using this flag [[causeway.viewer.wicket.show-footer]] causeway.viewer.wicket.show-footer -| +| true | Whether to show the footer menu bar. This is enabled by default. @@ -438,7 +440,7 @@ This is enabled by default. causeway.viewer.wicket. + strip-wicket-tags -| +| true | Whether Wicket tags should be stripped from the markup. By default this is enabled, in other words Wicket tags are stripped. Please be aware that if tags are _not_ stripped, then this may break CSS rules on some browsers. @@ -480,7 +482,7 @@ enabled causeway.viewer.wicket.themes. + initial -| +| Flatly | The initial theme to use. Expected to be in the list of ``#getEnabled()`` themes. @@ -509,7 +511,7 @@ tooltip-text-mode causeway.viewer.wicket. + use-indicator-for-form-submit -| +| true | Whether to show an indicator for a form submit button that it has been clicked. This behaviour is enabled by default. @@ -520,7 +522,7 @@ This behaviour is enabled by default. causeway.viewer.wicket. + use-indicator-for-no-arg-action -| +| true | Whether to show an indicator for a no-arg action button that it has been clicked. This behaviour is enabled by default. diff --git a/core/config/src/main/adoc/modules/config/pages/sections/datanucleus.adoc b/core/config/src/main/adoc/modules/config/pages/sections/datanucleus.adoc index 77a60d8f8b..3c9cd78e7b 100644 --- a/core/config/src/main/adoc/modules/config/pages/sections/datanucleus.adoc +++ b/core/config/src/main/adoc/modules/config/pages/sections/datanucleus.adoc @@ -27,7 +27,7 @@ For more details, see https://www.datanucleus.org/products/accessplatform_6_0/jd [[datanucleus.cache.level2.type]] datanucleus.cache.level2.type -| +| soft | Name of the type of Level 2 Cache to use. Can be used to interface with external caching products. Use "none" to turn off L2 caching; other values include "soft", "weak", "javax.cache". @@ -47,7 +47,7 @@ datanucleus.identifier.case [[datanucleus.manage-relationships]] datanucleus.manage-relationships -| +| true | Whether DataNucleus will try to manage bidirectional relations, correcting the input objects so that all relations are consistent. This process runs when flush()/commit() is called. You can set it to false if you always set both sides of a relation when persisting/updating. @@ -61,7 +61,7 @@ datanucleus. + persistence-by-reachability-at- + commit -| +| true | Whether to run the "persistence-by-reachability" algorithm at commit time. This means that objects that were reachable at a call to makePersistent() but that are no longer persistent will be removed from persistence. For performance improvements, consider turning this off. @@ -138,7 +138,7 @@ For more details, see https://www.datanucleus.org/products/accessplatform_6_0/jd datanucleus.schema. + generate-database.mode -| +| none | Whether to eagerly create all tables at startup. For integration testing, this is generally preferred to using datanucleus.schema.autoCreateAll, because the ``autoCreateAll`` will only create tables lazily, when first persisted to. While lazily initialization is potentially quicker, it can cause issues (eg with rollup mapping to super class tables). diff --git a/core/config/src/main/adoc/modules/config/pages/sections/eclipselink.adoc b/core/config/src/main/adoc/modules/config/pages/sections/eclipselink.adoc index 3142697a4b..bd590faae1 100644 --- a/core/config/src/main/adoc/modules/config/pages/sections/eclipselink.adoc +++ b/core/config/src/main/adoc/modules/config/pages/sections/eclipselink.adoc @@ -24,7 +24,7 @@ database-event-listener [[eclipselink.cache.shared]] eclipselink.cache.shared -| +| true | @see https://www.eclipse.org/eclipselink/documentation/2.7/jpa/extensions/persistenceproperties_ref.htm#CHDEJCJJ[eclipselink.cache.shared] @@ -32,7 +32,7 @@ eclipselink.cache.shared [[eclipselink.cache.size]] eclipselink.cache.size -| +| 100 | @see https://www.eclipse.org/eclipselink/documentation/2.7/jpa/extensions/persistenceproperties_ref.htm#CHDIGIEC[eclipselink.cache.size] @@ -49,7 +49,7 @@ eclipselink.cache.type eclipselink.concurrency.manager. + allow.concurrencyexception -| +| true | @see https://www.eclipse.org/eclipselink/documentation/2.7/jpa/extensions/persistenceproperties_ref.htm#concurrency.manager.allow.concurrencyexception[eclipselink.concurrency.manager.allow.concurrencyexception] @@ -58,7 +58,7 @@ allow.concurrencyexception eclipselink.concurrency.manager. + allow.interruptedexception -| +| true | @see https://www.eclipse.org/eclipselink/documentation/2.7/jpa/extensions/persistenceproperties_ref.htm#concurrency.manager.allow.interruptedexception[eclipselink.concurrency.manager.allow.interruptedexception] @@ -67,7 +67,7 @@ allow.interruptedexception eclipselink.concurrency.manager. + allow.readlockstacktrace -| +| true | @see https://www.eclipse.org/eclipselink/documentation/2.7/jpa/extensions/persistenceproperties_ref.htm#concurrency.manager.allow.readlockstacktrace[eclipselink.concurrency.manager.allow.readlockstacktrace] @@ -76,7 +76,7 @@ allow.readlockstacktrace eclipselink.concurrency.manager. + maxfrequencytodumpmassivemessage -| +| 60000 | @see https://www.eclipse.org/eclipselink/documentation/2.7/jpa/extensions/persistenceproperties_ref.htm#concurrency.manager.maxfrequencytodumptinymessage[eclipselink.concurrency.manager.maxfrequencytodumpmassivemessage] @@ -85,7 +85,7 @@ maxfrequencytodumpmassivemessage eclipselink.concurrency.manager. + maxfrequencytodumptinymessage -| +| 40000 | @see https://www.eclipse.org/eclipselink/documentation/2.7/jpa/extensions/persistenceproperties_ref.htm#concurrency.manager.maxfrequencytodumptinymessage[eclipselink.concurrency.manager.maxfrequencytodumptinymessage] @@ -94,7 +94,7 @@ maxfrequencytodumptinymessage eclipselink.concurrency.manager. + maxsleeptime -| +| 40000 | @see https://www.eclipse.org/eclipselink/documentation/2.7/jpa/extensions/persistenceproperties_ref.htm#concurrency.manager.maxsleeptime[eclipselink.concurrency.manager.maxsleeptime] @@ -120,7 +120,7 @@ create-ddl-jdbc-file-name [[eclipselink.ddl-generation]] eclipselink.ddl-generation -| +| none | @see https://www.eclipse.org/eclipselink/documentation/2.7/jpa/extensions/persistenceproperties_ref.htm#BABHEJJI[eclipselink.ddl-generation] @@ -129,7 +129,7 @@ eclipselink.ddl-generation eclipselink.ddl-generation. + output-mode -| +| database | @see https://www.eclipse.org/eclipselink/documentation/2.7/jpa/extensions/persistenceproperties_ref.htm#BABCDHBB[eclipselink.ddl-generation.output-mode] @@ -196,7 +196,7 @@ eclipselink.id-validation eclipselink.jdbc. + allow-native-sql-queries -| +| true | @see https://www.eclipse.org/eclipselink/documentation/2.7/jpa/extensions/persistenceproperties_ref.htm#CIHHJBFB[eclipselink.jdbc.allow-native-sql-queries] @@ -204,7 +204,7 @@ allow-native-sql-queries [[eclipselink.jdbc.batch-writing]] eclipselink.jdbc.batch-writing -| +| none | @see https://www.eclipse.org/eclipselink/documentation/2.7/jpa/extensions/persistenceproperties_ref.htm#CIHIAGAF[eclipselink.jdbc.batch-writing] @@ -221,7 +221,7 @@ size [[eclipselink.jdbc.cache-statements]] eclipselink.jdbc.cache-statements -| +| true | @see https://www.eclipse.org/eclipselink/documentation/2.7/jpa/extensions/persistenceproperties_ref.htm#CHDHAFAA[eclipselink.jdbc.cache-statements] @@ -238,7 +238,7 @@ size [[eclipselink.jdbc.native-sql]] eclipselink.jdbc.native-sql -| +| true | @see https://www.eclipse.org/eclipselink/documentation/2.7/jpa/extensions/persistenceproperties_ref.htm[eclipselink.jdbc.native-sql] @@ -255,7 +255,7 @@ upper-case-column-names [[eclipselink.jpql.validation]] eclipselink.jpql.validation -| +| EclipseLink | null @@ -263,7 +263,7 @@ eclipselink.jpql.validation [[eclipselink.logging.connection]] eclipselink.logging.connection -| +| true | @see https://www.eclipse.org/eclipselink/documentation/2.7/jpa/extensions/persistenceproperties_ref.htm#CHDJCBIF[eclipselink.logging.connection] @@ -271,7 +271,7 @@ eclipselink.logging.connection [[eclipselink.logging.exceptions]] eclipselink.logging.exceptions -| +| true | @see https://www.eclipse.org/eclipselink/documentation/2.7/jpa/extensions/persistenceproperties_ref.htm#BEIFJBIE[eclipselink.logging.exceptions] @@ -295,7 +295,7 @@ eclipselink.logging.level [[eclipselink.logging.session]] eclipselink.logging.session -| +| true | @see https://www.eclipse.org/eclipselink/documentation/2.7/jpa/extensions/persistenceproperties_ref.htm#BEIHGGHH[eclipselink.logging.session] @@ -303,7 +303,7 @@ eclipselink.logging.session [[eclipselink.logging.thread]] eclipselink.logging.thread -| +| true | @see https://www.eclipse.org/eclipselink/documentation/2.7/jpa/extensions/persistenceproperties_ref.htm#BEIFFGGB[eclipselink.logging.thread] @@ -311,7 +311,7 @@ eclipselink.logging.thread [[eclipselink.logging.timestamp]] eclipselink.logging.timestamp -| +| true | @see https://www.eclipse.org/eclipselink/documentation/2.7/jpa/extensions/persistenceproperties_ref.htm#BEIJCEBJ[eclipselink.logging.timestamp] @@ -319,7 +319,7 @@ eclipselink.logging.timestamp [[eclipselink.profiler]] eclipselink.profiler -| +| NoProfiler | The "``profiler``" property configures the type of profiler used to capture runtime statistics. *Allowed Values:* @@ -395,7 +395,7 @@ eclipselink.weaving [[eclipselink.weaving.changetracking]] eclipselink.weaving.changetracking -| +| true | @see https://www.eclipse.org/eclipselink/documentation/2.7/jpa/extensions/persistenceproperties_ref.htm#CHDCEEFC[eclipse.weaving.changetracking] @@ -411,7 +411,7 @@ eclipselink.weaving.eager [[eclipselink.weaving.fetchgroups]] eclipselink.weaving.fetchgroups -| +| true | @see https://www.eclipse.org/eclipselink/documentation/2.7/jpa/extensions/persistenceproperties_ref.htm#CHDDIFGE[eclipse.weaving.fetchgroups] @@ -419,7 +419,7 @@ eclipselink.weaving.fetchgroups [[eclipselink.weaving.internal]] eclipselink.weaving.internal -| +| true | @see https://www.eclipse.org/eclipselink/documentation/2.7/jpa/extensions/persistenceproperties_ref.htm#BABJICDJ[eclipse.weaving.internal] @@ -427,7 +427,7 @@ eclipselink.weaving.internal [[eclipselink.weaving.lazy]] eclipselink.weaving.lazy -| +| true | @see https://www.eclipse.org/eclipselink/documentation/2.7/jpa/extensions/persistenceproperties_ref.htm#BABDBIFE[eclipse.weaving.lazy] diff --git a/core/config/src/main/adoc/modules/config/pages/sections/resteasy.adoc b/core/config/src/main/adoc/modules/config/pages/sections/resteasy.adoc index 16b58c26b5..656362faee 100644 --- a/core/config/src/main/adoc/modules/config/pages/sections/resteasy.adoc +++ b/core/config/src/main/adoc/modules/config/pages/sections/resteasy.adoc @@ -27,7 +27,7 @@ There should be very little reason to change this from its default. [[resteasy.jaxrs.default-path]] resteasy.jaxrs.default-path -| +| /restful | The path at which the RO viewer should be mounted. Note that this is used rather than ``prefix`` because there is _NO_ implementation of ``Application``, so we rely on it being automatically created.
