Class JakartarsWhiteboardConstants

java.lang.Object
org.osgi.service.jakartars.whiteboard.JakartarsWhiteboardConstants

public final class JakartarsWhiteboardConstants extends Object
Defines standard constants for the Jakarta RESTful Web Services Whiteboard services.
  • Field Details

    • JAKARTA_RS_NAME

      public static final String JAKARTA_RS_NAME
      Service property specifying the name of a Jakarta RESTful Web Services whiteboard service.

      This name is provided as a property on the registered Endpoint service so that the URI for a particular Jakarta RESTful Web Services service can be identified. If this service property is not specified, then no Endpoint information will be registered for this resource.

      Resource names must be unique among all services associated with a single Whiteboard implementation. If a clashing name is registered then the lower ranked service will be failed with a cause of DTOConstants.FAILURE_REASON_DUPLICATE_NAME

      The value of this service property must be of type String.

      See Also:
    • JAKARTA_RS_RESOURCE

      public static final String JAKARTA_RS_RESOURCE
      Service property specifying that a Jakarta RESTful Web Services resource should be processed by the whiteboard.

      The value of this service property must be of type String or Boolean and set to "true" or true.

      See Also:
    • JAKARTA_RS_APPLICATION_BASE

      public static final String JAKARTA_RS_APPLICATION_BASE
      Service property specifying the base URI mapping for a Jakarta RESTful Web Services application service.

      The specified uri is used to determine whether a request should be mapped to the resource. Services without this service property are ignored.

      The value of this service property must be of type String, and will have a "/" prepended if no "/" exists.

      If two applications are registered with the same base uri then the lower ranked service is failed with a cause of DTOConstants.FAILURE_REASON_SHADOWED_BY_OTHER_SERVICE

      See Also:
    • JAKARTA_RS_APPLICATION_SELECT

      public static final String JAKARTA_RS_APPLICATION_SELECT
      Service property specifying the target application for a Jakarta RESTful Web Services resource or extension service.

      The specified filter(s) is/are used to determine whether a resource should be included in a particular application. Services without this service property are bound to the default Application.

      If a filter property is registered and no application running in the whiteboard matches the filter then the service will be failed with a cause of DTOConstants.FAILURE_REASON_REQUIRED_APPLICATION_UNAVAILABLE

      The value of this service property must be of type String+, and each entry must be a valid OSGi filter.

      See Also:
    • JAKARTA_RS_APPLICATION_SERVICE_PROPERTIES

      public static final String JAKARTA_RS_APPLICATION_SERVICE_PROPERTIES
      The property key which can be used to find the application service properties inside an injected Configuration
      See Also:
    • JAKARTA_RS_DEFAULT_APPLICATION

      public static final String JAKARTA_RS_DEFAULT_APPLICATION
      The name of the default Jakarta RESTful Web Services application in every Whiteboard instance.
      See Also:
    • JAKARTA_RS_EXTENSION

      public static final String JAKARTA_RS_EXTENSION
      Service property specifying that a Jakarta RESTful Web Services resource service should be processed by the whiteboard.

      The value of this service property must be of type String or Boolean and set to "true" or true.

      A service providing this property must be registered as one or more of the following types:

      • MessageBodyReader
      • MessageBodyWriter
      • ContainerRequestFilter
      • ContainerResponseFilter
      • ReaderInterceptor
      • WriterInterceptor
      • ContextResolver
      • ExceptionMapper
      • ParamConverterProvider
      • Feature
      • DynamicFeature

      If a service with this property does not match any of the defined types then it is registered as a failure DTO with the error code DTOConstants.FAILURE_REASON_NOT_AN_EXTENSION_TYPE,

      See Also:
    • JAKARTA_RS_EXTENSION_SELECT

      public static final String JAKARTA_RS_EXTENSION_SELECT
      A Service property specifying one or more target filters used to select the set of Jakarta RESTful Web Services extension services required to support this whiteboard service.

      A Jakarta RESTful Web Services Whiteboard service may require one or more extensions to be available so that it can function. For example a resource which declares that it @Produces("text/json") requires a MessageBodyWriter which supports JSON to be available.

      This service property provides a String+ set of LDAP filters which will be applied to the service properties of all extensions available in the Jakarta RESTful Web Services container. If all of the filters are satisfied then this service is eligible to be hosted by the Jakarta RESTful Web Services container.

      This service property may be declared by any Jakarta RESTful Web Services whiteboard service, whether it is a resource, or an extension.

      If this service property is not specified, then no extensions are required.

      If one or more filter properties are registered and no suitable extension(s) are available then the service will be failed with a cause of DTOConstants.FAILURE_REASON_REQUIRED_EXTENSIONS_UNAVAILABLE

      The value of this service property must be of type String and be a valid filter string.

      See Also:
    • JAKARTA_RS_MEDIA_TYPE

      public static final String JAKARTA_RS_MEDIA_TYPE
      A service property specifying that a Jakarta RESTful Web Services extension service, application service, or whiteboard implementation provides support for reading from and writing to a specific media type.

      The value of this property will be one or more media type identifiers, and where possible IANA registered names, such as application/json should be used. The value must not be a wildcard type. Support for multiple media types that use the same suffix should be supported by registering the media type associated with the suffix.

      See Also:
    • JAKARTA_RS_WHITEBOARD_TARGET

      public static final String JAKARTA_RS_WHITEBOARD_TARGET
      Service property specifying the target filter to select the Jakarta RESTful Web Services Whiteboard implementation to process the service.

      A Jakarta RESTful Web Services Whiteboard implementation can define any number of service properties which can be referenced by the target filter. The service properties should always include the osgi.jakartars.endpoint service property if the endpoint information is known.

      If this service property is not specified, then all Jakarta RESTful Web Services Whiteboard implementations can process the service.

      The value of this service property must be of type String and be a valid filter string.

      See Also:
    • JAKARTA_RS_WHITEBOARD_IMPLEMENTATION

      public static final String JAKARTA_RS_WHITEBOARD_IMPLEMENTATION
      The name of the implementation capability for the Whiteboard Specification for Jakarta RESTful Web Services.
      See Also:
    • JAKARTA_RS_WHITEBOARD_SPECIFICATION_VERSION

      public static final String JAKARTA_RS_WHITEBOARD_SPECIFICATION_VERSION
      The version of the implementation capability for the Whiteboard Specification for Jakarta RESTful Web Services.
      See Also: