You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@sling.apache.org by "Dan Klco (Jira)" <ji...@apache.org> on 2023/03/07 14:10:00 UTC
[jira] [Created] (SLING-11798) Clarify Job Topic Validity Rules
Dan Klco created SLING-11798:
--------------------------------
Summary: Clarify Job Topic Validity Rules
Key: SLING-11798
URL: https://issues.apache.org/jira/browse/SLING-11798
Project: Sling
Issue Type: Improvement
Components: Site
Reporter: Dan Klco
Assignee: Dan Klco
Our [documentation on Sling Jobs|https://sling.apache.org/documentation/bundles/apache-sling-eventing-and-job-handling.html#jobs-guarantee-of-processing-1] mentions that:
{quote}The job topic follows the conventions for the topic of an OSGi event.
{quote}
Which, after finding and reviewing the relevant documentation:
[https://docs.osgi.org/specification/osgi.cmpn/7.0.0/service.event.html#d0e46909]
[https://docs.osgi.org/specification/osgi.core/7.0.0/ch01.html#framework.general.syntax]
One could determine means a string which:
- Does not start or end with a slash
- Contains only ASCII alphanumeric, underscore, dash, and slash characters
- Does not contain double slashes
However, it would be more convenient for users of Apache Sling to document the rules on the Jobs page for easy reference and to indicate that attempting to add a Job with an invalid topic with JobManager#addJob will return null.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)