org.glassfish.jersey.CommonProperties 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.
/*
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
*
* Copyright (c) 2013-2014 Oracle and/or its affiliates. All rights reserved.
*
* The contents of this file are subject to the terms of either the GNU
* General Public License Version 2 only ("GPL") or the Common Development
* and Distribution License("CDDL") (collectively, the "License"). You
* may not use this file except in compliance with the License. You can
* obtain a copy of the License at
* http://glassfish.java.net/public/CDDL+GPL_1_1.html
* or packager/legal/LICENSE.txt. See the License for the specific
* language governing permissions and limitations under the License.
*
* When distributing the software, include this License Header Notice in each
* file and include the License file at packager/legal/LICENSE.txt.
*
* GPL Classpath Exception:
* Oracle designates this particular file as subject to the "Classpath"
* exception as provided by Oracle in the GPL Version 2 section of the License
* file that accompanied this code.
*
* Modifications:
* If applicable, add the following below the License Header, with the fields
* enclosed by brackets [] replaced by your own identifying information:
* "Portions Copyright [year] [name of copyright owner]"
*
* Contributor(s):
* If you wish your version of this file to be governed by only the CDDL or
* only the GPL Version 2, indicate your decision by adding "[Contributor]
* elects to include this software in this distribution under the [CDDL or GPL
* Version 2] license." If you don't indicate a single choice of license, a
* recipient has the option to distribute your version of this file under
* either the CDDL, the GPL Version 2 or to extend the choice of license to
* its licensees as provided above. However, if you add GPL Version 2 code
* and therefore, elected the GPL Version 2 license, then the option applies
* only if the new code is made subject to such option by the copyright
* holder.
*/
package org.glassfish.jersey;
import java.util.HashMap;
import java.util.Map;
import javax.ws.rs.RuntimeType;
import org.glassfish.jersey.internal.util.PropertiesClass;
import org.glassfish.jersey.internal.util.PropertiesHelper;
/**
* Common (server/client) Jersey configuration properties.
*
* @author Michal Gajdos (michal.gajdos at oracle.com)
* @author Libor Kramolis (libor.kramolis at oracle.com)
*/
@PropertiesClass
public final class CommonProperties {
public static Map LEGACY_FALLBACK_MAP = new HashMap();
static {
LEGACY_FALLBACK_MAP.put(CommonProperties.OUTBOUND_CONTENT_LENGTH_BUFFER_CLIENT,
"jersey.config.contentLength.buffer.client");
LEGACY_FALLBACK_MAP.put(CommonProperties.OUTBOUND_CONTENT_LENGTH_BUFFER_SERVER,
"jersey.config.contentLength.buffer.server");
LEGACY_FALLBACK_MAP.put(CommonProperties.FEATURE_AUTO_DISCOVERY_DISABLE_CLIENT,
"jersey.config.disableAutoDiscovery.client");
LEGACY_FALLBACK_MAP.put(CommonProperties.FEATURE_AUTO_DISCOVERY_DISABLE_SERVER,
"jersey.config.disableAutoDiscovery.server");
LEGACY_FALLBACK_MAP.put(CommonProperties.JSON_PROCESSING_FEATURE_DISABLE_CLIENT,
"jersey.config.disableJsonProcessing.client");
LEGACY_FALLBACK_MAP.put(CommonProperties.JSON_PROCESSING_FEATURE_DISABLE_SERVER,
"jersey.config.disableJsonProcessing.server");
LEGACY_FALLBACK_MAP.put(CommonProperties.METAINF_SERVICES_LOOKUP_DISABLE_CLIENT,
"jersey.config.disableMetainfServicesLookup.client");
LEGACY_FALLBACK_MAP.put(CommonProperties.METAINF_SERVICES_LOOKUP_DISABLE_SERVER,
"jersey.config.disableMetainfServicesLookup.server");
LEGACY_FALLBACK_MAP.put(CommonProperties.MOXY_JSON_FEATURE_DISABLE_CLIENT,
"jersey.config.disableMoxyJson.client");
LEGACY_FALLBACK_MAP.put(CommonProperties.MOXY_JSON_FEATURE_DISABLE_SERVER,
"jersey.config.disableMoxyJson.server");
}
/**
* If {@code true} then disable feature auto discovery globally on client/server.
*
* By default auto discovery is automatically enabled. The value of this property may be overridden by the client/server
* variant of this property.
*
* The default value is {@code false}.
*
*
* The name of the configuration property is {@value}.
*
*/
public static final String FEATURE_AUTO_DISCOVERY_DISABLE = "jersey.config.disableAutoDiscovery";
/**
* Client-specific version of {@link CommonProperties#FEATURE_AUTO_DISCOVERY_DISABLE}.
*
* If present, it overrides the generic one for the client environment.
* @since 2.8
*/
public static final String FEATURE_AUTO_DISCOVERY_DISABLE_CLIENT = "jersey.config.client.disableAutoDiscovery";
/**
* Server-specific version of {@link CommonProperties#FEATURE_AUTO_DISCOVERY_DISABLE}.
*
* If present, it overrides the generic one for the server environment.
* @since 2.8
*/
public static final String FEATURE_AUTO_DISCOVERY_DISABLE_SERVER = "jersey.config.server.disableAutoDiscovery";
/**
* If {@code true} then disable configuration of Json Processing (JSR-353) feature.
*
* By default Json Processing is automatically enabled. The value of this property may be overridden by the client/server
* variant of this property.
*
* The default value is {@code false}.
*
*
* The name of the configuration property is {@value}.
*
*/
public static final String JSON_PROCESSING_FEATURE_DISABLE = "jersey.config.disableJsonProcessing";
/**
* Client-specific version of {@link CommonProperties#JSON_PROCESSING_FEATURE_DISABLE}.
*
* If present, it overrides the generic one for the client environment.
* @since 2.8
*/
public static final String JSON_PROCESSING_FEATURE_DISABLE_CLIENT = "jersey.config.client.disableJsonProcessing";
/**
* Server-specific version of {@link CommonProperties#JSON_PROCESSING_FEATURE_DISABLE}.
*
* If present, it overrides the generic one for the server environment.
* @since 2.8
*/
public static final String JSON_PROCESSING_FEATURE_DISABLE_SERVER = "jersey.config.server.disableJsonProcessing";
/**
* If {@code true} then disable META-INF/services lookup globally on client/server.
*
* By default Jersey lookups SPI implementations described by META-INF/services/* files.
* Then you can register appropriate provider classes by {@link javax.ws.rs.core.Application}.
*
*
* The default value is {@code false}.
*
*
* The name of the configuration property is {@value}.
*
*
* @since 2.1
*/
public static final String METAINF_SERVICES_LOOKUP_DISABLE = "jersey.config.disableMetainfServicesLookup";
/**
* Client-specific version of {@link CommonProperties#METAINF_SERVICES_LOOKUP_DISABLE}.
*
* If present, it overrides the generic one for the client environment.
* @since 2.8
*/
public static final String METAINF_SERVICES_LOOKUP_DISABLE_CLIENT = "jersey.config.client.disableMetainfServicesLookup";
/**
* Server-specific version of {@link CommonProperties#METAINF_SERVICES_LOOKUP_DISABLE}.
*
* If present, it overrides the generic one for the server environment.
* @since 2.8
*/
public static final String METAINF_SERVICES_LOOKUP_DISABLE_SERVER = "jersey.config.server.disableMetainfServicesLookup";
/**
* If {@code true} then disable configuration of MOXy Json feature.
*
* By default MOXy Json is automatically enabled. The value of this property may be overridden by the client/server
* variant of this property.
*
* The default value is {@code false}.
*
*
* The name of the configuration property is {@value}.
*
*/
public static final String MOXY_JSON_FEATURE_DISABLE = "jersey.config.disableMoxyJson";
/**
* Client-specific version of {@link CommonProperties#MOXY_JSON_FEATURE_DISABLE}.
*
* If present, it overrides the generic one for the client environment.
* @since 2.8
*/
public static final String MOXY_JSON_FEATURE_DISABLE_CLIENT = "jersey.config.client.disableMoxyJson";
/**
* Server-specific version of {@link CommonProperties#MOXY_JSON_FEATURE_DISABLE}.
*
* If present, it overrides the generic one for the server environment.
* @since 2.8
*/
public static final String MOXY_JSON_FEATURE_DISABLE_SERVER = "jersey.config.server.disableMoxyJson";
/**
* An integer value that defines the buffer size used to buffer the outbound message entity in order to
* determine its size and set the value of HTTP {@value javax.ws.rs.core.HttpHeaders#CONTENT_LENGTH} header.
*
* If the entity size exceeds the configured buffer size, the buffering would be cancelled and the entity size
* would not be determined. Value less or equal to zero disable the buffering of the entity at all.
*
* The value of this property may be overridden by the client/server variant of this property by defining the suffix
* to this property ".server" or ".client"
* ({@value}.server or {@value}.client).
*
* The default value is {@value org.glassfish.jersey.message.internal.CommittingOutputStream#DEFAULT_BUFFER_SIZE}.
*
*
* The name of the configuration property is {@value}.
*
*/
public static final String OUTBOUND_CONTENT_LENGTH_BUFFER = "jersey.config.contentLength.buffer";
/**
* Client-specific version of {@link CommonProperties#OUTBOUND_CONTENT_LENGTH_BUFFER}.
*
* If present, it overrides the generic one for the client environment.
* @since 2.8
*/
public static final String OUTBOUND_CONTENT_LENGTH_BUFFER_CLIENT = "jersey.config.client.contentLength.buffer";
/**
* Server-specific version of {@link CommonProperties#OUTBOUND_CONTENT_LENGTH_BUFFER}.
*
* If present, it overrides the generic one for the server environment.
* @since 2.8
*/
public static final String OUTBOUND_CONTENT_LENGTH_BUFFER_SERVER = "jersey.config.server.contentLength.buffer";
/**
* Prevent instantiation.
*/
private CommonProperties() {
}
public static Object getValue(Map properties, String propertyName, Class type) {
return PropertiesHelper.getValue(properties, propertyName, type, CommonProperties.LEGACY_FALLBACK_MAP);
}
/**
* Get the value of the specified property.
*
* If the property is not set or the real value type is not compatible with {@code defaultValue} type,
* the specified {@code defaultValue} is returned. Calling this method is equivalent to calling
* {@code CommonProperties.getValue(properties, key, defaultValue, (Class) defaultValue.getClass())}
*
* @param properties Map of properties to get the property value from.
* @param propertyName Name of the property.
* @param defaultValue Default value if property is not registered
* @param Type of the property value.
* @return Value of the property or {@code null}.
*
* @since 2.8
*/
public static T getValue(Map properties, String propertyName, T defaultValue) {
return PropertiesHelper.getValue(properties, propertyName, defaultValue, CommonProperties.LEGACY_FALLBACK_MAP);
}
/**
* Get the value of the specified property.
*
* If the property is not set or the real value type is not compatible with {@code defaultValue} type,
* the specified {@code defaultValue} is returned. Calling this method is equivalent to calling
* {@code CommonProperties.getValue(properties, runtimeType, key, defaultValue, (Class) defaultValue.getClass())}
*
* @param properties Map of properties to get the property value from.
* @param runtime Runtime type which is used to check whether there is a property with the same
* {@code key} but post-fixed by runtime type (.server
* or {@code .client}) which would override the {@code key} property.
* @param propertyName Name of the property.
* @param defaultValue Default value if property is not registered
* @param Type of the property value.
* @return Value of the property or {@code null}.
*
* @since 2.8
*/
public static T getValue(Map properties, RuntimeType runtime, String propertyName, T defaultValue) {
return PropertiesHelper.getValue(properties, runtime, propertyName, defaultValue,CommonProperties.LEGACY_FALLBACK_MAP);
}
/**
* Get the value of the specified property.
*
* If the property is not set or the real value type is not compatible with the specified value type,
* returns {@code defaultValue}.
*
* @param properties Map of properties to get the property value from.
* @param runtime Runtime type which is used to check whether there is a property with the same
* {@code key} but post-fixed by runtime type (.server
* or {@code .client}) which would override the {@code key} property.
* @param propertyName Name of the property.
* @param defaultValue Default value if property is not registered
* @param type Type to retrieve the value as.
* @param Type of the property value.
* @return Value of the property or {@code null}.
*
* @since 2.8
*/
public static T getValue(Map properties, RuntimeType runtime, String propertyName, T defaultValue,
Class type) {
return PropertiesHelper.getValue(properties, runtime, propertyName, defaultValue, type,
CommonProperties.LEGACY_FALLBACK_MAP);
}
/**
* Get the value of the specified property.
*
* If the property is not set or the actual property value type is not compatible with the specified type, the method will
* return {@code null}.
*
* @param properties Map of properties to get the property value from.
* @param runtime Runtime type which is used to check whether there is a property with the same
* {@code key} but post-fixed by runtime type (.server
* or {@code .client}) which would override the {@code key} property.
* @param propertyName Name of the property.
* @param type Type to retrieve the value as.
* @param Type of the property value.
* @return Value of the property or {@code null}.
*
* @since 2.8
*/
public static T getValue(Map properties, RuntimeType runtime, String propertyName, Class type) {
return PropertiesHelper.getValue(properties, runtime, propertyName, type, CommonProperties.LEGACY_FALLBACK_MAP);
}
}