org.glassfish.jersey.message.MessageProperties Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of jaxrs-ri Show documentation
Show all versions of jaxrs-ri Show documentation
A bundle project producing JAX-RS RI bundles. The primary artifact is an "all-in-one" OSGi-fied JAX-RS RI bundle
(jaxrs-ri.jar).
Attached to that are two compressed JAX-RS RI archives. The first archive (jaxrs-ri.zip) consists of binary RI bits and
contains the API jar (under "api" directory), RI libraries (under "lib" directory) as well as all external
RI dependencies (under "ext" directory). The secondary archive (jaxrs-ri-src.zip) contains buildable JAX-RS RI source
bundle and contains the API jar (under "api" directory), RI sources (under "src" directory) as well as all external
RI dependencies (under "ext" directory). The second archive also contains "build.xml" ANT script that builds the RI
sources. To build the JAX-RS RI simply unzip the archive, cd to the created jaxrs-ri directory and invoke "ant" from
the command line.
/*
* Copyright (c) 2012, 2023 Oracle and/or its affiliates. All rights reserved.
*
* This program and the accompanying materials are made available under the
* terms of the Eclipse Public License v. 2.0, which is available at
* http://www.eclipse.org/legal/epl-2.0.
*
* This Source Code may also be made available under the following Secondary
* Licenses when the conditions for such availability set forth in the
* Eclipse Public License v. 2.0 are satisfied: GNU General Public License,
* version 2 with the GNU Classpath Exception, which is available at
* https://www.gnu.org/software/classpath/license.html.
*
* SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
*/
package org.glassfish.jersey.message;
import org.glassfish.jersey.internal.util.PropertiesClass;
/**
* Jersey configuration properties for message & entity processing.
*
* @author Marek Potociar
*/
@PropertiesClass
public final class MessageProperties {
/**
* If set to {@code true}, {@code DeflateEncoder deflate encoding interceptor} will use non-standard version
* of the deflate content encoding, skipping the zlib wrapper. Unfortunately, deflate encoding
* implementations in some products use this non-compliant version, hence the switch.
*
* The default value is {@code false}.
*
* The name of the configuration property is {@value}
.
*/
public static final String DEFLATE_WITHOUT_ZLIB = "jersey.config.deflate.nozlib";
/**
* If set to {@code true} then XML root element tag name for collections will
* be derived from {@link jakarta.xml.bind.annotation.XmlRootElement @XmlRootElement}
* annotation value and won't be de-capitalized.
*
* The default value is {@code false}.
*
* The name of the configuration property is {@value}
.
*/
public static final String JAXB_PROCESS_XML_ROOT_ELEMENT = "jersey.config.jaxb.collections.processXmlRootElement";
/**
* If set to {@code true} XML security features when parsing XML documents will be
* disabled.
*
* The default value is {@code false}.
*
* The name of the configuration property is {@value}
.
*/
public static final String XML_SECURITY_DISABLE = "jersey.config.xml.security.disable";
/**
* If set to {@code true} indicates that produced XML output should be formatted
* if possible (see below).
*
* A XML message entity written by a {@link jakarta.ws.rs.ext.MessageBodyWriter}
* may be formatted for the purposes of human readability provided the respective
* {@code MessageBodyWriter} supports XML output formatting. All JAXB-based message
* body writers support this property.
*
* The default value is {@code false}.
*
* The name of the configuration property is {@value}
.
*/
public static final String XML_FORMAT_OUTPUT = "jersey.config.xml.formatOutput";
/**
* Value of the property indicates the buffer size to be used for I/O operations
* on byte and character streams. The property value is expected to be a positive
* integer otherwise it will be ignored.
*
* The default value is {@value #IO_DEFAULT_BUFFER_SIZE}
.
*
* The name of the configuration property is {@value}
.
*/
public static final String IO_BUFFER_SIZE = "jersey.config.io.bufferSize";
/**
* The default buffer size ({@value}) for I/O operations on byte and character
* streams.
*/
public static final int IO_DEFAULT_BUFFER_SIZE = 8192;
/**
*
* Integer value used to override maximum number of string length during the JSON processing the JSON provider accepts.
*
*
* The default value is not set and the JSON provider default maximum value is used.
*
*
* If supported by Jackson provider, the default value can differ for each Jackson version. For instance,
* Jackson 14 does not support this setting and the default value is {@link Integer#MAX_VALUE}, Jackson 15.0
* has the default value 5_000_000, Jackson 15.2 has the default value 20_000_000.
*
*
* @since 2.41
*/
public static String JSON_MAX_STRING_LENGTH = "jersey.config.json.string.length";
/**
* If set to {@code true}, {@link jakarta.ws.rs.ext.MessageBodyReader MessageBodyReaders} and
* {@link jakarta.ws.rs.ext.MessageBodyWriter MessageBodyWriters} will be ordered by rules from JAX-RS 1.x, where custom
* providers have always precedence; providers are sorted by {@link jakarta.ws.rs.core.MediaType} and afterwards by
* declaration distance - see {@link org.glassfish.jersey.message.internal.MessageBodyFactory.DeclarationDistanceComparator}.
* Otherwise JAX-RS 3.x ordering will be used, which sorts providers firstly by declaration distance, then by
* {@link jakarta.ws.rs.core.MediaType} and by origin (custom/provided).
*
* The default value is {@code false}.
*
* The name of the configuration property is {@value}
.
*/
public static final String LEGACY_WORKERS_ORDERING = "jersey.config.workers.legacyOrdering";
/**
* Prevents instantiation.
*/
private MessageProperties() {
}
}